{"action":"created","comment":{"url":"https://api.github.com/repos/docker/docker/pulls/comments/24381901","id":24381901,"diff_hunk":"@@ -29,198 +31,242 @@ A Dockerfile is similar to a Makefile.\n \n # USAGE\n \n-**sudo docker build .**\n- -- runs the steps and commits them, building a final image\n-    The path to the source repository defines where to find the context of the\n-    build. The build is run by the docker daemon, not the CLI. The whole \n-    context must be transferred to the daemon. The Docker CLI reports \n-    \"Sending build context to Docker daemon\" when the context is sent to the daemon.\n-    \n-**sudo docker build -t repository/tag .**\n- -- specifies a repository and tag at which to save the new image if the build \n-    succeeds. The Docker daemon runs the steps one-by-one, committing the result \n-    to a new image if necessary before finally outputting the ID of the new \n-    image. The Docker daemon automatically cleans up the context it is given.\n-\n-Docker re-uses intermediate images whenever possible. This significantly \n-accelerates the *docker build* process.\n- \n+  sudo docker build .\n+\n+  -- Runs the steps and commits them, building a final image\n+  the path to the source repository defines where to find the context of the\n+  build. The build is run by the docker daemon, not the CLI. The whole\n+  context must be transferred to the daemon. The Docker CLI reports\n+  `\"Sending build context to Docker daemon\"` when the context is sent to the\n+  daemon.\n+\n+  sudo docker build -t repository/tag .\n+\n+  -- specifies a repository and tag at which to save the new image if the build\n+  succeeds. The Docker daemon runs the steps one-by-one, committing the result\n+  to a new image if necessary before finally outputting the ID of the new\n+  image. The Docker daemon automatically cleans up the context it is given.\n+\n+  Docker re-uses intermediate images whenever possible. This significantly\n+  accelerates the *docker build* process.\n+\n # FORMAT\n \n-**FROM image**\n-or\n-**FROM image:tag**\n- -- The FROM instruction sets the base image for subsequent instructions. A\n- valid Dockerfile must have FROM as its first instruction. The image can be any\n- valid image. It is easy to start by pulling an image from the public\n- repositories.\n- -- FROM must be he first non-comment instruction in Dockerfile.\n- -- FROM may appear multiple times within a single Dockerfile in order to create\n- multiple images. Make a note of the last image id output by the commit before\n- each new FROM command.\n- -- If no tag is given to the FROM instruction, latest is assumed. If the used\n- tag does not exist, an error is returned.\n+  FROM image\n+\n+  FROM image:tag\n+\n+  -- The **FROM** instruction sets the base image for subsequent instructions. A\n+  valid Dockerfile must have **FROM** as its first instruction. The image can be any\n+  valid image. It is easy to start by pulling an image from the public\n+  repositories.\n+\n+  -- **FROM** must be he first non-comment instruction in Dockerfile.\n+\n+  -- **FROM** may appear multiple times within a single Dockerfile in order to create\n+  multiple images. Make a note of the last image id output by the commit before\n+  each new **FROM** command.\n+\n+  -- If no tag is given to the **FROM** instruction, latest is assumed. If the\n+  used tag does not exist, an error is returned.\n \n **MAINTAINER**\n- --The MAINTAINER instruction sets the Author field for the generated images.\n+  -- **MAINTAINER** sets the Author field for the generated images.\n \n **RUN**\n- --RUN has two forms:\n- **RUN <command>**\n- -- (the command is run in a shell - /bin/sh -c)\n- **RUN [\"executable\", \"param1\", \"param2\"]**\n- --The above is executable form.\n- --The RUN instruction executes any commands in a new layer on top of the\n- current image and commits the results. The committed image is used for the next\n- step in Dockerfile.\n- --Layering RUN instructions and generating commits conforms to the core\n- concepts of Docker where commits are cheap and containers can be created from\n- any point in the history of an image. This is similar to source control.  The\n- exec form makes it possible to avoid shell string munging. The exec form makes\n- it possible to RUN commands using a base image that does not contain /bin/sh.\n+  -- **RUN** has two forms:\n+\n+    # the command is run in a shell - /bin/sh -c\n+    RUN <command>\n+\n+    # Executable form\n+    RUN [\"executable\", \"param1\", \"param2\"]\n+\n+\n+  -- The RUN instruction executes any commands in a new layer on top of the current","path":"docs/man/Dockerfile.5.md","position":126,"original_position":126,"commit_id":"9c5e0ac08323829be50b99c402eb8b655681ce3b","original_commit_id":"9c5e0ac08323829be50b99c402eb8b655681ce3b","user":{"login":"jamtur01","id":4365,"avatar_url":"https://avatars.githubusercontent.com/u/4365?v=3","gravatar_id":"","url":"https://api.github.com/users/jamtur01","html_url":"https://github.com/jamtur01","followers_url":"https://api.github.com/users/jamtur01/followers","following_url":"https://api.github.com/users/jamtur01/following{/other_user}","gists_url":"https://api.github.com/users/jamtur01/gists{/gist_id}","starred_url":"https://api.github.com/users/jamtur01/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jamtur01/subscriptions","organizations_url":"https://api.github.com/users/jamtur01/orgs","repos_url":"https://api.github.com/users/jamtur01/repos","events_url":"https://api.github.com/users/jamtur01/events{/privacy}","received_events_url":"https://api.github.com/users/jamtur01/received_events","type":"User","site_admin":false},"body":"\\*\\*RUN\\*\\*","created_at":"2015-02-10T01:17:44Z","updated_at":"2015-02-10T01:17:44Z","html_url":"https://github.com/docker/docker/pull/10674#discussion_r24381901","pull_request_url":"https://api.github.com/repos/docker/docker/pulls/10674","_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/comments/24381901"},"html":{"href":"https://github.com/docker/docker/pull/10674#discussion_r24381901"},"pull_request":{"href":"https://api.github.com/repos/docker/docker/pulls/10674"}}},"pull_request":{"url":"https://api.github.com/repos/docker/docker/pulls/10674","id":28972059,"html_url":"https://github.com/docker/docker/pull/10674","diff_url":"https://github.com/docker/docker/pull/10674.diff","patch_url":"https://github.com/docker/docker/pull/10674.patch","issue_url":"https://api.github.com/repos/docker/docker/issues/10674","number":10674,"state":"open","locked":false,"title":"Cleans up docs/man/Dockerfile.5.md","user":{"login":"cpuguy83","id":799078,"avatar_url":"https://avatars.githubusercontent.com/u/799078?v=3","gravatar_id":"","url":"https://api.github.com/users/cpuguy83","html_url":"https://github.com/cpuguy83","followers_url":"https://api.github.com/users/cpuguy83/followers","following_url":"https://api.github.com/users/cpuguy83/following{/other_user}","gists_url":"https://api.github.com/users/cpuguy83/gists{/gist_id}","starred_url":"https://api.github.com/users/cpuguy83/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cpuguy83/subscriptions","organizations_url":"https://api.github.com/users/cpuguy83/orgs","repos_url":"https://api.github.com/users/cpuguy83/repos","events_url":"https://api.github.com/users/cpuguy83/events{/privacy}","received_events_url":"https://api.github.com/users/cpuguy83/received_events","type":"User","site_admin":false},"body":"Fixes some improper usage of `**` instead of backticks\r\nRe-arranged some things for readability.","created_at":"2015-02-10T00:58:55Z","updated_at":"2015-02-10T01:17:44Z","closed_at":null,"merged_at":null,"merge_commit_sha":"a0cc6424d91d22115af181c53ca8af06fa8a528e","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/docker/docker/pulls/10674/commits","review_comments_url":"https://api.github.com/repos/docker/docker/pulls/10674/comments","review_comment_url":"https://api.github.com/repos/docker/docker/pulls/comments/{number}","comments_url":"https://api.github.com/repos/docker/docker/issues/10674/comments","statuses_url":"https://api.github.com/repos/docker/docker/statuses/9c5e0ac08323829be50b99c402eb8b655681ce3b","head":{"label":"cpuguy83:cleanup_Dockerfile_manpage","ref":"cleanup_Dockerfile_manpage","sha":"9c5e0ac08323829be50b99c402eb8b655681ce3b","user":{"login":"cpuguy83","id":799078,"avatar_url":"https://avatars.githubusercontent.com/u/799078?v=3","gravatar_id":"","url":"https://api.github.com/users/cpuguy83","html_url":"https://github.com/cpuguy83","followers_url":"https://api.github.com/users/cpuguy83/followers","following_url":"https://api.github.com/users/cpuguy83/following{/other_user}","gists_url":"https://api.github.com/users/cpuguy83/gists{/gist_id}","starred_url":"https://api.github.com/users/cpuguy83/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cpuguy83/subscriptions","organizations_url":"https://api.github.com/users/cpuguy83/orgs","repos_url":"https://api.github.com/users/cpuguy83/repos","events_url":"https://api.github.com/users/cpuguy83/events{/privacy}","received_events_url":"https://api.github.com/users/cpuguy83/received_events","type":"User","site_admin":false},"repo":{"id":15300899,"name":"docker","full_name":"cpuguy83/docker","owner":{"login":"cpuguy83","id":799078,"avatar_url":"https://avatars.githubusercontent.com/u/799078?v=3","gravatar_id":"","url":"https://api.github.com/users/cpuguy83","html_url":"https://github.com/cpuguy83","followers_url":"https://api.github.com/users/cpuguy83/followers","following_url":"https://api.github.com/users/cpuguy83/following{/other_user}","gists_url":"https://api.github.com/users/cpuguy83/gists{/gist_id}","starred_url":"https://api.github.com/users/cpuguy83/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cpuguy83/subscriptions","organizations_url":"https://api.github.com/users/cpuguy83/orgs","repos_url":"https://api.github.com/users/cpuguy83/repos","events_url":"https://api.github.com/users/cpuguy83/events{/privacy}","received_events_url":"https://api.github.com/users/cpuguy83/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/cpuguy83/docker","description":"Docker - the open-source application container engine","fork":true,"url":"https://api.github.com/repos/cpuguy83/docker","forks_url":"https://api.github.com/repos/cpuguy83/docker/forks","keys_url":"https://api.github.com/repos/cpuguy83/docker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/cpuguy83/docker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/cpuguy83/docker/teams","hooks_url":"https://api.github.com/repos/cpuguy83/docker/hooks","issue_events_url":"https://api.github.com/repos/cpuguy83/docker/issues/events{/number}","events_url":"https://api.github.com/repos/cpuguy83/docker/events","assignees_url":"https://api.github.com/repos/cpuguy83/docker/assignees{/user}","branches_url":"https://api.github.com/repos/cpuguy83/docker/branches{/branch}","tags_url":"https://api.github.com/repos/cpuguy83/docker/tags","blobs_url":"https://api.github.com/repos/cpuguy83/docker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/cpuguy83/docker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/cpuguy83/docker/git/refs{/sha}","trees_url":"https://api.github.com/repos/cpuguy83/docker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/cpuguy83/docker/statuses/{sha}","languages_url":"https://api.github.com/repos/cpuguy83/docker/languages","stargazers_url":"https://api.github.com/repos/cpuguy83/docker/stargazers","contributors_url":"https://api.github.com/repos/cpuguy83/docker/contributors","subscribers_url":"https://api.github.com/repos/cpuguy83/docker/subscribers","subscription_url":"https://api.github.com/repos/cpuguy83/docker/subscription","commits_url":"https://api.github.com/repos/cpuguy83/docker/commits{/sha}","git_commits_url":"https://api.github.com/repos/cpuguy83/docker/git/commits{/sha}","comments_url":"https://api.github.com/repos/cpuguy83/docker/comments{/number}","issue_comment_url":"https://api.github.com/repos/cpuguy83/docker/issues/comments/{number}","contents_url":"https://api.github.com/repos/cpuguy83/docker/contents/{+path}","compare_url":"https://api.github.com/repos/cpuguy83/docker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/cpuguy83/docker/merges","archive_url":"https://api.github.com/repos/cpuguy83/docker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/cpuguy83/docker/downloads","issues_url":"https://api.github.com/repos/cpuguy83/docker/issues{/number}","pulls_url":"https://api.github.com/repos/cpuguy83/docker/pulls{/number}","milestones_url":"https://api.github.com/repos/cpuguy83/docker/milestones{/number}","notifications_url":"https://api.github.com/repos/cpuguy83/docker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/cpuguy83/docker/labels{/name}","releases_url":"https://api.github.com/repos/cpuguy83/docker/releases{/id}","created_at":"2013-12-19T02:58:40Z","updated_at":"2015-01-16T15:03:31Z","pushed_at":"2015-02-10T01:08:41Z","git_url":"git://github.com/cpuguy83/docker.git","ssh_url":"git@github.com:cpuguy83/docker.git","clone_url":"https://github.com/cpuguy83/docker.git","svn_url":"https://github.com/cpuguy83/docker","homepage":"http://www.docker.io","size":44073,"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":1,"forks":0,"open_issues":1,"watchers":0,"default_branch":"master"}},"base":{"label":"docker:master","ref":"master","sha":"4284715c79acf1cdc4da1e8af4827b157ed08bb6","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}","created_at":"2013-01-18T18:10:57Z","updated_at":"2015-02-10T01:02:42Z","pushed_at":"2015-02-10T01:02:42Z","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":134692,"stargazers_count":19060,"watchers_count":19060,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":3936,"mirror_url":null,"open_issues_count":1008,"forks":3936,"open_issues":1008,"watchers":19060,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/10674"},"html":{"href":"https://github.com/docker/docker/pull/10674"},"issue":{"href":"https://api.github.com/repos/docker/docker/issues/10674"},"comments":{"href":"https://api.github.com/repos/docker/docker/issues/10674/comments"},"review_comments":{"href":"https://api.github.com/repos/docker/docker/pulls/10674/comments"},"review_comment":{"href":"https://api.github.com/repos/docker/docker/pulls/comments/{number}"},"commits":{"href":"https://api.github.com/repos/docker/docker/pulls/10674/commits"},"statuses":{"href":"https://api.github.com/repos/docker/docker/statuses/9c5e0ac08323829be50b99c402eb8b655681ce3b"}}}}