Release proposal: v5.5.1 (Stable)

.eslintrc

@@ -17,6 +17,8 @@ ecmaFeatures:
 rules:
   # Possible Errors
   # list: https://github.com/eslint/eslint/tree/master/docs/rules#possible-errors
+  ## disallow control characters in regular expressions
+  no-control-regex: 2
   ## check debugger sentence
   no-debugger: 2
   ## check duplicate arguments
@@ -25,24 +27,24 @@ rules:
   no-dupe-keys: 2
   ## check duplicate switch-case
   no-duplicate-case: 2
-  ## disallow superfluous semicolons
-  no-extra-semi: 2
+  ## disallow the use of empty character classes in regular expressions
+  no-empty-character-class: 2
   ## disallow assignment of exceptional params
   no-ex-assign: 2
-  ## disallow unreachable code
-  no-unreachable: 2
-  ## require valid typeof compared string like typeof foo === 'strnig'
-  valid-typeof: 2
-  ## disallow controls characters in regular expressions
-  no-control-regex: 2
   ## disallow extra boolean casts
   no-extra-boolean-cast : 2
+  ## disallow superfluous semicolons
+  no-extra-semi: 2
   ## validate regular expressions
   no-invalid-regexp: 2
   ## forbid weird whitespace characters
   no-irregular-whitespace: 2
   ## avoid unexpected multiline expressions
   no-unexpected-multiline: 2
+  ## disallow unreachable code
+  no-unreachable: 2
+  ## require valid typeof compared string like typeof foo === 'strnig'
+  valid-typeof: 2
 
   # Best Practices
   # list: https://github.com/eslint/eslint/tree/master/docs/rules#best-practices
@@ -81,6 +83,8 @@ rules:
   space-after-keywords: 2
   ## no leading/trailing spaces in parens
   space-in-parens: [2, "never"]
+  ## no spaces with non-word unary operators, require for word unary operators
+  space-unary-ops: 2
 
   # ECMAScript 6
   # list: http://eslint.org/docs/rules/#ecmascript-6

doc/api/buffer.markdown

@@ -75,8 +75,8 @@ The character encodings currently supported by Node.js include:
 Buffers are also `Uint8Array` TypedArray instances. However, there are subtle
 incompatibilities with the TypedArray specification in ECMAScript 2015. For
 instance, while `ArrayBuffer#slice()` creates a copy of the slice,
-the implementation of [`Buffer#slice()`][] creates a view over the existing
-Buffer without copying, making `Buffer#slice()` far more efficient.
+the implementation of [`Buffer#slice()`][`buf.slice()`] creates a view over the
+existing Buffer without copying, making `Buffer#slice()` far more efficient.
 
 It is also possible to create new TypedArray instances from a `Buffer` with the
 following caveats:
@@ -1351,17 +1351,16 @@ socket.on('readable', () => {
 Use of `SlowBuffer` should be used only as a last resort *after* a developer
 has observed undue memory retention in their applications.
 
-[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols
-[`Array#indexOf()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf
 [`Array#includes()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/includes
+[`Array#indexOf()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf
+[`buf.entries()`]: #buffer_buf_entries
 [`buf.fill(0)`]: #buffer_buf_fill_value_offset_end
+[`buf.keys()`]: #buffer_buf_keys
 [`buf.slice()`]: #buffer_buf_slice_start_end
+[`buf.values()`]: #buffer_buf_values
 [`buf1.compare(buf2)`]: #buffer_buf_compare_otherbuffer
-[`Buffer#slice()`]: #buffer_buf_slice_start_end
+[`JSON.stringify()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify
 [`RangeError`]: errors.html#errors_class_rangeerror
 [`String.prototype.length`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/length
 [`util.inspect()`]: util.html#util_util_inspect_object_options
-[`buf.values()`]: #buffer_buf_values
-[`buf.keys()`]: #buffer_buf_keys
-[`buf.entries()`]: #buffer_buf_entries
-[`JSON.stringify()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify
+[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols

doc/api/console.markdown

@@ -53,19 +53,10 @@ duplicate the browsers functionality exactly.
 
 ## Asynchronous vs Synchronous Consoles
 
-The console functions are synchronous when the destination is a terminal or
-a file (to avoid lost messages in case of premature exit) and asynchronous
-when the destination is a pipe (to avoid blocking for long periods of time).
-
-In the following example, stdout is non-blocking while stderr is blocking:
-
-```
-$ node script.js 2> error.log | tee info.log
-```
-
-Typically, the distinction between blocking/non-blocking is not important
-unless an application is logging significant amounts of data. High volume
-logging *should* use a `Console` instance that writes to a pipe.
+The console functions are asynchronous unless the destination is a file.
+Disks are fast and operating systems normally employ write-back caching;
+it should be a very rare occurrence indeed that a write blocks, but it
+is possible.
 
 ## Class: Console
 

doc/api/dgram.markdown

@@ -86,7 +86,7 @@ Returns an object containing the address information for a socket.
 For UDP sockets, this object will contain `address`, `family` and `port`
 properties.
 
-### [socket.bind([port][, address][, callback])]
+### socket.bind([port][, address][, callback])
 
 * `port` Integer, Optional
 * `address` String, Optional

doc/api/os.markdown

@@ -14,7 +14,7 @@ system.
 ## os.arch()
 
 Returns the operating system CPU architecture. Possible values are `'x64'`,
-`'arm'` and `'ia32'`. Returns the value of `process.arch`.
+`'arm'` and `'ia32'`. Returns the value of [`process.arch`][].
 
 ## os.cpus()
 
@@ -159,7 +159,7 @@ interfaces that have been assigned an address.
 
 Returns the operating system platform. Possible values are `'darwin'`,
 `'freebsd'`, `'linux'`, `'sunos'` or `'win32'`. Returns the value of
-`process.platform`.
+[`process.platform`][].
 
 ## os.release()
 
@@ -181,3 +181,6 @@ on OS X and `'Windows_NT'` on Windows.
 ## os.uptime()
 
 Returns the system uptime in seconds.
+
+[`process.arch`]: process.html#process_process_arch
+[`process.platform`]: process.html#process_process_platform