Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Double-quotes in names should be stripped in the output (was Dots in folder names causes problem with module names) #59

Closed
tstatler opened this issue Nov 16, 2011 · 3 comments
Labels
Milestone

Comments

@tstatler
Copy link

A custom of a framework I'm documenting involves using dots (.) in folder names, like a "folder extension" so to speak. For instance:

lib/folder.fun

The folder named "folder.fun" contains the JavaScript file that exports the symbol (Funclass, in this case)

lib/folder.fun/funclass.js

I tagged the class like this:

@Class module:lib/folder.fun.Funclass

Thhe full module name is not picked up by the parser (I'm assuming) due to the dot in the folder name. The actual output names the module "fun" instead of the desired "lib/folder.fun".

@micmath
Copy link
Contributor

micmath commented Nov 16, 2011

Support for names with special-meaning characters, like dot, hash, etc, is new in JSDoc 3, so it is not well field-tested. But you can certainly give it a try:

/**
 * @module "lib/folder.fun"
 */

/**
 * @class module:"lib/folder.fun".Funclass
 */

@tstatler
Copy link
Author

Brilliant! The only change I would request is that the double-quotes are stripped in the output, but that's probably something I can fix in the template?

Thanks!

@micmath
Copy link
Contributor

micmath commented May 30, 2012

Closing this as the original issue raised by the poster is already addressed. Removing quotes in the template is a separate issue that can be raised in a separate issue if needed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants