O que é [1] na documentação do GIT?

Question

Estou começando a aprender GIT e a sintaxe da documentação é confusa. O que [1] significa em casos de uso como "git-add[1]" ou "git-commit[1]"?

Está em toda a documentação. Em algumas páginas do site aparece entre parênteses – "git-init(1)"

O que isso representa?

Answer 1

É o número da seção do manual. Esta convenção é geral, não limitada ao Git. Verman 1 man:

[…] Uma seção, se fornecida, direcionará manpara olhar apenas aquela seção do manual. A ação padrão é pesquisar em todas as seções disponíveis, seguindo uma ordem pré-definida e mostrar apenas a primeira página encontrada, mesmo que exista página em várias seções.

A tabela abaixo mostra os números das seções do manual seguidos dos tipos de páginas que elas contêm.

1. Programas executáveis ​​ou comandos shell
2. Chamadas de sistema (funções fornecidas pelo kernel)
3. Chamadas de biblioteca (funções dentro de bibliotecas de programas)
4. Arquivos especiais (normalmente encontrados em /dev)
5. Formatos de arquivo e convenções, por exemplo/etc/passwd
6. Jogos
7. Diversos (incluindo pacotes de macro e convenções), por exemplo man(7),groff(7)
8. Comandos de administração do sistema (geralmente apenas para root)
9. Rotinas do kernel [não padrão]

O comando para ver o manual git-init(1)é portanto man 1 git-init. Neste caso, simples man git-initfunciona, mas às vezes você precisa especificar explicitamente o número da seção que deseja. Por exemplo, existe man(1)e man(7); man manirá mostrar o primeiro, para ver o último você precisa man 7 man.