github.com/goern/docker@v1.9.0-rc1/man/README.md (about)

     1  Docker Documentation
     2  ====================
     3  
     4  This directory contains the Docker user manual in the Markdown format.
     5  Do *not* edit the man pages in the man1 directory. Instead, amend the
     6  Markdown (*.md) files.
     7  
     8  # Generating man pages from the Markdown files
     9  
    10  The recommended approach for generating the man pages is via a Docker
    11  container using the supplied `Dockerfile` to create an image with the correct
    12  environment. This uses `go-md2man`, a pure Go Markdown to man page generator.
    13  
    14  ## Building the md2man image
    15  
    16  There is a `Dockerfile` provided in the `/man` directory of your
    17  'docker/docker' fork.
    18  
    19  Using this `Dockerfile`, create a Docker image tagged `docker/md2man`:
    20  
    21      docker build -t docker/md2man .
    22  
    23  ## Utilizing the image
    24  
    25  From within the `/man` directory run the following command:
    26  
    27      docker run -v $(pwd):/man -w /man -i docker/md2man ./md2man-all.sh
    28      
    29  The `md2man` Docker container will process the Markdown files and generate
    30  the man pages inside the `/man/man1` directory of your fork using
    31  Docker volumes. For more information on Docker volumes see the man page for
    32  `docker run` and also look at the article [Sharing Directories via Volumes]
    33  (https://docs.docker.com/use/working_with_volumes/).