+ <para>FreeBSD is a registered trademark of the FreeBSD Foundation.</para>
+ <para>IEEE, POSIX, and 802 are registered trademarks of Institute of Electrical and Electronics Engineers, Inc. in the United States.</para>
+ <para>Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this document, and the FreeBSD Project was aware of the trademark claim, the designations have been followed by the <quote>â¢</quote> or the <quote>®</quote> symbol.</para>
- <para>A seguinte lista de tarefas e sub-projetos representa uma
- amálgama de várias listas de
- <filename>TODO</filename> e solicitações enviadas
- por usuários.</para>
+ <para>A lista de tarefas e sub-projetos a seguir representa algo como uma amálgama de várias listas de <filename>TODO</filename> e outras solicitações.</para>
<sect2 xml:id="non-programmer-tasks">
- <title>Tarefas em execução por
- não-programadores.</title>
+ <title>Tarefas em execução por não-programadores.</title>
- <para>Muitas das pessoas que estão envolvidas com o
- FreeBSD não são programadores. O projeto inclui
- autores de documentação, <literal>Web
- designers</literal>, e pessoal de suporte. Tudo o que estas
- pessoas precisam para contribuir é algum tempo livre
- para investir e vontade de aprender.</para>
+ <para>Muitas pessoas que estão envolvidas com o FreeBSD não são programadores. O Projeto inclui escritores de documentação, Web designers, e pessoas de suporte. Todas estas pessoas contribuem investindo tempo e sua vontade de aprender.</para>
<orderedlist>
<listitem>
- <para>Leia o <literal>FAQ</literal> e &a.ptbr.p.handbook;
- periodicamente. Se algo estiver mal explicado,
- desatualizado ou mesmo completamente errado; por favor,
- <para>Se você executar o FreeBSD-CURRENT e tiver uma
- boa conexão Internet, existe uma máquina
- <systemitem class="fqdomainname">current.FreeBSD.org</systemitem> que
- produz um lançamento
- (<foreignphrase>release</foreignphrase>) completo uma vez
- por dia — tente instalar diariamente o
- lançamento mais recente gerado e relate todas as
- falhas encontradas no processo.</para>
+ <para>Se você executa o FreeBSD-CURRENT e possui uma boa conexão com a Internet, existe uma máquina <systemitem class="fqdomainname">current.FreeBSD.org</systemitem> a qual compila uma release completa uma vez por dia - de vez em quando, tente instalar uma destas versões e informe quaisquer problemas no processo.</para>
</listitem>
<listitem>
- <para>Leia a &a.bugs;. Pode existir um problema o qual
- você possa comentar construtivamente ou mesmo uma
- correção que possa testar. Ou, você
- pode ainda tentar reparar um dos problemas sozinho.</para>
- <para>Se você souber de qualquer problema que tenha
- sido corrigido com sucesso no <literal>-CURRENT</literal>
- e cuja correção não tenha sido
- aplicada ao <literal>-STABLE</literal> após um
- intervalo razoável de tempo (normalmente algumas
- semanas), envie ao
- <foreignphrase>committer</foreignphrase> um lembrete
- educado.</para>
+ <para>Se você souber de qualquer problema que tenha sido corrigido com sucesso no -CURRENT e cuja correção não tenha sido aplicada ao -STABLE após um intervalo razoável de tempo (normalmente algumas semanas), envie ao committer um lembrete educado.</para>
</listitem>
<listitem>
- <para>Mova as contribuições de
- <foreignphrase>software</foreignphrase> para
- <filename>src/contrib</filename>
- na árvore do código fonte.</para>
+ <para>Mova as contribuições de software para <filename>src/contrib</filename> na árvore do código fonte.</para>
</listitem>
<listitem>
- <para>Tenha certeza que o código disponível em
- <filename>src/contrib</filename>
- está atualizado.</para>
+ <para>Tenha certeza que o código disponÃvel em <filename>src/contrib</filename> está atualizado.</para>
</listitem>
<listitem>
- <para>Compile o sistema (ou apenas uma parte dele) com
- <literal>warnings</literal> extras habilitados e remova os
- <literal>warnings</literal>.</para>
+ <para>Compile o sistema (ou apenas uma parte dele) com um nÃvel de debug extra habilitado e corrija a causa dos alertas encontrados.</para>
</listitem>
<listitem>
- <para>Corrija <literal>warnings</literal> de
- <literal>ports</literal> que ainda fazem coisas
- ultrapassadas tais como utilizar
- <function>gets()</function> ou incluir
- <filename>malloc.h</filename>.</para>
+ <para>Corrija os alertas existentes para os ports que ainda fazem coisas ultrapassadas tais como utilizar <function>gets()</function> ou incluir <filename>malloc.h</filename>.</para>
</listitem>
<listitem>
- <para>Se você contribuiu com algum dos
- <literal>ports</literal>, e teve que fazer alguma
- mudança específica para o &os;, envie suas
- correções de volta aos autores originais
- (isto tornará sua vida mais fácil quando
- eles lançarem a próxima
- versão).</para>
+ <para>Se você contribuiu com algum dos ports, e teve que fazer alguma mudança especÃfica para o FreeBSD, envie suas correções de volta aos autores originais (isto tornará sua vida mais fácil quando eles lançarem a próxima versão).</para>
</listitem>
<listitem>
- <para>Consiga cópias de padrões formais tais
- como &posix;. Você pode obter alguns
- <foreignphrase>links</foreignphrase> sobre estes
- padrões no sítio www <link xlink:href="&url.base;/projects/c99/index.html">FreeBSD
- C99 & Projeto de Conformidade com Padrões
- Posix</link>. Compare o comportamento do FreeBSD
- àquele requerido pelo padrão. Se o
- comportamento diferir, particularmente em pontos sutis ou
- obscuros da especificação, envie-nos um
- <literal>PR</literal> sobre ele. Se você for capaz,
- descubra como corrigi-lo e inclua um
- <literal>patch</literal> em seu <literal>PR</literal>. Se
- você acredita que o padrão está
- errado, peça ao comitê de padrões que
- considere a pergunta.</para>
+ <para>Consiga cópias de padrões formais tais como o <trademark class="registered">POSIX</trademark>. Compare o comportamento do FreeBSD àquele requerido pelo padrão. Se o comportamento diferir, particularmente em pontos sutis ou obscuros da especificação, envie-nos um PR sobre ele. Se você for capaz, descubra como corrigi-lo e inclua um patch em seu PR. Se você acredita que o padrão está errado, peça ao comitê de padrões que considere a pergunta.</para>
</listitem>
<listitem>
@@ -249,423 +111,565 @@
</sect2>
<sect2>
- <title>Trabalhe no banco de dados de <literal>PR</literal>
- (relatório de problemas)</title>
+ <title>Trabalhe no banco de dados de PR (relatório de problemas)</title>
- <indexterm>
- <primary>base de dados de relatórios de
- problemas</primary>
- </indexterm>
+ <indexterm><primary>banco de dados de relatórios de problemas</primary></indexterm>
+ <para>Existem várias maneiras fáceis de contribuir para manter a árvore de ports atualizada e em boas condições de funcionamento:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Encontre algum software legal ou útil e <link xlink:href="@@URL_RELPREFIX@@/doc/en_US.ISO8859-1/books/porters-handbook">crie um port</link> para ele.</para>
+ </listitem>
+
+ <listitem>
+ <para>Existe um grande número de ports que não possuem nenhum mantenedor. Torne-se um mantenedor e <link linkend="adopt-port">adote um port</link>.</para>
+ </listitem>
+
+ <listitem>
+ <para>Se você criou ou adotou um port, esteja ciente <link linkend="maintain-port">do que você precisa fazer como mantenedor</link>.</para>
+ </listitem>
+
+ <listitem>
+ <para>Quando estiver procurando um desafio você poderá <link linkend="fix-broken">consertar um bug ou um port quebrado</link>.</para>
- <para>Depois de enviar o relatório, voce deve receber uma
- confirmação junto com um número de
- registro. Guarde este número de registro, de forma que
- você possa nos manter atualizados sobre o seu problema
- enviando um e-mail para &a.bugfollowup;. Coloque o
- número no assunto da mensagem, por ex. <literal>"Re:
- kern/3377"</literal>. Informações adicionais
- sobre qualquer relatório de problema
- (<foreignphrase>Problem Report</foreignphrase>) devem ser
- submetidas desta forma.</para>
+ <para>Após preencher o relatório, você receberá a confirmação com o número de rastreamento. Guarde este número para que você possa nos atualizar com detalhes sobre do problema.</para>
- <para>Se você não receber a
- confirmação em prazo razoável (3 dias a 1
- semana, dependendo da sua conexão de e-mail), ou
- está por alguma razão impossibilitado de
- utilizar o comando &man.send-pr.1; ; então, você
- pode pedir que alguém o envie para você enviando
- e-mail para &a.bugs;.</para>
-
- <para>Consulte também <link xlink:href="&url.articles.problem-reports;/article.html">este
- artigo</link> sobre como escrever um bom relatório
- <para>deverá gerar um conjunto de <literal>diffs</literal>
- unificados para o arquivo de origem informado ou hierarquia de
- diretórios.</para>
+ <para>deverá gerar um conjunto de diffs unificados para o arquivo de origem informado ou para a hierarquia de diretórios.</para>
- <para>Consulte o manual do &man.diff.1; para maiores
- informações.</para>
+ <para>Consulte o manual do <citerefentry><refentrytitle>diff</refentrytitle><manvolnum>1</manvolnum></citerefentry> para maiores informações.</para>
- <para>Uma vez que você tenha o conjunto de
- <literal>diffs</literal> (os quais você pode testar com
- o comando &man.patch.1;), você deve submetê-los
- para inclusão no FreeBSD. Utilize o comando
- &man.send-pr.1; como descrito no <link linkend="contrib-general">Relatórios de Erro e
- Comentários em Geral</link>.
- <emphasis>Não</emphasis> envie os
- <literal>diffs</literal> apenas para a &a.hackers; ou eles
- serão perdidos! Nós apreciamos extremamente a
- sua submissão (este é um projeto
- voluntário!); porque nós somos ocupados,
- nós podemos não ter como tratá-la
- imediatamente, mas ela permanecerá em nosso bando de
- dados de <literal>PRs</literal> até que nós o
- façamos. Marque a sua submissão incluindo a
- palavra <literal>[PATCH]</literal> na sinópse do
- submetê-las com o &man.send-pr.1;. O &a.core; é formado
- por um grupo muito pequeno de pessoas as quais
- cuidam de muitas das tarefas diárias de administração do
- projeto &os;. Observe que este grupo também é <emphasis>muito
- ocupado</emphasis> e portanto você só deve enviar
- um e-mail a eles se for realmente necessário.</para>
+ <para>Por favor, consulte os manuais <citerefentry><refentrytitle>intro</refentrytitle><manvolnum>9</manvolnum></citerefentry> e <citerefentry><refentrytitle>style</refentrytitle><manvolnum>9</manvolnum></citerefentry> para algumas informações sobre estilo de codificação. Nós apreciarÃamos se você estivesse ao menos ciente destas informações antes de submeter o seu código.</para>
+ </sect2>
- <para>Por favor, consulte a &man.intro.9; e a &man.style.9; para
- obter alguma informação sobre o estilo de
- codificação. Nós apreciaríamos se
- você estivesse ao menos ciente destas
- informações antes de submeter o seu
- código.</para>
+ <sect2>
+ <title>Código novo ou pacotes de maior valor agregado</title>
+ <para>Quando se trabalha com grandes quantidades de código, o sensÃvel assunto de direitos autorais invariavelmente vem a tona. O Projeto FreeBSD prefere licenças de software livre tais como BSD ou ISC. Licenças copyleft, como a GPLv2, à s vezes são permitidas. A lista completa pode ser encontrada na página sobre a <link xlink:href="@@URL_RELPREFIX@@/internal/software-license.html">polÃtica de licenciamento do core team</link>.</para>
</sect2>
<sect2>
- <title>Código Novo ou Pacotes Principais de Valor
- Adicional (<foreignphrase>Major Value-Added
- Packages</foreignphrase>)</title>
+ <title>Dinheiro ou Hardware</title>
- <para>No caso de uma contribuição significativa de
- um trabalho de grande porte, ou a adição de uma
- nova característica importante ao FreeBSD, torna-se
- quase sempre necessário que se envie as
- alterações em um arquivo <literal>tar
- uuencoded</literal> ou então que se faça o
- <foreignphrase>upload</foreignphrase> das mesmas para um
- servidor WWW ou FTP para que as outras pessoas possam
- acessá-las. Se você não possui acesso a
- um servidor WWW ou FTP, pergunte em uma lista de
- extras que exigem de qualquer pessoa que venha a utilizar
- o código com finalidades comerciais, mas dada a
- grande quantidade de código GPL que nós
- necessitamos atualmente (compilador, montador assembler,
- formatador de texto, etc) seria tolice recusar
- contribuições adicionais sob esta licensa.
- O código sob a GPL também vai para uma parte
- diferente da árvore, mais especificamente para
- <filename>/sys/gnu</filename> ou
- <filename>/usr/src/gnu</filename>, de
- forma que é muito fácil
- identificá-lo para qualquer um que a GPL
- representa um problema.</para>
- </listitem>
- </orderedlist>
+ <para>Maiores informações sobre a Fundação FreeBSD podem ser obtidas no documento <link xlink:href="https://people.FreeBSD.org/~jdp/foundation/announcement.html">A Fundação FreeBSD - Uma introdução</link>. Para contatar a Fundação por e-mail, escreva para <email>info@FreeBSDFoundation.org</email>.</para>
+ </sect3>
- <para>As contribuições que vêm sob qualquer
- outro tipo de licensa devem ser cuidadosamente revisadas antes
- de sua inclusão no FreeBSD ser considerada.
- Contribuições com algum tipo de
- restrição particular ao seu uso comercial
- são geralmente rejeitadas, embora os autores sejam
- sempre incentivados a tornarem tais alteração
- disponíveis por meio de canais próprios.</para>
+ <sect3>
+ <title>Doando Hardware</title>
- <para>Para colocar o seu trabalho sob licensa
- <quote>estilo-BSD</quote>, inclua o texto abaixo no
- início de cada um dos arquivos que você deseja
- proteger, substituindo o texto entre <literal>%%</literal> com
+ <para>O projeto FreeBSD aceita alegremente doações de hardware para os quais pode encontrar bom uso. Se você estiver interessado em doar componentes de hardware, por favor contate o <link xlink:href="@@URL_RELPREFIX@@/donations/">Escritório de Relacionamento com Doadores</link>.</para>
+ </sect3>
+ </sect2>
+ </sect1>
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions
-are met:
-1. Redistributions of source code must retain the above copyright
- notice, this list of conditions and the following disclaimer as
- the first lines of this file unmodified.
-2. Redistributions in binary form must reproduce the above copyright
- notice, this list of conditions and the following disclaimer in the
- documentation and/or other materials provided with the distribution.
+ <sect1 xml:id="ports-contributing">
+ <title>Contribuindo com a coleção de ports</title>
-THIS SOFTWARE IS PROVIDED BY %%your_name_here%% ``AS IS'' AND ANY EXPRESS OR
-IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
-OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
-IN NO EVENT SHALL %%your_name_here%% BE LIABLE FOR ANY DIRECT, INDIRECT,
-INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
-NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
-THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ <sect2 xml:id="adopt-port">
+ <title>Adotando um port não mantido</title>
- $&os;$</programlisting>
+ <sect3>
+ <title>Escolhendo um port não mantido</title>
- <para>Para a sua comodidade, uma cópia deste texto pode
+ <para>Os ports sem um responsável tem o seu <varname>MAINTAINER</varname> configurado como <literal>ports@FreeBSD.org</literal>. Uma lista com todos os ports nesta situação, bem como os seus erros atuais e os seus relatórios de problemas pode ser visualizada no <link xlink:href="http://portsmon.FreeBSD.org/portsconcordanceformaintainer.py?maintainer=ports%40FreeBSD.org">Sistema de Monitoração da coleção de ports do FreeBSD</link>.</para>
+
+ <para>Alguns ports afetam um grande número de outros devido a dependências e relacionamentos de ports escravos. Geralmente, esperamos que as pessoas tenham alguma experiência antes de se voluntariarem para manter tais ports.</para>
- <title>Dinheiro, Hardware ou Acesso Internet</title>
+ <sect2 xml:id="maintain-port">
+ <title>O desafio para os mantenedores de um port</title>
- <para>Nós ficamos sempre muito felizes em aceitar
- doações para agregar a causa do Projeto FreeBSD,
- em um esforço voluntário como o nosso, um pouco
- pode significar muito! Doações de
- <foreignphrase>hardware</foreignphrase> também
- são muito importantes para expandir a nossa lista de
- periféricos suportados, uma vez que normalmente
- não temos recursos para comprar estes ítens
- nós mesmos.</para>
+ <para>Esta seção lhe dará uma ideia do motivo pelo qual os ports precisam ser mantidos e descreve as responsabilidades de um mantenedor de ports.</para>
- <sect3 xml:id="donations">
- <title>Doando Dinheiro</title>
+ <sect3 xml:id="why-maintenance">
+ <title>Por que os ports requerem manutenção</title>
- <para>A Fundação FreeBSD é uma entidade
- sem fins lucrativos e isenta de impostos, estabelecida com o
- objetivo de promover os objetivos do Projeto FreeBSD. Como
- uma entidade 501(c)3, a fundação é
- isenta de recolher as taxas do governo federal, bem como as
- do Estado do Colorado. As doações para uma
- entidade isenta de impostos são freqüentemente
+ <title>Novas versões e atualizações de software.</title>
+
+ <para>Novas versões e atualizações de software são disponibilizadas o tempo todo para os aplicativos já convertidos, e elas precisam ser incorporadas à Coleção de Ports a fim de prover software atualizado.</para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>Mudanças nas dependências.</title>
+
+ <para>Se forem feitas alterações significativas nas dependências do seu port, talvez seja necessário atualizá-las para que ele continue funcionando corretamente.</para>
+ </formalpara>
+ </listitem>
+
+ <listitem>
+ <formalpara>
+ <title>Mudanças que afetem os ports que dependem do seu.</title>
+ <title>Preste atenção às atualizações</title>
+
+ <para>Monitorar os fabricantes upstream em relação a liberação de novas versões, patches e correções de segurança para o software. Listas de discussão de anúncios ou páginas web de noticias sobre o software são úteis para este propósito. Algumas vezes os usuários entrarão em contato com você perguntando quando seu port será atualizado. Se você estiver ocupado com outras atividades ou devido a qualquer outra razão não puder realizar a atualização naquele momento, pergunte se o usuário pode te ajudar enviando uma atualização.</para>
+ <para>Quando estiverem disponÃves, incorpore as mudanças em seu port. Você precisa ser capaz de gerar um patch entre o port original e o port atualizado.</para>
+ </step>
+
+ <step>
+ <title>Revisão e teste</title>
+
+ <para>Examine cuidadosamente e teste as suas mudanças</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Compile, instale e teste o seu port em todas plataformas e arquiteturas que você puder. à comum um port funcionar em uma branch ou plataforma e falhar em outra.</para>
+ <para>Verifique se a lista de componentes do pacote está atualizada. Isto envolve adicionar novos arquivos e diretórios , bem como remover as entradas sem uso.</para>
+ </listitem>
+
+ <listitem>
+ <para>Verifique seu port usando o <citerefentry vendor="ports"><refentrytitle>portlint</refentrytitle><manvolnum>1</manvolnum></citerefentry> como um guia. Consulte a seção sobre <link linkend="resources">recursos</link> para informações importantes sobre o uso do <application>portlint</application>.</para>
+ <para>Submeta sua atualização enviando um relatório de problema (PR) com uma explicação das alterações e um patch contendo as diferenças entre o port original e a versão atualizada. Por favor, consulte o artigo <link xlink:href="@@URL_RELPREFIX@@/doc/en_US.ISO8859-1/articles/problem-reports">Escrevendo um Relatório de Problema para o FreeBSD</link> para mais informações sobre como escrever um PR realmente bom.</para>
+ <para>Em algum momento, um commiter lidará com o seu PR. Isto pode levar alguns minutos ou pode levar semanas - portanto, seja paciente.</para>
+ </step>
+
+ <step>
+ <title>Dê feedback</title>
+
+ <para>Se um committer encontrar um problema nas suas alterações, ele provavelmente o encaminhará de volta para você. Uma resposta rápida a este contato irá ajudá-lo a ter o seu PR resolvido mais rapidamente. à muito importante manter o canal de comunicação aberto para agilizar a resolução de qualquer eventual problema.</para>
+ </step>
+
+ <step>
+ <title>E finalmente</title>
+
+ <para>As suas alterações serão incorporadas na arvore de código fonte e o seu port será atualizado. O PR então será fechado pelo committer. à isso!</para>
+ </step>
+ </procedure>
+ </sect4>
+
+ <sect4>
+ <title>Certifique-se de que seus ports continuem a ser compilados corretamente</title>
+ <para>O projeto FreeBSD garante o funcionamento da coleção de Ports apenas na branch <literal>-STABLE</literal>. Teoricamente, você deve será capaz de garantir o funcionamento do port ao executá-lo na ultima release de cada branch(já que não se espera que as ABIs mudem), mas se você puder executar a branch, será ainda melhor.</para>
+ <para>Os padrões usuais nas falhas para máquinas não-<literal>x86</literal> são que os programadores originais assumiram que, por exemplo, os ponteiros são <literal>int</literal>s, ou que um compilador <application>gcc</application> mais antigo seria utilizado. Cada vez mais, os autores de aplicativos estão retrabalhando o código das suas aplicações para remover essas suposições - mas se o autor não estiver mantendo ativamente o código, talvez seja necessário que você mesmo faça isso.</para>
+ </note>
+
+ <para>Estas são as tarefas que você precisa executar para garantir que o seu port pode ser compilado:</para>
+
+ <procedure>
+ <step>
+ <title>Preste atenção para falhas de compilação</title>
+
+ <para>Confira o seu e-mail e busque por mensagens do <literal>pkg-fallout@FreeBSD.org</literal> e consulte o <link xlink:href="http://portscout.FreeBSD.org">scanner de arquivos distfiles</link> para verificar se algum dos ports que estão falhando na compilação estão desatualizados.</para>
+ </step>
+
+ <step>
+ <title>Colete informação</title>
+
+ <para>Quando você estiver ciente de um problema, colete informações para ajudá-lo a solucioná-lo. Os erros de compilação relatados pelo <literal>pkg-fallout</literal> são acompanhados por logs que mostram onde a compilação falhou. Se a falha foi reportada para você por um usuário, peça para que ele lhe envie informações que possam ajudar no diagnóstico do problema, tais como:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Logs de compilação</para>
+ </listitem>
+
+ <listitem>
+ <para>Os comandos e opções usados para compilar o port (incluindo opções definidas no <filename>/etc/make.conf</filename>)</para>
+ </listitem>
+
+ <listitem>
+ <para>Uma lista dos pacotes instalados no sistema como mostrado pelo comando <citerefentry><refentrytitle>pkg-info</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>
+ </listitem>
+
+ <listitem>
+ <para>A versão do FreeBSD que ele está executando como mostrado pelo comando <citerefentry><refentrytitle>uname</refentrytitle><manvolnum>1</manvolnum></citerefentry><command> -a</command></para>
+ </listitem>
+
+ <listitem>
+ <para>Quando a coleção de ports dele foi atualizada pela última vez</para>
+ </listitem>
+
+ <listitem>
+ <para>Quando a árvore de ports e o arquivo <filename>INDEX</filename> dele foram atualizados pela última vez</para>
+ </listitem>
+ </itemizedlist>
+ </step>
+
+ <step>
+ <title>Investigue e encontre uma solução</title>
+ <para>Assim como na atualização de um port, agora você deve incorporar as alterações, revisar, testar e enviar suas alterações em um relatório de problemas (PR) e fornecer feedback, se solicitado.</para>
+ </step>
+
+ <step>
+ <title>Envie os patches para os autores upstream</title>
+ <para>Bugs especÃficos do FreeBSD são causados geralmente por suposições sobre os ambientes de compilação e execução que não se aplicam ao FreeBSD. à pouco provável que você encontre um problema desse tipo, mas se encontrar ele poderá ser mais sutil e difÃcil de diagnosticar.</para>
+
+ <para>Estas são as tarefas que você precisa executar para garantir que o seu port continuará funcionando como pretendido:</para>
+ <para>Você deve responder os PRs (Relatório de Problemas) e outros relatórios dentro de 14 dias, mas por favor, tente não levar tanto tempo. Tente responder o mais rápido possÃvel, mesmo que seja apenas para dizer que você precisa de mais algum tempo antes de poder trabalhar no PR.</para>
+
+ <para>Se você não tiver respondido após 14 dias, qualquer committer poderá efetuar o commit de um PR que você não tenha respondido por meio da regra de <literal>maintainer-timeout</literal>.</para>
+ </step>
+
+ <step>
+ <title>Colete informação</title>
+
+ <para>Se a pessoa que reportou o bug não tiver fornecido uma correção, você precisará coletar as informações que permitirão gerar uma.</para>
+
+ <para>Se o bug for reproduzÃvel, você poderá coletar a maior parte das informações necessárias você mesmo. Caso contrário, peça à pessoa que relatou o bug para coletar as informações para você, tais como:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Uma descrição detalhada das suas ações, comportamento esperado e comportamento real do aplicativo</para>
+ </listitem>
+
+ <listitem>
+ <para>Cópias dos dados de entrada usados para acionar o bug</para>
+ </listitem>
+
+ <listitem>
+ <para>Informações sobre seu ambiente de compilação e execução - por exemplo, uma lista de pacotes instalados e a saÃda de <citerefentry><refentrytitle>env</refentrytitle><manvolnum>1</manvolnum></citerefentry></para>
+ </listitem>
+
+ <listitem>
+ <para>Core dumps</para>
+ </listitem>
+
+ <listitem>
+ <para>Stack traces</para>
+ </listitem>
+ </itemizedlist>
+ </step>
+
+ <step>
+ <title>Elimine os relatórios incorretos</title>
+ <para>Tal como acontece com erros de compilação, você precisará encontrar uma correção para o problema. Mais uma vez, lembre-se de perguntar se você estiver emperrado!</para>
+ <para>Depois de encontrar um bug ou problema, colete informações, investigue e corrija! Se houver um PR existente, de seguimento a ele. Caso contrário, crie um novo PR. Suas alterações serão analisadas e, se tudo estiver OK, elas serão aceitas e incorporadas.</para>
+ <para>O artigo <link xlink:href="@@URL_RELPREFIX@@/doc/en_US.ISO8859-1/articles/problem-reports">Escrevendo um relatório de problemas para o FreeBSD</link> descreve como melhor formular e enviar um PR. Em 2005, foram submetidos mais de onze mil relatórios de problemas relacionados aos ports! Ao seguir as boas práticas descritas neste artigo você nos ajudará a reduzir em muito o tempo necessário para lidar com seus PRs.</para>
+ <para>O <link xlink:href="http://portscout.FreeBSD.org">scanner de arquivos distfile</link> da coleção de ports do FreeBSD pode lhe mostrar os ports para os quais os arquivos distfiles não estão disponÃveis. Você pode utilizá-lo para verificar seus próprios ports ou para encontrar ports que precisam ter seu <varname>MASTER_SITES</varname> atualizado.</para>
+
+ <para xml:lang="en"><package>ports-mgmt/poudriere</package> is the most
+ thorough way to test a port through the entire cycle of
+ <para>Procurando por algo interessante para começar, e que não foi mencionado em outras partes deste artigo? O Projeto FreeBSD tem várias páginas Wiki contendo áreas nas quais novos colaboradores podem ter ideias sobre como começar.</para>