Files
docker-cli/components/cli/man
Doug Davis 2f100155de Add support for DOCKER_CONFIG/--config to specific config file dir
Carry #11675

Aside from what #11675 says, to me a key usecase for this is to support
more than one Docker cli running at the same time but each may have its
own set of config files.

Signed-off-by: Doug Davis <dug@us.ibm.com>
Upstream-commit: 408d7deaf7
Component: cli
2017-06-02 00:07:01 +00:00
..
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:59 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00
2017-06-02 00:06:57 +00:00

Docker Documentation

This directory contains the Docker user manual in the Markdown format. Do not edit the man pages in the man1 directory. Instead, amend the Markdown (*.md) files.

Generating man pages from the Markdown files

The recommended approach for generating the man pages is via a Docker container using the supplied Dockerfile to create an image with the correct 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.

Using this Dockerfile, create a Docker image tagged docker/md2man:

docker build -t 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

The md2man Docker container will process the Markdown files and generate the man pages inside the docker/man/man1 directory 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/).