git-help

git-help - 显示有关Git的帮助信息

概要

如果没有选项，也没有给出COMMAND或GUIDE，则 git 命令的概要和最常用的Git命令列表将打印在标准输出上。

如果给出选项或-a，则所有可用命令都将打印在标准输出上。

如果给出选项--guide或-g，则标准输出上也会打印有用的Git指南列表。

如果给出了命令或指南，则会显示该命令或指南的手册页。默认情况下， man 程序用于此目的，但这可以被其他选项或配置变量覆盖。

如果给出了别名，git会在标准输出上显示别名的定义。要获取别名命令的手册页，请使用git COMMAND --help。

请注意，git --help ...与git help ...相同，因为前者在内部转换为后者。

要显示手册页，请使用git help git。

可以使用 git help help 或git help --help显示此页面

-a

 --all

打印标准输出上的所有可用命令。此选项会覆盖任何给定的命令或指南名称。

 --verbose

与--all打印描述一起使用时，用于所有已识别的命令。这是默认值。

-c

列出所有可用的配置变量。这是 git-config [1] 中列表的简短摘要。

 --guides

-i

 --info

以 info 格式显示命令的手册页。 info 程序将用于此目的。

 --man

以 man 格式显示命令的手册页。此选项可用于覆盖help.format配置变量中设置的值。

默认情况下， man 程序将用于显示手册页，但man.viewer配置变量可用于选择其他显示程序（见下文）。

-w

以 Web （HTML）格式显示命令的手册页。 Web浏览器将用于此目的。

如果未设置前者，可以使用配置变量help.browser或web.browser指定Web浏览器。如果没有设置这些配置变量， git web {litdd}浏览帮助程序脚本（由 git help 调用）将选择合适的默认值。有关详细信息，请参阅。

如果未传递命令行选项，则将检查help.format配置变量。此变量支持以下值;他们使 git help 的行为与其对应的命令行选项相同：

如果选择 web 格式（通过命令行选项或配置变量），也将检查help.browser，web.browser和。参见上面OPTIONS部分的 -w | —web 和 git-web {litdd}浏览[1] 。

如果选择 man 格式，将检查man.viewer配置变量。目前支持以下值：

如果存在相应的man.<tool>.cmd配置条目（参见下文），则可以使用其他工具的值。

可以为man.viewer配置变量赋予多个值。将按配置文件中列出的顺序尝试相应的程序。

例如，这个配置：

    [man]
        viewer = konqueror
        viewer = woman

将首先尝试使用konqueror。但这可能会失败（例如，如果没有设置DISPLAY），那么将尝试emacs的女人模式。

如果一切都失败，或者没有配置查看器，将尝试在GIT_MAN_VIEWER环境变量中指定的查看器。如果那也失败了，无论如何都会尝试 man 程序。

您可以通过设置配置变量man.<tool>.path显式提供首选人员查看器的完整路径。例如，您可以通过设置 man.konqueror.path 来配置konqueror的绝对路径。否则， git help 假定该工具在PATH中可用。

当man.viewer配置变量指定的man查看器不在支持的那个中时，将查找相应的man.<tool>.cmd配置变量。如果此变量存在，则指定的工具将被视为自定义命令，并且将使用shell eval运行命令，并将手册页作为参数传递。

当在man.viewer配置变量中指定 konqueror 时，我们启动 kfmclient 以尝试在新选项卡中打开已打开的konqueror的手册页（如果可能）。

为了保持一致性，如果将 man.konqueror.path 设置为 A_PATH_TO / konqueror ，我们也会尝试这样的技巧。这意味着我们将尝试启动 A_PATH_TO / kfmclient 。

如果你真的想使用 konqueror ，那么你可以使用如下内容：

请注意，可能应使用--global标志设置所有这些配置变量，例如：

$ git config --global help.format web

部分套件