Isso depende das páginas de manual ... Tradicionalmente, elas incluíram uma seção com exemplos - mas por alguma razão que normalmente está faltando nas páginas man do Linux (e eu assumo outras usando o GNU comandos - que são mais estes dias). No Solaris, por outro lado, quase todas as páginas man incluem a seção Example, geralmente com vários exemplos.
Se eu fosse adivinhar, a FSF / GNU há muito tempo desencorajou o uso de man páginas e prefere que os usuários usem as informações para documentação. As páginas info tendem a ser mais abrangentes do que as páginas do manual e, geralmente, fazer incluem exemplos. info páginas também são mais "tópicas" - isto é, comandos relacionados (por exemplo, comandos para localizar arquivos) geralmente podem ser encontrados juntos.
Outra razão pode ser que o GNU e suas páginas man são usadas em muitos sistemas operacionais diferentes, os quais podem diferir uns dos outros (existem, depois de todas as diferenças, apenas entre diferentes distribuições do Linux). A intenção pode ter sido que o editor tenha adicionado exemplos relevantes para o sistema operacional / distribuição em particular - o que obviamente raramente é feito.
Também gostaria de acrescentar que man páginas nunca foram destinadas a "ensinar iniciantes". O UNIX foi desenvolvido por especialistas em informática (antigo termo "hackers") e destina-se a ser usado por especialistas em informática. As páginas man não foram feitas para ensinar um novato, mas para ajudar rapidamente um especialista em computador que precisava de um lembrete para alguma opção obscura ou formato de arquivo estranho - e isso se reflete em como uma página de manual é seccionada.
man -pages são, portanto, pretendidas como
- Uma referência rápida para refrescar sua memória; mostrando como o comando deve ser chamado e listando as opções disponíveis.
- Uma descrição profunda e completa - e geralmente muito técnica - de todos os aspectos do comando. Ele é escrito por especialistas em computação, para colegas especialistas em computação.
- Lista de variáveis de ambiente e arquivos (ou seja, arquivos de configuração) usados pelo comando.
- Referência a outra documentação (por exemplo, livros) e outras
manpáginas - por exemplo. para o formato de arquivos de configuração e comandos relacionados / semelhantes.
Dito isso, concordo muito com você que man páginas devem ter exemplos, já que podem explicar melhor o uso do que percorrer a própria página man. Exemplos muito ruins geralmente não estão disponíveis no Linux man pages ...
Exemplo da parte Exemplo de uma página man do Solaris - zfs (1M):
(...)
EXAMPLES
Example 1 Creating a ZFS File System Hierarchy
The following commands create a filesystem named pool/home
and a filesystem named pool/home/bob. The mount point
/export/home is set for the parent filesystem, and is
automatically inherited by the child filesystem.
# zfs create pool/home
# zfs set mountpoint=/export/home pool/home
# zfs create pool/home/bob
Example 2 Creating a ZFS Snapshot
The following command creates a snapshot named yesterday.
This snapshot is mounted on demand in the .zfs/snapshot
directory at the root of the pool/home/bob file system.
# zfs snapshot pool/home/bob@yesterday
Example 3 Creating and Destroying Multiple Snapshots
The following command creates snapshots named yesterday of
pool/home and all of its descendent file systems. Each
snapshot is mounted on demand in the .zfs/snapshot directory
at the root of its file system. The second command destroys
the newly created snapshots.
# zfs snapshot -r pool/home@yesterday
# zfs destroy -r pool/home@yesterday
SunOS 5.11 Last change: 23 Jul 2012 51
System Administration Commands zfs(1M)
Example 4 Disabling and Enabling File System Compression
The following command disables the compression property for
(...)
Esta página do manual em particular vem com 16 (!) tais exemplos ... Kudos para o Solaris!
(E eu admito que eu mesmo segui esses exemplos, em vez de ler a man page inteira para esse comando ...)
