Ajuda

Geralmente há horas em que você precisa de ajuda com um comando específico, configurando um programa ou fazendo algum hardware funcionar. Talvez você simplesmente quer entender um comando melhor ou ver quais opções estão disponíveis para utilizar. Com sorte, há uma variedade de formas de encontrar a ajuda que você procura. Depois de instalar o Zenwalk você tem a opção de instalar os pacotes do repositório [extra/f] que inclui FAQs (perguntas freqüentes) e HOWTOs (como fazer). Programas também vêm com "ajuda" sobre suas opções, arquivos de configuração e uso.

Ajuda do sistema

man

O comando man (abreviatura para "manual") é a forma tradicional de documentação offline nos sistemas operacionais Unix e Linux. Comprimidas em formatos especiais, mas "man pages" (páginas de manual) são escritas para a maioria de comandos e são distribuídas com o próprio software. Executar man alguma_coisa irá visualisar a página do manual do comando específico. No nosso exemplo, esse seria o programa imaginário alguma_coisa.

Como você pode imaginar, a quantia de páginas man podem crescer rapidamente, tornando-se muito confuso e complicado o seu uso, até mesmo para usuários avançados. Por esta razão, as páginas man são agrupadas em seções enumeradas. Este sistema está em uso há muito tempo; tanto que você verá comandos, programas, e até mesmo funções de bibliotecas de programação referenciadas pelo número de sua seção man.

Por exemplo :

Você deve ver uma referência para o man. A numeração diz que aquele "man" está documentada na seção 1 (comandos do usuário) ; você pode especificar que quer a página do manual seção 1 para o comando man 1 man. Especificando a seção que o man deve procurar é útil no caso de múltiplos itens com o mesmo nome.

Tabela 2.1. Seções da "Man Page"

  Seções		Conteúdo
  Seção 1		comandos do usuário (apenas uma introdução)
  Seção 2		chamadas do sistema
  Seção 3		chamadas da biblioteca C
  Seção 4		dispositivos (v.g. sd, sr)
  Seção 5		formatos de arquivos e protocolos (v.g. wtmp, /etc/passwd, nfs)
  Seção 6		jogos (apenas uma introdução)
  Seção 7		convenções, macro pacotes, etc. (v.g. nroff, ascii)
  Seção 8		administração do sistema (apenas uma introdução)

Em adição ao man, há comandos whatis (o que é) e apropos (a propósito) disponíveis, que são usados para que seja mais fácil encontrar informações no sistema man.

O comando whatis (o que é) dá uma breve descrição do sistema de comandos, algo como uma "referência de bolso" dos comandos.

Exemplo :

  % whatis whatis
  whatis (1)  - search the whatis database for complete words

O comando apropos é utilizado para procurar por uma "man page" contendo uma palavra-chave.

Exemplo :

  % apropos wav
  cdda2wav     (1)  - a sampling utility that dumps CD audio data into wav sound files
  netwave_cs   (4)  - Xircom Creditcard Netwave device driver
  oggdec       (1)  - simple decoder, Ogg Vorbis file to PCM audio file (WAV or RAW)
  wavelan      (4)  - AT&T GIS WaveLAN ISA device driver
  wavelan_cs   (4)  - AT&T GIS WaveLAN PCMCIA device driver
  wvlan_cs     (4)  - Lucent WaveLAN/IEEE 802.11 device driver
  fadeplot     (6)  - draws a waving ribbon following a sinusoidal path
  flag         (6)  - draws a waving flag, containing text or an image
  interference (6)  - decaying sinusoidal waves

Se quiser maiores informações sobre algum desses comandos, leia as páginas man deles para detalhes ;)

O diretório /usr/doc

A fonte para a maioria dos pacotes que construímos vem com alguma documentação : arquivos README, instruções de uso, arquivos de licença etc. Alguma documentação que vem com a fonte está incluída e instalada no seu sistema no diretório /usr/doc. Cada programa irá (geralmente) instalar sua própria documentação nessa ordem:

`/usr/doc/$programa-$versão`

Onde $programa é o nome do programa que você quer ler e $versão é (obviamente) a versão atual do pacote de software instalado no seu sistema.

Por exemplo, para ler a documentação do comando man você deve encaminhar (cd) para :

`$ cd /usr/doc/man-$versão`

Se ler a(s) "man page(s)" apropriadas não lhe der nenhuma informação, ou encaminhar o que procura em particular, o diretório `/usr/doc` será sua próxima parada.

HOWTOS e mini-HOWTOS

É no mais verdadeiro espírito da comunidade "Open Source" que nos trazem a coleção HOWTO/mini-HOWTO. Esses arqivos são exatamente o que eles parecem - documentos e guias descrevendo como fazer alguma coisa. Se você instalou a coleção HOWTO, eles serão instalados no `/usr/doc/Linux-HOWTOs` e os mini-HOWTOs para `/usr/doc/Linux-mini-HOWTOs`.

Também incluídos na mesma série de pacotes está a coleção de FAQs, ou seja Frequently Asked Questions (perguntas freqüentes).

Esses documentos estão escritos no estilo "pergunta e resposta" para (surpresa) perguntas frequentes. As FAQs podem geralmente ser o melhor lugar para se procurar se você está procurando por um "Quick Fix" (conserto rápido) em algo. Se você decidir instalar os FAQs, você os encontrará no diretório /usr/doc/Linux-FAQs.

Esses arquivos valem a pena ler quando você não tem certeza de como proceder em algo. Eles cobrem uma gama excelente de tópicos, melhor até do que se fosse altamente detalhado. Muito bom !

Ajuda on-line

Em adição à documentação contida no sistema Zenwalk Linux instalado, há uma vasta multitude de recursos online disponíveis para você aprender também.

O site oficial e o Fórum

O site oficial do Zenwalk Linux

O site oficial do Zenwalk Linux contém informações relevantes para a última versão incluindo a versão atual do changelog (mudanças do sistema), bem como o changelog da versão de desenvolvimento (também chamada snapshot). Você pode achar ainda mais ajuda no Fórum.

Suporte por E-mail

O Zenwalk tem algumas listas de discussões dedicadas: