Aplica-se a SUSE Linux Enterprise Desktop 15 SP5

40 Ajuda e documentação #

O SUSE® Linux Enterprise Desktop vem 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 armazena 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 no Seção 40.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 no Seção 40.2, “Páginas de manual” e no Seção 40.3, “Páginas de informações”.
Centro de ajuda da área de trabalho: O centro de ajuda da área de trabalho do GNOME (Ajuda) oferece acesso centralizado aos recursos de documentação mais importantes no sistema de 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 SUSE fornecidos com o produto.
Pacotes de ajuda separados para determinados aplicativos: Quando um novo software é instalado com o YaST, a respectiva documentação, em geral, é instalada automaticamente e aparece no centro de ajuda da área de trabalho. Porém, determinados aplicativos, como o GIMP, podem ter diversos pacotes de ajuda online que podem ser instalados separadamente com o YaST e que não se integram aos centros de ajuda.

40.1 Diretório da documentação #

O diretório tradicional para encontrar a documentação do sistema Linux instalado é /usr/share/doc. O diretório contém informações sobre os pacotes instalados no sistema, além de notas de versão, manuais e muito mais.

Nota: 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, como um software. O volume e o tipo das informações encontradas em /usr/share/docs também dependem dos pacotes (documentação) instalados. Se você não encontrar os subdiretórios mencionados aqui, verifique se os respectivos pacotes estão instalados em seu sistema e adicione-os com o YaST, se necessário.

40.1.1 Manuais do SUSE #

Fornecemos versões em HTML e PDF de nossos manuais em idiomas diferentes. No subdiretório manual, você encontra as versões em HTML de quase todos os manuais do 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 dos manuais em idiomas diferentes. As versões em HTML dos manuais do 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 em /usr/share/doc/release-notes/ ou online, na página da Web específica do produto em https://www.suse.com/releasenotes//.

40.1.2 Documentação do pacote #

Em packages, encontre a documentação incluída nos pacotes de software instalados no sistema. Para cada pacote, é criado um subdiretório /usr/share/doc/packages/PACKAGENAME. 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 /usr/share/doc/packages. Nenhuma destas entradas é obrigatória, e muitos pacotes incluem apenas algumas delas.

AUTHORS: Lista dos principais desenvolvedores.
BUGS: Bugs 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 , ChangeLog: Resumo de mudanças de versão para versão. É interessante para os desenvolvedores, pois é detalhado.
COPYING , LICENSE: Informações sobre licenciamento.
FAQ: Perguntas e respostas coletadas em listas de endereçamento ou grupos de notícias.
INSTALL: Como 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.
TODO: Itens ainda não implementados, mas que podem ser no futuro.
MANIFEST: Lista de arquivos com um breve resumo.
NEWS: Descrição do que há de novo nesta versão.

40.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 40.1, “Páginas de manual – categorias e descrições” (extraída da página de manual do próprio comando man).

Tabela 40.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 `/dev`)
5	Convenções e formatos de arquivos (`/etc/fstab`)
6	Jogos
7	Diversos (incluindo convenções e pacotes de macro); por exemplo, man(7), groff(7)
8	Comandos de administração de sistema (geralmente, apenas para `root`)
9	Rotinas de kernel (não padrão)

Cada página de manual consiste em várias partes chamadas NAME, SYNOPSIS, DESCRIPTION, SEE ALSO, LICENSING e AUTHOR. Pode haver seções adicionais disponíveis, dependendo do tipo de comando.

40.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. Elas abrangem mais do que as opções de linha de comando e, às vezes, incluem tutoriais completos ou documentação de referência. 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 todo comando vem com uma página de informações e vice-versa.

40.4 Recursos online #

Para obter uma visão geral de toda a documentação disponível referente ao SUSE Linux Enterprise Desktop, visite as páginas da documentação específica do produto na Web em https://documentation.suse.com/.

Se você estiver pesquisando mais informações relativas ao produto, também poderá consultar os seguintes sites:

Suporte técnico da SUSE: Você encontra o Suporte Técnico do SUSE em https://www.suse.com/support/, em caso de dúvidas ou soluções para problemas técnicos.
Comunidade de usuários do SUSE Linux Enterprise Desktop: SUSE and Rancher Community
Blog da SUSE: O blog da SUSE inclui artigos, dicas, perguntas e respostas: https://www.suse.com/c/blog/
Documentação do GNOME: A documentação para usuários, administradores e desenvolvedores do GNOME está disponível em https://help.gnome.org/.
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 https://www.tldp.org). É provavelmente o recurso de documentação mais completo do 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 pesquisa gerais. Por exemplo, use os termos de pesquisa Linux CD-RW help ou OpenOffice file conversion problem se você tiver problemas para gravar CDs ou converter arquivos do LibreOffice.