Capítulo 2 Documentação e Suporte

2.1. Quais bons livros existem sobre FreeBSD?
2.2. A documentação está disponível em outros formatos, como texto puro (ASCII) ou Postscript?
2.3. Onde posso obter informações sobre as listas de discussão FreeBSD?
2.4. Que grupos de notícias (news groups) existem sobre o FreeBSD?
2.5. Existem canais de bate-papo retransmitido via Internet (IRC) FreeBSD?
2.6. Onde eu consigo treinamento em e suporte comercial ao FreeBSD?

2.1. Quais bons livros existem sobre FreeBSD?

O projeto FreeBSD produz um grande número de documentos disponíveis em http://www.FreeBSD.org/docs.html. Além destes, outros livros recomendados são referenciados nas Bibliografias disponíveis ao final deste FAQ e do Manual do FreeBSD.

2.2. A documentação está disponível em outros formatos, como texto puro (ASCII) ou Postscript?

Claro. A documentação pode ser obtida em uma variedade de formatos e opções de compressão no servidor FTP do FreeBSD, sob o diretório /pub/FreeBSD/doc/.

A documentação é organizada em diversas categorias, como:

  • O nome do documento, como faq ou Manual do FreeBSD.

  • A codificação e língua do conteúdo do documento. Tal categorização é baseada nos nomes de localização, que podem ser encontrados sob /usr/share/locale no seu FreeBSD. Atualmente existem documentos nas seguintes línguas e codificações:

    Nome Significado
    en_US.ISO8859-1 Inglês Americano
    de_DE.ISO8859-1 Alemão
    es_ES.ISO8859-1 Espanhol
    fr_FR.ISO8859-1 Francês
    ja_JP.eucJP Japonês (codificação EUC)
    ru_RU.KOI8-R Russo (codificação KOI8-R)
    zh_TW.Big5 Chinês (codificação Big5)

    Nota: Alguns documentos podem não estar disponíveis em todas as línguas.

  • Formato da documentação. A documentação é produzida em vários formatos. Cada qual com suas vantagens e desvantagens. Alguns formatos são mais apropriados para leitura on-line, enquanto outros são mais agradéveis estéticamente em formato impresso. Disponibilizar a documentação em todos estes formatos, garante que os leitores poderão sempre ler os trechos de seu interesse, tanto no monitor do seu computador quanto em papel impresso. Atualmente os formatos disponíveis são:

    Formato Significado
    html-split Uma série de pequenos documentos HTML, devidamente ligados.
    html Um único grande arquivo HTML contendo todo o documento.
    pdb Formato de banco de dados pra Palm Pilot, para ser usado com o visualizador iSilo.
    pdf PDF (Formato de Documento Portável) da Adobe
    ps Postscript
    rtf RTF (Formato de Texto Enriquecido) da Microsoft[a]
    txt Texto puro
    Notas:
    a. A númeração de página não é automaticamente atualizada quando este tipo de arquivo é aberto no Word. Digite CTRL+A, CTRL+END, F9 depois de abrir o documento no Word, para atualizar a numeração das páginas.
  • As técnicas de compressão e empacotamento dos arquivos. Atualmente, 3 destes formatos estão em uso:

    1. Para o formato html-split, os arquivos são todos empacotados com tar(1). O resultado é um arquivo .tar que é posteriormente comprimido usando as técnicas de compressão detalhadas a seguir.

    2. Todos os outros formatos geram apenas um arquivo, nomeado book.formato (por exemplo, book.pdb, book.html, e outros).

      Estes arquivos são, então comprimidos utilizando três técnicas de compressão:

      Tipo Descrição
      zip Formato Zip. Se você quiser descomprimir este formato no FreeBSD, será necessário instalar o port archivers/unzip antes.
      gz Formato GNU Zip. Para descomprimir estes arquivos, use o comando gunzip(1) que faz parte do FreeBSD.
      bz2 Formato BZip2. Esse formato é menos popular que os outros, mas geralmente produz arquivos menores. Instale o port archivers/bzip2 para descomprimir arquivos deste formato.

      Portanto, o Manual do FreeBSD em formato Postscript comprimido com o BZip2 será armazenado como book.ps.bz2 sob o diretório handbook/.

    3. A documentação formatada está disponível ainda como um pacote FreeBSD.

Após escolher o formato e o mecanismo de compressão, você deve decidir se vai ou não pegar o documento em formato de pacote FreeBSD.

A vantagem de baixar e instalar os pacotes é que a documentação pode então ser gerenciada usando os comandos de gerenciamento de pacotes FreeBSD, como pkg_add(1) e pkg_delete(1).

Se decidir baixar e instalar o pacote, então você deve conhecer o nome do arquivo antes de começar. Os arquivos de documentação-como-pacotes estão estocados em um diretório chamado packages. Cada arquivo de pacote segue o padrão de nome document-name.lang.encoding.format.tgz.

Por exemplo, o FAQ, em língua Inglesa e formato PDF, estará no pacote de nome faq.en_US.ISO8859-1.pdf.tgz.

Sabendo isto, você pode usar o seguinte comando pra instalar o pacote contendo o FAQ na língua Inglesa e formato PDF:

# pkg_add
	      ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/packages/faq.en_US.ISO8859-1.pdf.tgz

Depois disso, você pode usar o pkg_info(1) pra determinar onde o documento foi instalado.

# pkg_info -f faq.en_US.ISO8859-1.pdf
Information for faq.en_US.ISO8859-1.pdf:

Packing list:
        Package name: faq.en_US.ISO8859-1.pdf
        CWD to /usr/share/doc/en_US.ISO8859-1/books/faq
File: book.pdf
        CWD to .
File: +COMMENT (ignored)
File: +DESC (ignored)

Como pode ver, book.pdf terá sido instalado sob /usr/share/doc/en_US.ISO8859-1/books/faq.

Se você preferir não usar pacotes, será necessário baixar os arquivos comprimidos, depois descomprimí-los e copiar os documentos apropriados para os lugares corretos.

Por exemplo, a versão do FAQ dividido em vários arquivos HTML, comprimido usando gzip(1), pode ser encontrado no arquivo doc/en_US.ISO8859-1/books/faq/book.html-split.tar.gz. Para baixar e descomprimir aquele arquivo, você deveria fazer o seguinte.

# fetch ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/en_US.ISO8859-1/books/faq/book.html-split.tar.gz
# gzip -d book.html-split.tar.gz
# tar xvf book.html-split.tar

Será criada, então, uma série de arquivos .html. O principal arquivo é chamado index.html contendo o índice, material introdutório e links para outras partes do documento. Posteriormente, você pode copiar ou mover esses arquivos pra onde você quiser.

2.3. Onde posso obter informações sobre as listas de discussão FreeBSD?

Você pode encontrar uma vasta gama de informações na seção do Manual do FreeBSD sobre listas de discussão.

2.4. Que grupos de notícias (news groups) existem sobre o FreeBSD?

Informações completas podem ser encontradas na seção do Manual do FreeBSD sobre grupos de notícias (newsgroups).

2.5. Existem canais de bate-papo retransmitido via Internet (IRC) FreeBSD?

Sim, a maioria das grandes redes de bate-papo retransmitido via Internet (IRC) tem um canal de bate-papo sobre FreeBSD:

  • O canal #FreeBSD na EFNet é essencialmente um fórum sobre FreeBSD, mas não entre no canal se você procura suporte técnico, nem se você está procurando uma maneira de evitar a leitura de páginas de manual ou fazer suas próprias pesquisas. Este é essencialmente um canal de bate-papo geral. Assuntos como sexo, esportes ou armas nucleares são tão comuns quanto FreeBSD no canal. Lembre-se, Você Foi Avisado! Para conectar-se, use o servidor irc.chat.org.

  • O canal #FreeBSDhelp na EFNet é dedicado a suporte e auxilio de usuários de FreeBSD. Os participantes neste canal são bem mais receptivos a perguntas que os do canal #FreeBSD.

  • O canal #FreeBSD na DALNET pode ser acessado em irc.dal.net nos Estados Unidos, e irc.eu.dal.net na Europa.

  • O canal #FreeBSD na UNDERNET pode ser acessado em us.undernet.org nos Estados Unidos, e eu.undernet.org na Europa. Partindo do princípio que esse é um canal de ajuda, esteja preparado para ler todos os documentos a que for referido.

  • O canal #FreeBSD na HybNet é um canal de ajuda. Uma lista de servidores pode ser encontrada no sítio WWW da HybNet.

Cada um destes canais é independente, e exatamente por estarem em redes distintas, não é conectada ou relacionada entre si. Os estilos de bate-papo em cada um dos canais são bastante distintos, pode ser necessário testar cada um para descobrir qual á mais adequado ao seu estilo pessoal de bate-papo. Como em toda rede de bate-papo retransmitido via Internet (IRC), nem considere acessar os canais se você ofende-se facilmente ou se você não se dá bem com muita gente jovem (e alguns bem velhos) que usam as mais irregulares formas de escrita e conversação possível, quase sempre assassinando sem o menor pudor todos os princípios verbais - de qualquer língua que seja.

2.6. Onde eu consigo treinamento em e suporte comercial ao FreeBSD?

DaemonNews oferece treinamento em e suporte comercial ao FreeBSD. Mais informações podem ser obtidas no sítio WWW BSD Mall.

FreeBSD Services oferece suporte comercial ao FreeBSD no Reino Unido (além de vender o FreeBSD em mídia DVD). Veja o sítio WWW deles para maiores informações.

A FreeBSD Mall oferece suporte comercial ao FreeBSD. Maiores informações podem ser obtidas no sítio WWW deles.

Qualquer outra organização que ofereça treinamento em ou suporte ao FreeBSD deve entrar em contato com o projeto para serem listadas aqui.

Este, e outros documentos, podem ser obtidos em ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.

Para perguntas sobre FreeBSD, leia a documentação antes de contatar <questions@FreeBSD.org>.
Para perguntas sobre esta documentação, envie e-mail para <doc@FreeBSD.org>.