{"action":"created","issue":{"url":"https://api.github.com/repos/75lb/jsdoc-to-markdown/issues/13","labels_url":"https://api.github.com/repos/75lb/jsdoc-to-markdown/issues/13/labels{/name}","comments_url":"https://api.github.com/repos/75lb/jsdoc-to-markdown/issues/13/comments","events_url":"https://api.github.com/repos/75lb/jsdoc-to-markdown/issues/13/events","html_url":"https://github.com/75lb/jsdoc-to-markdown/issues/13","id":52736096,"number":13,"title":"@throws annotations not rendered correctly","user":{"login":"fasttime","id":6367844,"avatar_url":"https://avatars.githubusercontent.com/u/6367844?v=3","gravatar_id":"","url":"https://api.github.com/users/fasttime","html_url":"https://github.com/fasttime","followers_url":"https://api.github.com/users/fasttime/followers","following_url":"https://api.github.com/users/fasttime/following{/other_user}","gists_url":"https://api.github.com/users/fasttime/gists{/gist_id}","starred_url":"https://api.github.com/users/fasttime/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fasttime/subscriptions","organizations_url":"https://api.github.com/users/fasttime/orgs","repos_url":"https://api.github.com/users/fasttime/repos","events_url":"https://api.github.com/users/fasttime/events{/privacy}","received_events_url":"https://api.github.com/users/fasttime/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":5,"created_at":"2014-12-23T12:16:50Z","updated_at":"2015-01-10T13:44:41Z","closed_at":"2015-01-10T13:44:41Z","body":"I'm not sure where this belongs, so I'm going to post here. I have this .js file:\r\n\r\n```js\r\n/**\r\n * @function\r\n * @throws {ReferenceError}\r\n * @throws {SyntaxError} Syntax error\r\n * @throws Another error, too.\r\n */\r\nfunction foo () { }\r\n```\r\n\r\nThe output of jsdoc-parse looks so:\r\n\r\n```json\r\n[\r\n  {\r\n    \"kind\": \"function\",\r\n    \"exceptions\": [\r\n      {\r\n        \"type\": {\r\n          \"names\": [\r\n            \"ReferenceError\"\r\n          ]\r\n        }\r\n      },\r\n      {\r\n        \"type\": {\r\n          \"names\": [\r\n            \"SyntaxError\"\r\n          ]\r\n        },\r\n        \"description\": \"Syntax error\"\r\n      },\r\n      {\r\n        \"description\": \"Another error, too.\"\r\n      }\r\n    ],\r\n    \"type\": {\r\n      \"names\": [\r\n        \"ReferenceError\"\r\n      ]\r\n    },\r\n    \"description\": \"Syntax error\",\r\n    \"name\": \"foo\",\r\n    \"longname\": \"foo\",\r\n    \"scope\": \"global\",\r\n    \"codeName\": \"foo\"\r\n  }\r\n]\r\n```\r\n\r\nThis is ok except that \"ReferenceError\" is repeated outside \"exceptions\". Then dmd gives this output:\r\n\r\n```md\r\n<a name=\"foo\"></a>\r\n#foo()\r\nSyntax error\r\n\r\n**Type**: `ReferenceError`  \r\n```\r\n\r\nHere one exception is rendered in place of the function description, one has the caption \"Type\", and another one is gone.\r\n\r\nI'm working on a project that uses grunt-jsdoc-to-markdown to generate the documentation for the function reference, and this is an example of a real file where the problem occurs: https://github.com/fasttime/Q-exact/blob/49f3daf0c2905e828c3544b1c16e6a518dd4c31f/lib/q.js (`@throws` annotation in constructor)."},"comment":{"url":"https://api.github.com/repos/75lb/jsdoc-to-markdown/issues/comments/69456202","html_url":"https://github.com/75lb/jsdoc-to-markdown/issues/13#issuecomment-69456202","issue_url":"https://api.github.com/repos/75lb/jsdoc-to-markdown/issues/13","id":69456202,"user":{"login":"75lb","id":1247980,"avatar_url":"https://avatars.githubusercontent.com/u/1247980?v=3","gravatar_id":"","url":"https://api.github.com/users/75lb","html_url":"https://github.com/75lb","followers_url":"https://api.github.com/users/75lb/followers","following_url":"https://api.github.com/users/75lb/following{/other_user}","gists_url":"https://api.github.com/users/75lb/gists{/gist_id}","starred_url":"https://api.github.com/users/75lb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/75lb/subscriptions","organizations_url":"https://api.github.com/users/75lb/orgs","repos_url":"https://api.github.com/users/75lb/repos","events_url":"https://api.github.com/users/75lb/events{/privacy}","received_events_url":"https://api.github.com/users/75lb/received_events","type":"User","site_admin":false},"created_at":"2015-01-10T13:44:41Z","updated_at":"2015-01-10T13:44:41Z","body":"i generated your docs from the `throws` branch, how's it looking? https://github.com/75lb/Q-exact/blob/throws/Q-exact.md\r\n\r\ninstall the next version preview:\r\n`$ npm install -g jsdoc-to-markdown@next`\r\n\r\nthen try it for yourself: \r\n`$ jsdoc2md --heading-depth 1 lib/q.js --sort-by scope,kind > Q-exact.md`\r\n"}}