aboutsummaryrefslogtreecommitdiff
path: root/pt_BR.ISO8859-1/articles/problem-reports
diff options
context:
space:
mode:
authorGabor Kovesdan <gabor@FreeBSD.org>2013-11-07 15:39:28 +0000
committerGabor Kovesdan <gabor@FreeBSD.org>2013-11-07 15:39:28 +0000
commit24d129e8d1984a0b46a543bc523b63d216813bb0 (patch)
tree7dd0501c857c6f2139f4a71191c93bf19136412a /pt_BR.ISO8859-1/articles/problem-reports
parent35f1d6c78be90eb13320d655cd68f94333a0ab26 (diff)
downloaddoc-24d129e8d1984a0b46a543bc523b63d216813bb0.tar.gz
doc-24d129e8d1984a0b46a543bc523b63d216813bb0.zip
- Definitively upgrade to DocBook 5.0
Notes
Notes: svn path=/projects/db5/; revision=43125
Diffstat (limited to 'pt_BR.ISO8859-1/articles/problem-reports')
-rw-r--r--pt_BR.ISO8859-1/articles/problem-reports/article.xml182
1 files changed, 73 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 9099749011..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&oslash;rgrav</surname>
- <contrib>Contribuido por</contrib>
- </author>
-
- <author>
- <firstname>Mark</firstname>
- <surname>Linimon</surname>
- </author>
+ <author><personname><firstname>Dag-Erling</firstname><surname>Sm&oslash;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> &mdash; 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> &mdash; 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
&mdash; 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,18 +1594,16 @@
<itemizedlist>
<listitem>
- <para><ulink
- url="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">
- Como reportar bugs de forma efetiva</ulink>&mdash; Um
+ <para><link xlink:href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">
+ Como reportar bugs de forma efetiva</link>&mdash; 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> &mdash;
+ <para><link xlink:href="&url.articles.pr-guidelines;/article.html">Guia de como
+ lidar com relatórios de problemas</link> &mdash;
Uma percepção valiosa sobre como os
desenvolvedores do FreeBSD devem lidar com os
relatórios de problemas.</para>