Merge pull request #16291 from mikebrow/readme-updates-for-man-pages

updates to readme documents for manual page

docs/README.md

@@ -286,9 +286,9 @@ aws cloudfront  create-invalidation --profile docs.docker.com --distribution-id
 
 ### Generate the man pages 
 
-For information on generating man pages (short for manual page), see [the man
-page directory](https://github.com/docker/docker/tree/master/docker) in this
-project.
+For information on generating man pages (short for manual page), see the README.md
+document in [the man page directory](https://github.com/docker/docker/tree/master/docker)
+in this project.
 
 
 

man/README.md

@@ -13,7 +13,8 @@ environment. This uses `go-md2man`, a pure Go Markdown to man page generator.
 
 ## Building the md2man image
 
-There is a `Dockerfile` provided in the `docker/man` directory.
+There is a `Dockerfile` provided in the `/man` directory of your
+'docker/docker' fork.
 
 Using this `Dockerfile`, create a Docker image tagged `docker/md2man`:
 
@@ -21,13 +22,12 @@ Using this `Dockerfile`, create a Docker image tagged `docker/md2man`:
 
 ## Utilizing the image
 
-Once the image is built, run a container using the image with *volumes*:
-
-    docker run -v /<path-to-git-dir>/docker/man:/docs:rw \
-    -w /docs -i docker/md2man /docs/md2man-all.sh
+From within the `/man` directory run the following command:
 
+    docker run -v $(pwd):/man -w /man -i docker/md2man ./md2man-all.sh
+    
 The `md2man` Docker container will process the Markdown files and generate
-the man pages inside the `docker/man/man1` directory using
+the man pages inside the `/man/man1` directory of your fork using
 Docker volumes. For more information on Docker volumes see the man page for
 `docker run` and also look at the article [Sharing Directories via Volumes]
 (https://docs.docker.com/use/working_with_volumes/).