@@ -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.

@@ -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/).