                Contribuindo para a Colec,ao de Ports do FreeBSD

  Sam Lawrance

  Mark Linimon

   Revisao: 43126

   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.

   2013-11-07 por gabor.
   Sumario

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

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

   Indice

   1. Introduc,ao

   2. O que voce pode fazer para ajudar

   3. Criando um novo port

   4. Adotando um port sem manutenc,ao

   5. Os desafios dos mantenedores de ports

   6. Localizando e corrigindo um port quebrado.

   7. Saber quando parar

   8. Recursos para mantenedores de ports e colaboradores

   Indice Remissivo

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.

Indice Remissivo

  C

   Contribuindo com o ports, Contribuindo para a Colec,ao de Ports do FreeBSD
