diff options
Diffstat (limited to 'pt_BR.ISO8859-1/articles/problem-reports/article.xml')
| -rw-r--r-- | pt_BR.ISO8859-1/articles/problem-reports/article.xml | 184 |
1 files changed, 75 insertions, 109 deletions
diff --git a/pt_BR.ISO8859-1/articles/problem-reports/article.xml b/pt_BR.ISO8859-1/articles/problem-reports/article.xml index ec1f919881..b64e157381 100644 --- a/pt_BR.ISO8859-1/articles/problem-reports/article.xml +++ b/pt_BR.ISO8859-1/articles/problem-reports/article.xml @@ -1,19 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN" - "../../../share/xml/freebsd45.dtd"> - +<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" + "../../../share/xml/freebsd50.dtd"> <!-- The FreeBSD Documentation Project The FreeBSD Brazilian Portuguese Documentation Project Original revision: r39544 --> +<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="pt_br"> + <info><title>Escrevendo Relatórios de Problema no &os;</title> + -<article lang='pt_br'> - <articleinfo> - <title>Escrevendo Relatórios de Problema no &os;</title> - - <legalnotice id="trademarks" role="trademarks"> + <legalnotice xml:id="trademarks" role="trademarks"> &tm-attrib.freebsd; &tm-attrib.cvsup; &tm-attrib.ibm; @@ -34,23 +32,16 @@ </abstract> <authorgroup> - <author> - <firstname>Dag-Erling</firstname> - <surname>Smørgrav</surname> - <contrib>Contribuido por</contrib> - </author> - - <author> - <firstname>Mark</firstname> - <surname>Linimon</surname> - </author> + <author><personname><firstname>Dag-Erling</firstname><surname>Smørgrav</surname></personname><contrib>Contribuido por</contrib></author> + + <author><personname><firstname>Mark</firstname><surname>Linimon</surname></personname></author> </authorgroup> - </articleinfo> + </info> <indexterm><primary>relatório de problema</primary> </indexterm> - <section id="pr-intro"> + <section xml:id="pr-intro"> <title>Introdução</title> <para>Uma das experiências mais frustrantes que @@ -90,7 +81,7 @@ de tratá-lo como um tutorial passo-a-passo.</para> </section> - <section id="pr-when"> + <section xml:id="pr-when"> <title>Quando enviar um relatório de problema</title> <para>Existem muitos tipos de problemas, e nem todos eles devem @@ -148,7 +139,7 @@ <para>Para os ports sem manutenção (aqueles nos quais a variável - <makevar>MAINTAINER</makevar> contém + <varname>MAINTAINER</varname> contém <literal>ports@FreeBSD.org</literal>), essas notificações de atualização podem ser capturadas por um <literal>committer</literal> @@ -171,12 +162,10 @@ etc.</para> <para>Em ambos os casos, você irá obter melhores - resultados se seguir o processo descrito no <ulink - url="&url.books.porters-handbook;/port-upgrading.html">Porter's Handbook</ulink>. - (Talvez você também queira ler o artigo <ulink - url="&url.articles.contributing-ports;/article.html"> + resultados se seguir o processo descrito no <link xlink:href="&url.books.porters-handbook;/port-upgrading.html">Porter's Handbook</link>. + (Talvez você também queira ler o artigo <link xlink:href="&url.articles.contributing-ports;/article.html"> Contribuindo para a Coleção de Ports - do &os;</ulink>.)</para> + do &os;</link>.)</para> </listitem> </itemizedlist> @@ -252,8 +241,8 @@ <para>Se o problema está na base do sistema, você deverá primeiro ler a seção do FAQ sobre - <ulink url="&url.books.faq;/introduction.html#LATEST-VERSION"> - Versões do &os;</ulink>, se você não estiver + <link xlink:href="&url.books.faq;/introduction.html#LATEST-VERSION"> + Versões do &os;</link>, se você não estiver familiarizado com o tema. Não é possível para o &os; corrigir problemas em versões muito antigas do sistema base, desta forma enviar um relatório de @@ -262,8 +251,8 @@ que você atualize o seu sistema para uma versão suportada para ver se o problema ainda ocorre. A equipe de <literal>Security Officer</literal> mantém a - <ulink url="&url.base;/security/">lista de versões - suportadas</ulink>.</para> + <link xlink:href="&url.base;/security/">lista de versões + suportadas</link>.</para> <para>Se o problema está em um port, observe que você deverá primeiro atualizar seu sistema para a @@ -276,7 +265,7 @@ aplicativo simplesmente não podem ser corrigidos.</para> </section> - <section id="pr-prep"> + <section xml:id="pr-prep"> <title>Preparação</title> <para>Uma boa regra a ser seguida sempre é realizar uma @@ -293,26 +282,20 @@ <itemizedlist> <listitem> - <para>A lista de <ulink - url="&url.books.faq;/index.html">Perguntas e Respostas mais - Frequentes</ulink> sobre o &os; (FAQ). A FAQ tem por + <para>A lista de <link xlink:href="&url.books.faq;/index.html">Perguntas e Respostas mais + Frequentes</link> sobre o &os; (FAQ). A FAQ tem por objetivo fornecer respostas para uma grande variedade de - perguntas, tais como as que dizem respeito a <ulink - url="&url.books.faq;/hardware.html">compatibilidade de - hardware</ulink>, <ulink - url="&url.books.faq;/applications.html">aplicações - do usuário</ulink>, <ulink - url="&url.books.faq;/kernelconfig.html">Configuração - do kernel</ulink>, etc.</para> + perguntas, tais como as que dizem respeito a <link xlink:href="&url.books.faq;/hardware.html">compatibilidade de + hardware</link>, <link xlink:href="&url.books.faq;/applications.html">aplicações + do usuário</link>, <link xlink:href="&url.books.faq;/kernelconfig.html">Configuração + do kernel</link>, etc.</para> </listitem> <listitem> - <para>As <ulink - url="&url.books.handbook;/eresources.html#ERESOURCES-MAIL"> - listas de discussão</ulink> — se você - não está inscrito, utilize a <ulink - url="http://www.FreeBSD.org/search/search.html#mailinglists"> - busca do histórico</ulink> no web site do + <para>As <link xlink:href="&url.books.handbook;/eresources.html#ERESOURCES-MAIL"> + listas de discussão</link> — se você + não está inscrito, utilize a <link xlink:href="http://www.FreeBSD.org/search/search.html#mailinglists"> + busca do histórico</link> no web site do &os;. Se o seu problema não tiver sido discutido nas listas, você pode tentar enviar uma mensagem sobre ele e aguardar alguns dias para ver se alguém consegue @@ -331,10 +314,9 @@ </listitem> <listitem> - <para>Na sequência, verifique o <ulink - url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query"> + <para>Na sequência, verifique o <link xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query"> banco de dados com os relatórios de problema do - &os;</ulink> (GNATS). A menos que o seu problema seja + &os;</link> (GNATS). A menos que o seu problema seja recente ou muito obscuro, existe uma boa chance dele já ter sido reportado.</para> </listitem> @@ -348,9 +330,8 @@ estudar cuidadosamente o conteúdo do arquivo <filename>/usr/src/UPDATING</filename> disponível no seu sistema de arquivos ou a sua versão mais - recente no <ulink - url="http://svnweb.freebsd.org/base/head/UPDATING"> - Repositório Subversion</ulink>. (Esta + recente no <link xlink:href="http://svnweb.freebsd.org/base/head/UPDATING"> + Repositório Subversion</link>. (Esta informação é vital se você estiver atualizando de uma versão para outra — especialmente se estiver atualizando para o @@ -363,16 +344,14 @@ individuais) ou o <filename>/usr/ports/CHANGES</filename> (para mudanças que afetam a Coleção de Ports inteira). Estes arquivos também estão - disponíveis no SVNWeb, nos urls <ulink - url="http://svnweb.freebsd.org/ports/head/UPDATING"></ulink> - e <ulink - url="http://svnweb.freebsd.org/ports/head/CHANGES"></ulink> + disponíveis no SVNWeb, nos urls <uri xlink:href="http://svnweb.freebsd.org/ports/head/UPDATING">http://svnweb.freebsd.org/ports/head/UPDATING</uri> + e <uri xlink:href="http://svnweb.freebsd.org/ports/head/CHANGES">http://svnweb.freebsd.org/ports/head/CHANGES</uri> respectivamente.</para> </listitem> </itemizedlist> </section> - <section id="pr-writing"> + <section xml:id="pr-writing"> <title>Escrevendo o Relatório de Problema</title> <para>Agora que você decidiu que o seu assunto merece um @@ -590,7 +569,7 @@ <para>As variáveis de ambiente que substituem os padrões do <filename>bsd.port.mk</filename>, como por exemplo - <makevar>PORTSDIR</makevar></para> + <varname>PORTSDIR</varname></para> </listitem> <listitem> <para>O fato de que você leu o @@ -630,9 +609,8 @@ submetido um PR semelhante antes.</emphasis> Embora isso já tenha sido mencionado anteriormente, faz sentido repetir aqui. Esta verificação irá - lhe tomar apenas 1 ou 2 minutos no uso do <ulink - url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query"> - mecanismo de busca</ulink> do banco de dados de PRs. + lhe tomar apenas 1 ou 2 minutos no uso do <link xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query"> + mecanismo de busca</link> do banco de dados de PRs. (é claro, todos são culpados de já terem esquecido de fazer isso de uma vez ou outra.)</para> </listitem> @@ -660,9 +638,8 @@ também para defender porque o seu <literal>patch</literal> é <quote>a coisa certa a se fazer</quote>. Como mencionado acima, realizar uma - busca cuidadosa no histórico das <ulink - url="http://www.FreeBSD.org/search/search.html#mailinglists">listas - de discussão</ulink> é sempre uma boa + busca cuidadosa no histórico das <link xlink:href="http://www.FreeBSD.org/search/search.html#mailinglists">listas + de discussão</link> é sempre uma boa forma de se preparar.</para> </listitem> @@ -699,9 +676,8 @@ não irão chegar até a base de dados GNATS. Para maiores detalhes de como configurar o sistema de email no &os;, consulte o capítulo sobre <quote>Correio - Eletrônico</quote> no <ulink - url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mail.html">Handbook - do FreeBSD</ulink>.</para> + Eletrônico</quote> no <link xlink:href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mail.html">Handbook + do FreeBSD</link>.</para> <para>Certifique-se de que o seu sistema de email não irá alterar a formatação da mensagem ao @@ -717,9 +693,8 @@ web do PR poderá ser lida melhor.</para> <para>Considerações similares se aplicam se - você estiver utilizando o <ulink - url="&url.base;/send-pr.html">formulário web de - submissão de PR</ulink> ao invés de utilizar o + você estiver utilizando o <link xlink:href="&url.base;/send-pr.html">formulário web de + submissão de PR</link> ao invés de utilizar o &man.send-pr.1;. Observe que operações de copiar-e-colar possuem seus próprios efeitos colaterais na formatação do texto. Em certos casos, pode @@ -731,9 +706,8 @@ relatório offline, desta forma nada será perdido no caso de você ter problemas quando for submetê-lo. Isto pode ser um problema, em especial, - se você estiver utilizando o <ulink - url="&url.base;/send-pr.html">formulário - web</ulink>.</para> + se você estiver utilizando o <link xlink:href="&url.base;/send-pr.html">formulário + web</link>.</para> </section> <section> @@ -902,8 +876,8 @@ para o GNATS, pois todas as informações no GNATS são de conhecimento público. Por favor, envie estes problemas seguindo as nossas - <ulink url="http://security.freebsd.org/#how">diretrizes - sobre relatórios de segurança</ulink>. + <link xlink:href="http://security.freebsd.org/#how">diretrizes + sobre relatórios de segurança</link>. </para> @@ -929,7 +903,7 @@ <para>A próxima seção descreve os campos que são comuns entre a interface por email e a - <ulink url="&url.base;/send-pr.html">interface web</ulink>:</para> + <link xlink:href="&url.base;/send-pr.html">interface web</link>:</para> <itemizedlist> @@ -1031,21 +1005,17 @@ pertencem ao sistema base ou se foram adicionados através da coleção de ports. Se você estiver na dúvida, você pode - executar um <command>whereis <replaceable> - nomedoprograma</replaceable></command>, no + executar um <command>whereis + nomedoprograma</command>, no &os; por convenção todos os aplicativos da coleção de ports são - instalados sob <filename - class="directory">/usr/local</filename>, embora isso + instalados sob <filename>/usr/local</filename>, embora isso possa ser alterado por um administrador de sistemas. Para estes, você irá utilizar a categoria <literal>ports</literal> (sim, mesmo que a categoria do port seja <literal>www</literal>; veja abaixo). Se a localização do aplicativo for - <filename class="directory">/bin</filename>, <filename - class="directory">/usr/bin</filename>, <filename - class="directory">/sbin</filename>, ou <filename - class="directory">/usr/sbin</filename>, ele + <filename>/bin</filename>, <filename>/usr/bin</filename>, <filename>/sbin</filename>, ou <filename>/usr/sbin</filename>, ele faz parte do sistema base, e você deverá utilizar a categoria <literal>bin</literal>. (Alguns programas, como o @@ -1078,14 +1048,14 @@ <listitem> <para>Se você está tendo problemas com as - <ulink url="http://www.FreeBSD.org">páginas web - do &os;</ulink>, a escolha apropriada é + <link xlink:href="http://www.FreeBSD.org">páginas web + do &os;</link>, a escolha apropriada é <literal>www</literal>.</para> <note> <para>Independentemente se você está tendo algum problema com um port chamado - <literal>www/<replaceable>nomedoport</replaceable></literal>, + <literal>www/nomedoport</literal>, a categoria correta para o mesmo será <literal>ports</literal>.</para> </note> @@ -1194,8 +1164,7 @@ </itemizedlist> <para>Aqui está a lista atual de categorias - (retirada do url <ulink - url="http://www.FreeBSD.org/cgi/cvsweb.cgi/src/gnu/usr.bin/send-pr/categories"></ulink>):</para> + (retirada do url <uri xlink:href="http://www.FreeBSD.org/cgi/cvsweb.cgi/src/gnu/usr.bin/send-pr/categories">http://www.FreeBSD.org/cgi/cvsweb.cgi/src/gnu/usr.bin/send-pr/categories</uri>):</para> <itemizedlist> <listitem> @@ -1444,9 +1413,8 @@ validar o seu conteúdo, remover os comentários e enviar o seu PR.</para> - <para>Se você está utilizando o <ulink - url="&url.base;/send-pr.html">formulário - web</ulink>:</para> + <para>Se você está utilizando o <link xlink:href="&url.base;/send-pr.html">formulário + web</link>:</para> <para>Antes de pressionar o botão <literal>submit</literal> para enviar o seu relatório, @@ -1481,7 +1449,7 @@ </section> - <section id="pr-followup"> + <section xml:id="pr-followup"> <title>Acompanhamento</title> <para> @@ -1511,9 +1479,8 @@ <para>A forma mais fácil é utilizar o link e <literal>followup</literal> existente na página web individual de cada PR, a qual pode ser encontrada a partir - da <ulink - url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query"> - página de busca de relatórios</ulink>. Ao + da <link xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query"> + página de busca de relatórios</link>. Ao clicar no link será aberta uma janela do seu cliente de e-mail com os campos <literal>To:</literal> e <literal>Subject:</literal> já corretamente @@ -1560,7 +1527,7 @@ problema foi corrigido.</para> </section> - <section id="pr-problems"> + <section xml:id="pr-problems"> <title>Se você está tendo problemas</title> <para>A maioria dos PRs que chegam ao sistema é processada @@ -1606,9 +1573,8 @@ dados ficou fora de sincronia com o próprio banco de dados. Uma forma de testar se é isto que esta acontecendo com você é acessar um PR individual - qualquer listado a partir do <ulink - url="http://www.FreeBSD.org/cgi/query-pr.cgi">formulário - de busca</ulink>, e substituir o numero do PR na URL pelo seu e + qualquer listado a partir do <link xlink:href="http://www.FreeBSD.org/cgi/query-pr.cgi">formulário + de busca</link>, e substituir o numero do PR na URL pelo seu e verificar se ele carrega normalmente. Se ele carregar, por favor, notifique os administradores do GNATS no endereço <email>bugmeister@FreeBSD.org</email>. Observe que existe uma @@ -1618,7 +1584,7 @@ será necessária.</para> </section> - <section id="pr-further"> + <section xml:id="pr-further"> <title>Leituras complementares</title> <para>Esta é uma lista com material de referência @@ -1628,22 +1594,22 @@ <itemizedlist> <listitem> - <para><ulink - url="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html"> - Como reportar bugs de forma efetiva</ulink>— Um + <para><link xlink:href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html"> + Como reportar bugs de forma efetiva</link>— Um excelente ensaio por Simon G. Tatham sobre a elaboração de relatórios de problemas eficientes (não é especifico sobre o &os;).</para> </listitem> <listitem> - <para><ulink - url="&url.articles.pr-guidelines;/article.html">Guia de como - lidar com relatórios de problemas</ulink> — + <para><link xlink:href="&url.articles.pr-guidelines;/article.html">Guia de como + lidar com relatórios de problemas</link> — Uma percepção valiosa sobre como os desenvolvedores do FreeBSD devem lidar com os relatórios de problemas.</para> </listitem> </itemizedlist> </section> + + <index/> </article> |