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

时间:2011-11-06 05:00:50

标签: git macos manpage

我通过Mac OS X链接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已经关闭,所以它没什么用。

6 个答案:

答案 0 :(得分:6)

找到它。

$ 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"

答案 1 :(得分:2)

不要在OS X中设置MANPATH变量......它会破坏man!
这些说明将起作用,不会破坏任何内容,您可以使用脚本自动执行。

1)拥有您要安装的手册页的源文件(即使用groff格式化的文档)。如果源文件是纯文本,您可以使用像txt2man这样的工具进行转换,或者您可以学习groff语法并手动格式化。我找到了一个很好的方法来处理如何创建格式正确的手册页here

2)在文件命令之后命名文件,后缀为其所属的部分。大多数手册页都在man1中,所以如果你有git man源文件,请将其命名为#34; git。 1&#34;如果它还没有正确命名。

3)给源文件正确的权限:
sudo chown root:admin git.1
sudo chmod 444 git.1

4)gunzip源文件(我用tar):
sudo tar -czf git.1.gz git.1

5)将gunzipped文件移动到正确的位置(使用-n参数以防止在现有的手册页上书写)
sudo mv -n git.1.gz / usr / share / man / man1 /

你已经完成了。

man git

答案 2 :(得分:1)

此外,而不是:

$ help git fetch

你想要:

$ git help fetch

答案 3 :(得分:0)

/usr/local/git/share/man添加到您的shell的MANPATH环境变量中。

答案 4 :(得分:0)

你想尝试:

git fetch --help

答案 5 :(得分:0)

我使用这个脚本(来自我本地git源代码库的顶层)来更新我的git install,构建它,更新文档分支并安装手册页

git checkout master;  # Makes sure I am on the master branch
git pull; # pull the changes down
make prefix=/usr/local/git all; # configure my local installation directory
sudo make prefix=/usr/local/git install; # Make and install the git binaries
sudo git clean -dxf; # clear out the intermediate files created during compilation
git checkout html; # checkout my local html which tracks origin/html
git pull; # Pull the changes down. I leave the repo with this branch so I can see all the documentation
git archive origin/man | tar xvC /usr/local/share/man; # Install the manpages.

最后一行是解压缩并安装手册页的行。它在存储库中创建手册页的zip存档,但不是将它们写入文件,而是将其传送到管理目录。