Ajuda e documentação

Sumário

27.1. Diretório da documentação
27.2. Páginas de manual
27.3. Páginas de informações

Resumo

O SUSE® Linux Enterprise Desktop é fornecido com várias fontes de informações e documentação, muitas das quais já integradas no 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. Mais informações podem ser encontradas na Seção 27.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 27.2, “Páginas de manual” e na Seção 27.3, “Páginas de informações”.
Centros de ajuda da área de trabalho: Os centros de ajuda da área de trabalho KDE (KDE help center) e da área de trabalho 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.

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.

o conteúdo depende dos pacotes instalados

	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 `/usr/share/docs` 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 no seu sistema e adicione-os com o YaST, se necessário.

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 /usr/share/docs 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 no seu sistema e adicione-os com o YaST, se necessário.

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.novell.com/documentation/.

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.

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/nome_do_pacote. 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 dessas entradas é obrigatória e muitos pacotes podem incluir apenas alguns deles.

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. Geralmente interessante para desenvolvedores, pois é bastante 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 provavelmente serão no futuro.
MANIFEST: Lista de arquivos com um breve resumo.
NEWS: Descrição do que há de novo nesta versão.