src: deprecate undocumented variables

The `root` and `GLOBAL` never be documented.
nodejs · May 30, 2015 · e2d8bf4 · e2d8bf4
1 parent 2c686fd
commit e2d8bf4
Showing 1 changed file with 11 additions and 2 deletions.
diff --git a/src/node.js b/src/node.js
@@ -159,8 +159,17 @@
   startup.globalVariables = function() {
     global.process = process;
     global.global = global;
-    global.GLOBAL = global;
-    global.root = global;
+
+    // Deprecate GLOBAL and root
+    const holders = {GLOBAL: global, root: global};
+    ['GLOBAL', 'root'].forEach(function (name) {
+      const access = NativeModule.require('util').deprecate(function(val) {
+        if (val) holders[name] = val;
+        return holders[name];
+      }, "'" + name + "' is deprecated, use 'global'");
+      Object.defineProperty(global, name, {get: access, set: access});
+    });
+
     global.Buffer = NativeModule.require('buffer').Buffer;
     process.domain = null;
     process._exiting = false;