Por que nenhum comando avisa o usuário para consultar uma página do manual sobre o uso incorreto? [fechadas]

0

Recentemente, dei um workshop sobre ferramentas do Linux e pedi aos alunos que consultassem as páginas de manual dos comandos, caso ocorressem erros.

No entanto, notei que o comando nunca retorna uma mensagem para ver a man page com o comando man .

A maioria dos comandos recomenda usar a opção --help , usar a página info , uma sinopse no uso ou apenas imprimir a mensagem de erro.

Eu estou querendo saber por que nenhum comando pede ao usuário para consultar a página de manual? Não seria esse o primeiro lugar para procurar quando está sendo usado incorretamente?

    
por Ketan 01.11.2016 / 00:02

2 respostas

4

Existe uma razão objetiva para isso.

--help é um sinalizador embutido no utilitário em si - incorporado no executável binário ou, se for um script, incorporado ao script.

As páginas man são armazenadas separadamente no sistema de arquivos a partir do próprio executável.

As páginas do manual podem estar faltando e o próprio executável ainda acessível.

Como um desenvolvedor de utilitários, apontar os usuários para um recurso de documentação que pode ou não estar presente em seu sistema faz menos sentido do que inlining as informações no próprio código.

Não apenas isso, mas a versão do executável e a versão da página man podem ou não se alinhar.

Eu encontrei isso, por exemplo, quando uma versão do Postgres foi enviada com um determinado pacote, e uma versão diferente do Postgres também foi instalada no sistema. man psql mostraria informações para a versão one , mas não foi a versão que você obteve executando psql . Se não houvesse --help flag, eu teria um grande mistério porque certas opções não funcionavam de acordo com a página man.

    
por 01.11.2016 / 00:41
0

Isso está sujeito a opiniões porque provavelmente não há estatísticas sobre como os conselhos nas mensagens de erro são apresentados.

O laço predominante que eu vi é imprimir a mensagem de uso (que pode ser mais de uma linha), talvez porque dizer a alguém para ler a página de manual era desnecessário. Dizer a alguém para ler a mensagem --help é redundante e apenas uma pequena fração aconselha a leitura da página de informações.

Todos os programas que desenvolvi fornecem uma mensagem de uso (geralmente várias linhas).

    
por 01.11.2016 / 00:12