Capítulo 29. Ajuda e documentação¶
Sumário
Resumo
O SUSE® Linux Enterprise Desktop é fornecido com várias fontes de informações e documentação, muitas das quais já integradas ao sistema instalado.
- Documentação em
/usr/share/doc Esse diretório de ajuda tradicional contém vários arquivos de documentação e notas de versão do seu sistema. Também contém informações de pacotes instalados no subdiretório
packages. Mais informações podem ser encontradas na Seção 29.1, “Diretório da documentação”.- Páginas de manual e páginas de informações para comandos do shell
Ao trabalhar com o shell, você não precisa saber de cor as opções de comandos. Tradicionalmente, o shell oferece ajuda integrada por meio das páginas de manual e de informações. Leia mais na Seção 29.2, “Páginas de manual” e na Seção 29.3, “Páginas de informações”.
- Centros de ajuda da área de trabalho
Os centros de ajuda da área de trabalho do KDE (KDE help center) e da área de trabalho do GNOME (Yelp) oferecem acesso centralizado aos recursos de documentação mais importantes no sistema na forma pesquisável. Esses recursos incluem ajuda online para os aplicativos instalados, páginas de manual, páginas de informações e os manuais do Novell/SUSE fornecidos com o produto.
- Pacotes de Ajuda separados para alguns aplicativos
Quando você instala o novo software com o YaST, a documentação do software é instalada automaticamente (na maioria dos casos) e normalmente aparece no centro de ajuda da área de trabalho. Contudo, alguns aplicativos, como o GIMP, podem ter diversos pacotes de ajuda online a serem instalados separadamente com o YaST e que não se integram aos centros de ajuda.
29.1. Diretório da documentação¶
O diretório tradicional para encontrar a documentação do sistema Linux instalado é /usr/share/doc. Geralmente, o diretório contém informações sobre os pacotes instalados no sistema, bem como notas de versão, manuais e muito mais.
![[Note]](static/images/note.png) | o conteúdo depende dos pacotes instalados |
|---|---|
No mundo do Linux, muitos manuais e outros tipos de documentação estão disponíveis na forma de pacotes, assim como um software. As informações encontradas em | |
29.1.1. Manuais Novell/SUSE¶
Fornecemos versões em HTML e PDF dos nossos manuais em idiomas diferentes. No subdiretório manual, você encontra as versões em HTML de quase todos os manuais Novell/SUSE disponíveis para o seu produto. Para obter uma visão geral de toda a documentação disponível para o seu produto, consulte o prefácio dos manuais.
Se houver mais de um idioma instalado, /usr/share/doc/manual poderá conter versões em idiomas diferentes dos manuais. As versões em HTML dos manuais Novell/SUSE também estão disponíveis no centro de ajuda de ambas as áreas de trabalho. Para obter informações sobre onde encontrar as versões em PDF e HTML dos manuais na mídia de instalação, consulte as Notas de Versão do SUSE Linux Enterprise Desktop. Elas estão disponíveis no sistema instalado, no diretório /usr/share/doc/release-notes/, ou online, na página da Web específica do produto em http://www.suse.com/doc/.
29.1.2. HOWTOs¶
Se o pacote howto estiver instalado no sistema, /usr/share/doc também conterá o subdiretório howto, no qual você encontra documentação adicional de muitas tarefas relacionadas a configuração e operação do software Linux.
29.1.3. Documentação do pacote¶
Em packages, você encontra a documentação incluída nos pacotes de software instalados no seu sistema. Para qualquer pacote, é criado um subdiretório /usr/share/doc/packages/. Ele geralmente contém arquivos README do pacote e às vezes exemplos, arquivos de configuração ou scripts adicionais. A lista a seguir apresenta arquivos típicos encontrados em nome_do_pacote/usr/share/doc/packages. Nenhuma dessas entradas é obrigatória e muitos pacotes podem incluir apenas alguns deles.
AUTHORSLista dos principais desenvolvedores.
BUGSBugs ou falhas conhecidos. Pode conter também um link para uma página do Bugzilla na Web, onde é possível pesquisar todos os bugs.
CHANGES,ChangeLogResumo de mudanças de versão para versão. Geralmente interessante para desenvolvedores, pois é bastante detalhado.
COPYING,LICENSEInformações sobre licenciamento.
FAQPerguntas e respostas coletadas em listas de endereçamento ou grupos de notícias.
INSTALLComo instalar esse pacotes no seu sistema. Visto que o pacote já estará instalado no momento em que você ler este arquivo, você poderá ignorar o conteúdo do arquivo com segurança.
README,README.*Informações gerais sobre o software. Por exemplo, a finalidade e o modo de usá-lo.
TODOItens ainda não implementados, mas que provavelmente serão no futuro.
MANIFESTLista de arquivos com um breve resumo.
NEWSDescrição do que há de novo nesta versão.
29.2. Páginas de manual¶
Páginas de manual são uma parte essencial de qualquer sistema Linux. Elas explicam o uso de um comando e todos os parâmetros e opções disponíveis. As páginas de manual podem ser acessadas com man seguido do nome do comando, por exemplo, man ls.
As páginas de manual são exibidas diretamente no shell. Para navegar nelas, mova-se para cima e para baixo com Page ↑ e Page ↓. Desloque-se entre o início e o fim do documento com Home e End. Conclua esta exibição pressionando Q. Aprenda mais sobre o próprio comando man com man man. Páginas de manual são classificadas em categorias, como mostrado na Tabela 29.1, “Páginas de manual — categorias e descrições” (extraída da página de manual do próprio comando man).
Tabela 29.1. Páginas de manual — categorias e descrições¶
|
Número |
Descrição |
|---|---|
|
1 |
Programas executáveis ou comandos de shell |
|
2 |
Chamadas do sistema (funções fornecidas pelo Kernel) |
|
3 |
Chamadas de biblioteca (funções em bibliotecas de programas) |
|
4 |
Arquivos especiais (geralmente encontrados em |
|
5 |
Convenções e formatos de arquivos ( |
|
6 |
Jogos |
|
7 |
Diversos (incluindo convenções e pacotes de macro); por exemplo, man(7), groff(7) |
|
8 |
Comandos de administração do sistema (geralmente apenas para o |
|
9 |
Rotinas de kernel (não padrão) |
Cada página de manual consiste em várias partes rotuladas NAME, SYNOPSIS, DESCRIPTION, SEE ALSO, LICENSING e AUTHOR. Pode haver seções adicionais disponíveis, dependendo do tipo de comando.
29.3. Páginas de informações¶
Páginas de informações são outra fonte importante de informações no sistema. Geralmente, elas são mais detalhadas do que as páginas de manual. Para ver a página de informações de um determinado comando, digite info seguido pelo nome do comando, por exemplo, info ls. Você pode procurar uma página de informações com um viewer diretamente no shell e exibir as seções diferentes, denominadas “nós”. Use Space para avançar e <— para voltar. Em um nó, você também pode procurar com Page ↑ e Page ↓, mas apenas Space e <— o levarão também para o nó anterior ou subsequente. Pressione Q para sair do modo de visualização. Nem todas as páginas de manual contém uma página de informações e vice-versa.
29.4. Recursos Online ¶
Além das versões online dos manuais do Novell instaladas em /usr/share/doc, é possível também acessar os manuais e a documentação específicos do produto na Web. Para uma visão geral de toda a documentação disponível para o SUSE Linux Enterprise Desktop, consulte a página de documentação específica do seu produto na Web em http://www.novell.com/documentation/ .
Se você estiver pesquisando mais informações relativas ao produto, também poderá consultar os seguintes sites:
- Novell Technical Support Knowledgebase (Base de Informações de Suporte Técnico da Novell)
A Novell Technical Support Knowledgebase (Base de Informações de Suporte Técnico da Novell) pode ser encontrada em http://www.novell.com/support/. Ela apresenta artigos escritos como soluções para problemas técnicos com o SUSE Linux Enterprise Desktop.
- Fóruns da Novell
Há vários fóruns em que você pode participar de discussões sobre produtos da Novell. Acesse http://forums.novell.com/ para obter uma lista.
- Cool Solutions
Uma comunidade online, que oferece artigos, dicas, Perguntas e Respostas e ferramentas gratuitas para fazer download: http://www.novell.com/communities/coolsolutions
- Documentação do KDE
Encontre documentação para vários aspectos do KDE adequada para usuários e administradores em http://www.kde.org/documentation/.
- Documentação do GNOME
A documentação para usuários, administradores e desenvolvedores do GNOME está disponível em http://library.gnome.org/.
- O Projeto de Documentação do Linux
O TLDP (The Linux Documentation Project — O Projeto de Documentação do Linux) é administrado por uma equipe de voluntários que escrevem a documentação relacionada ao Linux (acesse http://www.tldp.org). É provavelmente o recurso de documentação mais completo para Linux. O conjunto de documentos contém tutoriais para iniciantes, mas é direcionado principalmente a usuários experientes e administradores de sistema profissionais. O TLDP publica HOWTOs (Como Fazer), FAQs e guias (manuais) sob uma licença livre. Partes da documentação do TLDP também estão disponíveis no SUSE Linux Enterprise Desktop
Você também pode experimentar mecanismos de busca para fins gerais. Por exemplo, use os termos de pesquisa Ajuda Linux CD-RW ou Problema de conversão de arquivos OpenOffice se tiver problemas com a gravação de CDs ou a conversão de arquivos LibreOffice. O Google™ também tem um mecanismo de pesquisa específico do Linux em http://www.google.com/linux que lhe pode ser útil.