{"action":"created","issue":{"url":"https://api.github.com/repos/eslint/eslint/issues/6694","repository_url":"https://api.github.com/repos/eslint/eslint","labels_url":"https://api.github.com/repos/eslint/eslint/issues/6694/labels{/name}","comments_url":"https://api.github.com/repos/eslint/eslint/issues/6694/comments","events_url":"https://api.github.com/repos/eslint/eslint/issues/6694/events","html_url":"https://github.com/eslint/eslint/issues/6694","id":165928603,"number":6694,"title":"valid-jsdoc seems to fail when using @external and @function","user":{"login":"cyChop","id":1841583,"avatar_url":"https://avatars.githubusercontent.com/u/1841583?v=3","gravatar_id":"","url":"https://api.github.com/users/cyChop","html_url":"https://github.com/cyChop","followers_url":"https://api.github.com/users/cyChop/followers","following_url":"https://api.github.com/users/cyChop/following{/other_user}","gists_url":"https://api.github.com/users/cyChop/gists{/gist_id}","starred_url":"https://api.github.com/users/cyChop/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cyChop/subscriptions","organizations_url":"https://api.github.com/users/cyChop/orgs","repos_url":"https://api.github.com/users/cyChop/repos","events_url":"https://api.github.com/users/cyChop/events{/privacy}","received_events_url":"https://api.github.com/users/cyChop/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/eslint/eslint/labels/blocked","name":"blocked","color":"e11d21"},{"url":"https://api.github.com/repos/eslint/eslint/labels/bug","name":"bug","color":"fc2929"},{"url":"https://api.github.com/repos/eslint/eslint/labels/core","name":"core","color":"c7def8"},{"url":"https://api.github.com/repos/eslint/eslint/labels/evaluating","name":"evaluating","color":"fef2c0"}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":6,"created_at":"2016-07-16T13:08:34Z","updated_at":"2016-07-18T18:54:53Z","closed_at":null,"body":"**What version are you using?** ESLint 3.0.1\r\n\r\n**What did you do?**\r\n```javascript\r\n    /**\r\n     * The jQuery plugin namespace.\r\n     *\r\n     * @external \"jQuery.fn\"\r\n     * @see {@link http://learn.jquery.com/plugins/|jQuery Plugins}\r\n     */\r\n\r\n    // This is a problem...\r\n    // eslint-disable-next-line valid-jsdoc\r\n    /**\r\n     * Creates a {@link BeveragesView} in the selected elements.\r\n     *\r\n     * @function external:\"jQuery.fn\".beverages\r\n     * @param {Object} options the options for the beverages view\r\n     */\r\n```\r\n\r\n**What happened?**\r\nI had to add `eslint-disable`.\r\n\r\nRemoving 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.\r\n\r\nI don't have more information on what makes this JSDoc invalid, so this may be normal but I don't know what's wrong.\r\n\r\n**What did you expect to happen?**\r\nThis should be valid (I think; see [JSDoc's doc](http://usejsdoc.org/tags-external.html)).\r\n"},"comment":{"url":"https://api.github.com/repos/eslint/eslint/issues/comments/233423504","html_url":"https://github.com/eslint/eslint/issues/6694#issuecomment-233423504","issue_url":"https://api.github.com/repos/eslint/eslint/issues/6694","id":233423504,"user":{"login":"nzakas","id":38546,"avatar_url":"https://avatars.githubusercontent.com/u/38546?v=3","gravatar_id":"","url":"https://api.github.com/users/nzakas","html_url":"https://github.com/nzakas","followers_url":"https://api.github.com/users/nzakas/followers","following_url":"https://api.github.com/users/nzakas/following{/other_user}","gists_url":"https://api.github.com/users/nzakas/gists{/gist_id}","starred_url":"https://api.github.com/users/nzakas/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nzakas/subscriptions","organizations_url":"https://api.github.com/users/nzakas/orgs","repos_url":"https://api.github.com/users/nzakas/repos","events_url":"https://api.github.com/users/nzakas/events{/privacy}","received_events_url":"https://api.github.com/users/nzakas/received_events","type":"User","site_admin":false},"created_at":"2016-07-18T18:54:53Z","updated_at":"2016-07-18T18:54:53Z","body":"Okay, well this is a problem in Doctrine (the JSDoc parser) rather than in ESLint, so there's not much we can do on our side alone. Would you mind opening a bug on the Doctrine repo? https://github.com/eslint/doctrine/issues\r\n\r\nWe can leave this issue open just in case any other ESLint user ends up with the same problem."}}
{"actor":{"display_login":"nzakas"}}