如何在Mac os上安装docker手册页

Question

我已经在mac os上安装了docker作为written in documentation。

但是在一些文档中(例如在docker book中)，我看到了使用man docker-run (man docker-pull等)的建议。

但是当我运行这样的命令时，我得到了错误：

bessarabov@bessarabov-osx:~$ man docker
No manual entry for docker

如何将docker手册文档安装到我的Mac OS系统中？

Answer 1

从2017.06.01开始，你必须从git签出你想要的标签/版本。

https://github.com/docker/docker-ce

• version >= 17.06版：
• 17.06：https://github.com/moby/moby

然后，转到components/cli目录并执行：

make -f docker.Makefile manpages

要将手册页添加到手册路径，请执行以下操作：

echo "MANPATH $PWD/man" | sudo tee -a /private/etc/man.conf

来源：https://github.com/docker/cli/issues/217

Answer 2

自从@Sergiy的answer之后，docker看起来有了一些变化。这是一个适用于我的略微更新的版本。

git clone https://github.com/docker/docker.git
cd docker/man                      # looks like the directory has moved up
docker build -t docker/md2man .    # don't forget the '.'
docker run -v $PWD/:/docs:rw -w /docs -i docker/md2man /docs/md2man-all.sh
sudo cp -R man* /usr/share/man/    # you'll likely need sudo access for this
man docker                         # check it worked

Answer 3

在解析issue之前，您可以使用提供的docker文件通过docker容器执行build man pages manually操作，然后将生成的文件复制到/usr/share/man/

# Step 1: checkout docker sources, but make sure you do this
# somewhere in /Users directory because boot2docker can only
# share this path with docker containers
git clone https://github.com/docker/docker.git

# Step 2: build docker image  
cd docker/docs/man
docker build -t docker/md2man .

# Step 3: build man pages
docker run -v /Users/<path-to-git-dir>/docker/docs/man:/docs:rw \
-w /docs -i docker/md2man /docs/md2man-all.sh

# Step 4: copy generated man pages to /usr/share/man
cp -R man* /usr/share/man/

享受吧！