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的东西，显然。这是我看到的完整手册页的online version。

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

Answer 1

您可以使用make man && make install-man从源包构建手册页。默认情况下不构建手册页，请参阅git的INSTALL文件：

  

要构建和安装文档套件，您需要拥有   asciidoc / xmlto工具链。因为人不多   倾向于安装工具，默认构建目标   （“make all”）不构建它们。

     

“make doc”以man和html格式构建文档;有   也“做人”，“制作HTML”和“制作信息”。注意“make html”   需要asciidoc，但不是xmlto。 “做人”（从而制作文件）   需要两者。

Answer 2

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

您可以看到可用的手册部分列表here。

Answer 3

更新git 2。8（2016年3月）

installation from sources提到，为了构建文档和手册页：

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

我确认man git会直接找到你man (1) git 它的内容与just lost the snarky "stupid content tracker"的README不同（README现在称为markdown-enabled README.md！）

  

README.md：不要在标题中调用git stupid

     

＆＃34;愚蠢的内容跟踪器＆＃34;在Git的早期就是如此，但这些日子几乎不适用   ＆＃34;快速，可扩展，分布式＆＃34;更准确地描述了Git。

     

此外，＆＃34;愚蠢＆＃34;有些人可以说是冒犯性的。我们不要用它   在README的第一句话中。

手册页应该很快就会效仿。

Answer 4

您可能需要man 1 git：

$ man 1 git

GIT(1)                              Git Manual                             GIT(1)

NAME
       git - the stupid content tracker

SYNOPSIS
       git [--version] [--exec-path[=<path>]] [--html-path]
           [-p|--paginate|--no-pager] [--no-replace-objects]
           [--bare] [--git-dir=<path>] [--work-tree=<path>]
           [-c <name>=<value>]
           [--help] <command> [<args>]

...

Answer 5

git的源代码不包含文档。尝试：

$ git archive origin/man | sudo tar -x -C /usr/local/share/man

在git的git工作目录中安装在/ usr / local / share。

Answer 6

执行他们（其他答案人员）所说的话，如果您仍然遇到同样的问题（或其他任何人），请确保您没有设置MANSECT环境变量，这也会导致此问题发生。它是一个以冒号分隔的要检查的部分列表，按降序排列（第一部分尝试在列表的开头，最后一部分在结尾）。如果我MANSECT = 3，我可以复制你的问题，但是根据你的用户的经验，这似乎是一个显而易见的事情。最后但并非最不重要的是，确保没有设置别名，函数（bash）或拦截'man'命令的脚本（因为man -section将明确告诉man要搜索哪个部分，格式与MANSECT相同） man，since --Section覆盖MANSECT变量。当你在它的时候检查MANOPT变量是否有' - section 3'或'-s3'标志（但你可能已经注意到了它，因为它会破坏许多查询）。确保导出MANPATH，如果它只是在本地声明，它没有任何好处（与其他变量相同）。最后，如果所有其他方法都失败了，你可以自己手动安装页面，这不是太难，除非你严格限制你所允许对你正在使用的系统做什么（我曾经工作的地方有一个规则，没有人被允许改变任何默认值，即使他们有权这样做，因为没有经验的人做出了不好的改变）。需要注意的另一件事是符号链接（即/ etc / alternatives），它现在又一次变得不相关，但人们通常会警告你。