            Contribuindo para a Colec,ao de Ports do FreeBSD

  Sam Lawrance

  Mark Linimon

   $FreeBSD:
   release/8.4.0/pt_BR.ISO8859-1/articles/contributing-ports/article.xml
   39632 2012-10-01 11:56:00Z gabor $

   $FreeBSD:
   release/8.4.0/pt_BR.ISO8859-1/articles/contributing-ports/article.xml
   39632 2012-10-01 11:56:00Z gabor $

   FreeBSD is a registered trademark of the FreeBSD Foundation.

   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 "(TM)" or the "(R)" symbol.

   Sumario

   Este artigo descreve as formas pelas quais uma pessoa pode
   contribuir com a Colec,ao de Ports do FreeBSD.

     --------------------------------------------------------------

     --------------------------------------------------------------

1 Introduc,ao

   A Colec,ao de Ports e um trabalho permanente, em constante
   evoluc,ao. Nos queremos oferecer aos nossos usuarios um
   repositorio de softwares de terceiros que seja facil de utilizar,
   atualizado e de alta qualidade.

   Qualquer um pode se envolver, e existem muitas formas diferentes
   de fazer isso. Contribuir para a colec,ao de ports e uma excelente
   forma de ajudar e de "devolver" algo para o projeto. Nao importa
   se voce esta `a procura de participac,ao continua, ou apenas um
   desafio divertido para um dia chuvoso, nos vamos adorar receber a
   sua ajuda!

   Como voluntario, o que voce faz e limitado apenas pelo que voce
   quer fazer. No entanto, pedimos que voce tome conhecimento do que
   os outros membros da comunidade FreeBSD irao esperar de voce. Voce
   pode querer levar isso em conta antes de decidir se voluntariar.

     --------------------------------------------------------------

2 O que voce pode fazer para ajudar

   Existem varias maneiras pelas quais voce pode contribuir para
   manter a arvore de Ports atualizada e em boas condic,oes de
   funcionamento:

     * Encontre algum software legal e util e crie um port para ele.

     * Existe um grande numero de ports que nao tem nenhum mantenedor
       ("maintainer"). Torne-se um mantenedor e adote um port.

     * Se voce tiver criado ou adotado um port, tome conhecimento do
       que precisa fazer agora que e um mantenedor.

     * Quando voce estiver procurando por um desafio rapido voce pode
       corrigir um bug ou um port quebrado.

     --------------------------------------------------------------

3 Criando um novo port

   Existe um documento separado, disponivel para ajudar e guia-lo no
   processo de criac,ao (ou de atualizac,ao) de um port, chamado
   Porter's Handbook. O Porter's Handbook e a melhor fonte de
   referencia para se trabalhar no sistema de ports. Ele fornece
   detalhes de como o sistema de ports funciona e discute as boas
   praticas recomendadas.

     --------------------------------------------------------------

4 Adotando um port sem manutenc,ao

  4.1 Escolhendo um port sem manutenc,ao

   Assumir a responsabilidade pela manutenc,ao de um port que esta
   abandonado e uma excelente forma de se envolver. Ports sem
   manutenc,ao so sao atualizados ou consertados quando alguem se
   voluntaria `a trabalhar neles. Existe um grande numero de ports
   sem manutenc,ao. E uma boa ideia iniciar com a adoc,ao de um port
   que voce usa regularmente.

   Os ports sem manutenc,ao tem a variavel MAINTAINER setada como
   ports@FreeBSD.org em seu Makefile. A lista dos ports sem
   manutenc,ao, seus erros atuais, e seus respectivos relatorios de
   problema , pode ser vista no Sistema de Monitorac,ao de Ports do
   FreeBSD.

   Alguns ports afetam um grande numero de outros devido as suas
   dependencias e aos ports escravos. Voce deve esperar ate que tenha
   alguma experiencia antes de se voluntariar para manter um port
   destes.

   Voce pode descobrir se um port tem ou nao dependencias ou ports
   escravos, observando o indice principal de ports chamado INDEX. (O
   nome do arquivo varia de acordo com a release do FreeBSD; por
   exemplo, INDEX-8.) Alguns ports tem dependencias condicionais que
   nao sao incluidas na compilac,ao padrao do INDEX. Esperamos que
   voce seja capaz de identificar estes ports observando os Makefiles
   dos outros ports.

     --------------------------------------------------------------

  4.2 Como adotar um port

   Primeiro certifique-se de que voce compreende as suas
   responsabilidades como um mantenedor. Tambem leia o Porter's
   Handbook. Por favor, nao se comprometa com mais do que o que voce
   se sente capaz de fazer.

   Voce pode pedir para se tornar o responsavel por um port sem
   manutenc,ao no momento em que desejar. Basta definir o MAINTAINER
   para o seu proprio email e enviar um PR (relatorio de problema)
   com a mudanc,a. Se o port tiver erros de compilac,ao ou se estiver
   precisando de atualizac,ao, voce pode querer enviar quaisquer
   outras alterac,oes no mesmo PR. Isto ira ajudar porque muitos
   comitters estao pouco dispostos a designar alguem sem um historico
   conhecido junto ao FreeBSD como responsavel pela manutenc,ao de um
   port. Enviar PRs os quais corrigem erros de compilac,ao ou que
   atualizam ports e a melhor forma de estabelecer um.

   Envie o seu PR com a categoria ports e a classe change-request. Um
   comitter ira examinar o seu PR, dar commit das alterac,oes e
   finalmente fechar o seu PR. Algumas vezes este processo pode
   demorar um pouco (afinal os comitters tambem sao voluntarios).

     --------------------------------------------------------------

5 Os desafios dos mantenedores de ports

   Esta sec,ao lhe dara uma ideia de porque os ports precisam ser
   mantidos e ira apresentar as responsabilidades de um mantenedor de
   ports.

     --------------------------------------------------------------

  5.1 Porque os ports precisam de manutenc,ao

   Criar um port e uma tarefa que demanda esforc,o uma unica vez.
   Garantir que um port esta atualizado e que continua a compilar e a
   executar e um esforc,o de manutenc,ao permanente. Os mantenedores
   ("maintainers"), sao pessoas as quais dedicam uma parte do seu
   tempo para a realizac,ao destes objetivos.

   A principal razao pela qual o sistema de ports precisa de
   manutenc,ao e trazer os melhores e mais recentes softwares de
   terceiros para a comunidade FreeBSD. Um desafio adicional e manter
   os ports individuais trabalhando com o framework da Colec,ao de
   Ports a medida que ele evolui.

   Como mantenedor, voce vai precisar gerenciar os seguintes
   desafios:

     * Novas versoes de software e atualizac,oes. Novas versoes e
       atualizac,oes de softwares que ja pertencem ao ports tornam-se
       disponiveis o tempo todo, e estes tem de ser incorporados a
       Colec,ao de Ports a fim de atualizar os softwares
       disponibilizados por ela.

     * Alterac,oes em dependencias. Se forem feitas mudanc,as
       significativas nas dependencias de seu port, ele pode precisar
       ser atualizado para que continue a funcionar corretamente.

     * Alterac,oes que afetam ports que dependem do seu. Se outros
       ports dependem de um port que voce mantem, alterac,oes em seu
       port podem demandar coordenac,ao com outros mantenedores.

     * Interac,ao com outros usuarios, mantenedores e
       desenvolvedores. Parte do trabalho de um mantenedor e atuar no
       suporte. Nao esperamos que voce oferec,a suporte generalizado
       (mas sera bem vindo se voce optar por isto). O que voce deve
       oferecer e um ponto de coordenac,ao para questoes sobre os
       seus ports que sejam especificos ao FreeBSD.

     * Cac,a aos bugs. Um port pode ser afetado por erros que sao
       especificos ao FreeBSD. Voce vai precisar investigar,
       encontrar e corrigir estes erros quando eles forem reportados.
       Testar exaustivamente um port para identificar problemas antes
       que eles cheguem na Colec,ao de Ports e ainda melhor.

     * Alterac,oes na politica e na infra-estrutura de ports.
       Ocasionalmente, os sistemas que sao utilizados para compilar
       os ports e os pacotes sao atualizados ou uma nova
       recomendac,ao que afeta esta infra-estrutura e feita. Voce
       deve estar ciente destas alterac,oes para o caso dos seus
       ports serem afetados e precisarem de atualizac,ao.

     * Alterac,oes no sistema base. O FreeBSD esta em constante
       desenvolvimento. Alterac,oes ao software, as bibliotecas, ao
       kernel ou mesmo alterac,oes na politica podem alterar os
       requisitos de um port.

     --------------------------------------------------------------

  5.2 Responsabilidades de um Mantenedor

    5.2.1 Mantenha seus ports atualizados

   Esta sec,ao descreve o processo que voce deve seguir para manter
   seus ports atualizados.

   Esta e uma visao geral. Maiores informac,oes sobre o processo de
   atualizac,ao de um port estao disponiveis no   Porter's Handbook.

    1. Fique atentendo para as atualizac,oes

       Monitore o desenvolvedor para tomar conhecimento sobre a
       liberac,ao de novas versoes, atualizac,oes, e correc,oes de
       seguranc,a para o software do seu port. Listas de discussao
       destinadas a avisos de lanc,amentos ou paginas web de noticias
       sao uteis para fazer isso. Algumas vezes os usuarios irao
       entrar em contato com voce e perguntar quando o seu port sera
       atualizado. Se voce esta ocupado com outras coisas ou se por
       qualquer outra razao nao pode fazer a atualizac,ao naquele
       momento, pergunte se eles irao ajuda-lo enviando um PR com a
       atualizac,ao.

       Voce tambem pode receber um email automatico do sistema de
       verificac,ao de ports do FreeBSD informando que uma nova
       versao do seu port's distfile esta disponivel. Maiores
       informac,oes sobre este sistema (incluindo a de como parar
       emails futuros) serao fornecidas na mensagem.

    2. Incorpore as alterac,oes

       Quando elas se tornarem disponiveis, incorpore as mudanc,as ao
       seu port. Voce precisa ser capaz de gerar um patch entre o seu
       port original e o seu port atualizado.

    3. Revisao e teste

       Examine cuidadosamente e teste as suas alterac,oes:

          * Compile, instale e teste o seu port no maior numero
            possivel de plataformas e arquiteturas. E comum que um
            port funcione em um branch ou plataforma e falhe em
            outra.

          * Certifique-se de que as dependencias do seu port estao
            completas. A melhor forma de fazer isto e instalar a sua
            propria ports tinderbox. Consulte a sec,ao sobre recursos
            para maiores informac,oes.

          * Verifique se a lista de empacotamento esta atualizada.
            Isto envolve a adic,ao de novos arquivos e diretorios e a
            remoc,ao de entradas nao utilizadas.

          * Verifique o seu port utilizando o portlint(1) como um
            guia. Consulte a sec,ao sobre recursos para informac,oes
            importantes sobre o uso do portlint.

          * Avalie se as alterac,oes no seu port podem levar a quebra
            de outros ports. Se este for o caso, coordene as
            alterac,oes com os mantenedores destes ports. Isto e
            especialmente importante se a sua atualizac,ao alterar a
            versao de uma biblioteca compartilhada; neste caso, no
            minimo, os ports que forem dependentes do seu vao
            precisar atualizar seu PORTREVISION de modo que eles
            sejam automaticamente atualizados pelas ferramentas de
            automac,ao tais como o portmaster ou o portupgrade(1).

    4. Envie as alterac,oes

       Envie sua atualizac,ao atraves da submissao de um PR contendo
       uma explicac,ao sobre as mudanc,as e um patch com as
       diferenc,as entre o port original e a versao atualizada. Por
       favor, consulte o artigo Escrevendo Relatorios de Problema
       para o FreeBSD para maiores informac,oes sobre como escrever
       um bom PR.

         Nota: Por favor, nao envie um arquivo shar(1) com o port
         inteiro. Em vez disso, utilize diff(1) -ruN. Desta forma, os
         committers podem ver com muito mais facilidade e precisao
         quais sao as mudanc,as que estao sendo feitas. A sec,ao
         Atualizac,oes do Porter's Handbook tem maiores informac,oes.

    5. Aguarde

       Em algum momento um committer vai cuidar do seu PR. Isto pode
       demorar alguns minutos, ou pode levar semanas - desta forma,
       por favor, seja paciente.

    6. De feedbacks

       Se um committer encontrar um problema nas suas alterac,oes,
       ele provavelmente ira encaminha-lo de volta para voce. Uma
       resposta rapida ira ajuda-lo a ter o seu PR resolvido mais
       rapidamente, e sera melhor para manter o fluxo de conversac,ao
       quando se esta tentando resolver qualquer problema.

    7. E finalmente...

       As suas alterac,oes serao aceitas e o seu port estara
       atualizado. O PR sera fechado pelo committer. E e isso!

     --------------------------------------------------------------

    5.2.2 Assegure que os seus ports continuem compilando corretamente.

   Esta sec,ao e sobre descobrir e corrigir problemas que impec,am os
   seus ports de compilar corretamente.

   O funcionamendo da Colec,ao de Ports e garantido pelo FreeBSD
   apenas no ramo -STABLE do sistema. Voce deve estar executando o
   8-STABLE ou o 9-STABLE, preferencialmente o ultimo. Em teoria,
   voce deve ser capaz de usa-lo com a ultima release de cada ramo
   estavel (uma vez que as ABIs nao deveriam mudar) mas se voce puder
   executar o ramo -STABLE, isto sera ainda melhor.

   Uma vez que a maioria das instalac,oes do FreeBSD rodam em
   maquinas PC compativeis (como e denominada a arquitetura i386),
   nos esperamos que voce mantenha os seus ports funcionando nesta
   arquitetura. Nos preferimos que os ports tambem funcionem de forma
   nativa na arquitetura amd64. E totalmente justo que voce pec,a
   ajuda se voce nao possuir uma destas maquinas.

     Nota: As falhas mais usuais na compilac,ao para maquinas
     nao-i386 ocorrem porque o programador original assumiu, por
     exemplo, que os ponteiros sao do tipo int, ou entao que uma
     versao antiga e relativamente mais frouxa do compilador gcc esta
     sendo utilizada. Cada vez mais, os autores de aplicac,oes estao
     retrabalhando seu codigo para remover estes pressupostos - mas
     se o autor nao estiver mantendo o codigo de forma ativa, voce
     pode precisar fazer isto voce mesmo.

   Estas sao as tarefas que precisam ser executadas para garantir o
   seu port pode ser compilado:

    1. Esteja atento para falhas de compilac,ao

       Verifique regularmente o cluster de compilac,ao automatizada
       de ports, o pointyhat, e o scanner de arquivos de
       distribuic,ao para ver se algum dos ports que voce mantem esta
       falhando na compilac,ao ou no download do codigo fonte (veja a
       sec,ao sobre recursos para maiores informac,oes sobre estes
       sistemas). Relatorios de falha tambem podem chegar ate voce
       por email, vindos de outros usuarios ou dos sistemas
       automatizados.

    2. Colete informac,oes

       Uma vez que voce tome conhecimento de um problema, colete
       informac,oes para ajuda-lo a corrigi-lo. Os erros de
       compilac,ao reportados pelo pointyhay sao acompanhados por
       logs os quais irao lhe mostrar onde a compilac,ao falhou. Se a
       falha tiver sido reportada `a voce por um usuario, pec,a a ele
       para lhe enviar informac,oes as quais possam lhe ajudar no
       diagnostico do problema, tais como:

          * Logs de compilac,ao

          * Os comandos e as opc,oes que foram utilizadas para
            compilar o port (incluindo as opc,oes definidas no
            /etc/make.conf)

          * A lista de aplicativos instalados em seus sistemas, como
            mostrada pelo pkg_info(1)

          * A versao do FreeBSD que eles estao utilizando, como
            mostrada pelo uname(1) -a

          * Quando a sua Colec,ao de Ports foi atualizada pela ultima
            vez

          * Quando o seu arquivo INDEX foi atualizado pela ultima vez

    3. Investigue e encontre uma soluc,ao

       Infelizmente nao existe um processo simples a ser seguido para
       fazer isto. Porem lembre-se: Se voce estiver sem saber o que
       fazer, pec,a ajuda! A lista de discussao sobre a colec,ao de
       ports do FreeBSD e um bom lugar para comec,ar, e os
       desenvolvedores do software tambem estao frequentemente
       dispostos a ajudar.

    4. Envie as alterac,oes

       Assim como na atualizac,ao de um port, voce agora deve
       incorporar as alterac,oes, revisa-las, testa-las, e depois
       submeter um PR com elas, fornecendo feedback, se necessario.

    5. Envie patches para os desenvolvedores do software

       Em alguns casos voce ira precisar modificar o software do seu
       port para que ele execute no FreeBSD. Alguns (mas nao todos)
       desenvolvedores irao aceitar incorporar tais patches em seu
       codigo para a proxima release. Se eles aceitarem, isto pode
       ate ajudar os seus usuarios nos outros sistemas derivados do
       BSD e talvez evite esforc,os duplicados. Por favor, considere
       o envio de qualquer patch aplicavel aos desenvolvedores do
       software como uma cortesia.

     --------------------------------------------------------------

    5.2.3 Investigue os relatorios de bugs e os PRs relacionados ao seu
    port

   Esta sec,ao e sobre a descoberta e correc,ao de bugs.

   Os bugs especificos ao FreeBSD sao geralmente causados por
   suposic,oes feitas pelo desenvolvedor sobre o ambiente de
   compilac,ao e de execuc,ao que nao se aplicam ao FreeBSD. E pouco
   provavel que voce encontre um problema deste tipo, eles sao mais
   sutis e dificeis de diagnosticar.

   Estas sao as tarefas que precisam ser executadas para garantir que
   o seu port continua funcionando como esperado:

    1. Responda os relatorios de bugs

       Bugs podem ser reportados para voce por meio de email atraves
       do Banco de Dados de Relatorios de Problema GNATS. Bugs tambem
       podem ser reportados diretamente `a voce pelos usuarios.

       Voce deve responder os PRs e demais relatorios no prazo de ate
       14 dias, mas por favor tente nao levar tanto tempo. Tente
       responder o mais rapido possivel, mesmo que seja so para dizer
       que voce precisa de mais algum tempo antes que voce possa
       trabalhar no PR.

       Se voce nao responder neste prazo de 14 dias, qualquer
       committer podera realizar o commit do PR ao qual voce nao
       respondeu baseado na regra de maintainer-timeout.

    2. Colete informac,oes

       Se a pessoa que reportou o bug nao tiver fornecido tambem uma
       correc,ao, voce vai precisar coletar as informac,oes que irao
       lhe permitir gerar uma.

       Se o bug pode ser reproduzido, voce pode coletar a maioria das
       informac,oes necessarias voce mesmo. Se nao conseguir
       reproduzi-lo, pec,a para a pessoa que reportou o bug para
       coletar as informac,oes para voce, tais como:

          * Uma descric,ao detalhada das suas ac,oes, comportamento
            esperado para o programa e o seu comportamento atual

          * Copia dos dados que desencadearam o bug

          * Informac,ao sobre o seu ambiente de compilac,ao e
            execuc,ao - como, por exemplo, a lista dos aplicativos
            instalados e a saida do env(1)

          * Dumps de memoria

          * Rastreamento de pilhas

    3. Elimine os relatorios incorretos

       Alguns dos relatorios de bugs podem estar incorretos. Por
       exemplo, o usuario pode ter simplesmente utilizado o programa
       de forma errada; ou os aplicativos instalados podem estar
       desatualizados e precisando de atualizac,ao. A vezes, o bug
       reportado nao e especifico ao FreeBSD. Neste caso, relate o
       bug para o desenvolvedor do software. Se a correc,ao do bug
       estiver dentro da sua capacidade tecnica, voce tambem pode
       aplicar um patch ao seu port, para que a correc,ao seja
       disponibilizada antes do release da nova versao oficial por
       parte do desenvolvedor.

    4. Encontre uma soluc,ao

       Assim como ocorre com os erros de compilac,ao, voce vai
       precisar encontrar uma correc,ao para o problema. Mais uma
       vez, lembre-se de pedir ajuda se voce estiver sem saber por
       onde comec,ar!

    5. Envie ou aprove as alterac,oes

       Assim como ocorre na atualizac,ao de um port, agora voce deve
       incorporar as alterac,oes, revisa-las, testa-las, e enviar as
       suas mudanc,as em um PR (ou enviar um followup se ja existir
       um PR para o problema). Se outro usuario tiver submetido
       alterac,oes em um PR, voce tambem pode enviar um followup
       dizendo se aprova ou nao estas mudanc,as.

     --------------------------------------------------------------

    5.2.4 Fornec,a suporte

   Faz parte da func,ao de mantenedor prover suporte - nao para o
   software em geral - mas para o port e para qualquer problema ou
   peculiaridade que seja especifica do FreeBSD. Usuarios podem
   contata-lo com perguntas, sugestoes, problemas e patches. Na maior
   parte do tempo serao mensagens especificas ao FreeBSD.

   Ocasionalmente voce pode precisar usar as suas habilidades
   diplomaticas para gentilmente direcionar os usuarios que buscam
   suporte geral aos recursos apropriados. Menos frequentemente voce
   ira encontrar pessoas perguntando por que o RPM nao esta
   atualizado ou como eles podem fazer o software executar no Linux
   XYZ. Aproveite a oportunidade para informar que o seu port esta
   atualizado (se ele estiver, e claro) e sugira que eles testem o
   FreeBSD.

   A vezes os usuarios e desenvolvedores irao decidir que voce e um
   pessoa ocupada, cujo tempo e valioso e irao fazer parte do
   trabalho para voce. Por exemplo, eles podem:

     * Submeter um PR ou enviar um patch para atualizar o seu port,

     * investigar e talvez disponibilizar uma correc,ao para um PT,
       ou

     * de outra forma, submeter mudanc,as para o seu port.

   Nestes casos a sua principal obrigac,ao e responder rapidamente.
   Mais uma vez, o tempo limite de espera pela resposta de um
   mantenedor e de 14 dias. Apos este periodo as alterac,oes podem
   ser processadas sem a sua aprovac,ao. Eles se deram ao trabalho de
   fazer isto por voce, portanto, tente pelo menos responder
   prontamente. Em seguida analise, aprove, modifique ou discuta as
   alterac,oes com eles o mais rapidamente possivel.

   Se voce puder faze-los sentir que a contribuic,ao deles e
   apreciada (e ela deveria ser), voce tera melhores chances de
   persuadi-los a fazer mais coisas para voce no futuro :-).

     --------------------------------------------------------------

6 Localizando e corrigindo um port quebrado.

   Existem dois lugares muito bons nos quais voce pode encontrar
   ports que precisam de alguma atenc,ao.

   Voce pode utilizar a interface web do banco de dados dos
   Relatorios de Problema para pesquisar e visualizar os PRs nao
   resolvidos. A maioria dos PRs da categoria ports sao referentes a
   atualizac,oes, mas com um pouco de pesquisa e leitura das sinopses
   voce devera ser capaz de encontrar algo interessante para
   trabalhar (a classe sw-bug e um bom ponto de partida).

   O outro lugar e o Sistema de Monitorac,ao de Ports do FreeBSD. Em
   especial, procure por ports sem manutenc,ao e com erros de
   compilac,ao e por ports que estejam marcados como BROKEN
   (quebrados). E OK enviar alterac,oes para um port que esta sendo
   mantido, mas lembre-se de consultar primeiro o mantenedor para o
   caso dele ja estar trabalhando na soluc,ao do problema.

   Depois que voce tiver encontrado um bug ou problema, colete
   informac,oes, investigue e conserte! Se existir ja um PR, envie um
   followup. Caso contrario, crie um novo PR. Suas alterac,oes serao
   revisadas e se tudo estiver OK, serao processadas e incorporadas.

     --------------------------------------------------------------

7 Saber quando parar

   A medida que seus interesses e compromissos mudarem, voce podera
   se ver sem tempo para continuar com algumas (ou com todas) das
   suas contribuic,oes para os seus ports. Tudo bem! Por favor, nos
   avise se voce nao estiver mais utilizando um port, ou se de outra
   forma voce nao tem mais tempo ou mesmo interesse para ser um
   mantenedor. Desta forma, poderemos seguir em frente e permitir que
   outras pessoas trabalhem com os problemas existentes nestes ports
   sem ter que aguardar pela sua resposta. Lembre-se, o FreeBSD e um
   projeto voluntario, se manter um port nao e mais divertido,
   provavelmente esta na hora de deixar alguma outra pessoa faze-lo.

   De qualquer forma, a Equipe de Gerenciamento do Ports (portmgr) se
   reserva o direito de revogar a sua condic,ao de mantenedor de um
   port se voce nao estiver dando manutenc,ao de forma ativa ao mesmo
   ja ha algum tempo (Atualmente, o periodo limite e de 3 meses). Com
   isto queremos dizer que existem problemas nao resolvidos ou
   atualizac,oes pendentes as quais nao foram trabalhadas durante
   esse tempo.

     --------------------------------------------------------------

8 Recursos para mantenedores de ports e colaboradores

   O Porter's Handbook e o seu guia de mochila para o sistema de
   ports. Mantenha ele sempre a mao!

   O artigo Escrevendo Relatorios de Problemas para o FreeBSD
   descreve as melhores praticas na elaborac,ao e na submissao de um
   PR. Em 2005 foram submetidos mais de 11 mil relatorios de problema
   na categoria ports. Ao seguir as recomendac,oes deste artigo voce
   ira nos ajudar a reduzir o tempo necessario para processar o seu
   PR.

   O   Banco de Dados de Relatorios de Problemas.

   O Pointyhat e o cluster de compilac,ao do sistema de ports. Voce
   pode utilizar o Pointyhat para verificar os logs de compilac,ao de
   um port em todas as arquiteturas e releases principais.

   O Sistema de Monitorac,ao de Ports do FreeBSD pode lhe mostrar
   informac,oes de referencia cruzada sobre um port tais como erros
   de compilac,ao e relatorios de problema. Se voce e um mantenedor
   voce pode utiliza-lo para verificar o status de compilac,ao dos
   seus ports. Se voce e um colaborador voce pode utiliza-lo para
   encontrar ports quebrados e sem manutenc,ao os quais precisam ser
   corrigidos.

   O Scanner de Arquivos de Distribuic,ao da Colec,ao de Ports do
   FreeBSD pode lhe mostrar ports para os quais nao e possivel fazer
   o download do codigo fonte. Voce pode utiliza-lo nos seus proprios
   ports ou usa-lo para encontrar ports que precisam ter o seu
   MASTER_SITES atualizado.

   O ports tinderbox e a forma mais completa de testar um port
   atraves de todo o ciclo de instalac,ao, empacotamento, e
   desinstalac,ao. Ele possui uma interface de linha de comando, mas
   tambem pode ser controlado atraves de uma interface web. Ele esta
   disponivel em ports/ports-mgmt/tinderbox. Voce ira encontrar
   maiores informac,oes na Home page do marcuscom sobre o tinderbox.

   O portlint(1) e um aplicativo o qual pode ser utilizado para
   verificar se o seu port esta em conformidade com as muitas e
   importantes diretrizes funcionais e de estilo que se aplicam a um
   port. O portlint e um aplicac,ao heuristica simples, de forma que
   voce deve usa-lo apenas como um guia. Se o portlint sugerir uma
   alterac,ao que lhe parece ser irracional, consulte o Porter's
   Handbook ou pec,a orientac,ao usando os canais apropriados.

   A lista de discussao sobre a colec,ao de ports do FreeBSD
   destina-se a discussao de assuntos gerais relacionados ao sistema
   de ports. Ela e um bom lugar para se pedir ajuda. Voce pode se
   inscrever, ou ler e consultar o historico de mensagens da lista. A
   leitura do historico da lista de discussao para relatar erros na
   colec,ao de ports do FreeBSD e da lista de distribuic,ao das
   mensagens de commit do ports no CVS do FreeBSD tambem pode ser
   interessante.

     --------------------------------------------------------------

            Este, e outros documentos, podem ser obtidos em
                ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.

  Para perguntas sobre FreeBSD, leia a documentac,ao antes de contatar
                        <questions@FreeBSD.org>.
       Para perguntas sobre esta documentac,ao, envie e-mail para
                           <doc@FreeBSD.org>.
