v8.7.0

c708423 · Oct 15, 2017 · 3a93293 · 3a93293
1 parent e03e5de
commit 3a93293
Show file tree

Hide file tree

Showing 107 changed files with 333 additions and 312 deletions.
diff --git a/addons/void_atexit_callback_args.md b/addons/void_atexit_callback_args.md
@@ -1,6 +1,6 @@
 
-* `callback`: `void (*)(void*)` - 一个退出时调用的函数的指针。
-* `args`: `void*` - 一个退出时传递给回调的指针。
+* `callback` {void (\*)(void\*)} - 一个退出时调用的函数的指针。
+* `args` {void\*} - 一个退出时传递给回调的指针。
 
 注册的 AtExit 钩子会在事件循环结束之后但虚拟机被终止之前退出。
 

diff --git a/assert/__link.md b/assert/__link.md
@@ -27,4 +27,5 @@
 [可枚举的自身属性]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Enumerability_and_ownership_of_properties
 [原型]: https://tc39.github.io/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots
 [类型标签]: https://tc39.github.io/ecma262/#sec-object.prototype.tostring
-[MDN的等式比较指南]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Equality_comparisons_and_sameness
+[MDN的等式比较指南]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Equality_comparisons_and_sameness
+[对象封装器]: https://developer.mozilla.org/en-US/docs/Glossary/Primitive#Primitive_wrapper_objects_in_JavaScript
diff --git a/async_hooks/async_hooks_createhook_callbacks.md b/async_hooks/async_hooks_createhook_callbacks.md
@@ -3,12 +3,12 @@
 added: v8.1.0
 -->
 
-* `callbacks` {Object} the [Hook Callbacks][] to register
+* `callbacks` {Object} The [Hook Callbacks][] to register
   * `init` {Function} The [`init` callback][].
   * `before` {Function} The [`before` callback][].
   * `after` {Function} The [`after` callback][].
   * `destroy` {Function} The [`destroy` callback][].
-* Returns: `{AsyncHook}` instance used for disabling and enabling hooks
+* Returns: `{AsyncHook}` Instance used for disabling and enabling hooks
 
 Registers functions to be called for different lifetime events of each async
 operation.

diff --git a/async_hooks/async_hooks_executionasyncid.md b/async_hooks/async_hooks_executionasyncid.md
@@ -1,5 +1,5 @@
 
-* Returns {number} the `asyncId` of the current execution context. Useful to
+* Returns: {number} The `asyncId` of the current execution context. Useful to
   track when something calls.
 
 For example:

diff --git a/async_hooks/async_hooks_triggerasyncid.md b/async_hooks/async_hooks_triggerasyncid.md
@@ -1,5 +1,5 @@
 
-* Returns {number} the ID of the resource responsible for calling the callback
+* Returns: {number} The ID of the resource responsible for calling the callback
   that is currently being executed.
 
 For example:

diff --git a/async_hooks/asynchook_disable.md b/async_hooks/asynchook_disable.md
@@ -1,5 +1,5 @@
 
-* Returns {AsyncHook} A reference to `asyncHook`.
+* Returns: {AsyncHook} A reference to `asyncHook`.
 
 Disable the callbacks for a given `AsyncHook` instance from the global pool of
 AsyncHook callbacks to be executed. Once a hook has been disabled it will not

diff --git a/async_hooks/asynchook_enable.md b/async_hooks/asynchook_enable.md
@@ -1,5 +1,5 @@
 
-* Returns {AsyncHook} A reference to `asyncHook`.
+* Returns: {AsyncHook} A reference to `asyncHook`.
 
 Enable the callbacks for a given `AsyncHook` instance. If no callbacks are
 provided enabling is a noop.

diff --git a/async_hooks/asyncresource_asyncid.md b/async_hooks/asyncresource_asyncid.md
@@ -1,3 +1,3 @@
 
-* Returns {number} the unique `asyncId` assigned to the resource.
+* Returns: {number} The unique `asyncId` assigned to the resource.
 
diff --git a/async_hooks/asyncresource_emitafter.md b/async_hooks/asyncresource_emitafter.md
@@ -1,5 +1,5 @@
 
-* Returns {undefined}
+* Returns: {undefined}
 
 Call all `after` callbacks. If nested calls to `emitBefore()` were made, then
 make sure the stack is unwound properly. Otherwise an error will be thrown.

diff --git a/async_hooks/asyncresource_emitbefore.md b/async_hooks/asyncresource_emitbefore.md
@@ -1,5 +1,5 @@
 
-* Returns {undefined}
+* Returns: {undefined}
 
 Call all `before` callbacks to notify that a new asynchronous execution context
 is being entered. If nested calls to `emitBefore()` are made, the stack of

diff --git a/async_hooks/asyncresource_emitdestroy.md b/async_hooks/asyncresource_emitdestroy.md
@@ -1,5 +1,5 @@
 
-* Returns {undefined}
+* Returns: {undefined}
 
 Call all `destroy` hooks. This should only ever be called once. An error will
 be thrown if it is called more than once. This **must** be manually called. If

diff --git a/async_hooks/asyncresource_triggerasyncid.md b/async_hooks/asyncresource_triggerasyncid.md
@@ -1,5 +1,5 @@
 
-* Returns {number} the same `triggerAsyncId` that is passed to the `AsyncResource`
+* Returns: {number} The same `triggerAsyncId` that is passed to the `AsyncResource`
 constructor.
 
 [`after` callback]: #async_hooks_after_asyncid

diff --git a/async_hooks/asyncresource_type_triggerasyncid.md b/async_hooks/asyncresource_type_triggerasyncid.md
@@ -1,8 +1,8 @@
 
 * arguments
-  * `type` {string} the type of async event
-  * `triggerAsyncId` {number} the ID of the execution context that created this
-    async event
+  * `type` {string} The type of async event.
+  * `triggerAsyncId` {number} The ID of the execution context that created this
+    async event.
 
 Example usage:
 

diff --git a/async_hooks/init_asyncid_type_triggerasyncid_resource.md b/async_hooks/init_asyncid_type_triggerasyncid_resource.md
@@ -1,10 +1,10 @@
 
-* `asyncId` {number} a unique ID for the async resource
-* `type` {string} the type of the async resource
-* `triggerAsyncId` {number} the unique ID of the async resource in whose
-  execution context this async resource was created
-* `resource` {Object} reference to the resource representing the async operation,
-  needs to be released during _destroy_
+* `asyncId` {number} A unique ID for the async resource.
+* `type` {string} The type of the async resource.
+* `triggerAsyncId` {number} The unique ID of the async resource in whose
+  execution context this async resource was created.
+* `resource` {Object} Reference to the resource representing the async operation,
+  needs to be released during _destroy_.
 
 Called when a class is constructed that has the _possibility_ to emit an
 asynchronous event. This _does not_ mean the instance must call

diff --git a/buffer/buf_fill_value_offset_end_encoding.md b/buffer/buf_fill_value_offset_end_encoding.md
@@ -6,12 +6,11 @@ changes:
     description: The `encoding` parameter is supported now.
 -->
 
-* `value` {string|Buffer|integer} 用来填充 `buf` 的值
-* `offset` {integer} 开始填充 `buf` 的位置。**默认:** `0`
-* `end` {integer} 结束填充 `buf` 的位置（不包含）。**默认:** [`buf.length`]
-* `encoding` {string} 如果 `value` 是一个字符串，则这是它的字符编码。
-  **默认:** `'utf8'`
-* 返回: {Buffer} `buf` 的引用
+* `value` {string|Buffer|integer} 用来填充 `buf` 的值。
+* `offset` {integer} 开始填充 `buf` 前要跳过的字节数。**默认:** `0`。
+* `end` {integer} 结束填充 `buf` 的位置（不包含）。**默认:** [`buf.length`]。
+* `encoding` {string} 如果 `value` 是一个字符串，则这是它的字符编码。**默认:** `'utf8'`。
+* 返回: {Buffer} `buf` 的引用。
 
 如果未指定 `offset` 和 `end`，则填充整个 `buf`。
 这个简化使得一个 `Buffer` 的创建与填充可以在一行内完成。

diff --git a/buffer/buf_readdoublele_offset_noassert.md b/buffer/buf_readdoublele_offset_noassert.md
@@ -2,8 +2,8 @@
 added: v0.11.15
 -->
 
-* `offset` {integer} 开始读取的位置，必须满足：`0 <= offset <= buf.length - 8`
-* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`
+* `offset` {integer} 开始读取前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 8`。
+* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`。
 * 返回: {number}
 
 用指定的字节序格式（`readDoubleBE()` 返回大端序，`readDoubleLE()` 返回小端序）从 `buf` 中指定的 `offset` 读取一个64位双精度值。

diff --git a/buffer/buf_readfloatle_offset_noassert.md b/buffer/buf_readfloatle_offset_noassert.md
@@ -2,8 +2,8 @@
 added: v0.11.15
 -->
 
-* `offset` {integer} 开始读取的位置，必须满足：`0 <= offset <= buf.length - 4`
-* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`
+* `offset` {integer} 开始读取前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 4`。
+* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`。
 * 返回: {number}
 
 用指定的字节序格式（`readFloatBE()` 返回大端序，`readFloatLE()` 返回小端序）从 `buf` 中指定的 `offset` 读取一个32位浮点值。

diff --git a/buffer/buf_readint16le_offset_noassert.md b/buffer/buf_readint16le_offset_noassert.md
@@ -2,8 +2,8 @@
 added: v0.5.5
 -->
 
-* `offset` {integer} 开始读取的位置，必须满足：`0 <= offset <= buf.length - 2`
-* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`
+* `offset` {integer} 开始读取前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 2`。
+* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`。
 * 返回: {integer}
 
 用指定的字节序格式（`readInt16BE()` 返回大端序，`readInt16LE()` 返回小端序）从 `buf` 中指定的 `offset` 读取一个有符号的16位整数值。

diff --git a/buffer/buf_readint32le_offset_noassert.md b/buffer/buf_readint32le_offset_noassert.md
@@ -2,8 +2,8 @@
 added: v0.5.5
 -->
 
-* `offset` {integer} 开始读取的位置，必须满足：`0 <= offset <= buf.length - 4`
-* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`
+* `offset` {integer} 开始读取前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 4`。
+* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`。
 * 返回: {integer}
 
 用指定的字节序格式（`readInt32BE()` 返回大端序，`readInt32LE()` 返回小端序）从 `buf` 中指定的 `offset` 读取一个有符号的32位整数值。

diff --git a/buffer/buf_readint8_offset_noassert.md b/buffer/buf_readint8_offset_noassert.md
@@ -2,8 +2,8 @@
 added: v0.5.0
 -->
 
-* `offset` {integer} 开始读取的位置，必须满足：`0 <= offset <= buf.length - 1`
-* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`
+* `offset` {integer} 开始读取前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 1`。
+* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`。
 * 返回: {integer}
 
 从 `buf` 中指定的 `offset` 读取一个有符号的8位整数值。

diff --git a/buffer/buf_readintle_offset_bytelength_noassert.md b/buffer/buf_readintle_offset_bytelength_noassert.md
@@ -2,9 +2,9 @@
 added: v0.11.15
 -->
 
-* `offset` {integer} 开始读取的位置，必须满足：`0 <= offset <= buf.length - byteLength`
-* `byteLength` {integer} 要读取的字节数。必须满足：`0 < byteLength <= 6`
-* `noAssert` {boolean} 是否跳过 `offset` 和 `byteLength` 校验？ **默认:** `false`
+* `offset` {integer} 开始读取前要跳过的字节数，必须满足：`0 <= offset <= buf.length - byteLength`。
+* `byteLength` {integer} 要读取的字节数。必须满足：`0 < byteLength <= 6`。
+* `noAssert` {boolean} 是否跳过 `offset` 和 `byteLength` 校验？ **默认:** `false`。
 * 返回: {integer}
 
 从 `buf` 中指定的 `offset` 读取 `byteLength` 个字节，且读取的值会被解析为二进制补码值。

diff --git a/buffer/buf_readuint16le_offset_noassert.md b/buffer/buf_readuint16le_offset_noassert.md
@@ -2,8 +2,8 @@
 added: v0.5.5
 -->
 
-* `offset` {integer} 开始读取的位置，必须满足：`0 <= offset <= buf.length - 2`
-* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`
+* `offset` {integer} 开始读取前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 2`。
+* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`。
 * 返回: {integer}
 
 用指定的字节序格式（`readUInt16BE()` 返回大端序，`readUInt16LE()` 返回小端序）从 `buf` 中指定的 `offset` 读取一个无符号的16位整数值。

diff --git a/buffer/buf_readuint32le_offset_noassert.md b/buffer/buf_readuint32le_offset_noassert.md
@@ -2,8 +2,8 @@
 added: v0.5.5
 -->
 
-* `offset` {integer} 开始读取的位置，必须满足：`0 <= offset <= buf.length - 4`
-* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`
+* `offset` {integer} 开始读取前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 4`。
+* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`。
 * 返回: {integer}
 
 用指定的字节序格式（`readUInt32BE()` 返回大端序，`readUInt32LE()` 返回小端序）从 `buf` 中指定的 `offset` 读取一个无符号的32位整数值。

diff --git a/buffer/buf_readuint8_offset_noassert.md b/buffer/buf_readuint8_offset_noassert.md
@@ -2,8 +2,8 @@
 added: v0.5.0
 -->
 
-* `offset` {integer} 开始读取的位置，必须满足：`0 <= offset <= buf.length - 1`
-* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`
+* `offset` {integer} 开始读取前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 1`。
+* `noAssert` {boolean} 是否跳过 `offset` 检验？**默认:** `false`。
 * 返回: {integer}
 
 从 `buf` 中指定的 `offset` 读取一个无符号的8位整数值。

diff --git a/buffer/buf_readuintle_offset_bytelength_noassert.md b/buffer/buf_readuintle_offset_bytelength_noassert.md
@@ -2,9 +2,9 @@
 added: v0.11.15
 -->
 
-* `offset` {integer} 开始读取的位置，必须满足：`0 <= offset <= buf.length - byteLength`
-* `byteLength` {integer} 要读取的字节数。必须满足：`0 < byteLength <= 6`
-* `noAssert` {boolean} 是否跳过 `offset` 和 `byteLength` 校验？ **默认:** `false`
+* `offset` {integer} 开始读取前要跳过的字节数，必须满足：`0 <= offset <= buf.length - byteLength`。
+* `byteLength` {integer} 要读取的字节数。必须满足：`0 < byteLength <= 6`。
+* `noAssert` {boolean} 是否跳过 `offset` 和 `byteLength` 校验？ **默认:** `false`。
 * 返回: {integer}
 
 从 `buf` 中指定的 `offset` 读取 `byteLength` 个字节，且读取的值会被解析为无符号的整数。

diff --git a/buffer/buf_write_string_offset_length_encoding.md b/buffer/buf_write_string_offset_length_encoding.md
@@ -2,11 +2,11 @@
 added: v0.1.90
 -->
 
-* `string` {string} 要写入 `buf` 的字符串
-* `offset` {integer} 开始写入 `string` 的位置。**默认:** `0`
-* `length` {integer} 要写入的字节数。**默认:** `buf.length - offset`
-* `encoding` {string} `string` 的字符编码。**默认:** `'utf8'`
-* 返回: {integer} 写入的字节数
+* `string` {string} 要写入 `buf` 的字符串。
+* `offset` {integer} 开始写入 `string` 前要跳过的字节数。**默认:** `0`。
+* `length` {integer} 要写入的字节数。**默认:** `buf.length - offset`。
+* `encoding` {string} `string` 的字符编码。**默认:** `'utf8'`。
+* 返回: {integer} 写入的字节数。
 
 根据 `encoding` 的字符编码写入 `string` 到 `buf` 中的 `offset` 位置。
 `length` 参数是写入的字节数。

diff --git a/buffer/buf_writedoublele_value_offset_noassert.md b/buffer/buf_writedoublele_value_offset_noassert.md
@@ -2,10 +2,10 @@
 added: v0.11.15
 -->
 
-* `value` {number} 要写入 `buf` 的数值
-* `offset` {integer} 开始写入的位置，必须满足：`0 <= offset <= buf.length - 8`
-* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`
-* 返回: {integer} `offset` 加上写入的字节数
+* `value` {number} 要写入 `buf` 的数值。
+* `offset` {integer} 开始写入前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 8`。
+* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`。
+* 返回: {integer} `offset` 加上写入的字节数。
 
 用指定的字节序格式（`writeDoubleBE()` 写入大端序，`writeDoubleLE()` 写入小端序）写入 `value` 到 `buf` 中指定的 `offset` 位置。
 `value` 应当是一个有效的64位双精度值。

diff --git a/buffer/buf_writefloatle_value_offset_noassert.md b/buffer/buf_writefloatle_value_offset_noassert.md
@@ -2,10 +2,10 @@
 added: v0.11.15
 -->
 
-* `value` {number} 要写入 `buf` 的数值
-* `offset` {integer} 开始写入的位置，必须满足：`0 <= offset <= buf.length - 4`
-* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`
-* 返回: {integer} `offset` 加上写入的字节数
+* `value` {number} 要写入 `buf` 的数值。
+* `offset` {integer} 开始写入前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 4`。
+* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`。
+* 返回: {integer} `offset` 加上写入的字节数。
 
 用指定的字节序格式（`writeFloatBE()` 写入大端序，`writeFloatLE()` 写入小端序）写入 `value` 到 `buf` 中指定的 `offset` 位置。
 `value` 应当是一个有效的32位浮点值。

diff --git a/buffer/buf_writeint16le_value_offset_noassert.md b/buffer/buf_writeint16le_value_offset_noassert.md
@@ -2,10 +2,10 @@
 added: v0.5.5
 -->
 
-* `value` {integer} 要写入 `buf` 的数值
-* `offset` {integer} 开始写入的位置，必须满足：`0 <= offset <= buf.length - 2`
-* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`
-* 返回: {integer} `offset` 加上写入的字节数
+* `value` {integer} 要写入 `buf` 的数值。
+* `offset` {integer} 开始写入前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 2`。
+* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`。
+* 返回: {integer} `offset` 加上写入的字节数。
 
 用指定的字节序格式（`writeInt16BE()` 写入大端序，`writeInt16LE()` 写入小端序）写入 `value` 到 `buf` 中指定的 `offset` 位置。
 `value` 应当是一个有效的有符号的16位整数。

diff --git a/buffer/buf_writeint32le_value_offset_noassert.md b/buffer/buf_writeint32le_value_offset_noassert.md
@@ -2,10 +2,10 @@
 added: v0.5.5
 -->
 
-* `value` {integer} 要写入 `buf` 的数值
-* `offset` {integer} 开始写入的位置，必须满足：`0 <= offset <= buf.length - 4`
-* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`
-* 返回: {integer} `offset` 加上写入的字节数
+* `value` {integer} 要写入 `buf` 的数值。
+* `offset` {integer} 开始写入前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 4`。
+* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`。
+* 返回: {integer} `offset` 加上写入的字节数。
 
 用指定的字节序格式（`writeInt32BE()` 写入大端序，`writeInt32LE()` 写入小端序）写入 `value` 到 `buf` 中指定的 `offset` 位置。
 `value` 应当是一个有效的有符号的32位整数。

diff --git a/buffer/buf_writeint8_value_offset_noassert.md b/buffer/buf_writeint8_value_offset_noassert.md
@@ -2,10 +2,10 @@
 added: v0.5.0
 -->
 
-* `value` {integer} 要写入 `buf` 的数值
-* `offset` {integer} 开始写入的位置，必须满足：`0 <= offset <= buf.length - 1`
-* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`
-* 返回: {integer} `offset` 加上写入的字节数
+* `value` {integer} 要写入 `buf` 的数值。
+* `offset` {integer} 开始写入前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 1`。
+* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`。
+* 返回: {integer} `offset` 加上写入的字节数。
 
 写入 `value` 到 `buf` 中指定的 `offset` 位置。
 `value` 应当是一个有效的有符号的8位整数。

diff --git a/buffer/buf_writeintle_value_offset_bytelength_noassert.md b/buffer/buf_writeintle_value_offset_bytelength_noassert.md
@@ -2,11 +2,11 @@
 added: v0.11.15
 -->
 
-* `value` {integer} 要写入 `buf` 的数值
-* `offset` {integer} 开始写入的位置，必须满足：`0 <= offset <= buf.length - byteLength`
-* `byteLength` {integer} 要写入的字节数，必须满足：`0 < byteLength <= 6`
-* `noAssert` {boolean} 是否跳过 `value`、`offset` 和 `byteLength` 检验？**默认:** `false`
-* 返回: {integer} `offset` 加上写入的字节数
+* `value` {integer} 要写入 `buf` 的数值。
+* `offset` {integer} 开始写入前要跳过的字节数，必须满足：`0 <= offset <= buf.length - byteLength`。
+* `byteLength` {integer} 要写入的字节数，必须满足：`0 < byteLength <= 6`。
+* `noAssert` {boolean} 是否跳过 `value`、`offset` 和 `byteLength` 检验？**默认:** `false`。
+* 返回: {integer} `offset` 加上写入的字节数。
 
 写入 `value` 中的 `byteLength` 个字节到 `buf` 中指定的 `offset` 位置。
 最高支持48位精度。

diff --git a/buffer/buf_writeuint16le_value_offset_noassert.md b/buffer/buf_writeuint16le_value_offset_noassert.md
@@ -2,10 +2,10 @@
 added: v0.5.5
 -->
 
-* `value` {integer} 要写入 `buf` 的数值
-* `offset` {integer} 开始写入的位置，必须满足：`0 <= offset <= buf.length - 2`
-* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`
-* 返回: {integer} `offset` 加上写入的字节数
+* `value` {integer} 要写入 `buf` 的数值。
+* `offset` {integer} 开始写入前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 2`。
+* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`。
+* 返回: {integer} `offset` 加上写入的字节数。
 
 用指定的字节序格式（`writeUInt16BE()` 写入大端序，`writeUInt16LE()` 写入小端序）写入 `value` 到 `buf` 中指定的 `offset` 位置。
 `value` 应当是一个有效的无符号的16位整数。

diff --git a/buffer/buf_writeuint32le_value_offset_noassert.md b/buffer/buf_writeuint32le_value_offset_noassert.md
@@ -2,10 +2,10 @@
 added: v0.5.5
 -->
 
-* `value` {integer} 要写入 `buf` 的数值
-* `offset` {integer} 开始写入的位置，必须满足：`0 <= offset <= buf.length - 4`
-* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`
-* 返回: {integer} `offset` 加上写入的字节数
+* `value` {integer} 要写入 `buf` 的数值。
+* `offset` {integer} 开始写入前要跳过的字节数，必须满足：`0 <= offset <= buf.length - 4`。
+* `noAssert` {boolean} 是否跳过 `value` 和 `offset` 检验？**默认:** `false`。
+* 返回: {integer} `offset` 加上写入的字节数。
 
 用指定的字节序格式（`writeUInt32BE()` 写入大端序，`writeUInt32LE()` 写入小端序）写入 `value` 到 `buf` 中指定的 `offset` 位置。
 `value` 应当是一个有效的无符号的32位整数。
Original file line number	Diff line number	Diff line change
		@@ -1,3 +1,3 @@

		* Returns {number} the unique `asyncId` assigned to the resource.
		* Returns: {number} The unique `asyncId` assigned to the resource.