Qual é a diferença entre a documentação "man" e "info"?

92

Em relação às páginas de manual e documentação de ajuda de informações:

Por que existem duas fontes de documentação semelhantes?
Às vezes, uma página de manual está disponível e as informações não; ou vice-versa.
Ainda não me apeguei à rima e à razão por trás disso.

Talvez exista uma diferença significativa entre eles, mas mesmo que exista, por que os dois existem? Parece desnecessário dobrar.

Peter.O
fonte
11
GNU-Info Ruim, Homem (1) Bom de 2003, leitura engraçada. Flat is better than nested.
N611x007
Tente fazer info infoe man info. man infomostra exemplos coloridos. Eu sou uma pessoa mais visual, usar a mesma cor me deixa com sono. A sintaxe do homem com um pouco de cor torna compreensível rapidamente.
randominstanceOfLivingThing

Respostas:

80

As páginas de manual são a maneira tradicional do UNIX de distribuir documentação sobre programas. O termo "página de manual" em si é abreviação de "página de manual", pois corresponde às páginas do manual impresso; as páginas de manual "seções" (1 para comandos, 2 para chamadas do sistema etc.) correspondem às seções no manual completo do UNIX. O suporte ainda existe se você quiser imprimir uma página de manual em papel, embora isso raramente seja feito atualmente, e o grande número de páginas de manual torne impossível vinculá-las a todos em um único livro.

No início dos anos 90, o projeto GNU decidiu que o sistema de documentação "man" estava desatualizado e escreveu o comando info para substituí-lo: o info possui recursos básicos de hiperlink e uma linguagem de marcação mais simples de usar (em comparação com o sistema "troff" usado para páginas de manual). Além disso, o GNU advoga contra o uso de páginas de manual e afirma que sistemas de software complexos devem ter documentação completa e abrangente, em vez de apenas um conjunto de páginas de manual curtas.

Na verdade, existem outros sistemas de documentação em uso, além de man e info : o GNOME e o KDE têm um sistema próprio, baseado em HTML, etc.

No final, a forma como você obtém a documentação depende das políticas internas do projeto que forneceram o software em primeiro lugar - não há um padrão aceito globalmente.

Riccardo Murri
fonte
14
infonunca decolou mesmo, não é?
UncleZeiv 25/10/10
9
@UncleZeiv: execute infosem parâmetros para ter uma idéia de quantos aplicativos usam a documentação em formato de informação.
JanC 26/10/10
24

Info é o formato padrão para documentação dentro do projeto GNU, man é o formato tradicional muito mais antigo para UNIX.

O Info usa o Texinfo como formato de origem, que é um monte de macros para o TeX, e isso facilita muito a criação de versões impressas ou PDFs "de boa aparência".

Geralmente, as páginas de manual são mais sobre um tópico específico (um comando, um arquivo de configuração, uma função do sistema, ...) enquanto as informações normalmente têm mais a estrutura de um manual combinado, mais como um livro.

JanC
fonte
14

O man usa menos para exibir a página de manual, que por sua vez usa as teclas de atalho do vim, enquanto as informações usam as teclas de atalho do emacs e os comandos padrão do emacs para pesquisar, sair etc.


fonte
3
A questão das combinações de teclas é interessante (então eu pesquisei no Google) ... Parece que infotem uma opção de combinações de teclas VI: --vi-keys (Use combinações de teclas semelhantes a vi e menos similares ) ... $ alias info = 'info - vi-keys '... talvez?
Peter.O