lib: add static identifier codes for all deprecations

Assigns a static identifier code to all runtime and documentation
only deprecations. The identifier code is included in the emitted
DeprecationWarning.

Also adds a deprecations.md to the API docs to provide a central
location where deprecation codes can be referenced and explained.

PR-URL: https://github.com/nodejs/node/pull/10116
Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com>
Reviewed-By: Michal Zasso <targos@protonmail.com>
Reviewed-By: Fedor Indutny <fedor.indutny@gmail.com>

1 files changed, 4 insertions, 2 deletions

diff --git a/lib/os.js b/lib/os.js
index a59cc49bae..7ab0ec5fa4 100644
--- a/lib/os.js
+++ b/lib/os.js
@@ -53,12 +53,14 @@ exports.tmpdir = function() {
 
 const tmpDirDeprecationMsg =
   'os.tmpDir() is deprecated. Use os.tmpdir() instead.';
-exports.tmpDir = internalUtil.deprecate(exports.tmpdir, tmpDirDeprecationMsg);
+exports.tmpDir = internalUtil.deprecate(exports.tmpdir,
+                                        tmpDirDeprecationMsg,
+                                        'DEP0022');
 
 exports.getNetworkInterfaces = internalUtil.deprecate(function() {
   return exports.networkInterfaces();
 }, 'os.getNetworkInterfaces is deprecated. ' +
-   'Use os.networkInterfaces instead.');
+   'Use os.networkInterfaces instead.', 'DEP0023');
 
 exports.EOL = isWindows ? '\r\n' : '\n';