2017-07-19, Version 8.2.0 (Current)

Big thanks to @addaleax who prepared the vast majority of this release.

Notable changes:

* **Async Hooks**
  * Multiple improvements to Promise support in `async_hooks` have been made.

* **Build**
  * The compiler version requirement to build Node with GCC has been raised to
    GCC 4.9.4.
    [[`820b011ed6`](820b011ed6)]
    [#13466](#13466)

* **Cluster**
  * Users now have more fine-grained control over the inspector port used by
    individual cluster workers. Previously, cluster workers would simply
    increment from the master's debug port.
    [[`dfc46e262a`](dfc46e262a)]
    [#14140](#14140)

* **DNS**
  * The server used for DNS queries can now use a custom port.
    [[`ebe7bb29aa`](ebe7bb29aa)]
    [#13723](#13723)
  * Support for `dns.resolveAny()` has been added.
    [[`6e30e2558e`](6e30e2558e)]
    [#13137](#13137)

* **npm**
  * The `npm` CLI has been updated to version 5.3.0. In particular, it now comes
    with the `npx` binary, which is also shipped with Node.
    [[`dc3f6b9ac1`](dc3f6b9ac1)]
    [#14235](#14235)
  * `npm` Changelogs:
      - [v5.0.4](https://github.com/npm/npm/releases/tag/v5.0.4)
      - [v5.1.0](https://github.com/npm/npm/releases/tag/v5.1.0)
      - [v5.2.0](https://github.com/npm/npm/releases/tag/v5.2.0)
      - [v5.3.0](https://github.com/npm/npm/releases/tag/v5.3.0)

PR-URL: #13744

CHANGELOG.md

@@ -27,7 +27,8 @@ release.
 </tr>
 <tr>
     <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V8.md#8.1.4">8.1.4</a></b><br/>
+<b><a href="doc/changelogs/CHANGELOG_V8.md#8.2.0">8.2.0</a></b><br/>
+<a href="doc/changelogs/CHANGELOG_V8.md#8.1.4">8.1.4</a><br/>
 <a href="doc/changelogs/CHANGELOG_V8.md#8.1.3">8.1.3</a><br/>
 <a href="doc/changelogs/CHANGELOG_V8.md#8.1.2">8.1.2</a><br/>
 <a href="doc/changelogs/CHANGELOG_V8.md#8.1.1">8.1.1</a><br/>

doc/api/buffer.md

@@ -910,7 +910,7 @@ A `TypeError` will be thrown if `str` is not a string.
 
 ### Class Method: Buffer.from(object[, offsetOrEncoding[, length]])
 <!-- YAML
-added: REPLACEME
+added: v8.2.0
 -->
 
 * `object` {Object} An object supporting `Symbol.toPrimitive` or `valueOf()`
@@ -2665,15 +2665,15 @@ console.log(buf);
 
 ## Buffer Constants
 <!-- YAML
-added: REPLACEME
+added: 8.2.0
 -->
 
 Note that `buffer.constants` is a property on the `buffer` module returned by
 `require('buffer')`, not on the `Buffer` global or a `Buffer` instance.
 
 ### buffer.constants.MAX_LENGTH
 <!-- YAML
-added: REPLACEME
+added: 8.2.0
 -->
 
 * {integer} The largest size allowed for a single `Buffer` instance
@@ -2685,7 +2685,7 @@ This value is also available as [`buffer.kMaxLength`][].
 
 ### buffer.constants.MAX_STRING_LENGTH
 <!-- YAML
-added: REPLACEME
+added: 8.2.0
 -->
 
 * {integer} The largest length allowed for a single `string` instance

doc/api/cluster.md

@@ -694,7 +694,7 @@ values are `"rr"` and `"none"`.
 <!-- YAML
 added: v0.7.1
 changes:
-  - version: REPLACEME
+  - version: 8.2.0
     pr-url: https://github.com/nodejs/node/pull/14140
     description: The `inspectPort` option is supported now.
   - version: v6.4.0

doc/api/n-api.md

@@ -540,7 +540,7 @@ thrown to immediately terminate the process.
 
 #### napi_fatal_error
 <!-- YAML
-added: REPLACEME
+added: v8.2.0
 -->
 ```C
 NAPI_EXTERN NAPI_NO_RETURN void napi_fatal_error(const char* location, const char* message);
@@ -2338,7 +2338,7 @@ This API checks if the Object passed in has the named property.
 
 #### *napi_delete_property*
 <!-- YAML
-added: REPLACEME
+added: v8.2.0
 -->
 ```C
 napi_status napi_delete_property(napi_env env,
@@ -2360,7 +2360,7 @@ This API attempts to delete the `key` own property from `object`.
 
 #### *napi_has_own_property*
 <!-- YAML
-added: REPLACEME
+added: v8.2.0
 -->
 ```C
 napi_status napi_has_own_property(napi_env env,
@@ -2507,7 +2507,7 @@ requested index.
 
 #### *napi_delete_element*
 <!-- YAML
-added: REPLACEME
+added: v8.2.0
 -->
 ```C
 napi_status napi_delete_element(napi_env env,

doc/api/util.md

@@ -12,7 +12,7 @@ const util = require('util');
 
 ## util.callbackify(original)
 <!-- YAML
-added: REPLACEME
+added: v8.2.0
 -->
 
 * `original` {Function} An `async` function