Como encontrar documentação em meu próprio sistema GNU / Linux

Muitos daqueles novos para o mundo GNU / Linux estão cheios de dúvidas e não conseguem encontrar uma resposta rápida às suas preocupações, às vezes nem têm uma ligação para aceder a um fórum de suporte e acabam por ter a ideia de que o Linux é muito difícil para eles.

Muitos dos que se encontram nesta situação não sabem que o nosso próprio sistema contém boa parte das respostas às nossas preocupações iniciais. Existem essencialmente três fontes de documentação em um sistema GNU / Linux: páginas de manual (páginas de manual), páginas de informações (páginas de informações) e manuais de aplicativos empacotados em / usr / share / doc.

Neste artigo, detalharemos cada uma dessas fontes.

---

Páginas de homem

As páginas de manual ou "páginas de manual" são as formas clássicas de documentação de referência no Linux e Unix. Idealmente, você pode pesquisar as páginas de manual para obter ajuda para qualquer comando, arquivo de configuração ou rotina de biblioteca.

Na prática, o Linux é um software livre, e algumas páginas não foram escritas ou mostram sua idade. No entanto, as páginas do manual são o primeiro lugar para procurar quando você precisar de ajuda. Para acessar as páginas de manual, basta digitar homem seguido do tema a ser investigado.

Uma paginação será iniciada, então você pressionará q quando eu terminar de ler. Por exemplo, para encontrar informações sobre o comando ls, Eu escreveria:

$ homem ls

Conhecendo as partes das páginas do manual, pode ser útil pular rapidamente para as informações de que você precisa. Você encontrará as seguintes seções na página do manual (Quadro 1):

Tabela 1: Páginas manuais

NOME	Nome e descrição do comando
SINOPSE	Como usar o comando
DESCRIÇÃO	Explicação detalhada de como o comando funciona
EXEMPLOS	Sugestões de como usar o comando
VEJA TAMBÉM	Tópicos relacionados (geralmente em páginas de manual)

Seções das páginas de manual

Os arquivos que compõem as páginas de manual são armazenados em / usr / share / man (ou em / usr / man em alguns sistemas antigos). Nesse diretório, você descobrirá que as páginas do manual estão organizadas nas seguintes seções (Quadro 2).

Tabela 2: Seções das páginas do manual

man1	Programas do usuário
man2	Chamadas de sistema
man3	Funções de biblioteca
man4	Arquivos especiais
man5	Formato de arquivo
man6	Jogos
man7	Miscelânea

Múltiplas páginas de manual

Alguns tópicos existem em mais de uma seção. Para demonstrar isso, vamos usar o comando o que é, que mostra todas as páginas de manual disponíveis para este tópico:

$ o que é printf

printf (1) - formatar e imprimir dados

printf (3) - conversão de saída formatada

Neste caso, homem printf estaria na página da seção 1 (Programas do usuário). Se fôssemos escrever um programa C, estaríamos mais interessados ​​na página da seção 3 (Funções de biblioteca). Você pode chamar uma certa seção de páginas de manual especificando-a na linha de comando, para solicitar printf, nós podemos escrever:

$ homem 3 printf

Encontrando a página de manual correta

Às vezes é difícil encontrar algumas páginas de manual sobre um determinado tópico. Nesse caso, você pode usar homem -k para encontrar a seção NAME das páginas de manual. Saiba que esta é uma pesquisa de substring, algo como homem -k ls forneceria muitos resultados, aqui está um exemplo usando uma palavra mais específica:

$ man -k whatis whatis (1) - imprime as descrições da página do manual

Tudo sobre a propósito

O exemplo anterior nos trouxe mais alguns pontos. Primeiro, o comando a propósito é exatamente equivalente a homem -k, (Na verdade, vou lhe dar um segredo. Quando você executa homem -k realmente correr a propósito nos bastidores).

---

A linha de código MANPATH

Agora nos voltamos para o segundo tipo de documentação que encontraremos em nosso sistema GNU / Linux. Por padrão, o programa man procura as páginas man em / usr / share / man, / usr / local / man, / usr / X11R6 / man e possivelmente / opt / man. às vezes, você pode encontrar o que precisa adicionando um caminho adicional ao caminho de pesquisa. Sendo esse o caso, basta editar /etc/man.conf em um editor de texto e adicione uma linha como a seguinte:

MANPATH / opt / man

Daqui em diante, qualquer página de manual no diretório / opt / man será encontrada. Lembre-se de que você precisa correr novamente fazer o que é para adicionar essas novas páginas de manual ao banco de dados o que é.

---

Informação GNU

Uma das deficiências das páginas de manual é que elas não suportam hipertexto, então você não pode pular facilmente de uma página para outra. Amigos do GNU reconhecem essa falha, então eles inventaram outro formato de documentação: as páginas "info".

Muitos dos programas GNU vêm com uma extensa documentação no formato de página de informações. Você pode começar a ler as páginas de informações com o comando info:

Traremos assim um índice de todas as páginas de informação disponíveis no sistema. Você pode movê-los com as setas do teclado, seguir os "links" (indicados com uma estrela) usando a tecla Enter e para sair pressionando q. As chaves são baseadas no Emacs, então deve ser fácil de navegar se você estiver familiarizado com esse editor.

Para obter mais informações com o uso de info, leia sua página de informações. Você deve ser capaz de navegá-los usando as teclas mencionadas acima:

$ informações informações

---

/ usr / share / doc

Existe uma última fonte que pode ajudá-lo no sistema Linux. Muitos programas vêm equipados com documentação adicional em outros formatos: texto, PDF, PostScript, HTML, para citar alguns.

Dê uma olhada em / usr / share / doc (/ usr / doc em sistemas antigos). Você encontrará uma longa lista de diretórios, cada um dos quais acompanha os aplicativos em seu sistema. A pesquisa nesta documentação geralmente pode revelar algo interessante, como tutoriais ou documentação técnica adicional. Uma verificação rápida revela uma tonelada de material disponível para leitura:

$ cd / usr / share / doc

$ find. -tipo f | wc -l

---

Em outros artigos, iremos nos referir a fontes externas de documentação, como The Linux Documentation Project (LDP), listas de discussão e grupos de notícias.

Fonte: Artigo retirado de GUTL e escrito por Maikel Llamaret Heredia. Links: https://blog.desdelinux.net, http://www.raybenjamin.com, http://forum.codecall.net, http://www.linfo.org,  http://www.esdebian.org