module name inference should depend on current directory?

[jfirebaugh]

A bit of odd behavior from standard JSDoc:

If the module name is not provided, it is derived from the module's path and filename. For example, suppose I have a file test.js, located in the src directory, that contains the block comment /** @module */. Here are some scenarios for running JSDoc and the resulting module names for test.js:

Derived module names if none is provided.

# from src/
jsdoc ./test.js   # module name 'test'

# from src's parent directory:
jsdoc src/test.js # module name 'src/test'
jsdoc -r src/     # module name 'test'

Should documentation.js emulate this?

[tmcw]

tbh, I really don't get what modules are getting at - I strongly suspect they're just a closure compiler concept turned into a JSDoc tag.