valid-jsdoc seems to fail when using @external and @function

What version are you using? ESLint 3.0.1

What did you do?

    /**
     * The jQuery plugin namespace.
     *
     * @external "jQuery.fn"
     * @see {@link http://learn.jquery.com/plugins/|jQuery Plugins}
     */

    // This is a problem...
    // eslint-disable-next-line valid-jsdoc
    /**
     * Creates a {@link BeveragesView} in the selected elements.
     *
     * @function external:"jQuery.fn".beverages
     * @param {Object} options the options for the beverages view
     */

What happened? I had to add eslint-disable.

Removing the line beginning with @function removes the error. Trying synonyms (@func and @method) seems to have no impact. Moving the line around does not fix the error.

I don’t have more information on what makes this JSDoc invalid, so this may be normal but I don’t know what’s wrong.

What did you expect to happen? This should be valid (I think; see JSDoc’s doc).

[platinumazure]

Marking as a question for now. Hopefully someone who knows JSDoc on the team will take a look and speak to whether this might be a bug or not.

[nzakas]

Unfortunately, it looks like there wasn’t enough interest from the team or community to implement this change. While we wish we’d be able to accommodate everyone’s requests, we do need to prioritize. We’ve found that issues failing to be implemented after 90 days tend to never be implemented, and as such, we close those issues. This doesn’t mean the idea isn’t interesting or useful, just that it’s not something the team can commit to.