1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/man
Mary Anthony eacae64bd8 Moving man pages out of docs
Adding in other areas per comments
Updating with comments; equalizing generating man page info
Updating with duglin's comments
Doug is right here again;fixing.

Signed-off-by: Mary Anthony <mary@docker.com>
2015-06-10 13:43:35 -07:00
..
docker-attach.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-build.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-commit.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-cp.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-create.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-diff.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-events.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-exec.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-export.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-history.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-images.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-import.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-info.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-inspect.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-kill.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-load.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-login.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-logout.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-logs.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-pause.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-port.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-ps.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-pull.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-push.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-rename.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-restart.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-rm.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-rmi.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-run.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-save.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-search.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-start.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-stats.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-stop.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-tag.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-top.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-unpause.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-version.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker-wait.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
docker.1.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
Dockerfile Moving man pages out of docs 2015-06-10 13:43:35 -07:00
Dockerfile.5.md Moving man pages out of docs 2015-06-10 13:43:35 -07:00
md2man-all.sh Moving man pages out of docs 2015-06-10 13:43:35 -07:00
README.md Moving man pages out of docs 2015-06-10 13:43:35 -07: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.

Generate the man pages

On Linux installations, Docker includes a set of man pages you can access by typing man command-name on the command line. For example, man docker displays the docker man page. When using Docker on Mac OSX the man pages are not automatically included.

You can generate and install the man pages yourself by following these steps:

  1. Checkout the docker source.

     $ git clone https://github.com/docker/docker.git
    

If you are using Boot2Docker, you must clone into your /Users directory because Boot2Docker can only share this path with the docker containers.

  1. Build the docker image.

     $ cd docker/man
     $ docker build -t docker/md2man .
    
  2. Build the man pages.

     $ docker run -v <path-to-git-dir>/docker/man:/man:rw -w /man -i docker/md2man /man/md2man-all.sh
    

The md2man Docker container processes the Markdown files and generates a man1 and man5 subdirectories in the docker/man directory.

  1. Copy the generated man pages to /usr/share/man

     $ cp -R man* /usr/share/man/