        Contribuer au Catalogue des logiciels portes de FreeBSD

  Sam Lawrance

  Mark Linimon

   $FreeBSD:
   release/9.1.0/fr_FR.ISO8859-1/articles/contributing-ports/article.sgml
   38826 2012-05-17 19:12:14Z hrs $

   FreeBSD est une marque deposee de la fondation FreeBSD.

   Plusieurs designations utilisees par les constructeurs et vendeurs
   pour distinguer leurs produits sont mentionnees comme des marques
   deposees. Lorsqu'elles apparaissent dans ce document et que le
   projet FreeBSD est au courant de cette mention, la designation est
   suivie du symbole "(TM)" ou du symbole "(R)".

   Resume

   Cet article decrit les differentes possibilites que chacun a de
   contribuer au catalogue des logiciels portes de FreeBSD.

   Version franc,aise de Frederic Culot <culot@freebsd.org>.

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

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

1. Introduction

   Le catalogue des logiciels portes (appele Ports en anglais) est le
   fruit d'un travail en perpetuelle evolution. Nous voulons fournir
   `a nos utilisateurs une collection de logiciels tiers qui soit
   facile `a utiliser, `a jour, et de grande qualite. Pour nous aider
   `a atteindre ce but, nous avons besoin que des personnes donnent
   de leur temps libre et participent `a cet effort.

   Tout le monde peut participer et il existe de nombreuses
   possibilites pour ce faire. Contribuer aux logiciels portes est un
   excellent moyen de "donner quelque chose en retour" au projet. Que
   vous cherchiez `a vous impliquer de maniere continue ou bien juste
   un defi amusant pour chasser l'ennui un jour de pluie, nous
   aimerions beaucoup avoir votre aide!

   En tant que volontaire, ce que vous faites est limite uniquement
   par les barrieres que vous vous imposez vous-meme. Cependant, nous
   vous demandons d'etre conscient de ce que les autres membres de la
   communaute FreeBSD attendent de vous. Il serait souhaitable que
   vous le preniez en compte avant de vous decider `a vous porter
   volontaire.

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

2. Ce que vous pouvez faire pour aider

   Vous pouvez contribuer facilement `a la mise `a jour du catalogue
   des logiciels portes et `a son maintien en bon etat en utilisant
   une des possibilites suivantes:

     * Trouvez un logiciel sympa ou utile et creez un logiciel porte
       de celui-ci.

     * Il existe un grand nombre de logiciels portes qui n'ont pas de
       mainteneur. Devenez un mainteneur et adoptez un logiciel
       porte.

     * Si vous avez cree ou adopte un logiciel porte, soyez conscient
       de vos devoirs en tant que mainteneur.

     * Si vous etes `a la recherche d'un petit defi vous pouvez
       corriger un bogue ou un logiciel porte deficient.

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

3. Creer un logiciel porte

   Un autre document est `a votre disposition pour vous guider dans
   la creation (et la mise `a jour) d'un logiciel porte: le Guide du
   Porteur de logiciels. Ce guide est la meilleure reference pour
   travailler avec le systeme des logiciels portes. Il fournit des
   details sur la maniere dont fonctionne ce systeme et expose les
   pratiques recommandees.

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

4. Adopter un logiciel porte non maintenu

  4.1. Choisir un logiciel porte non maintenu

   Prendre la releve en maintenant des logiciels portes abandonnes
   est un excellent moyen de s'impliquer. Les logiciels portes non
   maintenus sont mis `a jour et repares uniquement lorsque quelqu'un
   se porte volontaire pour travailler dessus. Il existe un grand
   nombre de logiciels portes non maintenus. C'est une bonne idee de
   commencer par adopter un logiciel porte que vous utilisez
   regulierement.

   Les logiciels portes non maintenus ont leur MAINTAINER assigne `a
   ports@FreeBSD.org. Une liste des logiciels portes non maintenus
   ainsi que de leurs bogues actuels et leurs rapports de problemes
   peuvent etre consultes dans le Systeme de suivi des logiciels
   portes FreeBSD.

   Certains logiciels portes en affectent un grand nombre d'autres du
   fait des dependances et des relations logiciels portes-esclaves.
   Generalement, nous voulons que les personnes aient de l'experience
   avant qu'ils maintiennent de tels logiciels portes.

   Vous pouvez savoir si un logiciel portes a ou non des dependances
   ou des logiciels portes esclaves en regardant un index maitre du
   catalogue des logiciels portes appele INDEX (Le nom de ce fichier
   varie en fonction des distributions de FreeBSD; par exemple,
   INDEX-6). Certains logiciels portes ont des dependances
   conditionnelles qui n'apparaissent pas dans la version par defaut
   de INDEX. Nous attendons de vous que vous soyez capable de
   reconnaitre de tels logiciels portes en examinant les Makefiles
   d'autres logiciels portes.

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

  4.2. Comment adopter un logiciel porte

   Premierement faites en sorte de comprendre vos responsabilites en
   tant que mainteneur. Lisez egalement le Guide du Porteur de
   logiciels. S'il-vous-plait ne vous impliquez pas au del`a de ce
   que vous pensez pouvoir raisonnablement assumer.

   Vous pouvez demander `a devenir mainteneur de n'importe quel
   logiciel porte non maintenu des que vous le souhaitez. Assignez
   simplement votre propre adresse de courriel `a MAINTAINER et
   envoyez un PR (Rapport de Probleme) avec cette modification. Si le
   logiciel porte montre des erreurs lors de sa compilation ou qu'il
   necessite une mise `a jour, vous devriez inclure tout autre
   changement dans le meme PR. Ceci sera utile car beaucoup de
   committers sont moins enclins `a assigner la maintenance `a
   quelqu'un qui n'a pas d'antecedents connus avec FreeBSD. Soumettre
   des PRs qui corrigent des erreurs de compilation ou mettent `a
   jour des logiciels portes est le meilleur moyen de faire ses
   preuves.

   Remplissez votre PR en indiquant la categorie ports et la classe
   change-request. Un committer examinera votre PR, enregistrera vos
   modifications, et finalement fermera le PR. Parfois ce processus
   peut prendre du temps (les committers sont des volontaires eux
   aussi :).

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

5. Le defi pour les mainteneurs d'un logiciel porte

   Cette section vous donnera une idee de pourquoi les logiciels
   portes necessitent qu'on les maintienne et met en evidence les
   responsabilites qui incombent au mainteneur d'un logiciel porte.

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

  5.1. Pourquoi les logiciels portes necessitent une maintenance

   Creer un logiciel portes est une tache ponctuelle dans le temps.
   S'assurer qu'un logiciel porte est `a jour, compile, et s'execute
   toujours correctement necessite un effort de maintenance continu.
   Les mainteneurs sont des personnes qui consacrent une partie de
   leur temps `a atteindre ce but.

   La raison principale pour laquelle les logiciels portes
   necessitent une maintenance est d'apporter `a la communaute
   FreeBSD les tous derniers et meilleurs logiciels tiers
   disponibles. Un defi supplementaire est de s'assurer que les
   logiciels portes continuent `a fonctionner au sein de la structure
   du depot des logiciels portes lorsque celle-ci evolue.

   En tant que mainteneur, vous devrez relever les defis suivants:

     * Nouvelles versions et mises `a jour logicielles. De nouvelles
       versions et mises `a jour de logiciels portes apparaissent
       frequemment, et il est necessaire de les incorporer au depot
       des logiciels portes afin de proposer des logiciels qui soient
       `a jour.

     * Changements dans les dependances. Si des modifications
       significatives sont appliquees `a des dependances de votre
       logiciel porte, il pourrait etre necessaire de le mettre `a
       jour pour qu'il continue `a fonctionner correctement.

     * Changements affectant des logiciels portes dependants. Si
       d'autres logiciels portes dependent d'un logiciel porte dont
       vous avez la maintenance, appliquer des changements `a votre
       logiciel porte pourrait necessiter une coordination avec
       d'autres mainteneurs.

     * Interactions avec d'autres utilisateurs, mainteneurs et
       developpeurs. Une des taches du mainteneur est d'assurer un
       role de support. Vous n'etes pas cense fournir un support
       d'ordre general (mais nous serions ravis si vous decidiez de
       le faire). Ce que vous devriez fournir, c'est un point de
       coordination pour les problemes specifiques `a FreeBSD lies `a
       vos logiciels portes.

     * Chasser les bogues. Un logiciel porte peut souffrir de bogues
       qui sont specifiques `a FreeBSD. Il vous faudra enqueter,
       trouver, et corriger ces bogues lorsqu'ils seront rapportes.
       Tester minutieusement un logiciel porte pour identifier les
       problemes avant qu'ils ne qu'ils atteignent le depot des
       logiciels portes est encore mieux.

     * Changements dans l'infrastructure des logiciels portes et
       politique. Occasionnellement les systemes qui sont utilises
       pour construire les logiciels portes et les paquets binaires
       sont mis `a jour ou bien de nouvelles recommendations
       affectant cette infrastructure sont etablies. Vous devriez
       prendre connaissance de ces changements au cas ou vos
       logiciels portes seraient affectes et necessiteraient une mise
       `a jour.

     * Changements dans le systeme de base. FreeBSD est en constant
       developpement. Les changements de logiciels, bibliotheques, du
       noyau, ou meme des changements de politique peuvent induire
       des demandes de modifications sur les logiciels portes, et ce
       de maniere continue.

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

  5.2. Les responsabilites du mainteneur

    5.2.1. Maintenir ses logiciels portes `a jour

   Cette section expose la maniere de proceder pour maintenir vos
   logiciels portes `a jour.

   Ceci est une vue d'ensemble. Des informations complementaires sur
   la fac,on de mettre `a jour un logiciel porte sont disponibles
   dans le Guide du Porteur d'applications.

    1. Surveillez les mises `a jour

       Surveillez les sorties de nouvelles versions, mises `a jour et
       correctifs de securite effectuees par l'editeur du logiciel.
       Les listes diffusant les annonces ou les pages Web sont utiles
       pour cela. Parfois les utilisateurs vous contacteront et vous
       demanderont quand votre logiciel porte sera mis `a jour. Si
       vous etes occupe par d'autres taches ou que vous n'etes pas en
       mesure pour une raison ou une autre de le mettre `a jour `a ce
       moment, demandez-leur si ils peuvent vous aider en soumettant
       une mise `a jour.

       Il se peut que vous receviez egalement un courrier
       electronique de la part du Verificateur de version des
       logiciels portes de FreeBSD vous informant qu'une version plus
       recente du fichier distribution pour votre logiciel porte est
       disponible. De plus amples informations `a propos de ce
       systeme (incluant les instructions pour ne plus recevoir de
       notification) seront fournies dans les messages.

    2. Integrer les changements

       Lorsqu'ils sont disponibles, integrez les changements `a votre
       logiciel porte. Vous devez etre en mesure de pouvoir generer
       un patch entre le logiciel porte original et celui mis `a
       jour.

    3. Verification et test

       Verifiez minutieusement et testez vos changements:

          * Compilez, installez et testez votre logiciel porte sur
            autant de plates-formes et d'architectures que vous
            pouvez. Il est courant pour un logiciel porte de
            fonctionner sur une branche ou une plate-forme et
            d'echouer sur une autre.

          * Faites en sorte qu'il ne manque aucune dependance `a
            votre logiciel porte. Il est recommande pour cela
            d'installer votre propre tinderbox. Consultez les
            ressources pour plus d'informations.

          * Verifiez que la liste des fichiers du paquetage est `a
            jour. Cela implique de rajouter tout nouveau fichier ou
            repertoire et de supprimer toutes les entrees non
            utilisees.

          * Verifiez votre logiciel porte en utilisant portlint(1)
            comme guide. Consultez les ressources pour obtenir des
            informations importantes sur la maniere d'utiliser
            portlint.

          * Prenez en consideration le fait que des changements sur
            votre logiciel porte pourraient casser d'autres logiciels
            portes. Si tel est le cas, coordonnez les modifications
            avec les mainteneurs de ces autres logiciel portes. Ceci
            est d'autant plus important que votre mise `a jour
            modifie une version de bibliotheque partagee, dans ce cas
            les logiciels portes dependants auront au moins besoin
            d'une incrementation de PORTREVISION pour qu'ils soient
            automatiquement mis `a jour par des outils
            d'automatisation comme portupgrade(1).

    4. Soumettre les changements

       Envoyez votre mise `a jour en soumettant un PR contenant les
       raisons de vos changements ainsi que le correctif contenant
       les differences entre le logiciel porte original et celui mis
       `a jour. Referez-vous `a Ecrire des rapports de probleme
       FreeBSD pour obtenir des informations concernant la maniere
       d'ecrire un bon PR.

         Note : S'il-vous-plait, ne soumettez pas une archive shar(1)
         du logiciel porte entier mais utilisez `a la place diff(1)
         -ruN. De cette maniere, les committers pourront bien plus
         facilement voir exactement les changements qui ont ete
         faits. La section du Guide du Porteur d'applications sur la
         Mise `a jour contient de plus amples informations `a ce
         sujet.

    5. Soyez patient

       A un moment donne un committer s'occupera de votre PR. Cela
       peut prendre quelque minutes, ou quelques semaines -- donc
       s'il-vous-plait, soyez patient.

    6. Faites-nous un retour

       Si un committer detecte un probleme avec vos changements, il
       vous le mentionnera tres probablement. Une reponse rapide de
       votre part aidera `a ce que votre PR soit pris en compte plus
       rapidement, et cela est mieux pour maintenir le fil de la
       discussion lorsque l'on essaie de resoudre un probleme.

    7. Et Finalement

       Vos changements seront enregistres et votre logiciel porte
       aura ete mis `a jour. Le PR sera alors ferme par le committer.
       Et voil`a!

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

    5.2.2. Assurez-vous que vos logiciels portes continuent `a compiler
    correctement

   Cette section concerne la decouverte et la correction de problemes
   qui empechent vos logiciels portes de compiler correctement.

   FreeBSD garantit seulement que le catalogue des logiciels portes
   fonctionne sur la branche -STABLE. Vous devriez utiliser 5-STABLE
   ou 6-STABLE, preferablement cette derniere. Theoriquement vous
   devriez etre capable de vous en sortir en faisant tourner la
   derniere version de chacune des branches stables (car les ABI ne
   sont pas supposees changer) mais si vous pouvez utiliser la
   branche c'est encore mieux.

   Etant donne que la majorite des installations de FreeBSD tourne
   sur des machines compatibles PC (ce que l'on appelle
   l'architecture i386), nous attendons de vous que vous assuriez le
   bon fonctionnement du logiciel porte sur cette architecture.
   Cependant, comme de plus en plus de personnes commencent `a
   utiliser l'architecture amd64 en natif, il va devenir de plus en
   plus important de s'assurer que les logiciels portes fonctionnent
   sur celle-ci aussi. Il est parfaitement acceptable de demander de
   l'aide si vous n'etes pas en possession d'une telle machine.

     Note : Les causes de dysfonctionnement les plus courants sur les
     architectures non-i386 proviennent du fait que les programmeurs
     sont partis du principe que, par exemple, les pointeurs sont des
     ints, ou que le compilateur relativement laxiste gcc 2.95 a ete
     utilise. De plus en plus, les auteurs d'applications
     retravaillent leur code pour supprimer ce genre d'hypotheses --
     mais si l'auteur ne maintient pas activement son code, il se
     pourrait que vous ayez `a le faire vous-meme.

   Voici les taches dont vous devez vous acquitter pour vous assurer
   que votre logiciel porte peut etre compile:

    1. Surveillez les erreurs de compilation

       Verifiez regulierement les fermes de compilation automatique
       des logiciels portes, pointyhat, ainsi que le scanneur des
       fichiers distribution pour voir si un des logiciels portes que
       vous maintenez ne parvient pas `a compiler ou ne peut
       telecharger l'archive dont il a besoin (voir ressources pour
       plus d'informations concernant ces systemes). Des rapports
       d'erreurs peuvent egalement vous parvenir par courrier
       electronique en provenance d'autres utilisateurs ou systemes
       automatises.

    2. Collectez les informations

       Lorsque vous avez detecte un probleme, collectez les
       informations vous permettant de le corriger. Les erreurs de
       compilation rapportees par pointyhat s'accompagnent de
       fichiers d'historique qui vous montreront l'endroit ou
       l'erreur de compilation est survenue. Si le probleme vous a
       ete rapporte par un utilisateur, demandez-lui de vous envoyer
       les informations qui vous aideraient `a diagnostiquer le
       probleme, comme:

          * Les fichiers d'historique de compilation

          * Les commandes et options utilisees pour compiler le
            logiciel porte (incluant le jeu d'options present dans
            /etc/make.conf)

          * La liste des paquets installes sur leur systeme tel
            qu'indique par pkg_info(1)

          * La version de FreeBSD qu'ils utilisent tel qu'indique par
            uname(1) -a

          * De quand date la derniere mise `a jour de leur catalogue
            des logiciels portes

          * De quand date la derniere mise `a jour de leur fichier
            INDEX

    3. Enquetez et trouvez une solution

       Malheureusement il n'existe pas de processus simple pour cela
       mais souvenez-vous cependant que si vous etes bloque, demandez
       de l'aide! La liste de diffusion `a propos du catalogue des
       logiciels portes de FreeBSD est un bon point de depart, et les
       developpeurs en amont sont souvent tres serviables.

    4. Soumettre les changements

       De la meme maniere que pour mettre `a jour un logiciel porte,
       vous devriez inclure les changements, verifier et tester,
       soumettre vos modifications dans un PR, et expliciter vos
       actions si besoin.

    5. Envoyez vos modifications aux auteurs

       Dans certains cas, il vous sera necessaire de produire un
       correctif au logiciel porte pour qu'il fonctionne sur FreeBSD.
       Certains auteurs (mais pas tous) accepteront d'inclure de tels
       correctifs dans leur code pour la prochaine version. Dans ce
       cas, cela pourrait meme etre utile aux utilisateurs d'autres
       systemes bases sur BSD et peut-etre eviter des efforts
       redondants. Par courtoisie, prenez s'il-vous-plait en
       consideration l'envoi de vos correctifs aux auteurs du
       logiciel.

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

    5.2.3. Analysez les rapports d'erreur et PRs lies `a votre logiciel
    porte

   Cette section concerne la decouverte et la correction des bogues.

   Les bogues specifiques `a FreeBSD proviennent generalement
   d'hypotheses faites sur les environnements de compilation et
   d'execution qui ne s'appliquent pas `a FreeBSD. Il est moins
   probable que vous rencontriez un probleme de ce type, mais il se
   peut qu'il soit plus subtile et difficile `a diagnostiquer.

   Voici les taches que vous devrez effectuer pour vous assurer que
   votre logiciel porte continue `a fonctionner comme attendu:

    1. Repondre aux rapports de bogues

       Les bogues peuvent vous etre rapportes par courrier
       electronique par l'intermediaire de la base de donnees des
       rapports de probleme GNATS. Les bogues peuvent egalement vous
       etre rapportes directement par les utilisateurs.

       Vous devriez repondre aux PRs et autres rapports dans les 14
       jours, mais s'il-vous-plait faites votre possible pour ne pas
       prendre autant de temps pour repondre. Essayez de le faire
       aussi vite que possible, meme si c'est juste pour dire que
       vous avez besoin d'un peu de temps avant de pouvoir travailler
       sur ce PR.

    2. Collectez les informations

       Si la personne rapportant le bogue n'a pas dans le meme temps
       fourni de correctif, vous devez collecter les informations
       necessaires qui vous permettront d'en produire un.

       Si le bogue est reproductible, vous pouvez collecter la
       plupart des informations necessaires vous-meme. Dans le cas
       contraire, demandez `a la personne qui vous a rapporte le
       bogue de collecter les informations pour vous, comme:

          * Une description detaillee de leurs actions, le
            comportement attendu du programme ainsi que le
            comportement observe

          * Une copie des donnees d'entree qui ont declenche
            l'apparition du bogue

          * Les informations concernant leur environnement de
            compilation et d'execution -- par exemple, la liste des
            paquetages installes et la sortie de env(1)

          * Images memoire (Core dumps)

          * Traces de la pile memoire (Stack traces)

    3. Eliminez les rapports incorrects

       Certains rapports de bogues peuvent etre incorrects. Par
       exemple, l'utilisateur peut tout simplement avoir mal utilise
       le programme; ou bien les paquets qu'ils ont installes peuvent
       etre obsoletes et necessiter une mise `a jour. Parfois un
       rapport de bogue n'est pas specifique `a FreeBSD. Rapportez
       dans ce cas le bogue aux developpeurs en amont. Si vous avez
       les competences requises pour resoudre le bogue, vous pouvez
       egalement corriger le logiciel porte de sorte que le correctif
       soit applique avant la diffusion par les developpeurs de la
       version suivante du logiciel.

    4. Trouvez une solution

       Tout comme pour les erreurs de compilation, vous devrez
       trouver une solution au probleme. A nouveau, souvenez-vous que
       vous pouvez demander de l'aide si vous etes bloque!

    5. Soumettez ou approuvez les changements

       Comme pour la mise `a jour d'un logiciel porte, vous devriez
       integrer vos changements, verifier et tester, et soumettre vos
       modifications dans un PR (ou envoyer un suivi si un PR existe
       dej`a pour ce probleme). Si un autre utilisateur a soumis des
       changements dans le PR, vous pouvez egalement envoyer un suivi
       indiquant si vous approuvez ou non ces changements.

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

    5.2.4. Fournir du support

   Fournir du support fait partie des taches incombant au mainteneur
   -- pas pour le logiciel lui-meme -- mais pour son logiciel porte
   ainsi que tout probleme lie `a FreeBSD. Les utilisateurs peuvent
   prendre contact avec vous concernant des questions, suggestions,
   problemes ou correctifs. La plupart du temps leur correspondance
   sera specifique `a FreeBSD.

   Occasionnellement vous devrez faire appel `a vos talents
   diplomatiques, et aimablement orienter les utilisateurs `a la
   recherche de support general vers les ressources appropriees.
   Moins frequemment vous rencontrerez une personne demandant
   pourquoi les RPMs ne sont pas `a jour ou comment il peut faire
   pour faire fonctionner le logiciel sous Linux Untel. Profitez de
   l'occasion pour lui dire que votre logiciel porte est `a jour (si
   il l'est, bien evidemment!), et suggerez-lui d'essayer FreeBSD.

   Parfois les utilisateurs et developpeurs considereront que vous
   etes une personne occupee dont le temps est precieux et ils
   prendront en charge une partie de votre travail. Ils pourraient
   par exemple:

     * soumettre un PR ou envoyer un correctif pour mettre `a jour
       votre logiciel porte,

     * enqueter et peut-etre proposer un correctif `a un PR, ou bien

     * proposer une modification `a appliquer `a votre logiciel
       porte.

   Pour ce genre de situations votre principale obligation est de
   repondre rapidement. Le delai maximum qu'a un mainteneur pour
   repondre est de 14 jours. Apres cette periode les changements
   peuvent etre appliques meme sans accord. Les utilisateurs ont pris
   la peine de faire le travail pour vous donc s'il-vous-plait
   essayez de leur repondre rapidement. Puis verifiez, approuvez,
   modifiez ou discutez leurs changements avec eux des que possible.

   Si vous parvenez `a leur faire sentir que leur contribution est
   appreciee (cela devrait etre le cas) vous serez plus en mesure de
   les persuader de faire plus de choses pour vous `a l'avenir :-).

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

6. Trouver et corriger un logiciel porte defectueux

   Il existe deux endroits vraiment appropries pour trouver un
   logiciel porte qui requiere de l'attention.

   Vous pouvez utiliser l'interface Web vers la base de donnees des
   rapports de problemes pour rechercher et consulter les PRs non
   resolus. La majorite des PRs relatifs aux logiciels portes sont
   des mises `a jour, mais en recherchant un peu et en parcourant les
   resumes vous devriez etre capable de trouver quelque chose
   d'interessant sur lequel travailler (la categorie sw-bug est un
   endroit approprie pour commencer).

   L'autre endroit approprie est le Systeme de suivi des logiciels
   portes FreeBSD. Recherchez en particulier les logiciels portes non
   maintenus qui presentent des erreurs de compilation et les
   logiciels portes qui sont marques BROKEN (casse). Il est aussi
   acceptable d'envoyer des changements pour un logiciel porte qui
   est maintenu, mais rappelez-vous de prevenir le mainteneur au cas
   ou il serait dej`a en train de travailler sur le probleme.

   Des lors que vous avez trouve un bogue ou probleme, collectez les
   informations, enqueter et corrigez! Si il existe dej`a un PR,
   envoyez un suivi. Sinon creez un nouveau PR. Vos changements
   seront verifies et, si tout parait correct, enregistres.

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

7. Savoir quand mettre un terme `a sa participation

   Vos interets et vos engagements evoluant, il se peut que vous vous
   rendiez compte que vous n'avez plus le temps de continuer `a
   contribuer `a vos logiciels portes. Aucun soucis ! Faites-le nous
   savoir si vous n'utilisez plus un logiciel porte ou que vous
   n'avez plus le temps ou perdu l'interet d'etre mainteneur. De la
   sorte nous pouvons prendre les mesures necessaires et permettre `a
   d'autres personnes d'essayer de travailler sur des problemes
   concernant le logiciel porte sans attendre votre reponse.
   N'oubliez-pas, FreeBSD est un projet de volontaires, donc si
   maintenir un logiciel porte n'est plus amusant alors c'est
   probablement le bon moment pour laisser `a quelqu'un d'autre le
   soin de s'en occuper!

   En tous les cas, l'Equipe de Gestion des Logiciels Portes
   (portmgr) se reserve le droit d'annuler votre droit de mainteneur
   si vous n'avez pas activement maintenu votre logiciel porte
   pendant un certain temps (actuellement, cette periode est de 3
   mois). Par l`a nous voulons dire qu'il y a eu des problemes non
   resolus ou des mises `a jour en attente qui n'ont pas ete traitees
   pendant cette periode.

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

8. Ressources pour les mainteneurs de logiciels portes et les
participants

   Le Guide du Porteur est votre guide du routard pour le systeme des
   logiciels portes. Gardez-le `a porte de main!

   Ecrire des rapports de probleme pour FreeBSD decrit quelle est la
   meilleure maniere de rediger et soumettre un PR. En 2005 plus de
   onze mille PRs pour les logiciels portes ont ete soumis! Respecter
   les consignes de cet article nous aidera grandement `a reduire le
   temps temps necessaire pour traiter vos PRs.

   La Base de donnees des rapports de problemes.

   Pointyhat (chapeau pointu) est la ferme de compilation des
   logiciels portes. Vous pouvez utiliser Pointyhat pour verifier les
   historiques de compilation des logiciels portes pour toutes les
   architectures et versions majeures.

   Le Systeme de Surveillance des logiciels portes FreeBSD peut vous
   montrer des informations croisees concernant les logiciels portes
   comme les erreurs de compilation et les rapports de probleme. Si
   vous etes un mainteneur vous pouvez l'utiliser pour verifier le
   status de vos logiciels portes. En tant que participant vous
   pouvez l'utiliser pour trouver des logiciels portes defectueux ou
   non maintenus qui ont besoin d'un correctif.

   Le scanneur des fichiers distribution des logiciels portes FreeBSD
   peut vous montrer les portages pour lesquels le fichier
   distribution n'est pas telechargeable. Vous pouvez verifier vos
   propres logiciels portes ou bien trouver des logiciels portes pour
   lesquels leur MASTER_SITES a besoin d'une mise `a jour.

   Utiliser tinderbox est le moyen le plus rigoureux pour tester un
   logiciel porte sur tout le cycle d'installation, empaquetage, et
   desinstallation. Il presente une interface en ligne de commande
   mais peut aussi etre controle par l'intermediaire d'une interface
   Web. Referez-vous `a ports/ports-mgmt/tinderbox. Plus de
   documentation peut etre trouvee `a la page principale de tinderbox
   de marcuscom.

   portlint(1) est une application qui peut etre utilisee pour
   verifier que votre logiciel porte est en conformite avec une
   multitude de recommendations stylistiques et fonctionnelles.
   portlint est une application simple basee sur des heuristiques,
   donc vous devriez l'utiliser seulement `a titre indicatif. Si
   portlint vous suggere des modifications qui ne vous semblent pas
   appropriees, consultez le Guide du Porteur ou demandez conseil.

   La liste de diffusion `a propos du catalogue des logiciels portes
   de FreeBSD convient pour les discussions generales sur les
   logiciels portes. C'est un bon endroit pour demander de l'aide.
   Vous pouvez souscrire, ou lire et rechercher dans les archives de
   la liste. Lire les archives de la liste de diffusion `a propos des
   rapports de bogue concernant le catalogue des logiciels portes de
   FreeBSD et de la liste de diffusion des messages de modification
   CVS concernant les logiciels portes de FreeBSD peut aussi
   presenter de l'interet.

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

        Ce document, ainsi que d'autres peut etre telecharge sur
                   ftp.FreeBSD.org/pub/FreeBSD/doc/.

Pour toutes questions `a propos de FreeBSD, lisez la documentation avant
                 de contacter <questions@FreeBSD.org>.
Pour les questions sur cette documentation, contactez <doc@FreeBSD.org>.
