配置“git help”以打开 kernel.org 参考答案

【问题标题】：Configuring 'git help' to open kernel.org reference配置“git help”以打开 kernel.org 参考
【发布时间】：2011-03-29 16:49:45
【问题描述】：

我在我的 Mac 上安装了 git，但我忘记或决定不安装本地文档。然而，在我的 Windows 安装中，当我使用 git help command 时，它实际上会打开 kernel.org 上的相应文档。这也可以为我的 mac 安装配置吗？如果有怎么办？

【问题讨论】：

标签： git macos

【解决方案1】：

您需要设置the help.format variable (git config --global help.format web) 或在帮助命令中使用-w 选项：

help.format

如果没有传递命令行选项，help.format 配置变量将被检查。为此支持以下值多变的;他们使 git help 表现为他们相应的命令行选项：
  *   "man" corresponds to -m|--man,

  *   "info" corresponds to -i|--info,

  *   "web" or "html" correspond to -w|--web.

这也是-w 上的部分：

-w, --web
以 Web (HTML) 格式显示命令的手册页。一个网络浏览器将用于此目的。

可以使用配置变量指定网络浏览器 help.browser 或 web.browser 如果前者未设置。如果没有这些配置变量已设置，git web--browse 帮助脚本（由 git help 调用）将选择一个合适的默认值。见 git- web--browse(1) 了解更多信息。

我现在无法对其进行测试，但我相当确定在 Windows 上，使用网络帮助实际上使用了 HTML 文档的本地副本（不是您所说的来自 kernel.org）；这很好，因为这些文档与您的 git 版本相对应，您不会错误地阅读不同版本的文档。无论如何，我在 OSX 10.6 上使用 -w 也会加载本地 HTML 文档。

【讨论】：

嗯...当我尝试得到 fatal: '/usr/local/share/doc/git-doc': not a documentation directory. 时，也许还需要其他东西？
@Paul：你是如何安装 git 的？我使用了 fink 或 MacPorts，并成功重定向到 /opt/local/share/doc/git-core/git-whatever.html。您可能以某种方式在没有本地 html 文档的情况下安装了它——构建文档确实依赖于 AsciiDoc，因此这可能与它有关。
如果您从源代码构建（使用 makefile），您实际上必须明确要求安装文档。每种类型的文档都有一个规则：install-man、install-html、install-info 和 install-pdf。（install-doc 仅指install-man）。我认为默认情况下它们不会完成，因为构建文档实际上需要相当长的时间 - asciidoc 并不是世界上最快的实用程序。
我不是从源代码构建的，我在 Ubuntu 上使用了apt-get。