Git手册页似乎不正确

Question

我是git的新手,所以请原谅我这是一个愚蠢的问题.

我在SLES Linux上从源代码安装了git 1.7.7.4,看起来都不错.我在$ MANPATH中添加了以下内容:

/usr/local/git-1.7.7.4/share/man

当我这样做的时候man git,我会被提出来

Git(3)         User Contributed Perl Documentation         Git(3)

NAME
       Git - Perl interface to the Git version control system

SYNOPSIS
...

这看起来不像我在命令行中使用的git命令的手册页.或者是吗？听起来像perl的东西,显然.这是我看到的完整手册页的在线版本.

如果这不是正确的手册页,我在哪里可以找到它们？如果需要,我可以给我的git安装目录列表.谢谢.

Answer 1

您可以使用源代码包构建手册页make man && make install-man.默认情况下不构建手册页,请参阅git的INSTALL文件:

要构建和安装文档套件,您需要具有asciidoc/xmlto工具链.因为没有多少人倾向于安装工具,默认的构建目标("让所有")并没有建立他们.

"make doc"以man和html格式构建文档; 还有"make man","make html"和"make info".请注意,"make html"需要asciidoc,而不是xmlto."制造男人"(因此制造医生)需要两者兼而有之.

Answer 2

您正在获取git手册页的错误部分.您需要的信息在第1 man 1 git部分中.用于获取正确的手册部分.

您可以在此处查看可用手册部分的列表.

Answer 3

Update git 2.8 (March 2016)

The installation from sources mentions, in order to build the doc and man pages:

$ make all doc info
$ sudo make install install-doc install-html install-info

I confirm a man git will directly get you man (1) git.
It content differs from the git README which just lost the snarky "stupid content tracker" (said README is now a markdown-enabled README.md!)

README.md: don't call git stupid in the title

"the stupid content tracker" was true in the early days of Git, but hardly applicable these days.
"fast, scalable, distributed" describes Git more accurately.

Also, "stupid" can be seen as offensive by some people. Let's not use it in the very first words of the README.

The man page should soon follow suit.