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

Question

Com relação a páginas de manual e documentação de ajuda de informações:

Por que existem duas fontes similares de documentação?
Às vezes, uma página de manual está disponível e a informação não é; ou vice-versa.
Eu ainda não percebi a rima e a razão por trás disso.

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

    

Answer 1

Man pages são a maneira tradicional do UNIX de distribuir documentação sobre programas. O termo "man page" é a abreviatura de "manual page", uma vez que corresponde às páginas do manual impresso; as páginas do manual "seções" (1 para comandos, 2 para chamadas do sistema, etc.) correspondem a seções no manual completo do UNIX. O suporte ainda está lá, se você quiser imprimir uma página de manual no papel, embora isso raramente seja feito nos dias de hoje, e o grande número de páginas de manual torna impossível uni-las 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 info comando para substituí-lo: info tem recursos básicos de hiperlink e uma linguagem de marcação mais simples de usar (em comparação com o "troff" "sistema usado para páginas man). Além disso, o GNU defende contra o uso de páginas de manual em todos e afirma que software complexo Os sistemas 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 : GNOME e KDE têm seu próprio sistema baseado em HTML, etc.

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

    

Answer 2

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

A Info usa o Texinfo como seu formato de origem, que é um monte de macros para o TeX, e isso torna muito mais fácil também criar versões impressas ou PDFs "de boa aparência".

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

    

Answer 3

man usa menos para exibir a página de manual que, por sua vez, usa atalhos de teclado do vim, enquanto a info usa atalhos de teclado do emacs e comandos padrão do emacs para pesquisa, abandono, etc.