Diferenças entre man pages

Question

Muitas vezes me vejo lendo man pages online em vez de na linha de comando do meu sistema. Parte do motivo é porque acho mais fácil procurar essas informações em um navegador na Internet do que na linha de comando.

No entanto, isso também significa que muitas vezes acabo lendo informações de páginas de manual "genéricas" (por exemplo, do link ) ou de um diferente distribuição ou versão da ferramenta, e não da ferramenta / versão específica real que tenho no meu sistema.

Então, sempre me perguntei se estava faltando alguma coisa por não ler as páginas do manual instaladas na minha máquina. Presumo que, para as ferramentas (e parâmetros) mais comumente usadas e estáveis, as diferenças sejam insignificantes, mas gostaria de saber até que ponto isso é uma suposição segura.

Mais especificamente:

1. É comum que distribuições diferentes tenham páginas de manual diferentes? Isso é verdade mesmo para a mesma versão das ferramentas fornecida pela distro?
2. Quais páginas de manual podem variar mais significativamente nas distribuições?

Answer 1

Existem alguns programas que têm várias implementações diferentes, que são compatíveis no que diz respeito às suas principais características, mas diferem em detalhes ou extensões e possivelmente possuem documentação que foi escrita de forma independente. Quando isso acontece, você verá diferentes man pages em diferentes sistemas, já que estes são programas tecnicamente diferentes.

Alguns exemplos no Linux são cron (existem várias implementações ao redor), init e amigos (existem muitas diferenças entre SysVinit, Upstart e Systemd), awk (a maioria dos sistemas Linux tem GNU awk mas também há o Mawk menor), locate (há o GNU locate e, em seguida, há mlocate e slocate),…

Além disso, alguns programas possuem recursos opcionais que são selecionados por opções de compilação. Muitas vezes, a página man é gerada em tempo de compilação e apenas documenta as opções incluídas nessa compilação em particular.

Algumas distribuições colocam suas páginas de manual on-line (isso pode ser útil para verificar a portabilidade), por exemplo, Debian , SuSE , Ubuntu ,… Os links devem estar no wiki da tag de distribuição no Unix Stack Exchange (se uma distribuição tiver páginas man on-line e o link não está no wiki, por favor adicione-o).

    

Answer 2

A página man de um determinado software é geralmente escrita por seu (s) autor (es). Os que estão no seu sistema serão os mais apropriados para as ferramentas que você instalou, porque eles terão as informações corretas para sua implementação e nível de versão.

Principalmente, as diferenças são insignificantes, mas a maior diferença é entre as ferramentas GNU, BSD e BusyBox.