GIT 文档中的 [1] 是什么？

Question

我开始学习 GIT，文档语法令人困惑。在“git-add[1]”或“git-commit[1]”等用例中，[1] 表示什么？

它遍布整个文档。在一些网站页面上，它以括号的形式出现 - “git-init(1)”

它代表什么？

Answer 1

这是手册的章节编号。此约定是通用的，不仅限于 Git。请参阅man 1 man：

[…] 如果提供了某个部分，则将指示man仅在手册的该部分中查找。默认操作是按照预定义的顺序在所有可用部分中搜索，并仅显示找到的第一页，即使页面存在于多个部分中。

下表显示了手册的章节编号以及其包含的页面类型。

1. 可执行程序或 shell 命令
2. 系统调用（内核提供的函数）
3. 库调用（程序库内的函数）
4. 特殊文件（通常位于/dev）
5. 文件格式和约定，例如/etc/passwd
6. 游戏
7. 杂项（包括宏包和约定），例如man(7)，groff(7)
8. 系统管理命令（通常仅适用于 root）
9. 内核例程[非标准]

因此，查看手册的命令git-init(1)是man 1 git-init。在这种情况下，简单man git-init有效，但有时您需要明确指定您要查找的章节编号。例如，有 和man(1)；man(7)将man man显示前者，要查看后者，您需要man 7 man。