{"action":"created","issue":{"url":"https://api.github.com/repos/JuliaLang/julia/issues/10482","labels_url":"https://api.github.com/repos/JuliaLang/julia/issues/10482/labels{/name}","comments_url":"https://api.github.com/repos/JuliaLang/julia/issues/10482/comments","events_url":"https://api.github.com/repos/JuliaLang/julia/issues/10482/events","html_url":"https://github.com/JuliaLang/julia/issues/10482","id":60750839,"number":10482,"title":"Documenting Base methods with doc macro clobbers their help entries","user":{"login":"mbauman","id":154641,"avatar_url":"https://avatars.githubusercontent.com/u/154641?v=3","gravatar_id":"","url":"https://api.github.com/users/mbauman","html_url":"https://github.com/mbauman","followers_url":"https://api.github.com/users/mbauman/followers","following_url":"https://api.github.com/users/mbauman/following{/other_user}","gists_url":"https://api.github.com/users/mbauman/gists{/gist_id}","starred_url":"https://api.github.com/users/mbauman/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mbauman/subscriptions","organizations_url":"https://api.github.com/users/mbauman/orgs","repos_url":"https://api.github.com/users/mbauman/repos","events_url":"https://api.github.com/users/mbauman/events{/privacy}","received_events_url":"https://api.github.com/users/mbauman/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/JuliaLang/julia/labels/doc","name":"doc","color":"02d7e1"}],"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":3,"created_at":"2015-03-12T00:05:17Z","updated_at":"2015-03-14T16:27:30Z","closed_at":null,"body":"It'd be nice to show both the extended `@doc` documentation and the old helpdb.jl entry.  This would allow package authors to document their extensions to base methods, and it'd start paving the way towards documenting base methods inline.\r\n\r\nTrivial example:\r\n\r\n```julia\r\nhelp?> +\r\nsearch: + .+\r\n\r\nBase.+(x, y...)\r\n\r\n   Addition operator. \"x+y+z+...\" calls this function with all\r\n   arguments, i.e. \"+(x, y, z, ...)\".\r\n\r\njulia> @doc \"Foo!\" -> +(::Foo) = Foo()\r\n+ (generic function with 141 methods)\r\n\r\nhelp?> +\r\nsearch: + .+\r\n\r\n  Foo!\r\n\r\njulia>\r\n```"},"comment":{"url":"https://api.github.com/repos/JuliaLang/julia/issues/comments/80562193","html_url":"https://github.com/JuliaLang/julia/issues/10482#issuecomment-80562193","issue_url":"https://api.github.com/repos/JuliaLang/julia/issues/10482","id":80562193,"user":{"login":"mbauman","id":154641,"avatar_url":"https://avatars.githubusercontent.com/u/154641?v=3","gravatar_id":"","url":"https://api.github.com/users/mbauman","html_url":"https://github.com/mbauman","followers_url":"https://api.github.com/users/mbauman/followers","following_url":"https://api.github.com/users/mbauman/following{/other_user}","gists_url":"https://api.github.com/users/mbauman/gists{/gist_id}","starred_url":"https://api.github.com/users/mbauman/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mbauman/subscriptions","organizations_url":"https://api.github.com/users/mbauman/orgs","repos_url":"https://api.github.com/users/mbauman/repos","events_url":"https://api.github.com/users/mbauman/events{/privacy}","received_events_url":"https://api.github.com/users/mbauman/received_events","type":"User","site_admin":false},"created_at":"2015-03-14T16:27:30Z","updated_at":"2015-03-14T16:27:30Z","body":"Yeah, I took a quick glance myself before I posted the issue.  The fallback behaviors make this trickier than I imagined it would be.  I had initially thought that this would block a migration away from helpdb, but that's not really true since the only sensible way to do it would be by moving whole functions at a time.  It's not really worth spending time on."}}