Documentation for __dirname is incorrect

[ghost]

• Version: 8.1.2
• Platform: Linux 4.8.0 (Ubuntu 16.04)
• Subsystem: Documentation

In the documentation about Global Objects __dirname is listed as a global object.
In reality it is not.

I would suggest correcting the documentation to represent this.

[dnalborczyk]

agreed, though the docs try to clarify:

__dirname is not actually a global but rather local to each module.

https://nodejs.org/api/globals.html#globals_dirname

so maybe the category "Globals" might be somewhat wrong.

[starkwang]

I think __dirname, __filename, exports, module and require should be removed into the Modules doc.
"Globals" is only for the values like console, setTimeout, process, etc.

[cjihrig]

I think it makes sense to move the documentation for those things to https://nodejs.org/api/modules.html#modules_the_module_wrapper, but I'd add a small section in the Globals documentation about these module specific variables, and link to the real docs.

[tniessen]

@cjihrig I fear that might not be noticeable enough. To me, that section sounds like it is more of a technical explanation of how node executes modules. What do you think about adding a section ("The module scope") between "The module wrapper" and "The module object"? Or, maybe, rename "The module wrapper" to "The module scope" and move the variables there.

I could PR this later.

[cjihrig]

I don't have strong feelings. As long as each entry has it's own linkable subsection and a link at the top of the page, the discoverability is going to be the same.