Como posso saber se a página de manual que estou vendo é a correta?

Você não, realmente. Não sem conhecimento externo à página de manual.

No caso de echo(e printf, e test, ...), geralmente é um shell embutido, então você precisará saber disso e ler a documentação do shell. _{(E echoé notoriamente diferente em diferentes implementações, use .printf )}

Na maioria, se não em todos os shells, você pode descobrir se algo está embutido com , por exemplo , imprimirá . ( é especificado pelo POSIX mas, por exemplo , o fish também o suporta, por mais não-POSIXy que seja.) No Bash , você leria então a documentação online ou usaria o comando interno (que é específico do Bash e do qual você precisa saber existe).type commandtype echoecho is a shell builtintypeman bashhelp

Mesmo que o comando não seja um built-in, é possível que existam vários comandos com o mesmo nome, renamesendo um exemplo famoso (veja Por que o utilitário de renomeação no Debian/Ubuntu é diferente do de outras distribuições, como CentOS? ). Agora, seu sistema operacional deve ter a página de manual correta para o utilitário realmente instalado e, por exemplo, no Debian, o sistema de "alternativas" atualiza as páginas de manual correspondentes também quando as alternativas de comando são alteradas. Mas se você ler uma página de manual online , precisará estar ciente disso.

Muitos utilitários têm uma opção de linha de comando, como a --versionque pode informar qual é a implementação desse comando. (Mas nem quase todos os utilitários o têm. Eu acho que é um GNUism originalmente, então os utilitários GNU o têm, assim como aqueles que por acaso copiaram o costume.) No caso de rename, isso funciona para diferenciar duas implementações diferentes:

debian$ rename --version
/usr/bin/rename using File::Rename version 0.20
centos$ rename --version
rename (util-linux-ng 2.17.2)

Além disso, seu sistema pode ter um alias ou uma função com o mesmo nome de um utilitário, geralmente para modificar o comportamento do utilitário. Nesse caso, os padrões apresentados em uma página de manual podem não se aplicar. Os aliases para lssão comuns, assim como os aliases que adicionam -ia rmou mv. Mas type footambém diria se fooé um alias ou função.

Se você quiser o manual de um comando interno, precisará consultar o manual do seu shell. O comando será documentado nele, juntamente com todos os outros comandos internos (ou haverá pelo menos uma referência de onde a documentação para internos pode ser encontrada).

• bash: man bashou de um shell help echointerativo .bash
• zsh: man zsh(e depois de um pouco de leitura, man zshbuiltin)
• fish: man fish(e depois de um pouco de leitura, help echo)

O manual que você obtém para man echodocumentos /bin/echo, ou seja, o comando externo . echoEste comando não é o que você usaria quando usasse echosem um caminho explícito.

Deve ser possível invocar a versão não interna do shell fornecendo o caminho completo (que você pode obter com which echo). Não há páginas de manual separadas para internos do shell; para documentação sobre aqueles que você deseja procurar na página de manual do seu shell. O comando "type" que você mencionou acima é a melhor maneira de descobrir qual você obterá.

Como o comando sobre o qual você deseja obter informações é um shell embutido, digitar help <command name>o mesmo shell fornecerá a entrada de ajuda correta:

$ help echo
echo: echo [-neE] [arg ...]
    Write arguments to the standard output.
    ...

Alternativamente, você pode digitar man bash(ou qualquer shell que esteja usando) e encontrar o built-in que estava procurando.

Infelizmente, não há uma maneira fácil de verificar se uma página de manual corresponde totalmente ao comando que você deseja executar. Obter a página "certa" é mais complicado do que parece, pois isso dependerá de muitos fatores, como o caminho completo do comando, variáveis ​​de ambiente e aliases, e é tecnicamente impossível manlevar em conta todos esses fatores. No entanto, após um curto período de tempo, você deve desenvolver uma compreensão geral de onde procurar ajuda.

Se eu fosse descrever um algoritmo geral para obter a documentação correta na maioria dos *nices modernos, seria algo assim:

• Você precisa de ajuda com um built-in ( type <command>diz que é built-in)?
  • Use help <command>ou man <shellname>se helpnão estiver disponível em seu shell.
• Quer sua ajuda sucinta e técnica?
  • Use man <command>(ou man <section> <command>se houver várias entradas em diferentes seções, consulte man mana lista de seções)
• Você quer sua ajuda na forma de um tutorial/manual interativo mais longo (se disponível)?
  • usarinfo <command>
• Se as etapas acima falharem:
  • Verifique /usr/share/doc/<package name>se há documentação adicional no pacote, como páginas HTML.
  • Execute o comando com as opções -hou --help, supondo que o comando seja confiável. Muitas vezes, isso fornecerá um breve resumo do que ele faz e informará onde você pode encontrar mais informações.
  • Google.

mas devo reiterar, tudo isso se tornará "natural" à medida que se passa algum tempo com o sistema operacional.

mané dividido em seção:

1. Seção Geral
2. Chamadas do sistema
3. Funções da biblioteca
4. Formatos de arquivo
5. Jogos e protetores de tela
6. Diversos
7. Administração do Sistema

Dependendo do que você procura você pode invocar manassim para evitar confusão: man section command.

Para obter mais informações, você pode realmente usarman man

Se a distribuição do seu sistema operacional não tiver páginas de manual para esses programas que mencionam as diferenças, você deve fazer um relatório de bug.

Na verdade, essa é a tarefa dos criadores da distro, mas se você digitar:

type cmdname

você obterá a saída se cmdnamefor um shell embutido. Se você souber qual shell está usando, poderá executar:

man shellname

substituindo shellnamepelo nome do seu shell. A página man do seu shell deve conter informações sobre comandos internos.

Deixe-me dar um exemplo de como um UNIX amigável deve documentar isso: http://schillix.sourceforge.net/man/man1/test.1.html