O manual do UNIX
Em 3 de novembro de 1971, foi lançada a primeira versão do Unix Programmer’s Manual, comumente conhecido como man pages.
Você pode baixar em PDF ou PostScript na página de Dennis Ritchie na Bell Labs, mantida pela Nokia por motivos históricos.
É interessante como os comandos do UNIX não mudaram muito ao longo dos anos. Se você é usuário de Linux ou BSD, certamente reconhecerá a maioria deles. Também é fantástico como uma ideia tão simples pode ser tão incrivelmente útil.
Paginador
O comando man usa um paginador para exibir as manpages, geralmente o more ou o less. Você pode substituir o paginador padrão do seu sistema alterando a variável de ambiente PAGER, como no exemplo abaixo.
export PAGER="less"
Colocando cores nas manpages
Em muitos sistemas modernos, o comando less é o paginador. Podemos configurá-lo para exibir cores e destacar títulos, palavras, parâmetros, listas, etc., tornando o texto mais legível.
Para adicionar cores nas manpages, primeiro, certifique-se de que está usando o less como paginador. Em seguida, adicione as seguintes variáveis.
export LESS_TERMCAP_mb=$'\e[1;32m'
export LESS_TERMCAP_md=$'\e[1;32m'
export LESS_TERMCAP_me=$'\e[0m'
export LESS_TERMCAP_se=$'\e[0m'
export LESS_TERMCAP_so=$'\e[01;33m'
export LESS_TERMCAP_ue=$'\e[0m'
export LESS_TERMCAP_us=$'\e[1;4;31m'
Experimente abrir uma manpage. Vários elementos do texto estarão coloridos. Você pode brincar com os códigos ANSI para personalizar suas cores.
Listando os arquivos
Vários programas, como o Python, adicionam manpages. Para listar os arquivos, use o comando man -w.
man -w
O man exibirá o caminho onde está procurando as manpages.
Exportando manpages para HTML
Além do man, outro utilitário muito útil é o mandoc, que você pode usar para exportar manpages para outros formatos, como por exemplo, HTML.
mandoc -Thtml -Ostyle=style.css > foo.1.html
História do mandoc
O mandoc surgiu pela primeira vez no OpenBSD 4.8, lançado em novembro de 2010. É bastante recente em relação aos utilitários UNIX.