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

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

从源代码中提及安装 ，以构建doc和man页面：

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

我确认一个man git会直接找你man (1) git 。
它的内容不同于git README ，它刚刚失去了愚蠢的“愚蠢的内容跟踪器” （说README现在是一个支持降价的README.md ！）

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

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

此外，“愚蠢”可能会被一些人视为冒犯。 我们不要在README第一句话中使用它。

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

Answer 4

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

Answer 5

你可能想要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 6

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

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

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