<chapt id="support">Obtendo suporte para o &debian;.

<sect id="debiandocs">Que outra documentação existe em/para um sistema Debian?

<p><list>
  <item>Instruções de instalação para a versão atual: veja
    <url id="http://www.br.debian.org/releases/stable/i386/install">.
  <item>O Manual de empacotamento é a documentação principal sobre os
    aspectos técnicos da criação de pacotes Debian, tanto binários como
    fontes.  
    <p>Você pode encontrá-lo no pacote <package>packaging-manual</package>, ou em
    <url id="ftp://ftp.debian.org/debian/doc/package-developer/packaging.html.tar.gz">.
  <item>O Policy Manual (Manual de políticas) documenta as exigências políticas
    para a distribuição, por exemplo, a estrutura e conteúdos do arquivo Debian,
    vários sobre o planejamento do sistema operacional, assim como requisitos
    técnicos que cada pacote tem que satisfazer para ser incluído da distribuição.
    <p>Obtenha-o através do pacote <package>debian-policy</package>, ou em
    <url id="ftp://ftp.debian.org/debian/doc/package-developer/policy.html.tar.gz">.
  <item>Documentação sobre pacotes Debian instalados:
    a maioria dos pacotes tem arquivos que são desempacotados em
    <tt>/usr/doc/PACKAGE</tt>.
  <item>Documentação sobre o projeto Linux:
    o pacote <package>doc-linux</package> instala todas as mais recentes versões
    dos HOWTOs e mini-HOWTOs do <url name="Linux
    Documentation Project (Projeto de documentação do Linux)"
    id="http://www.linuxdoc.org">.
  <item>Páginas de manual estilo Unix: a maioria dos comandos tem páginas de
    manual escritas no estilo dos arquivos "man" do Unix. Elas são
    referenciadas pela seção do diretório "man" em que residem: por exemplo,
    foo(3) refere-se à página de manual que reside em /usr/man/man3,
    e pode ser chamada através do comando: <tt>man 3 foo</tt>, ou apenas
    <tt>man foo</tt> se a seção 3 for a única a conter uma página sobre
    <tt>foo</tt>.
    <p>Pode-se saber qual diretório de <tt>/usr/share/man/</tt> contém uma
    certa página de manual executando <tt>man -w foo</tt>.
    <p>Novos usuários do Debian devem observar que as páginas de manual de
    muitos comandos gerais do sistema não estão disponíveis até que estes
    pacotes sejam instalados:
    <list>
      <item><tt>man-db</tt>, que contém o próprio programa <tt>man</tt>,
        e outros programas para manipular as páginas de manual.
      <item><tt>manpages</tt>, que contém o sistema de páginas de manual.
        (veja <ref id="nonenglish">).
    </list>
  <item>Páginas "info" estilo GNU: documentação para vários comandos,
    especialmente ferramentas GNU, não está disponível em páginas de
    manual, e sim em arquivos "info" que podem ser lidos pela ferramenta
    GNU <tt>info</tt>, ou executando <tt>M-x info</tt> dentro do GNU Emacs,
    ou com algum outro visualizador de páginas Info.
    <p>Sua principal vantagem em relação às páginas de manual originais
    é que usam um sistema de hipertexto. Entretanto, <em>não</em>
    precisam da WWW; o <tt>info</tt> pode ser executado a partir de um
    console em modo texto. Ele foi projetado por Richard Stallman e
    precedeu a WWW.
</list>

<p>Note que você pode acessar muita documentação em seu sistema usando um
browser WWW, através dos comandos "dwww" ou "dhelp", encontrados em seus
respectivos pacotes.

<sect id="onlineresources">Existem recursos on-line para discussão sobre o Debian?

<p>Existem várias listas de discussão relacionadas ao Debian.

<p>Num sistema que possua o pacote <package>doc-debian</package> instalado,
existe uma lista completa de listas de discussão em
<file>/usr/share/doc/debian/mailing-lists.txt</file>.

<p>Para se inscrever na debian-X (para anúncios sobre o X, usuários, etc.),
envie um mail para debian-X-request@lists.debian.org com a palavra
"subscribe" no campo "Assunto:". Se você possui um browser WWW que
possua suporte a formulários, você pode se inscrever na lista usando
o <url name="formulário on-line" id="http://www.debian.org/MailingLists/subscribe">.
Você também pode se retirar da lista utilizando o mesmo formulário.

<p>O endereço de e-mail do administrador da lista é
<email>listmaster@lists.debian.org</email>, em caso de você ter algum problema.

<p>Arquivos das listas de discussão do Debian estão disponíveis via WWW em
<url id="http://lists.debian.org/">.

<p>Usuários podem enviar perguntas a mantenedores de pacotes individuais,
desde que seus endereços de e-mail sejam fornecidos no arquivo de controle
(veja a seção <ref id="controlfile">) que é incluído em cada pacote. A
pessoa pode também aprender o nome e e-mail do mantenedor procurando nos
arquivo "Packages", pois este arquivo é somente um conjunto dos arquivos
de controle dos pacotes que se encontram em uma árvore de diretórios particular.
Para extrair um arquivo de controle de um pacote Debian particular, use o
comando:
  <example>dpkg --info NomeDoPacote_VVV-RRR.deb</example>

<p>Usuários devem enviar perguntas não específicas ao Debian para um dos
grupos USENET do Linux, qeu são nomeados comp.os.linux.* ou linux.*.
Existem várias listas de newsgroups Usenet de Linux e outros recursos
relacionados na WWW, por exemplo, nos endereços <url name="Linux Online"
id="http://www.linux.org/docs/usenet.html"> e <url name="Linux Journal"
id="http://www.linuxjournal.com/helpdesk.php">.

<sect id="mailinglistconduct">Qual é o código de conduta para as listas de discussão?

<p>Quando usar as listas de discussão do Debian, por favor, siga estas regras:
<list>
  <item>Não brigue; não é agradável. As pessoas que desenvolvem o Debian são
    Voluntárias, doando seus tempos, energia e dinheiro numa tentativa de
    desenvolverem juntas o projeto Debian.
  <item>Não use linguajar inadequado;
  <item>Tenha certeza de que está utilizando a lista adequada. <em>Nunca</em>
    envie sua inscrição para a própria lista. <footnote>Use o endereço
    <em>nome_da_lista</em>-REQUEST@lists.debian.org para isso.</footnote>
  <item>Veja a seção <ref id="bugreport"> para informações sobre o relato de bugs.
</list>

<sect1 id="advertising">Política sobre anúncios em listas de discussão.

<p>As listas de discussão do &debian; aceitam publicidade comercial
através de pagamento. Nós oferecemos isenção se você puder nos mostrar
o comprovante de pagamento da doação de &dollar;1000 (U.S.) ou mais
para a Free Software Foundation ordenado pela "Debian". Uma doação por
anúncio, por favor. Se você não deseja doar, simplesmente envie seu
anúncio para a lista, e o operador das listas de discussão irá cobrar
&dollar;1999 (U.S.). O operador da lista irá doar esse total, menos as
despesas recolhimento desse total, para a FSF.

<p>Através do ato de enviar seu anúncio, você concorda em aceitar a
responsabilidade sobre a taxa, você concorda em indenizar o operador
das listas de discussão contra qualquer reivindicação legal de você ou
de outros com relação a seu anúncio, e você concorda em pagar qualquer
despesa legal e empresarial que incorra no recente recolhimento. Nossa
obrigação para com você é limitada ao esforço de boa-fé de entrega de
sua mensagem.

<p>Taxas reduzidas e/ou isenção de taxas estão disponíveis para anúncios
relacionados ao Debian. Você deve consultar com antecedência o operador
da lista de discussão se deseja obter uma redução da taxa ou isenção.

<sect id="searchtools">Existe uma maneira rápida de procurar informações
sobre o &debian;?

<p>Há vários mecanismos de busca que servem para localizar documentações
relacionadas ao Debian.

<list>
  <item><url id="http://www.br.debian.org/search" name="Site de pesquisa WWW do Debian">.
    <!-- the above URL isn't working right now, but will, hopefully soon -->
  <item><url id="http://www.dejanews.com/" name="Serviço de pesquisa de news DejaNews">.
    Para descobrir que experiências as pessoas tiveram para achar drivers
    para controladores Western Digital, experimente procurar por esta frase:
    <tt>linux & WD</tt>
    Isso diz ao DejaNews para que relate quaisquer artigos contendo ambas as
    strings "linux" E "WD". (como nota: quando um dos autores deste texto o
    usou, descobriu que sua placa WD (que ele posuia há apenas 6 meses) tinha
    sido declarada obsoleta pela Adaptec, agora que eles compraram a WD.
    Portanto, não havia mais drivers disponíveis (bendita Adaptec)).
  <item>Quaisquer dos mecanismos de busca na web (como o
    <url id="http://www.altavista.com/" name="AltaVista"> ou o
    <url id="http://www.google.com" name="Google">)
    também podem ser usados para procurar a Usenet (embora não sejam tão
    atualizados quanto o DejaNews).
    <p>Por exemplo, procurando pela string "cgi-perl" uma descrição mais
    detalhada é retornada para esse pacote do que uma breve descrição em
    seu arquivo de controle.
</list>

<sect id="buglogs">Existem registros de bugs conhecidos?

<p>A distribuição &debian; possui um sistema de monitoramento de bugs
(bug tracking system (BTS)) que armazena detalhes de bugs relatados por
usuários e desenvolvedores. A cada bug é dado um número, e é mantido
armazenado até que seja marcado como tendo sido resolvido.

<p>Cópias dessas informações estão disponíveis em
<url id="http://www.br.debian.org/Bugs/">.

<p>Um servidor de mail oferece acesso a base de dados do sistema de
monitoramento de bugs via correio eletrônico. Para adquirir as instruções,
envie um e-mail a <email>request@bugs.debian.org</email> com "help" no corpo
da mensagem.

<sect id="bugreport">Como posso informar sobre um bug no Debian?

<p>Se você encontrou um bug no Debian, por favor, leia as instruções
para informar um bug no Debian. Essas instruções podem ser obtidas em
um de vários métodos:
<list>
  <item>Por FTP anônimo. Os sites espelhos do Debian possuem as instruções
  no arquivo <tt>doc/bug-reporting.txt</tt>.
  <item>A partir da WWW. Uma cópia das instruções é apresentada em
  <url id="http://www.br.debian.org/Bugs/Reporting">.
  <item>Em qualquer sistema Debian que tenha o pacote <package>doc-debian</package>
  instalado.
  As instruções estão no arquivo
  <file>/usr/doc/debian/bug-reporting.txt</file>.
</list>

<p>Você pode usar os pacotes <package>bug</package> ou <package>reportbug</package>
que irá guiá-lo através pelo processo de registro e enviará as mensagens para
o endereço apropriado, com alguns detalhes adicionais sobre o seu sistema
adicionados automaticamente.

<p>Se você deseja enviar o relatório com um MUA, envia a mensagem para
<email>submit@bugs.debian.org</email>, onde a primeira linha contenha algo do tipo
  <example>Package: NomeDoPacote</example>
(substitua "NomeDoPacote" com o nome do pacote). O resto da mensagem deve conter a
descrição do bug (por favor, faça isso de forma mais ou menos detalhada),
a versão do Debian que você está usando, e as versões pertinentes daquele pacote.

<p>Espere adquirir um conhecimento automático de seu relatório de bug.
Será automaticamente dado a ele um número de monitoramento de bug,
adicionado ao registro de bugs e remetido a lista de discussão debian-bugs-dist.

<p>Se alguém fosse identificar um bug que era comum a muitos programas,
então, ao invés de reportar dúzias de relatórios de bugs similares, alguém
poderia preferir enviar bugs individuais para <email>maintonly@bugs.debian.org</email>
(ao invés do endereço submit@...) para avisar somente o mantenedor do respectivo
pacote, e então enviar um relatório reduzido as listas de discussão debian-devel
e/ou de debian-bugs-dist.

<p>Adicionalmente, lá existe um verificador de pacotes Debian, chamado
<url name="Lintian" id="http://www.br.debian.org/lintian/">, que é
projetado para verificar mecanicamente os pacotes Debian em relação
a violações da política e erros comuns de empacotamento. Portanto,
se você encontrar um bug que aparentemente aparece em outros pacotes
também, será melhor você entrar em contato com o mantenedor do
Lintian em <email>lintian-maint@debian.org</email> de forma que
uma nova verificação para o Lintian seja escrita, ao invés de reportar
um bug diretamente. Isso prevenirá que o bug apareça em futuras versões
do pacote, ou em qualquer outro pacote da distribuição.

<p>Você também pode usar <email>quiet@bugs.debian.org</email>, para enviar um
relatório de bug ao BTS, sem os ter que enviar para a debian-bugs-dist ou para
o mantenedor. Esse endereço é usado muito raramente, por exemplo, quando você
quer enviar alguma informação menor para seu relatório, que deve somente ser
adicionada ao seu registro, ou quando você quer adicionar algo ao registro do
BTS, mas já enviou isso para o mantenedor.