如何在OS X上安装Git手册页？

Question

我通过Mac链接在这里http://git-scm.com/download安装了Git

安装后，我在终端中尝试执行以下操作：

$ git help fetch
$ git help remote
$ man git
$ man git-fetch

但是，我收到消息No manual entry for git-<subcommand>。如何安装Git的手册页？我和explained here有同样的问题，但是kernel.org停机了，所以它没有多大帮助。

Answer 1

找到了。

$ cd /usr/local/git/share/man
$ sudo git clone http://git.kernel.org/pub/scm/git/git-manpages.git

然后在.bash_profile中，添加以下行：

export MANPATH="${MANPATH}:/usr/local/git/share/man/git-manpages"

Answer 2

不要在OS X中设置MANPATH变量...它会击碎人类！

这些指令将起作用，不会破坏任何东西，并且您可以使用脚本实现自动化。

1)具有要安装的手册页的源文件(即使用groff格式化的文档)。如果源文件是纯文本，可以使用txt2man等工具进行转换，也可以学习Groff语法并手动格式化它。关于如何创建格式正确的手册页here，我找到了一个很好的方法。

2)以文件所记录的命令命名文件，后缀为文件所属的部分。大多数手册页都是用man1编写的，所以如果您有git man源文件，如果还没有正确命名，请将其命名为"git.1“。

3)对源文件赋予正确的权限：

sudo chown root:admin git.1

sudo chmod 444 git.1

4) gunzip源文件(我使用tar)：

sudo tar -czf git.1.gz git.1

5)将压缩后的文件移动到适当的位置(使用-n参数防止覆盖现有的手册页)

sudo mv -n git.1.gz /usr/share/man/man1/

你的任务完成了。

man git

Answer 3

此外，不是：

$ help git fetch

你会想要：

$ git help fetch