mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
fa3ac2d370
Update md2man script to generate manpages inside docs/man/ directory. Update usage documentation in the readme to point to the new docs/man path. Update Ubuntu makefile to use new path to manpages Docker-DCO-1.1-Signed-off-by: Matthew Heon <mheon@redhat.com> (github: mheon)
71 lines
2 KiB
Markdown
71 lines
2 KiB
Markdown
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.
|
|
|
|
# File List
|
|
|
|
docker.md
|
|
docker-attach.md
|
|
docker-build.md
|
|
docker-commit.md
|
|
docker-cp.md
|
|
docker-diff.md
|
|
docker-events.md
|
|
docker-export.md
|
|
docker-history.md
|
|
docker-images.md
|
|
docker-import.md
|
|
docker-info.md
|
|
docker-inspect.md
|
|
docker-kill.md
|
|
docker-load.md
|
|
docker-login.md
|
|
docker-logs.md
|
|
docker-port.md
|
|
docker-ps.md
|
|
docker-pull.md
|
|
docker-push.md
|
|
docker-restart.md
|
|
docker-rmi.md
|
|
docker-rm.md
|
|
docker-run.md
|
|
docker-save.md
|
|
docker-search.md
|
|
docker-start.md
|
|
docker-stop.md
|
|
docker-tag.md
|
|
docker-top.md
|
|
docker-wait.md
|
|
Dockerfile
|
|
md2man-all.sh
|
|
|
|
# Generating man pages from the Markdown files
|
|
|
|
The recommended approach for generating the man pages is via a Docker
|
|
container. Using the supplied Dockerfile, Docker will create a Fedora based
|
|
container and isolate the Pandoc installation. This is a seamless process,
|
|
saving you from dealing with Pandoc and dependencies on your own computer.
|
|
|
|
## Building the Fedora / Pandoc image
|
|
|
|
There is a Dockerfile provided in the `docker/docs/man` directory.
|
|
|
|
Using this Dockerfile, create a Docker image tagged `fedora/pandoc`:
|
|
|
|
docker build -t fedora/pandoc .
|
|
|
|
## Utilizing the Fedora / Pandoc image
|
|
|
|
Once the image is built, run a container using the image with *volumes*:
|
|
|
|
docker run -v /<path-to-git-dir>/docker/docs/man:/pandoc:rw \
|
|
-w /pandoc -i fedora/pandoc /pandoc/md2man-all.sh
|
|
|
|
The Pandoc Docker container will process the Markdown files and generate
|
|
the man pages inside the `docker/docs/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]
|
|
(http://docs.docker.io/use/working_with_volumes/).
|