Capítulo 2. Documentação e Suporte
Anterior |  | Próxima

## 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
  [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.
- 2. As técnicas de compressão e empacotamento dos arquivos. Atualmente, 3 destes formatos estão em uso: 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. 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/`. 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.

Anterior |  | Próxima
Capítulo 1. Introdução | Principal | Capítulo 3. Instalação

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>.