Что такое [1] в документации GIT?

Question

Я начинаю изучать GIT, и синтаксис документации сбивает с толку. Что означает [1] в таких случаях использования, как "git-add[1]" или "git-commit[1]"?

Это есть во всей документации. На некоторых веб-страницах это выглядит как скобки – "git-init(1)"

Что это собой представляет?

Answer 1

Это номер раздела руководства. Это общее соглашение, не ограниченное Git. Смотритеman 1 man:

[…] Раздел, если он указан, будет указывать manна поиск только в этом разделе руководства. Действие по умолчанию — поиск во всех доступных разделах в предопределенном порядке и отображение только первой найденной страницы, даже если страница существует в нескольких разделах.

В таблице ниже указаны номера разделов руководства, а также типы страниц, которые они содержат.

1. Исполняемые программы или команды оболочки
2. Системные вызовы (функции, предоставляемые ядром)
3. Библиотечные вызовы (функции внутри библиотек программ)
4. Специальные файлы (обычно находятся в /dev)
5. Форматы файлов и соглашения, например/etc/passwd
6. Игры
7. Разное (включая макропакеты и соглашения), например man(7),groff(7)
8. Команды системного администрирования (обычно только для root)
9. Процедуры ядра [Нестандартные]

Команда для просмотра руководства по , git-init(1)следовательно man 1 git-init, . В этом случае simple man git-initработает, но иногда вам нужно явно указать номер раздела, который вы ищете. Например, есть man(1)и man(7); man manпокажет вам первый, чтобы увидеть последний, вам нужен man 7 man.