{"action":"opened","number":2672,"pull_request":{"url":"https://api.github.com/repos/rust-lang/cargo/pulls/2672","id":69618689,"html_url":"https://github.com/rust-lang/cargo/pull/2672","diff_url":"https://github.com/rust-lang/cargo/pull/2672.diff","patch_url":"https://github.com/rust-lang/cargo/pull/2672.patch","issue_url":"https://api.github.com/repos/rust-lang/cargo/issues/2672","number":2672,"state":"open","locked":false,"title":"Markdown manpages","user":{"login":"alx741","id":2545720,"avatar_url":"https://avatars.githubusercontent.com/u/2545720?v=3","gravatar_id":"","url":"https://api.github.com/users/alx741","html_url":"https://github.com/alx741","followers_url":"https://api.github.com/users/alx741/followers","following_url":"https://api.github.com/users/alx741/following{/other_user}","gists_url":"https://api.github.com/users/alx741/gists{/gist_id}","starred_url":"https://api.github.com/users/alx741/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alx741/subscriptions","organizations_url":"https://api.github.com/users/alx741/orgs","repos_url":"https://api.github.com/users/alx741/repos","events_url":"https://api.github.com/users/alx741/events{/privacy}","received_events_url":"https://api.github.com/users/alx741/received_events","type":"User","site_admin":false},"body":"This is related to #2647 and  #2660, Addresses #2645 \r\n\r\nI tried an *asciidoc* port (#2660), but markdown has some advantages:\r\n\r\n- Rust, Cargo, others use MD for documentation already so avoid introducing a new markup language.\r\n- Introducing a new tool is necessary for *asciidoc* or *markdown* anyways, but is possible to extend **rustdoc** (works with MD input) to output *troff* and thus effectively replace **pandoc** in the future to make the whole ecosystem *rusty*.\r\n- Much more easy to maintain and extend *markdown* than raw *troff*.\r\n\r\nAll of this would be applicable to **rustc** as well as @alexcrichton suggested.\r\n\r\nAnd of course as mentioned in the other PRs, this aims to make the man page system similar to **git**, having a man page for each sub-command and making `$ cargo help command` to launch the appropriate one.","created_at":"2016-05-11T05:57:51Z","updated_at":"2016-05-11T05:57:51Z","closed_at":null,"merged_at":null,"merge_commit_sha":null,"assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/rust-lang/cargo/pulls/2672/commits","review_comments_url":"https://api.github.com/repos/rust-lang/cargo/pulls/2672/comments","review_comment_url":"https://api.github.com/repos/rust-lang/cargo/pulls/comments{/number}","comments_url":"https://api.github.com/repos/rust-lang/cargo/issues/2672/comments","statuses_url":"https://api.github.com/repos/rust-lang/cargo/statuses/b2a58566465b7260c03fc2e4a66e5c9855f9199b","head":{"label":"alx741:md_manpages","ref":"md_manpages","sha":"b2a58566465b7260c03fc2e4a66e5c9855f9199b","user":{"login":"alx741","id":2545720,"avatar_url":"https://avatars.githubusercontent.com/u/2545720?v=3","gravatar_id":"","url":"https://api.github.com/users/alx741","html_url":"https://github.com/alx741","followers_url":"https://api.github.com/users/alx741/followers","following_url":"https://api.github.com/users/alx741/following{/other_user}","gists_url":"https://api.github.com/users/alx741/gists{/gist_id}","starred_url":"https://api.github.com/users/alx741/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alx741/subscriptions","organizations_url":"https://api.github.com/users/alx741/orgs","repos_url":"https://api.github.com/users/alx741/repos","events_url":"https://api.github.com/users/alx741/events{/privacy}","received_events_url":"https://api.github.com/users/alx741/received_events","type":"User","site_admin":false},"repo":{"id":58090858,"name":"cargo","full_name":"alx741/cargo","owner":{"login":"alx741","id":2545720,"avatar_url":"https://avatars.githubusercontent.com/u/2545720?v=3","gravatar_id":"","url":"https://api.github.com/users/alx741","html_url":"https://github.com/alx741","followers_url":"https://api.github.com/users/alx741/followers","following_url":"https://api.github.com/users/alx741/following{/other_user}","gists_url":"https://api.github.com/users/alx741/gists{/gist_id}","starred_url":"https://api.github.com/users/alx741/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alx741/subscriptions","organizations_url":"https://api.github.com/users/alx741/orgs","repos_url":"https://api.github.com/users/alx741/repos","events_url":"https://api.github.com/users/alx741/events{/privacy}","received_events_url":"https://api.github.com/users/alx741/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/alx741/cargo","description":"The Rust package manager","fork":true,"url":"https://api.github.com/repos/alx741/cargo","forks_url":"https://api.github.com/repos/alx741/cargo/forks","keys_url":"https://api.github.com/repos/alx741/cargo/keys{/key_id}","collaborators_url":"https://api.github.com/repos/alx741/cargo/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/alx741/cargo/teams","hooks_url":"https://api.github.com/repos/alx741/cargo/hooks","issue_events_url":"https://api.github.com/repos/alx741/cargo/issues/events{/number}","events_url":"https://api.github.com/repos/alx741/cargo/events","assignees_url":"https://api.github.com/repos/alx741/cargo/assignees{/user}","branches_url":"https://api.github.com/repos/alx741/cargo/branches{/branch}","tags_url":"https://api.github.com/repos/alx741/cargo/tags","blobs_url":"https://api.github.com/repos/alx741/cargo/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/alx741/cargo/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/alx741/cargo/git/refs{/sha}","trees_url":"https://api.github.com/repos/alx741/cargo/git/trees{/sha}","statuses_url":"https://api.github.com/repos/alx741/cargo/statuses/{sha}","languages_url":"https://api.github.com/repos/alx741/cargo/languages","stargazers_url":"https://api.github.com/repos/alx741/cargo/stargazers","contributors_url":"https://api.github.com/repos/alx741/cargo/contributors","subscribers_url":"https://api.github.com/repos/alx741/cargo/subscribers","subscription_url":"https://api.github.com/repos/alx741/cargo/subscription","commits_url":"https://api.github.com/repos/alx741/cargo/commits{/sha}","git_commits_url":"https://api.github.com/repos/alx741/cargo/git/commits{/sha}","comments_url":"https://api.github.com/repos/alx741/cargo/comments{/number}","issue_comment_url":"https://api.github.com/repos/alx741/cargo/issues/comments{/number}","contents_url":"https://api.github.com/repos/alx741/cargo/contents/{+path}","compare_url":"https://api.github.com/repos/alx741/cargo/compare/{base}...{head}","merges_url":"https://api.github.com/repos/alx741/cargo/merges","archive_url":"https://api.github.com/repos/alx741/cargo/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/alx741/cargo/downloads","issues_url":"https://api.github.com/repos/alx741/cargo/issues{/number}","pulls_url":"https://api.github.com/repos/alx741/cargo/pulls{/number}","milestones_url":"https://api.github.com/repos/alx741/cargo/milestones{/number}","notifications_url":"https://api.github.com/repos/alx741/cargo/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/alx741/cargo/labels{/name}","releases_url":"https://api.github.com/repos/alx741/cargo/releases{/id}","deployments_url":"https://api.github.com/repos/alx741/cargo/deployments","created_at":"2016-05-04T23:44:19Z","updated_at":"2016-05-04T23:44:22Z","pushed_at":"2016-05-11T05:45:19Z","git_url":"git://github.com/alx741/cargo.git","ssh_url":"git@github.com:alx741/cargo.git","clone_url":"https://github.com/alx741/cargo.git","svn_url":"https://github.com/alx741/cargo","homepage":"http://crates.io/","size":10272,"stargazers_count":0,"watchers_count":0,"language":"Rust","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"rust-lang:master","ref":"master","sha":"d6e1726b5dc0e3bdf502df80579c85e2feed866d","user":{"login":"rust-lang","id":5430905,"avatar_url":"https://avatars.githubusercontent.com/u/5430905?v=3","gravatar_id":"","url":"https://api.github.com/users/rust-lang","html_url":"https://github.com/rust-lang","followers_url":"https://api.github.com/users/rust-lang/followers","following_url":"https://api.github.com/users/rust-lang/following{/other_user}","gists_url":"https://api.github.com/users/rust-lang/gists{/gist_id}","starred_url":"https://api.github.com/users/rust-lang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rust-lang/subscriptions","organizations_url":"https://api.github.com/users/rust-lang/orgs","repos_url":"https://api.github.com/users/rust-lang/repos","events_url":"https://api.github.com/users/rust-lang/events{/privacy}","received_events_url":"https://api.github.com/users/rust-lang/received_events","type":"Organization","site_admin":false},"repo":{"id":17420913,"name":"cargo","full_name":"rust-lang/cargo","owner":{"login":"rust-lang","id":5430905,"avatar_url":"https://avatars.githubusercontent.com/u/5430905?v=3","gravatar_id":"","url":"https://api.github.com/users/rust-lang","html_url":"https://github.com/rust-lang","followers_url":"https://api.github.com/users/rust-lang/followers","following_url":"https://api.github.com/users/rust-lang/following{/other_user}","gists_url":"https://api.github.com/users/rust-lang/gists{/gist_id}","starred_url":"https://api.github.com/users/rust-lang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rust-lang/subscriptions","organizations_url":"https://api.github.com/users/rust-lang/orgs","repos_url":"https://api.github.com/users/rust-lang/repos","events_url":"https://api.github.com/users/rust-lang/events{/privacy}","received_events_url":"https://api.github.com/users/rust-lang/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/rust-lang/cargo","description":"The Rust package manager","fork":false,"url":"https://api.github.com/repos/rust-lang/cargo","forks_url":"https://api.github.com/repos/rust-lang/cargo/forks","keys_url":"https://api.github.com/repos/rust-lang/cargo/keys{/key_id}","collaborators_url":"https://api.github.com/repos/rust-lang/cargo/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/rust-lang/cargo/teams","hooks_url":"https://api.github.com/repos/rust-lang/cargo/hooks","issue_events_url":"https://api.github.com/repos/rust-lang/cargo/issues/events{/number}","events_url":"https://api.github.com/repos/rust-lang/cargo/events","assignees_url":"https://api.github.com/repos/rust-lang/cargo/assignees{/user}","branches_url":"https://api.github.com/repos/rust-lang/cargo/branches{/branch}","tags_url":"https://api.github.com/repos/rust-lang/cargo/tags","blobs_url":"https://api.github.com/repos/rust-lang/cargo/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/rust-lang/cargo/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/rust-lang/cargo/git/refs{/sha}","trees_url":"https://api.github.com/repos/rust-lang/cargo/git/trees{/sha}","statuses_url":"https://api.github.com/repos/rust-lang/cargo/statuses/{sha}","languages_url":"https://api.github.com/repos/rust-lang/cargo/languages","stargazers_url":"https://api.github.com/repos/rust-lang/cargo/stargazers","contributors_url":"https://api.github.com/repos/rust-lang/cargo/contributors","subscribers_url":"https://api.github.com/repos/rust-lang/cargo/subscribers","subscription_url":"https://api.github.com/repos/rust-lang/cargo/subscription","commits_url":"https://api.github.com/repos/rust-lang/cargo/commits{/sha}","git_commits_url":"https://api.github.com/repos/rust-lang/cargo/git/commits{/sha}","comments_url":"https://api.github.com/repos/rust-lang/cargo/comments{/number}","issue_comment_url":"https://api.github.com/repos/rust-lang/cargo/issues/comments{/number}","contents_url":"https://api.github.com/repos/rust-lang/cargo/contents/{+path}","compare_url":"https://api.github.com/repos/rust-lang/cargo/compare/{base}...{head}","merges_url":"https://api.github.com/repos/rust-lang/cargo/merges","archive_url":"https://api.github.com/repos/rust-lang/cargo/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/rust-lang/cargo/downloads","issues_url":"https://api.github.com/repos/rust-lang/cargo/issues{/number}","pulls_url":"https://api.github.com/repos/rust-lang/cargo/pulls{/number}","milestones_url":"https://api.github.com/repos/rust-lang/cargo/milestones{/number}","notifications_url":"https://api.github.com/repos/rust-lang/cargo/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/rust-lang/cargo/labels{/name}","releases_url":"https://api.github.com/repos/rust-lang/cargo/releases{/id}","deployments_url":"https://api.github.com/repos/rust-lang/cargo/deployments","created_at":"2014-03-04T23:20:42Z","updated_at":"2016-05-11T02:04:20Z","pushed_at":"2016-05-11T05:34:17Z","git_url":"git://github.com/rust-lang/cargo.git","ssh_url":"git@github.com:rust-lang/cargo.git","clone_url":"https://github.com/rust-lang/cargo.git","svn_url":"https://github.com/rust-lang/cargo","homepage":"http://crates.io/","size":58226,"stargazers_count":1622,"watchers_count":1622,"language":"Rust","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":375,"mirror_url":null,"open_issues_count":293,"forks":375,"open_issues":293,"watchers":1622,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/rust-lang/cargo/pulls/2672"},"html":{"href":"https://github.com/rust-lang/cargo/pull/2672"},"issue":{"href":"https://api.github.com/repos/rust-lang/cargo/issues/2672"},"comments":{"href":"https://api.github.com/repos/rust-lang/cargo/issues/2672/comments"},"review_comments":{"href":"https://api.github.com/repos/rust-lang/cargo/pulls/2672/comments"},"review_comment":{"href":"https://api.github.com/repos/rust-lang/cargo/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/rust-lang/cargo/pulls/2672/commits"},"statuses":{"href":"https://api.github.com/repos/rust-lang/cargo/statuses/b2a58566465b7260c03fc2e4a66e5c9855f9199b"}},"merged":false,"mergeable":null,"mergeable_state":"unknown","merged_by":null,"comments":0,"review_comments":0,"commits":8,"additions":239,"deletions":208,"changed_files":9}}