As páginas de "man" não são muito bem definidas ou às vezes até úteis, alternativas?

As páginas de "man" não são muito bem definidas ou às vezes até úteis, alternativas?

Sempre pensei em escrever um utilitário bash chamado realmanque explicaria comandos como nas páginas de manual, mas em vez de organizar os comandos em ordem alfabética pelas opções que o comando possui, ele simplesmente daria exemplos que o usuário médio precisaria.

Alguns comandos fornecem exemplos, mas como as páginas de manual são construídas por pessoas diferentes, não há controle central sobre a aparência de uma página de manual em termos de legibilidade.

Tome uma descrição mancomo 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 um exagero. Minha página de manual seria lida ...

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 aquela que a maioria dos usuários usaria não é muito construtivo.

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

Responder1

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 mangostaria de ver algo como:

É um programa que fornece mais detalhes de um comando.

Para obter informações como essas sobre comandos, use whatis. Isso resume as páginas de 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 fornece nenhuma informação sobre as opções de linha de comando para os comandos (mas, novamente, "É um programa que fornece mais detalhes sobre um comando").

Se você deseja uma quantidade intermediária de informações, o melhor caminho pode ser procurar o comando na Internet. Você pode pesquisar na web ou até mesmo na Wikipedia. Muitos dos comandos mais conhecidos e comumente usados ​​possuem artigos da Wikipedia. Por exemplo, veja os artigos sobrels,man(sobre páginas de manual em geral, mas inclui manconselhos de sintaxe),grep, efsck.

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

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 detalhado do que as páginas de manual, mas você pode achar que está mais bem organizado. E geralmente existem títulos descritivos que ajudam você a encontrar informações específicas, na minha experiência com muito mais facilidade do que em muitas páginas de manual.

Manuais GNUpode ser encontrado aqui. (Lembre-se nãotodosutilitários são utilitários GNU.) Muitos dos comandos mais comumente usados ​​não aparecem pelo nome, mas fazem parte deCoreutils GNU. Os manuais GNU podem ser visualizados online e também baixados em vários formatos de arquivo, alguns dos quais são adequados para visualização na linha de comando.

informação relacionada