            Contribuer au Catalogue des logiciels portes de FreeBSD

  Sam Lawrance

  Mark Linimon

   Version: 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 par gabor.
   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>.

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

   Table des matieres

   1. Introduction

   2. Ce que vous pouvez faire pour aider

   3. Creer un logiciel porte

   4. Adopter un logiciel porte non maintenu

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

   6. Trouver et corriger un logiciel porte defectueux

   7. Savoir quand mettre un terme `a sa participation

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

   Index

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.

Index

  C

   Contribuer, Contribuer au Catalogue des logiciels portes de FreeBSD
