git-help - 显示有关Git的帮助信息
git help [-a|--all [--[no-]verbose]] [-g|--guide]
[-i|--info|-m|--man|-w|--web] [COMMAND|GUIDE]
如果没有选项,也没有给出COMMAND或GUIDE,则 git 命令的概要和最常用的Git命令列表将打印在标准输出上。
如果给出选项--all
或-a
,则所有可用命令都将打印在标准输出上。
如果给出选项--guide
或-g
,则标准输出上也会打印有用的Git指南列表。
如果给出了命令或指南,则会显示该命令或指南的手册页。默认情况下, man 程序用于此目的,但这可以被其他选项或配置变量覆盖。
如果给出了别名,git会在标准输出上显示别名的定义。要获取别名命令的手册页,请使用git COMMAND --help
。
请注意,git --help ...
与git help ...
相同,因为前者在内部转换为后者。
要显示 git [1] 手册页,请使用git help git
。
可以使用 git help help 或git help --help
显示此页面
-a
--all
打印标准输出上的所有可用命令。此选项会覆盖任何给定的命令或指南名称。
--verbose
与--all
打印描述一起使用时,用于所有已识别的命令。这是默认值。
-c
--config
列出所有可用的配置变量。这是 git-config [1] 中列表的简短摘要。
-g
--guides
打印标准输出上的有用指南列表。此选项会覆盖任何给定的命令或指南名称。
-i
--info
以 info 格式显示命令的手册页。 info 程序将用于此目的。
-m
--man
以 man 格式显示命令的手册页。此选项可用于覆盖help.format
配置变量中设置的值。
默认情况下, man 程序将用于显示手册页,但man.viewer
配置变量可用于选择其他显示程序(见下文)。
-w
--web
以 Web (HTML)格式显示命令的手册页。 Web浏览器将用于此目的。
如果未设置前者,可以使用配置变量help.browser
或web.browser
指定Web浏览器。如果没有设置这些配置变量, _git web {litdd}浏览_帮助程序脚本(由 git help 调用)将选择合适的默认值。有关详细信息,请参阅 git-web {litdd}浏览[1] 。
如果未传递命令行选项,则将检查help.format
配置变量。此变量支持以下值;他们使 git help 的行为与其对应的命令行选项相同:
-
“man”对应于 -m | --man ,
-
“info”对应 -i | --info ,
-
“web”或“html”对应于 -w | --web 。
如果选择 web 格式(通过命令行选项或配置变量),也将检查help.browser
,web.browser
和browser.<tool>.path
。参见上面OPTIONS部分的 -w | --web 和 git-web {litdd}浏览[1] 。
如果选择 man 格式,将检查man.viewer
配置变量。目前支持以下值:
-
“man”:像往常一样使用 man 程序,
-
“女人”:使用 emacsclient 在emacs中启动“女人”模式(这只适用于emacsclient版本22),
-
“konqueror”:使用 kfmclient 在新的konqueror标签中打开手册页(参见下面的_关于konqueror_ 的注释)。
如果存在相应的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 ,那么你可以使用如下内容:
[man]
viewer = konq
[man "konq"]
cmd = A_PATH_TO/konqueror
请注意,可能应使用--global
标志设置所有这些配置变量,例如:
$ git config --global help.format web
$ git config --global web.browser firefox
因为它们可能比特定于存储库更具用户特性。有关此内容的详细信息,请参阅 git-config [1] 。
部分 git [1] 套件