{"action":"created","comment":{"url":"https://api.github.com/repos/docker/docker/pulls/comments/69835331","id":69835331,"diff_hunk":"@@ -60,3 +61,34 @@ func runCreate(dockerCli *client.DockerCli, opts createOptions) error {\n \tfmt.Fprintf(dockerCli.Out(), \"%s\\n\", vol.Name)\n \treturn nil\n }\n+\n+var createDescription = `\n+Creates a new volume that containers can consume and store data in. If a name is not specified, Docker generates a random name. You create a volume and then configure the container to use it, for example:","path":"api/client/volume/create.go","position":14,"original_position":14,"commit_id":"9f677e523fb3ab30f601ac483c9337579fcd7727","original_commit_id":"9f677e523fb3ab30f601ac483c9337579fcd7727","user":{"login":"thaJeztah","id":1804568,"avatar_url":"https://avatars.githubusercontent.com/u/1804568?v=3","gravatar_id":"","url":"https://api.github.com/users/thaJeztah","html_url":"https://github.com/thaJeztah","followers_url":"https://api.github.com/users/thaJeztah/followers","following_url":"https://api.github.com/users/thaJeztah/following{/other_user}","gists_url":"https://api.github.com/users/thaJeztah/gists{/gist_id}","starred_url":"https://api.github.com/users/thaJeztah/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thaJeztah/subscriptions","organizations_url":"https://api.github.com/users/thaJeztah/orgs","repos_url":"https://api.github.com/users/thaJeztah/repos","events_url":"https://api.github.com/users/thaJeztah/events{/privacy}","received_events_url":"https://api.github.com/users/thaJeztah/received_events","type":"User","site_admin":false},"body":"Should we stick to 80-chars for these strings as well, to be consistent with our markdown?","created_at":"2016-07-07T00:28:58Z","updated_at":"2016-07-07T00:28:58Z","html_url":"https://github.com/docker/docker/pull/23825#discussion_r69835331","pull_request_url":"https://api.github.com/repos/docker/docker/pulls/23825","_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/comments/69835331"},"html":{"href":"https://github.com/docker/docker/pull/23825#discussion_r69835331"},"pull_request":{"href":"https://api.github.com/repos/docker/docker/pulls/23825"}}},"pull_request":{"url":"https://api.github.com/repos/docker/docker/pulls/23825","id":74670775,"html_url":"https://github.com/docker/docker/pull/23825","diff_url":"https://github.com/docker/docker/pull/23825.diff","patch_url":"https://github.com/docker/docker/pull/23825.patch","issue_url":"https://api.github.com/repos/docker/docker/issues/23825","number":23825,"state":"open","locked":false,"title":"Generate man pages from the Command description","user":{"login":"dnephin","id":442180,"avatar_url":"https://avatars.githubusercontent.com/u/442180?v=3","gravatar_id":"","url":"https://api.github.com/users/dnephin","html_url":"https://github.com/dnephin","followers_url":"https://api.github.com/users/dnephin/followers","following_url":"https://api.github.com/users/dnephin/following{/other_user}","gists_url":"https://api.github.com/users/dnephin/gists{/gist_id}","starred_url":"https://api.github.com/users/dnephin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dnephin/subscriptions","organizations_url":"https://api.github.com/users/dnephin/orgs","repos_url":"https://api.github.com/users/dnephin/repos","events_url":"https://api.github.com/users/dnephin/events{/privacy}","received_events_url":"https://api.github.com/users/dnephin/received_events","type":"User","site_admin":false},"body":"`spf13/cobra` includes support for generating a man page. It makes use of `cpuguy83/go-md2man` which we already use to generate the existing man pages from markdown.\r\n\r\nThe cobra generated man page is very similar to the output of our current generation. There are a few small differences. If any of them are considered to be significant, we can update the generation code to output what we want.\r\n\r\nNotable differences:\r\n* the `SYNOPSIS` string only says `OPTIONS` instead of the full list of flags\r\n* the command group page (`docker volume`, `docker network`, etc) lists the child commands under \"SEE ALSO\" on a single line, instead of listing them out one-per-line in a \"COMMANDS\" section\r\n* the date is displayed in the footer of the page (where it currently says \"Docker User Manuals\") instead of in the header\r\n\r\nBy keeping the command description and examples in the code it should make it easier to keep the man pages up-to-date and accurate. It makes it easier to add new commands, as we can generate the man pages automatically without adding any new files. We can also use this `Long` (description) text to generate the command reference used by the online docs.\r\n\r\nThe existing markdown files have not been removed.  They will override the generated files if one exists for the same command. If the design of this PR is accepted I can start moving the text for more of the commands into the code.\r\n\r\nThis PR makes the following changes:\r\n* update the `man/Dockerfile` to include all the new required dependencies\r\n* update the packaging scripts to call the new `man/generate.sh` to generate all the man pages\r\n* remove the files for `volume` commands, and move the description into the `Command.Long` field.\r\n* adds man pages for all the new 1.12 commands. These man pages will be a little bare until we add a `Long` description to the commands.\r\n\r\n\r\ncc @cpuguy83, @icecrime ","created_at":"2016-06-21T19:27:17Z","updated_at":"2016-07-07T00:28:58Z","closed_at":null,"merged_at":null,"merge_commit_sha":"7e5bb5067ac7a3b8c14291b1c0a633100beab313","assignee":null,"assignees":[],"milestone":{"url":"https://api.github.com/repos/docker/docker/milestones/53","html_url":"https://github.com/docker/docker/milestones/1.12.0","labels_url":"https://api.github.com/repos/docker/docker/milestones/53/labels","id":1657301,"number":53,"title":"1.12.0","description":"feature/code freeze: June 14th, 2016","creator":{"login":"thaJeztah","id":1804568,"avatar_url":"https://avatars.githubusercontent.com/u/1804568?v=3","gravatar_id":"","url":"https://api.github.com/users/thaJeztah","html_url":"https://github.com/thaJeztah","followers_url":"https://api.github.com/users/thaJeztah/followers","following_url":"https://api.github.com/users/thaJeztah/following{/other_user}","gists_url":"https://api.github.com/users/thaJeztah/gists{/gist_id}","starred_url":"https://api.github.com/users/thaJeztah/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thaJeztah/subscriptions","organizations_url":"https://api.github.com/users/thaJeztah/orgs","repos_url":"https://api.github.com/users/thaJeztah/repos","events_url":"https://api.github.com/users/thaJeztah/events{/privacy}","received_events_url":"https://api.github.com/users/thaJeztah/received_events","type":"User","site_admin":false},"open_issues":117,"closed_issues":509,"state":"open","created_at":"2016-03-21T13:47:53Z","updated_at":"2016-07-07T00:16:23Z","due_on":null,"closed_at":null},"commits_url":"https://api.github.com/repos/docker/docker/pulls/23825/commits","review_comments_url":"https://api.github.com/repos/docker/docker/pulls/23825/comments","review_comment_url":"https://api.github.com/repos/docker/docker/pulls/comments{/number}","comments_url":"https://api.github.com/repos/docker/docker/issues/23825/comments","statuses_url":"https://api.github.com/repos/docker/docker/statuses/9f677e523fb3ab30f601ac483c9337579fcd7727","head":{"label":"dnephin:auto-gen-man-page","ref":"auto-gen-man-page","sha":"9f677e523fb3ab30f601ac483c9337579fcd7727","user":{"login":"dnephin","id":442180,"avatar_url":"https://avatars.githubusercontent.com/u/442180?v=3","gravatar_id":"","url":"https://api.github.com/users/dnephin","html_url":"https://github.com/dnephin","followers_url":"https://api.github.com/users/dnephin/followers","following_url":"https://api.github.com/users/dnephin/following{/other_user}","gists_url":"https://api.github.com/users/dnephin/gists{/gist_id}","starred_url":"https://api.github.com/users/dnephin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dnephin/subscriptions","organizations_url":"https://api.github.com/users/dnephin/orgs","repos_url":"https://api.github.com/users/dnephin/repos","events_url":"https://api.github.com/users/dnephin/events{/privacy}","received_events_url":"https://api.github.com/users/dnephin/received_events","type":"User","site_admin":false},"repo":{"id":24821004,"name":"docker","full_name":"dnephin/docker","owner":{"login":"dnephin","id":442180,"avatar_url":"https://avatars.githubusercontent.com/u/442180?v=3","gravatar_id":"","url":"https://api.github.com/users/dnephin","html_url":"https://github.com/dnephin","followers_url":"https://api.github.com/users/dnephin/followers","following_url":"https://api.github.com/users/dnephin/following{/other_user}","gists_url":"https://api.github.com/users/dnephin/gists{/gist_id}","starred_url":"https://api.github.com/users/dnephin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dnephin/subscriptions","organizations_url":"https://api.github.com/users/dnephin/orgs","repos_url":"https://api.github.com/users/dnephin/repos","events_url":"https://api.github.com/users/dnephin/events{/privacy}","received_events_url":"https://api.github.com/users/dnephin/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/dnephin/docker","description":"Docker - the open-source application container engine","fork":true,"url":"https://api.github.com/repos/dnephin/docker","forks_url":"https://api.github.com/repos/dnephin/docker/forks","keys_url":"https://api.github.com/repos/dnephin/docker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dnephin/docker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dnephin/docker/teams","hooks_url":"https://api.github.com/repos/dnephin/docker/hooks","issue_events_url":"https://api.github.com/repos/dnephin/docker/issues/events{/number}","events_url":"https://api.github.com/repos/dnephin/docker/events","assignees_url":"https://api.github.com/repos/dnephin/docker/assignees{/user}","branches_url":"https://api.github.com/repos/dnephin/docker/branches{/branch}","tags_url":"https://api.github.com/repos/dnephin/docker/tags","blobs_url":"https://api.github.com/repos/dnephin/docker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dnephin/docker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dnephin/docker/git/refs{/sha}","trees_url":"https://api.github.com/repos/dnephin/docker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dnephin/docker/statuses/{sha}","languages_url":"https://api.github.com/repos/dnephin/docker/languages","stargazers_url":"https://api.github.com/repos/dnephin/docker/stargazers","contributors_url":"https://api.github.com/repos/dnephin/docker/contributors","subscribers_url":"https://api.github.com/repos/dnephin/docker/subscribers","subscription_url":"https://api.github.com/repos/dnephin/docker/subscription","commits_url":"https://api.github.com/repos/dnephin/docker/commits{/sha}","git_commits_url":"https://api.github.com/repos/dnephin/docker/git/commits{/sha}","comments_url":"https://api.github.com/repos/dnephin/docker/comments{/number}","issue_comment_url":"https://api.github.com/repos/dnephin/docker/issues/comments{/number}","contents_url":"https://api.github.com/repos/dnephin/docker/contents/{+path}","compare_url":"https://api.github.com/repos/dnephin/docker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dnephin/docker/merges","archive_url":"https://api.github.com/repos/dnephin/docker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dnephin/docker/downloads","issues_url":"https://api.github.com/repos/dnephin/docker/issues{/number}","pulls_url":"https://api.github.com/repos/dnephin/docker/pulls{/number}","milestones_url":"https://api.github.com/repos/dnephin/docker/milestones{/number}","notifications_url":"https://api.github.com/repos/dnephin/docker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dnephin/docker/labels{/name}","releases_url":"https://api.github.com/repos/dnephin/docker/releases{/id}","deployments_url":"https://api.github.com/repos/dnephin/docker/deployments","created_at":"2014-10-05T17:10:26Z","updated_at":"2016-02-19T21:16:11Z","pushed_at":"2016-07-06T21:09:34Z","git_url":"git://github.com/dnephin/docker.git","ssh_url":"git@github.com:dnephin/docker.git","clone_url":"https://github.com/dnephin/docker.git","svn_url":"https://github.com/dnephin/docker","homepage":"http://www.docker.com","size":95860,"stargazers_count":0,"watchers_count":0,"language":"Go","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":"docker:master","ref":"master","sha":"e64a6912532b13beda6f172020438869ebe93d32","user":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"repo":{"id":7691631,"name":"docker","full_name":"docker/docker","owner":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/docker/docker","description":"Docker - the open-source application container engine","fork":false,"url":"https://api.github.com/repos/docker/docker","forks_url":"https://api.github.com/repos/docker/docker/forks","keys_url":"https://api.github.com/repos/docker/docker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/docker/docker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/docker/docker/teams","hooks_url":"https://api.github.com/repos/docker/docker/hooks","issue_events_url":"https://api.github.com/repos/docker/docker/issues/events{/number}","events_url":"https://api.github.com/repos/docker/docker/events","assignees_url":"https://api.github.com/repos/docker/docker/assignees{/user}","branches_url":"https://api.github.com/repos/docker/docker/branches{/branch}","tags_url":"https://api.github.com/repos/docker/docker/tags","blobs_url":"https://api.github.com/repos/docker/docker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/docker/docker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/docker/docker/git/refs{/sha}","trees_url":"https://api.github.com/repos/docker/docker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/docker/docker/statuses/{sha}","languages_url":"https://api.github.com/repos/docker/docker/languages","stargazers_url":"https://api.github.com/repos/docker/docker/stargazers","contributors_url":"https://api.github.com/repos/docker/docker/contributors","subscribers_url":"https://api.github.com/repos/docker/docker/subscribers","subscription_url":"https://api.github.com/repos/docker/docker/subscription","commits_url":"https://api.github.com/repos/docker/docker/commits{/sha}","git_commits_url":"https://api.github.com/repos/docker/docker/git/commits{/sha}","comments_url":"https://api.github.com/repos/docker/docker/comments{/number}","issue_comment_url":"https://api.github.com/repos/docker/docker/issues/comments{/number}","contents_url":"https://api.github.com/repos/docker/docker/contents/{+path}","compare_url":"https://api.github.com/repos/docker/docker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/docker/docker/merges","archive_url":"https://api.github.com/repos/docker/docker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/docker/docker/downloads","issues_url":"https://api.github.com/repos/docker/docker/issues{/number}","pulls_url":"https://api.github.com/repos/docker/docker/pulls{/number}","milestones_url":"https://api.github.com/repos/docker/docker/milestones{/number}","notifications_url":"https://api.github.com/repos/docker/docker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/docker/docker/labels{/name}","releases_url":"https://api.github.com/repos/docker/docker/releases{/id}","deployments_url":"https://api.github.com/repos/docker/docker/deployments","created_at":"2013-01-18T18:10:57Z","updated_at":"2016-07-06T23:31:34Z","pushed_at":"2016-07-06T23:06:11Z","git_url":"git://github.com/docker/docker.git","ssh_url":"git@github.com:docker/docker.git","clone_url":"https://github.com/docker/docker.git","svn_url":"https://github.com/docker/docker","homepage":"http://www.docker.com","size":204307,"stargazers_count":32763,"watchers_count":32763,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":9462,"mirror_url":null,"open_issues_count":1948,"forks":9462,"open_issues":1948,"watchers":32763,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/23825"},"html":{"href":"https://github.com/docker/docker/pull/23825"},"issue":{"href":"https://api.github.com/repos/docker/docker/issues/23825"},"comments":{"href":"https://api.github.com/repos/docker/docker/issues/23825/comments"},"review_comments":{"href":"https://api.github.com/repos/docker/docker/pulls/23825/comments"},"review_comment":{"href":"https://api.github.com/repos/docker/docker/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/docker/docker/pulls/23825/commits"},"statuses":{"href":"https://api.github.com/repos/docker/docker/statuses/9f677e523fb3ab30f601ac483c9337579fcd7727"}}}}
{"actor":{"display_login":"thaJeztah"}}