As páginas de “homem” não são muito bem definidas ou até mesmo úteis, às vezes, alternativas?

Question

Eu sempre pensei em escrever um utilitário bash chamado realman , que explicaria comandos como nas man pages, mas em vez de colocar os comandos em ordem alfabética pelas opções que o comando tem, ele simplesmente dava exemplos do usuário médio precisaria.

Alguns comandos dão exemplos, mas como as páginas do manual são construídas por pessoas diferentes, não há controle central sobre o que uma página do manual deve ter como legibilidade.

Pegue uma descrição de man como exemplo

NAME
       man - an interface to the on-line reference manuals

SYNOPSIS
       man  [-C  file]  [-d]  [-D] [--warnings[=warnings]] [-R encoding] [-L locale] [-m system[,...]] [-M path] [-S list] [-e extension] [-i|-I] [--regex|--wildcard]
       [--names-only] [-a] [-u] [--no-subpages] [-P pager] [-r prompt] [-7] [-E  encoding]  [--no-hyphenation]  [--no-justification]  [-p  string]  [-t]  [-T[device]]
       [-H[browser]] [-X[dpi]] [-Z] [[section] page ...] ...
       man -k [apropos options] regexp ...
       man -K [-w|-W] [-S list] [-i|-I] [--regex] [section] term ...
       man -f [whatis options] page ...
       man  -l  [-C  file]  [-d]  [-D]  [--warnings[=warnings]]  [-R  encoding]  [-L  locale]  [-P pager] [-r prompt] [-7] [-E encoding] [-p string] [-t] [-T[device]]
       [-H[browser]] [-X[dpi]] [-Z] file ...
       man -w|-W [-C file] [-d] [-D] page ...
       man -c [-C file] [-d] [-D] page ...
       man [-hV]

É totalmente exagerado. Minha página man iria ler ...

Its a program gives you more details of a command.
eg. "man bash" would explain more about the command "bash"

Ter que ler todas as opções de um comando para descobrir que uma opção que a maioria dos usuários usaria não é muito construtiva.

Então, minha pergunta é simples: existe um programa do tipo "realman" disponível no Ubuntu através da linha de comando que é mais orientada ao usuário como oposta ao administrador do sistema?

    

Answer 1

O que você está pedindo pode não estar bem definido. Nem todo comando tem "aquela opção que a maioria dos usuários usaria".

No entanto, você disse que, para man , gostaria de ver algo como:

  

É um programa que fornece mais detalhes sobre um comando.

Para informações como essa sobre comandos, use whatis . Isso resume as páginas do manual.

ek@Kip:~$ whatis man
man (7)              - macros to format man pages
man (1)              - an interface to the on-line reference manuals
ek@Kip:~$ whatis whatis
whatis (1)           - display manual page descriptions
ek@Kip:~$ whatis ls
ls (1)               - list directory contents
LS (6)               - display animations aimed to correct users who accident...
ek@Kip:~$ whatis ping
ping (8)             - send ICMP ECHO_REQUEST to network hosts

Isso ainda não lhe dá nenhuma informação sobre as opções de linha de comando para os comandos (mas também não "é um programa que fornece mais detalhes de um comando").

Se você quiser uma quantidade intermediária de informações, o melhor caminho pode ser procurar o comando na Internet. Você pode pesquisar na web por ele ou até mesmo na Wikipédia. Muitos dos comandos mais conhecidos e comumente usados possuem artigos da Wikipedia. Por exemplo, veja os artigos em ls , man (sobre manpages em geral, mas inclui man conselho de sintaxe), grep e fsck .

Você pode navegar na web a partir da linha de comando, se desejar, usando um navegador da Web que suporte o modo de linha de comando (como links2 ), ou um navegador somente de linha de comando (como lynx ).

Finalmente, observe que muitos utilitários de linha de comando no Ubuntu vêm do projeto GNU, que fornece excelente documentação. Muitas vezes é mais longo e mais detalhado do que as páginas de manual, mas você pode encontrá-lo melhor organizado. E geralmente há títulos descritivos que ajudam você a encontrar informações específicas, na minha experiência, muito mais facilmente do que em muitas páginas do manual.

Manuais GNU podem ser encontrados aqui. (Lembre-se que não todos utilitários são utilitários GNU.) Muitos dos comandos mais usados não aparecem pelo nome, mas são parte de GNU coreutils . Manuais GNU podem ser visualizados online e também podem ser baixados em vários formatos de arquivos, alguns dos quais são adequados para visualização na linha de comando.