{"action":"created","issue":{"url":"https://api.github.com/repos/JuliaLang/julia/issues/12000","labels_url":"https://api.github.com/repos/JuliaLang/julia/issues/12000/labels{/name}","comments_url":"https://api.github.com/repos/JuliaLang/julia/issues/12000/comments","events_url":"https://api.github.com/repos/JuliaLang/julia/issues/12000/events","html_url":"https://github.com/JuliaLang/julia/pull/12000","id":92796096,"number":12000,"title":"Better support for documenting expressions with macros","user":{"login":"yuyichao","id":712232,"avatar_url":"https://avatars.githubusercontent.com/u/712232?v=3","gravatar_id":"","url":"https://api.github.com/users/yuyichao","html_url":"https://github.com/yuyichao","followers_url":"https://api.github.com/users/yuyichao/followers","following_url":"https://api.github.com/users/yuyichao/following{/other_user}","gists_url":"https://api.github.com/users/yuyichao/gists{/gist_id}","starred_url":"https://api.github.com/users/yuyichao/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yuyichao/subscriptions","organizations_url":"https://api.github.com/users/yuyichao/orgs","repos_url":"https://api.github.com/users/yuyichao/repos","events_url":"https://api.github.com/users/yuyichao/events{/privacy}","received_events_url":"https://api.github.com/users/yuyichao/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/JuliaLang/julia/labels/breaking","name":"breaking","color":"800000"},{"url":"https://api.github.com/repos/JuliaLang/julia/labels/docsystem","name":"docsystem","color":"d4c5f9"}],"state":"open","locked":false,"assignee":{"login":"one-more-minute","id":2234614,"avatar_url":"https://avatars.githubusercontent.com/u/2234614?v=3","gravatar_id":"","url":"https://api.github.com/users/one-more-minute","html_url":"https://github.com/one-more-minute","followers_url":"https://api.github.com/users/one-more-minute/followers","following_url":"https://api.github.com/users/one-more-minute/following{/other_user}","gists_url":"https://api.github.com/users/one-more-minute/gists{/gist_id}","starred_url":"https://api.github.com/users/one-more-minute/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/one-more-minute/subscriptions","organizations_url":"https://api.github.com/users/one-more-minute/orgs","repos_url":"https://api.github.com/users/one-more-minute/repos","events_url":"https://api.github.com/users/one-more-minute/events{/privacy}","received_events_url":"https://api.github.com/users/one-more-minute/received_events","type":"User","site_admin":false},"milestone":null,"comments":45,"created_at":"2015-07-03T05:32:08Z","updated_at":"2015-07-08T15:07:21Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/JuliaLang/julia/pulls/12000","html_url":"https://github.com/JuliaLang/julia/pull/12000","diff_url":"https://github.com/JuliaLang/julia/pull/12000.diff","patch_url":"https://github.com/JuliaLang/julia/pull/12000.patch"},"body":"Fix #11993 (not sure if this is the best way though)\r\n\r\n* Update:\r\n\r\n    See below for the current behavior https://github.com/JuliaLang/julia/pull/12000#issuecomment-118404697 and examples of it https://github.com/JuliaLang/julia/pull/12000#issuecomment-118410489\r\n\r\n    It still uses `macroexpand` in a `macro`.\r\n\r\nOriginal post:\r\n\r\n1. Disallow documenting macro with\r\n\r\n    ```\r\n    \"<doc>\"\r\n    @macro\r\n    ```\r\n\r\n    syntax since it can be ambiguous with expanding and using the macro (which might have side effects)\r\n\r\n2. Expand the macro if the expression to be documented is a macro call in order to document the correct object.\r\n\r\nIssues\r\n\r\n1. This is calling `macroexpand` in a macro. Not sure if this is the best thing to do but I couldn't come up with a better way to do what I want.\r\n\r\n2. ~~Both `\"\" @m` and~~ `\"\"<\\n>@m` ~~are~~ is parsed as\r\n\r\n    ```julia\r\n    quote\r\n        \"\"\r\n        @id\r\n    end\r\n    ```\r\n\r\n    ~~The former should probably be reallowed,~~(edit: fixed) ~~the latter~~ this should probably not have the `block` (although I couldn't figure out if I can reset the input stream)\r\n"},"comment":{"url":"https://api.github.com/repos/JuliaLang/julia/issues/comments/119617251","html_url":"https://github.com/JuliaLang/julia/pull/12000#issuecomment-119617251","issue_url":"https://api.github.com/repos/JuliaLang/julia/issues/12000","id":119617251,"user":{"login":"yuyichao","id":712232,"avatar_url":"https://avatars.githubusercontent.com/u/712232?v=3","gravatar_id":"","url":"https://api.github.com/users/yuyichao","html_url":"https://github.com/yuyichao","followers_url":"https://api.github.com/users/yuyichao/followers","following_url":"https://api.github.com/users/yuyichao/following{/other_user}","gists_url":"https://api.github.com/users/yuyichao/gists{/gist_id}","starred_url":"https://api.github.com/users/yuyichao/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yuyichao/subscriptions","organizations_url":"https://api.github.com/users/yuyichao/orgs","repos_url":"https://api.github.com/users/yuyichao/repos","events_url":"https://api.github.com/users/yuyichao/events{/privacy}","received_events_url":"https://api.github.com/users/yuyichao/received_events","type":"User","site_admin":false},"created_at":"2015-07-08T15:07:21Z","updated_at":"2015-07-08T15:07:21Z","body":"> Sure, makes sense. I'll investigate whether changing it simplifies the implementation when I've got some time.\r\n\r\nI'd prefer not breaking it if it is not necessary. I'm fine either way though.\r\n"}}