{"action":"created","issue":{"url":"https://api.github.com/repos/JuliaLang/julia/issues/11943","labels_url":"https://api.github.com/repos/JuliaLang/julia/issues/11943/labels{/name}","comments_url":"https://api.github.com/repos/JuliaLang/julia/issues/11943/comments","events_url":"https://api.github.com/repos/JuliaLang/julia/issues/11943/events","html_url":"https://github.com/JuliaLang/julia/pull/11943","id":91948408,"number":11943,"title":"Doc hard, and with a vengeance","user":{"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},"labels":[{"url":"https://api.github.com/repos/JuliaLang/julia/labels/docsystem","name":"docsystem","color":"d4c5f9"}],"state":"closed","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/JuliaLang/julia/milestones/11","html_url":"https://github.com/JuliaLang/julia/milestones/0.4.0","labels_url":"https://api.github.com/repos/JuliaLang/julia/milestones/11/labels","id":748886,"number":11,"title":"0.4.0","description":"For tracking release-defining items for 0.4: important new features, breaking changes, and blocking bugs.\r\n\r\nAfter a brief period for deciding scope, adding issues to this milestone is not allowed. Once the items in this milestone are done, 0.4 will enter its stabilizing period and a release candidate can be made soon after.","creator":{"login":"JeffBezanson","id":744556,"avatar_url":"https://avatars.githubusercontent.com/u/744556?v=3","gravatar_id":"","url":"https://api.github.com/users/JeffBezanson","html_url":"https://github.com/JeffBezanson","followers_url":"https://api.github.com/users/JeffBezanson/followers","following_url":"https://api.github.com/users/JeffBezanson/following{/other_user}","gists_url":"https://api.github.com/users/JeffBezanson/gists{/gist_id}","starred_url":"https://api.github.com/users/JeffBezanson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JeffBezanson/subscriptions","organizations_url":"https://api.github.com/users/JeffBezanson/orgs","repos_url":"https://api.github.com/users/JeffBezanson/repos","events_url":"https://api.github.com/users/JeffBezanson/events{/privacy}","received_events_url":"https://api.github.com/users/JeffBezanson/received_events","type":"User","site_admin":false},"open_issues":6,"closed_issues":70,"state":"open","created_at":"2014-08-10T18:13:46Z","updated_at":"2015-08-02T18:38:09Z","due_on":"2015-06-20T18:30:00Z","closed_at":null},"comments":53,"created_at":"2015-06-30T01:16:18Z","updated_at":"2015-08-02T21:37:58Z","closed_at":"2015-08-02T18:38:09Z","pull_request":{"url":"https://api.github.com/repos/JuliaLang/julia/pulls/11943","html_url":"https://github.com/JuliaLang/julia/pull/11943","diff_url":"https://github.com/JuliaLang/julia/pull/11943.diff","patch_url":"https://github.com/JuliaLang/julia/pull/11943.patch"},"body":"Alright, so for some reason I've come back for round two. This time I hope that what's going on is a lot clearer, and it's more automated so that it'll be easier to wait for input from whomever wants to provide it.\r\n\r\nRemaining issues:\r\n\r\n* Quote escaping\r\n* Module clashes – the helpdb.jl production treats `eps` as separate from `Dates.eps`, but they're actually the same function and so one clobbers the other.\r\n* Multiple methods – these are all joined together for now. Technically we could fix this in a hacky way, but it would be fiddly – I think it's best to wait for a real solution with the new manual.\r\n* Shared docstrings, e.g. `∉` and `∋` with `in`.\r\n\r\nI think there are few enough of these cases (aside from the methods thing) that we can fix them by hand later.\r\n\r\nFrom a quick check, a relatively small number (222) of the docstrings use weird `:...:` syntaxes which means the rest (1036) should be easy to convert to markdown automatically."},"comment":{"url":"https://api.github.com/repos/JuliaLang/julia/issues/comments/127074313","html_url":"https://github.com/JuliaLang/julia/pull/11943#issuecomment-127074313","issue_url":"https://api.github.com/repos/JuliaLang/julia/issues/11943","id":127074313,"user":{"login":"ScottPJones","id":11798751,"avatar_url":"https://avatars.githubusercontent.com/u/11798751?v=3","gravatar_id":"","url":"https://api.github.com/users/ScottPJones","html_url":"https://github.com/ScottPJones","followers_url":"https://api.github.com/users/ScottPJones/followers","following_url":"https://api.github.com/users/ScottPJones/following{/other_user}","gists_url":"https://api.github.com/users/ScottPJones/gists{/gist_id}","starred_url":"https://api.github.com/users/ScottPJones/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ScottPJones/subscriptions","organizations_url":"https://api.github.com/users/ScottPJones/orgs","repos_url":"https://api.github.com/users/ScottPJones/repos","events_url":"https://api.github.com/users/ScottPJones/events{/privacy}","received_events_url":"https://api.github.com/users/ScottPJones/received_events","type":"User","site_admin":false},"created_at":"2015-08-02T21:37:58Z","updated_at":"2015-08-02T21:37:58Z","body":":+1: :100: for doing this!  Now to iron out any glitches before 0.4.0 release.\r\nI just got a build with new master, and found that the `?` is not giving any information for some functions that it used to (I was hoping that my document strings in Base would be picked up now).\r\n```julia\r\nhelp?> convert(UTF32String, Char['a','b','c'])\r\n\r\nhelp?> convert(UTF8String, Char['a','b','c'])\r\n\r\nhelp?> convert(UTF8String, UInt8[64,65,66])\r\n\r\nhelp?> convert(Int, 3.0)\r\n```\r\nOld:\r\n```julia\r\nhelp?> convert(Int, 3.0)\r\nconvert(::Type{Int64}, x::Float64) at int.jl:205\r\n\r\njulia> convert(UTF8String, UInt8[64, 65, 66])\r\n\"@AB\"\r\n\r\nhelp?> convert(UTF8String, UInt8[64, 65, 66])\r\nconvert(::Type{UTF8String}, dat::Array{UInt8,1}) at unicode/utf8.jl:231\r\n```\r\n"}}