eslint/doctrine

Accept slash as <namepath>

Closed this issue · 6 comments

spawn from eslint/eslint#1598.

Doctrine rejects the following comments.

/**
 * Base component implementation.
 *
 * @constructor
 * @extends module:stb/emitter~Emitter
 */

This is because doctrine doesn't support

  • / as namepath
  • @extends <namepath> syntax

Any plans to fix this?

When i try to fix this, I found it is not easy to cover all available chars for path.
maybe we can discuss that, which special char can be use in path,

space char is not allowed, that will change too much things.
and now, lodash(_), dash(-) , blackslash() and slash(/) can be used,

dot(.) should be allowed, too.

and any others ?

@Constellation are you still planning on fixing this?

I'll check it.

I'm seeing this same error with @alias, e.g. @alias module:mymodule/mymodule.init. Which works fine in the latest jsdoc package.

I'm also seeing this issue when using @alias with a '/' and eslint valid-jsdoc.