Aplica-se a SUSE Linux Enterprise Desktop 15 SP6

40 Ajuda e documentação #

O SUSE® Linux Enterprise Desktop acompanha várias fontes de informações e documentações, disponíveis online ou integradas ao sistema instalado.

Documentação do produto: A documentação abrangente do SUSE Linux Enterprise Desktop está disponível em https://documentation.suse.com/#sled. Os tópicos abordados variam de implantação, upgrade e administração do sistema a virtualização, ajuste e segurança do sistema, entre outros.
Documentação em /usr/share/doc: Esse diretório contém as notas de versão do seu sistema (no subdiretório release-notes). Ele também contém informações de pacotes instalados no subdiretório packages. Mais informações podem ser encontradas na 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 na Seção 40.2, “Páginas de manual” e na 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 central à documentação da área de trabalho do GNOME.
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 as notas de versão e informações sobre os pacotes instalados no sistema, além de manuais e muito mais.

Nota: O conteúdo depende dos pacotes instalados

No mundo do Linux, os manuais e outros tipos de documentação estão disponíveis na forma de pacotes, como um software. A quantidade e os tipos de informações disponíveis em /usr/share/doc também dependem dos pacotes (de 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 Notas de versão #

Disponibilizamos versões em HTML, PDF, RTF e texto das 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/index.html.

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, na qual é 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: Recursos planejados para o 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 (normalmente encontrados em `/dev`)
5	Formatos e convenções de arquivo (`/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 (normalmente, 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. Normalmente, 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 levam também para o nó anterior ou seguinte. 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: 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://tldp.org/). Trata-se de um recurso de documentação abrangente 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, perguntas frequentes e guias (manuais) sob uma licença gratuita. Partes da documentação do TLDP também estão disponíveis no SUSE Linux Enterprise Desktop.