5

我是 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 install 的目录列表。谢谢。

4

6 回答 6

8

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

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

“make doc”以 man 和 html 格式构建文档；还有“make man”、“make html”和“make info”。请注意，“make html”需要 asciidoc，但不需要 xmlto。“制作人”（因此制作文档）需要两者。

于 2011-11-23T15:27:17.020 回答
6

您正在获取 git 手册页的不正确部分。您想要的信息在第 1 节中。man 1 git用于获取正确的手册部分。

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

于 2011-11-23T15:00:46.400 回答
2

更新 git 2.8（2016 年 3 月）

来源安装提到，为了构建文档和手册页：

$ 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 愚蠢

“愚蠢的内容跟踪器”在 Git 的早期是正确的，但现在几乎不适用了。
“快速、可扩展、分布式”更准确地描述了 Git。

此外，“愚蠢”可能会被某些人视为冒犯。让我们不要在README.

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

于 2016-02-27T19:41:11.100 回答
0

git 的来源不包括文档。尝试：

$ git 档案来源/人 | sudo tar -x -C /usr/local/share/man

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

于 2011-11-23T15:05:09.627 回答
0

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

...
于 2011-11-23T14:58:40.973 回答
0

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

于 2013-12-09T15:23:29.227 回答