我开始学习 GIT,文档语法令人困惑。在“git-add[1]”或“git-commit[1]”等用例中,[1] 表示什么?
它遍布整个文档。在一些网站页面上,它以括号的形式出现 - “git-init(1)”
它代表什么?
答案1
这是手册的章节编号。此约定是通用的,不仅限于 Git。请参阅man 1 man
:
[…] 如果提供了某个部分,则将指示
man
仅在手册的该部分中查找。默认操作是按照预定义的顺序在所有可用部分中搜索,并仅显示找到的第一页,即使页面存在于多个部分中。下表显示了手册的章节编号以及其包含的页面类型。
- 可执行程序或 shell 命令
- 系统调用(内核提供的函数)
- 库调用(程序库内的函数)
- 特殊文件(通常位于
/dev
)- 文件格式和约定,例如
/etc/passwd
- 游戏
- 杂项(包括宏包和约定),例如
man(7)
,groff(7)
- 系统管理命令(通常仅适用于 root)
- 内核例程[非标准]
因此,查看手册的命令git-init(1)
是man 1 git-init
。在这种情况下,简单man git-init
有效,但有时您需要明确指定您要查找的章节编号。例如,有 和man(1)
;man(7)
将man man
显示前者,要查看后者,您需要man 7 man
。