documentação pode ser uma tarefa árdua e chato, você deve pelo menos ler
Vicfred
1
BTW - a menos que tenha uma versão simplificada de um dispositivo embutido que você faz tem as páginas do manual, mas você pode precisar instalá-los com o seu gerente primeiro pacote (FSM só sabe por que as distribuições não incluem as páginas do manual do pacakage padrão definido, mas eu já vi isso).
dmckee --- ex-moderador gatinho
@ Victor: Se você se sente assim, deve examinar se pode encontrar alguém para escrevê-lo. Se você não gostar, o resultado final pode sofrer com isso, e realmente, existem pessoas que gostam de escrever essas coisas - no groff, no LaTeX etc. (portanto, não precisa ser "não técnico") , ou).
Emanuel Berg
@dmckee: Tem a ver com as licenças de algumas das páginas de manual. Por exemplo, com o Debian, você precisa instalar a página man muito útil do gcc (13972 linhas!) Explicitamente, pois o pessoal do Debian considera o licenciamento como livre. Mas é muito fácil remediar com o aptitude, por isso não é um problema para nós, usuários.
Emanuel Berg
Respostas:
44
Existe um manual, você só precisa saber onde ele está. Pode ser acessado com o mancomando Se você não souber como usá-lo, digite man man. O mancomando é muito importante; lembre-se mesmo se você esquecer todo o resto.
O manual contém informações detalhadas sobre uma variedade de tópicos, que são separados em várias seções:
Comandos gerais
Chamadas do sistema
Funções da biblioteca, cobrindo em particular a biblioteca padrão C
Arquivos especiais (geralmente dispositivos, aqueles encontrados em /dev) e drivers
Formatos de arquivo e convenções
Jogos e protetores de tela
Diversos
Comandos e daemons de administração do sistema
A notação ls(1)refere-se à lspágina na seção 1. Para ler, digite man 1 lsou man ls.
Para evitar ser dito para ler o manual quando você faz uma pergunta, tente man command, apropos command, command -?, command --help, e algumas pesquisas do Google. Se você não entender algo no manual, cite-o na sua pergunta e tente explicar o que você não entende. Geralmente, quando eles pedem para você ler o manual, é porque eles acham que será mais benéfico para você do que uma resposta simples e incompleta. Se você não souber quais páginas de manual são relevantes, pergunte.
Corrigir. Acho que também devemos mencionar o infopovo GNU? Além disso, uma dica: se você usa o Emacs, tente M-x man- como você provavelmente conhece bem o seu editor (atalhos etc.), navegar e interagir com as páginas de manual será muito suave.
Emanuel Berg
2
Outras dicas úteis: leia algumas páginas do manual até o fim e observe os títulos das See Alsoseções (a seção pode ser imensamente útil quando você está perto, mas não chega lá). Aprenda também a usar seu pager ( moreou less), pois ele fornece a interface de pesquisa para a página de manual (muito útil, por exemplo, man bash(que você nunca deve enviar para a impressora de linha, diz a voz de uma experiência amarga)).
dmckee --- ex-moderador gatinho
28
Penso que o provérbio chinês frequentemente citado explica bem:
Se você der a um homem um peixe, ele fará uma única refeição. Se você ensiná-lo a pescar, ele comerá a vida toda.
Enquanto você pode pensar "Mas é apenas uma pergunta, por que eles não podem me dizer a resposta", é porque os fóruns ficam tão cheios de pessoas fazendo perguntas óbvias que seria difícil que perguntas sobre coisas mais esotéricas fossem notadas . Portanto, não pense neles como eles o afastam - pense neles como ajudando você a se ajudar.
Por exemplo, é trivial encontrar a resposta para "Como uso o grep para fazer uma pesquisa sem distinção entre maiúsculas e minúsculas", especialmente quando você é lembrado de procurar na página do manual. Mas para uma pergunta como "Como faço uma pesquisa sem distinção entre maiúsculas e minúsculas no primeiro campo de um arquivo, mas diferencia maiúsculas de minúsculas nos campos restantes?", Não existe uma página de manual simples que lhe dirá a resposta, e há uma infinidade de maneiras de responder.
Acredito que isso ocorre porque a maioria dos especialistas prefere ensinar alguém a aprender, em vez de ensinar-lhes um fato ou dois isolados. Dizer a alguém para ler a página de manual está tentando convencer alguém a seguir o caminho de aprender a aprender sozinho.
Lembro-me, mas não consigo pesquisar no Google, um estudo que afirmava que a diferença entre um iniciante em Unix e um especialista em Unix (talvez não tão diferente de um iniciante ou especialista em Linux) era que o especialista sabia como procurar as coisas. Ao tentar encontrar esse estudo, encontrei Compreensão imediata na produção de comandos do UNIX , o que parece contradizer o estudo que me lembro. Que pena: tudo o que você precisa fazer é conhecer um monte de fatos para ser um especialista. Mas, nesse caso, pedir a alguém para ler o manual também pode servir para preencher o questionador com conhecimento, levando à produção de outro especialista em Unix ou Linux.
Há também um investimento de curto e longo prazo no novato que faz a pergunta. Certamente leva menos tempo para dizer "use ls -ltr", por exemplo, do que ensinar ao novato sobre a lista de arquivos, opções e assim por diante. Mas se o especialista precisar responder a mais de 3 ou 4 perguntas, o valor a longo prazo de investir em alguém para ler o manual se tornará óbvio.
Respostas:
Existe um manual, você só precisa saber onde ele está. Pode ser acessado com o
mancomando Se você não souber como usá-lo, digiteman man. Omancomando é muito importante; lembre-se mesmo se você esquecer todo o resto.O manual contém informações detalhadas sobre uma variedade de tópicos, que são separados em várias seções:
/dev) e driversA notação
ls(1)refere-se àlspágina na seção 1. Para ler, digiteman 1 lsouman ls.Para evitar ser dito para ler o manual quando você faz uma pergunta, tente
man command,apropos command,command -?,command --help, e algumas pesquisas do Google. Se você não entender algo no manual, cite-o na sua pergunta e tente explicar o que você não entende. Geralmente, quando eles pedem para você ler o manual, é porque eles acham que será mais benéfico para você do que uma resposta simples e incompleta. Se você não souber quais páginas de manual são relevantes, pergunte.fonte
infopovo GNU? Além disso, uma dica: se você usa o Emacs, tenteM-x man- como você provavelmente conhece bem o seu editor (atalhos etc.), navegar e interagir com as páginas de manual será muito suave.See Alsoseções (a seção pode ser imensamente útil quando você está perto, mas não chega lá). Aprenda também a usar seu pager (moreouless), pois ele fornece a interface de pesquisa para a página de manual (muito útil, por exemplo,man bash(que você nunca deve enviar para a impressora de linha, diz a voz de uma experiência amarga)).Penso que o provérbio chinês frequentemente citado explica bem:
Enquanto você pode pensar "Mas é apenas uma pergunta, por que eles não podem me dizer a resposta", é porque os fóruns ficam tão cheios de pessoas fazendo perguntas óbvias que seria difícil que perguntas sobre coisas mais esotéricas fossem notadas . Portanto, não pense neles como eles o afastam - pense neles como ajudando você a se ajudar.
Por exemplo, é trivial encontrar a resposta para "Como uso o grep para fazer uma pesquisa sem distinção entre maiúsculas e minúsculas", especialmente quando você é lembrado de procurar na página do manual. Mas para uma pergunta como "Como faço uma pesquisa sem distinção entre maiúsculas e minúsculas no primeiro campo de um arquivo, mas diferencia maiúsculas de minúsculas nos campos restantes?", Não existe uma página de manual simples que lhe dirá a resposta, e há uma infinidade de maneiras de responder.
fonte
Acredito que isso ocorre porque a maioria dos especialistas prefere ensinar alguém a aprender, em vez de ensinar-lhes um fato ou dois isolados. Dizer a alguém para ler a página de manual está tentando convencer alguém a seguir o caminho de aprender a aprender sozinho.
Lembro-me, mas não consigo pesquisar no Google, um estudo que afirmava que a diferença entre um iniciante em Unix e um especialista em Unix (talvez não tão diferente de um iniciante ou especialista em Linux) era que o especialista sabia como procurar as coisas. Ao tentar encontrar esse estudo, encontrei Compreensão imediata na produção de comandos do UNIX , o que parece contradizer o estudo que me lembro. Que pena: tudo o que você precisa fazer é conhecer um monte de fatos para ser um especialista. Mas, nesse caso, pedir a alguém para ler o manual também pode servir para preencher o questionador com conhecimento, levando à produção de outro especialista em Unix ou Linux.
Há também um investimento de curto e longo prazo no novato que faz a pergunta. Certamente leva menos tempo para dizer "use ls -ltr", por exemplo, do que ensinar ao novato sobre a lista de arquivos, opções e assim por diante. Mas se o especialista precisar responder a mais de 3 ou 4 perguntas, o valor a longo prazo de investir em alguém para ler o manual se tornará óbvio.
fonte