[DDR] debian-doc://ddp/manuals.sgml/developers-reference/developers-reference.fr.sgml
Bonsoir à tous,
Je viens de remettre à jour la traduction de la dernière version de la
Référence du développeur Debian (du paquet developers-reference pour la
prochaine v3.3.4, la version CVS d'origine étant maintenant la 1.216).
Voici le fichier developers-reference.fr.sgml.diff (par rapport à la
version v1.37 du CVS Debian). Vous pouvez également consulter le
document complet source SGML (ou compressé) à :
http://olympie.dyndns.org/debian/doc/dev-ref/ ainsi que sous différents
formats (HTML, texte, ps, pdf).
Merci d'avance pour les relectures.
Fred
PS: je préfère ne pas mettre cette version tout de suite dans le CVS car
je préférerais qu'elle soit relue avant d'entrer dans le CVS (et
éventuellement de se retrouver dans un paquet officiel Debian), mais je
suis un peu coincé si personne ne désire en faire la relecture ...
--- developers-reference.fr.sgml Wed Jul 16 15:26:31 2003
+++ developers-reference.fr_new.sgml Thu Jul 17 02:19:11 2003
@@ -1,20 +1,20 @@
<!DOCTYPE debiandoc PUBLIC "-//DebianDoc//DTD DebianDoc//EN" [
<!-- include version information so we don't have to hard code it
within the document -->
- <!entity % versiondata SYSTEM "version.ent"> %versiondata;
+ <!ENTITY % versiondata SYSTEM "version.ent"> %versiondata;
<!-- common, language independant entities -->
- <!entity % commondata SYSTEM "common.ent" > %commondata;
+ <!ENTITY % commondata SYSTEM "common.ent" > %commondata;
<!-- CVS revision of this document -->
- <!entity cvs-rev "$Revision: 1.37 $">
+ <!ENTITY cvs-rev "$Revision: 1.38 $">
<!-- if you are translating this document, please notate the CVS
revision of the developers reference here -->
<!--
- <!entity cvs-en-rev "1.197">
+ <!ENTITY cvs-en-rev "1.216">
-->
<!-- -->
- <!entity FIXME "<em>FIXME:</em> ">
+ <!ENTITY FIXME "<em>FIXME:</em> ">
]>
<debiandoc>
@@ -31,11 +31,11 @@
<translator>version française par Antoine Hulin</translator>
<translator>et Frédéric Bothamy (traducteur actuel)</translator>
<translator>et les membres de la liste <email>debian-l10n-french@lists.debian.org</email></translator>
- <version>Version &version;, &date-fr; (version française 20030502).</version>
+ <version>Version &version;, &date-fr; (version française 20030717).</version>
<copyright>
<copyrightsummary>Copyright © 1998—2003 Adam Di Carlo</copyrightsummary>
- <copyrightsummary>Copyright © 2002 Raphaël Hertzog</copyrightsummary>
+ <copyrightsummary>Copyright © 2002—2003 Raphaël Hertzog</copyrightsummary>
<copyrightsummary>Copyright © 1997, 1998 Christian Schwarz.</copyrightsummary>
<p>
Ce manuel est un logiciel libre ; il peut être redistribué et/ou modifié
@@ -466,10 +466,12 @@
avec les développeurs amonts. Parfois, les utilisateurs établissent des
rapports de bogue qui ne sont pas spécifiques à Debian. Vous devez transmettre
ces rapports de bogue aux développeurs amonts pour qu'ils soient corrigés dans
- les prochaines versions. Il n'est pas de votre responsabilité de corriger les
- bogues qui ne sont pas spécifiques à Debian. Toutefois, si vous êtes capable de
- le faire, nous vous encourageons à contribuer au développement amont en
- proposant un correctif qui corrige le bogue. Les utilisateurs et responsables
+ les prochaines versions.
+<p>
+Bien qu'il ne soit pas de votre responsabilité de corriger les
+ bogues non spécifiques à Debian, vous pouvez le faire si vous en êtes capable.
+ Quand vous faites de telles corrections, assurez-vous de les envoyer
+ également au développeur amont. Les utilisateurs et responsables
Debian proposent souvent des correctifs pour corriger des bogues amonts, il
vous faudra alors évaluer ce correctif puis le transmettre aux développeurs
amonts.
@@ -534,10 +536,30 @@
<sect id="mailing-lists">Les listes de diffusion
<p>
-Le serveur de liste de diffusion est <tt>&lists-host;</tt>.
+Une grande partie des discussions entre les développeurs Debian (et les
+utilisateurs) est gérée par un vaste éventail de listes de diffusion que nous
+hébergeons à <tt><url id="http://&lists-host;/"; name="&lists-host;"></tt>.
+Pour en savoir plus sur comment s'abonner ou se désabonner, comment envoyer un
+message et comment ne pas en envoyer, comment retrouver d'anciens messages et
+comment les rechercher, comment contacter les responsables des listes et pour
+sevoir d'autres informations sur les listes de diffusion, veuillez lire <url
+id="&url-debian-lists;">. Cette section ne couvrira que les aspects des listes
+de diffusion qui ont un intérêt particulier pour les développeurs.
+
+ <sect1 id="mailing-lists-rules">Rêgles de base d'utilisation
+<p>
+Lorsque vous répondez sur une liste de diffusion, veuillez ne pas envoyer de
+copie (<tt>CC</tt>) à l'auteur d'origine sauf s'il le demande explicitement.
+Toute personne envoyant un message à une liste de diffusion devrait la suivre
+pour voir les réponses.
+<p>
+Le multi-postage (cross-posting) (envoyer le même message à plusieurs listes)
+est découragé. Comme toujours sur le net, veuillez réduire la citation des
+articles auxquels vous répondez. En général, veuillez adhérez aux conventions
+usuelles d'envoi de messages.
<p>
-Les archives des listes de diffusion sont consultables à <url
- id="&url-lists-archives;">.
+Veuillez lire le <url name="code de conduite"
+id="&url-debian-lists;#codeofconduct"> pour plus d'informations.
<sect1 id="core-devel-mailing-lists">Principales listes pour les
responsables
@@ -557,10 +579,10 @@
</list>
<p>
Il existe d'autres listes de diffusion spécialisées dans différents thèmes.
- Reportez-vous à la page <url id="&url-debian-lists-subscribe;"> pour en obtenir
+ Reportez-vous à la page <url id="http://&lists-host;/";> pour en obtenir
la liste complète.
- <sect1 id="mailing-lists-subunsub">S'abonner et se désabonner
+<!-- <sect1 id="mailing-lists-subunsub">S'abonner et se désabonner
<p>
Pour vous abonner ou vous désabonner de n'importe quelle liste, envoyez un
courrier électronique à
@@ -593,6 +615,7 @@
<p>
Veuillez lire le <url id="&url-debian-lists;" name="code de conduite"> pour plus
d'informations.
+ -->
<sect1 id="mailing-lists-special">Listes spéciales
<p>
@@ -611,6 +634,19 @@
telles que des échanges avec les auteurs amonts à propos de licences, de bogues
ou encore des discussions sur le projet avec d'autres personnes.
+ <sect1 id="mailing-lists-new">Demander une nouvelle liste relative au développement
+<p>
+Avant de demander un liste de diffusion liée au développement d'un paquet (ou
+d'un petit groupe de paquets liés), veuillez considérer si l'utilisation d'un
+alias (via un fichier .forward-aliasname sur master.debian.org, ce qui se
+traduit en une adresse raisonnablement agréable
+<var>you-aliasname@debian.org</var>) ou une liste de diffusion auto-gérée sur
+<qref id="alioth">Alioth</qref> serait plus appropriée.
+<p>
+Si vous décidez qu'une liste de diffusion standard sur lists.debian.org est
+vraiment ce que vous voulez, lancez-vous et faites une demande en suivant <url
+name="le guide" id="&url-debian-lists-new;">.
+
<sect id="irc-channels">Canaux IRC
<p>
@@ -972,7 +1008,7 @@
de contrôle (<prgn>md5sums</prgn>) et quelques informations supplémentaires
concernant le paquet (responsable, version, etc.).
- <sect1>Les répertoires des distributions
+ <sect1>Les distributions
<p>
L'organisation des répertoires présentée précédemment est elle-même englobée par
les <em>répertoires des distributions</em>. Chaque distribution est incluse
@@ -1046,6 +1082,61 @@
Notez que, pendant la période de gel, les développements continuent sur la
distribution <em>unstable</em> car cette distribution reste en place.
+ <sect2 id="testing">
+ <heading>Informations complémentaires sur la distribution
+ « testing »</heading>
+<p>
+Les scripts qui mettent à jour la distribution <em>testing</em> sont exécutés
+ chaque jour après l'installation des paquets mis à jour. Ils génèrent les
+ fichiers <file>Packages</file> pour la distribution <em>testing</em>, mais ils
+ le font d'une manière intelligente pour éviter toute incohérence et essayer de
+ n'utiliser que des paquets sans bogue.
+<p>
+L'inclusion d'un paquet d'<em>unstable</em> est soumise aux
+ conditions suivantes :
+<list compact="compact">
+<item><p>Le paquet doit avoir été disponible dans <em>unstable</em> depuis
+ plusieurs jours ; le nombre précis dépend du champ d'urgence de
+ l'envoi. Il s'agit de 10 jours pour une urgence faible, 5 jours pour une
+ urgence moyenne et 2 jours pour une urgence élevée. Ces délais peuvent
+ être doublés lors d'un gel de distribution ;</item>
+<item><p>Il doit avoir moins de bogues empêchant l'intégration dans la distribution que la
+ version disponible dans <em>testing</em> ;</item>
+<item><p>Il doit être disponible pour toutes les architectures pour lesquelles
+ il a été auparavant construit. <ref id="madison"> peut être
+ intéressant pour vérifier cette information ;</item>
+<item><p>Il ne doit pas casser les dépendances d'un paquet qui est déjà
+ disponible dans <em>testing</em> ;</item>
+<item><p>Les paquets dont il dépend doivent soit être déjà disponibles dans
+ <em>testing</em> soit être acceptés dans <em>testing</em> au
+ même moment (et ils doivent eux-mêmes respecter tous ces
+ critères).</item>
+</list>
+<p>
+Pour savoir si un paquet a progressé ou non dans <em>testing</em>, veuillez voir la
+ sortie du script de <em>testing</em> sur la <url name="page web de la distribution testing"
+id="&url-testing-maint;"> ou utilisez le programme <prgn>grep-excuses</prgn>
+inclus dans le paquet <package>devscripts</package>. Si l'on veut rester
+informé de la progression de ses paquets dans <em>testing</em>, on peut
+facilement le mettre dans la <manref
+ section="5" name="crontab">.
+<p>
+Le fichier <file>update_excuses</file> ne donne pas toujours la raison précise
+ pour laquelle un paquet est refusé, on peut avoir à la chercher soi-même en
+ regardant ce qui serait cassé avec l'inclusion du paquet. La <url
+ id="&url-testing-maint;" name="page web de la distribution testing"> donne plus
+ d'informations à propos des problèmes courants qui peuvent occasionner cela.
+<p>
+Parfois, certains paquets n'entrent jamais dans <em>testing</em> parce que le
+ jeu des inter-relations est trop compliqué et ne peut être résolu par le
+ script. Dans ce cas, le responsable de version doit être contacté et il forcera
+ l'inclusion du paquet.
+ <p>
+En général, veuillez vous référer à la <url name="page web de la distribution testing"
+id="&url-testing-maint;"> pour plus d'informations. Cette page inclut également
+des réponses aux questions fréquemment posées.
+
+
<sect2 id="experimental">Experimental
<p>
La distribution <em>experimental</em> est une distribution particulière. Ce n'est
@@ -1245,74 +1336,20 @@
<example>DELAY=5 dupload --to delayed <changes-file></example>
- <sect id="testing">
- <heading>La distribution « testing »
-<p>
-Les scripts qui mettent à jour la distribution <em>testing</em> sont exécutés
- chaque jour après l'installation des paquets mis à jour. Ils génèrent les
- fichiers <file>Packages</file> pour la distribution <em>testing</em>, mais ils
- le font d'une manière intelligente pour éviter toute incohérence et essayer de
- n'utiliser que des paquets sans bogue.
-<p>
-L'inclusion d'un paquet d'<em>unstable</em> est soumise aux
- conditions suivantes :
-<list compact="compact">
-<item><p>Le paquet doit avoir été disponible dans <em>unstable</em> depuis
- plusieurs jours ; le nombre précis dépend du champ d'urgence de
- l'envoi. Il s'agit de 10 jours pour une urgence faible, 5 jours pour une
- urgence moyenne et 2 jours pour une urgence élevée. Ces délais peuvent
- être doublés lors d'un gel de distribution ;</item>
-<item><p>Il doit avoir moins de bogues empêchant l'intégration dans la distribution que la
- version disponible dans <em>testing</em> ;</item>
-<item><p>Il doit être disponible pour toutes les architectures pour lesquelles
- il a été auparavant construit. <ref id="madison"> peut être
- intéressant pour vérifier cette information ;</item>
-<item><p>Il ne doit pas casser les dépendances d'un paquet qui est déjà
- disponible dans <em>testing</em> ;</item>
-<item><p>Les paquets dont il dépend doivent soit être déjà disponibles dans
- <em>testing</em> soit être acceptés dans <em>testing</em> au
- même moment (et ils doivent eux-mêmes respecter tous ces
- critères).</item>
-</list>
-<p>
-Pour savoir si un paquet a progressé ou non dans <em>testing</em>, veuillez voir la
- sortie du script de <em>testing</em> sur la <url name="page web de la distribution testing"
-id="&url-testing-maint;"> ou utilisez le programme <prgn>grep-excuses</prgn>
-inclus dans le paquet <package>devscripts</package>. Si l'on veut rester
-informé de la progression de ses paquets dans <em>testing</em>, on peut
-facilement le mettre dans la <manref
- section="5" name="crontab">.
-<p>
-Le fichier <file>update_excuses</file> ne donne pas toujours la raison précise
- pour laquelle un paquet est refusé, on peut avoir à la chercher soi-même en
- regardant ce qui serait cassé avec l'inclusion du paquet. La <url
- id="&url-testing-maint;" name="page web de la distribution testing"> donne plus
- d'informations à propos des problèmes courants qui peuvent occasionner cela.
-<p>
-Parfois, certains paquets n'entrent jamais dans <em>testing</em> parce que le
- jeu des inter-relations est trop compliqué et ne peut être résolu par le
- script. Dans ce cas, le responsable de version doit être contacté et il forcera
- l'inclusion du paquet.
- <p>
-En général, veuillez vous référer à la <url name="page web de la distribution testing"
-id="&url-testing-maint;"> pour plus d'informations. Cette page inclut également
-des réponses aux questions fréquemment posées.
-
-
<sect id="pkg-info">Informations sur un paquet
<p>
<sect1 id="pkg-info-web">Sur le web
<p>
Chaque paquet a plusieurs pages web dédiées.
- <tt>http://&packages-host;/<var>package-name</var></tt> affiche chaque version
+ <tt>http://&packages-host;/<var>nom-paquet</var></tt> affiche chaque version
du paquet disponible dans les différentes distributions. Les informations
détaillées par version incluent la description du paquet, les dépendances et
des liens pour récupérer le paquet.
<p>
Le système de suivi des bogues trie les bogues par paquet. Vous pouvez regarder
les bogues de chaque paquet à
- <tt>http://&bugs-host;/<var>package-name</var></tt>.
+ <tt>http://&bugs-host;/<var>nom-paquet</var></tt>.
<sect1 id="madison">L'outil <prgn>madison</prgn>
<p>
@@ -1336,18 +1373,16 @@
<sect id="pkg-tracking-system">Système de suivi des paquets
-<!-- FIXME: talk about
-http://qa.debian.org/developer.php?login=aph@debian.org
-http://packages.qa.debian.org/
-http://packages.qa.debian.org/pkgname -->
<p>
Le système de suivi des paquets (PTS)<footnote>« Package Tracking
System »</footnote> est un outil pour suivre par courrier l'activité
- concernant un paquet source. Il suffit simplement de s'inscrire à un
- paquet source pour recevoir les courriers liés à celui-ci. Vous
- recevrez les mêmes courriers que le responsable. Chaque courrier envoyé par le
- PTS est classé et associé à l'un des mots-clés listés ci-dessous. Ceci vous
- permettra de sélectionner les courriers que vous voulez recevoir.
+ concernant un paquet source. Cela veut vraiment dire que vous pourrez recevoir
+ les mêmes courriers que le responsable, simplement en vous inscrivant au paquet
+ dans le PTS.
+<p>
+Chaque courrier envoyé par le PTS est classé et associé à l'un des mots-clés
+ listés ci-dessous. Ceci vous permettra de sélectionner les courriers que vous
+ voulez recevoir.
<p>
Par défaut, vous recevrez :
<taglist>
@@ -1356,11 +1391,11 @@
suivent.
<tag><tt>bts-control</tt>
- <item>Les courriers de contrôle notifiant le changement d'état de l'un des
- bogues.
+ <item>Les courriers de notification de <email>control@bugs.debian.org</email>
+ sur les changement d'état de l'un des rapports de bogue.
<tag><tt>upload-source</tt>
- <item>Le courrier de confirmation de <prgn>katie</prgn> quand un paquet
+ <item>Le courrier de notification de <prgn>katie</prgn> quand un paquet
source envoyé a été accepté.
<tag><tt>katie-other</tt>
@@ -1370,33 +1405,38 @@
<tag><tt>default</tt>
<item>Tout courrier non automatique envoyé au PTS par les personnes qui
- veulent contacter les inscrits au paquet.
+ veulent contacter les inscrits au paquet. Ceci peut être fait en
+ envoyant un courrier à <tt><var>paquet-source</var>@&pts-host;</tt>. Pour
+ prévenir l'envoi de spam, tous les courriers envoyés à ces adresses doivent
+ contenir l'en-tête <tt>X-PTS-Approved</tt> avec une valeur non vide.
<tag><tt>summary</tt>
- <item>À l'avenir, vous pourriez recevoir des courriers de résumé pour vous
- tenir informé de l'état du paquet (statistiques sur les bogues, vue
- générale du portage, progression dans <em>testing</em>,
+ <item>(Ceci est une extension prévue.)
+ Les courriers de résumé réguliers sur l'état du paquet (statistiques sur
+ les bogues, vue générale du portage, progression dans <em>testing</em>,
etc.).
</taglist>
<p>
-Vous pouvez également décider de recevoir plus d'informations :
+Vous pouvez également décider de recevoir des informations supplémentaires :
<taglist>
<tag><tt>upload-binary</tt>
<item>Le courrier d'information de <prgn>katie</prgn> quand un paquet
- binaire envoyé est accepté (pour vérifier que votre paquet est
- recompilé pour toutes les architectures).
+ binaire envoyé est accepté. En d'autres termes, à chaque fois qu'un
+ démon de compilation ou un porteur envoie votre paquet pour une autre
+ architecture, vous recevez un courrier pour suivre comment votre paquet
+ est recompilé pour toutes les architectures.
<tag><tt>cvs</tt>
- <item>Les modifications CVS<footnote><p><em>CVS commits</em></footnote> si le
- responsable a mis en place un système pour faire suivre les
- notifications de modifications vers le PTS.
-
- <tag><tt>ddtp</tt>
- <item>Les traductions des descriptions ou des questionnaires debconf soumis
- au Projet de traduction des descriptions de paquets
- Debian<footnote><p><em>Debian Description Translation Project,
- DDTP</em></footnote>.
+ <item>Les notifications de modifications CVS<footnote><p><em>CVS
+ commits</em></footnote> si le responsable a mis en place un système pour
+ faire suivre les notifications de modifications vers le PTS.
+
+ <tag><tt>ddtp</tt>
+ <item>Les traductions des descriptions ou des questionnaires debconf soumis
+ au Projet de traduction des descriptions de paquets
+ Debian<footnote><p><em>Debian Description Translation Project,
+ DDTP</em></footnote>.
</taglist>
@@ -1406,28 +1446,27 @@
commandes à <email>pts@qa.debian.org</email>.
<taglist>
- <tag><tt>subscribe <srcpackage> [<email>]</tt>
- <item>Inscrit <var>email</var> aux communications liées au paquet source
- <var>srcpackage</var>. L'adresse de l'expéditeur est utilisée si le
- second argument n'est pas présent. Si <var>srcpackage</var> n'est pas
+ <tag><tt>subscribe <paquet source> [<adresse>]</tt>
+ <item>Inscrit <var>adresse</var> aux communications liées au paquet source
+ <var>paquet source</var>. L'adresse de l'expéditeur est utilisée si le
+ second argument n'est pas présent. Si <var>paquet source</var> n'est pas
un paquet source valide, vous obtiendrez un avertissement. Cependant,
s'il s'agit d'un paquet binaire valide, le PTS vous inscrira pour le
paquet source correspondant.
- <tag><tt>unsubscribe <srcpackage> [<email>]</tt>
+ <tag><tt>unsubscribe <paquet source> [<adresse>]</tt>
<item>Supprime une inscription précédente au paquet source
- <var>srcpackage</var> en utilisant l'adresse spécifiée ou l'adresse de
+ <var>paquet source</var> en utilisant l'adresse spécifiée ou l'adresse de
l'expéditeur si le second argument n'est pas rempli.
- <tag><tt>which [<email>]</tt>
+ <tag><tt>which [<adresse>]</tt>
<item>Liste les inscriptions pour l'expéditeur ou pour l'adresse indiquée
si elle est spécifiée.
- <tag><tt>keyword [<email>]</tt>
- <item>Donne les mots-clés que vous acceptez. Chaque courrier envoyé par le
- PTS est associé à un mot-clé et vous ne recevez que les courriers associés
- aux mots-clés que vous avez acceptés. Voici la liste des mots-clés
- disponibles :
+ <tag><tt>keyword [<adresse>]</tt>
+ <item>Donne les mots-clés que vous acceptez. Pour une explication des ces
+ mots-clés, <qref id="pkg-tracking-system">voir ci-dessus</qref>. Voici
+ un rapide résumé :
<list>
<item><tt>bts</tt> : courriers venant du système de gestion de bogues (BTS) Debian
<item><tt>bts-control</tt> : réponses aux courriers envoyés à
@@ -1447,16 +1486,16 @@
pas automatiques)
</list>
- <tag><tt>keyword <srcpackage> [<email>]</tt>
+ <tag><tt>keyword <paquet source> [<adresse>]</tt>
<item>Identique à l'élément précédent, mais pour un paquet source donné
car vous pouvez sélectionner un ensemble de mots-clés différent pour
chaque paquet source.
- <tag><tt>keyword [<email>] {+|-|=} <list of keywords></tt>
+ <tag><tt>keyword [<adresse>] {+|-|=} <liste de mots-clés></tt>
<item>Accepte (+) ou refuse (-) les courriers associés au(x) mot(s)-clé(s).
Définit la liste (=) des mots-clés acceptés.
- <tag><tt>keyword <srcpackage> [<email>] {+|-|=} <list of keywords></tt>
+ <tag><tt>keyword <paquet source> [<adresse>] {+|-|=} <liste de mots-clés></tt>
<item>Identique à l'élément précédent, mais remplace la liste des mots-clés
pour le paquet source indiqué.
@@ -1468,9 +1507,9 @@
<sect1 id="pts-mail-filtering">Filtrer les courriers du PTS
<p>
Une fois que vous vous êtes inscrit à un paquet, vous recevrez les courriers
- envoyés à <tt><var>srcpackage</var>@packages.qa.debian.org</tt>. Ces courriers
+ envoyés à <tt><var>paquet source</var>@packages.qa.debian.org</tt>. Ces courriers
ont des en-têtes spéciaux ajoutés pour vous permettre de les filtrer dans des
- boîtes aux lettres avec <prgn>procmail</prgn>. Les en-têtes ajoutés sont
+ boîtes aux lettres (par exemple, avec <prgn>procmail</prgn>). Les en-têtes ajoutés sont
<tt>X-Loop</tt>, <tt>X-PTS-Package</tt>, <tt>X-PTS-Keyword</tt> et
<tt>X-Unsubscribe</tt>.
<p>
@@ -1487,15 +1526,101 @@
<p>
Si vous utilisez un référentiel CVS accessible publiquement pour maintenir votre
paquet Debian, vous pouvez vouloir faire suivre les notifications de
- modifications vers le PTS pour que les inscrits (par exemple, des
+ modifications vers le PTS pour que les inscrits (ainsi que des possibles
co-responsables) puissent suivre de près l'évolution du paquet.
<p>
-C'est très facile à mettre en place. Une fois que votre référentiel génère des
- notifications de modifications, vous devez simplement vous assurer qu'il envoie une
- copie de tous ces courriers à <tt><var>srcpackage</var>_cvs@&pts-host;</tt>.
- Seules les personnes qui ont accepté le mot-clé <em>cvs</em> recevront les
- notifications.
-
+Une fois que votre référentiel génère des notifications de modifications, vous
+ devez simplement vous assurer qu'il envoie une copie de tous ces courriers à
+ <tt><var>paquet source</var>_cvs@&pts-host;</tt>. Seules les personnes qui ont
+ accepté le mot-clé <em>cvs</em> recevront les notifications.
+
+ <sect1 id="pts-web">L'interface web du PTS
+<p>
+Le PTS possède une interface web à <url id="http://&pts-host;/";> qui réunit
+beaucoup d'informations au
+même endroit à propos de chaque paquet source. Il propose plusieurs liens utiles
+(BTS, statistiques QA, informations de contact, état de traduction DDTP,
+journaux de compilation automatique) et il regroupe beaucoup d'autres informations
+provenant de différents endroits (les 30 dernières entrées de changelog, l'état
+dans <em>testing</em>, etc.). Il s'agit d'un outil très pratique si vous désirez
+connaître ce qu'il en est d'un paquet source spécifique. De plus, il y a un
+formulaire qui permet de facilement s'inscrire au PTS par courrier.
+ <p>
+Vous pouvez aller directement à la page web concernant un paquet source avec une
+URL comme <tt>http://&pts-host;/<var>paquet source</var></tt>.
+<p>
+Cette interface a été conçue comme un portail pour le développements des
+paquets : vous pouvez ajouter du contenu personnalisé aux pages de vos
+paquets. Vous pouvez ajouter des « informations
+statiques »<footnote><em>Static information</em></footnote> (des annonces
+qui sont destinées à rester disponibles indéfiniment) et des nouvelles dans la
+section « dernières nouvelles »<footnote><em>Latest
+news</em></footnote>.
+<p>
+Les annonces statiques peuvent être utilisées pour indiquer :
+<list>
+<item>la disponibilité d'un projet hébergé sur <qref id="alioth">Alioth</qref> pour la
+co-maintenance du paquet,
+<item>un lien vers le site web amont,
+<item>un lien vers le suivi de bogues amont,
+<item>l'existence d'un canal IRC dédié au logiciel,
+<item>toute autre ressource disponible qui peut être utile à la maintenance du paquet.
+</list>
+Les nouvelles usuelle peuvent être utilisées pour annoncer que :
+<list>
+<item>des paquets bêta sont disponibles pour test,
+<item>des paquets finaux sont attendus pour la semaine prochaine,
+<item>l'empaquètement est sur le point d'être intégralement refait,
+<item>des rétro-portages sont disponibles,
+<item>le responsable est en vacance (s'il désire publier cette information),
+<item>une mise à jour indépendante (NMU) est en cours de réalisation,
+<item>quelque chose d'important va affecter le paquet.
+</list>
+<p>
+Les deux types d'informations sont générés de façon similaire : il vous
+suffit d'envoyer un courrier soit à <email>pts-static-news@qa.debian.org</email>
+(pour les annonces statiques), soit à <email>pts-news@qa.debian.org</email>
+(pour les nouvelles usuelles). Le courrier devrait indiquer quel paquet est
+concerné par la nouvelle en donnant le nom du paquet source dans un en-tête de
+courrier <tt>X-PTS-Package</tt> ou dans un pseudo-en-tête <tt>Package</tt>
+(comme pour les rapports de bogue du BTS). Si une URL est disponible dans
+l'en-tête de courrier <tt>X-PTS-Url</tt> ou dans un pseudo-en-tête <tt>Url</tt>,
+le résultat est un lien vers cette URL au lieu d'une nouvelle complète.
+<p>
+Voici quelques exemples de courriers valides utilisés pour générer des nouvelles dans
+le PTS. Le premier ajoute un lien vers l'interface cvsweb de debian-cd dans la
+section « Informations statiques » :
+<example>
+From: Raphael Hertzog <hertzog@debian.org>
+To: pts-static-news@qa.debian.org
+Subject: Browse debian-cd CVS repository with cvsweb
+
+Package: debian-cd
+Url: http://cvs.debian.org/debian-cd/
+</example>
+<p>
+Le second est une annonce envoyée à une liste de diffusion et également
+envoyée au PTS pour qu'elle soit publiée sur la page web du PTS du paquet. Notez
+l'utilisation du champ BCC pour éviter que des réponses ne soient envoyées par
+erreur au PTS.
+<example>
+From: Raphael Hertzog <hertzog@debian.org>
+To: debian-gtk-gnome@lists.debian.org
+Bcc: pts-news@qa.debian.org
+Subject: Galeon 2.0 backported for woody
+X-PTS-Package: galeon
+
+Hello gnomers!
+
+I'm glad to announce that galeon has been backported for woody. You'll find
+everything here:
+...
+</example>
+<p>
+Réfléchissez-y à deux fois avant d'ajouter une nouvelle au PTS car vous ne
+pourrez pas l'enlever par la suite et vous ne pourrez pas non plus l'éditer. La
+seule chose que vous puissiez faire est d'envoyer une deuxième nouvelle qui va
+déprécier l'information contenue dans la précédente.
<sect id="ddpo">Vue d'ensemble des paquets d'un développeur
<p>
@@ -1510,6 +1635,21 @@
de bogues ouverts et pour ne pas oublier quels paquets sont sous votre
responsabilité.
+ <sect id="alioth">Debian *Forge: Alioth
+<p>
+Alioth est un service de Debian plutôt récent, basé sur une version légèrement
+modifiée du logiciel GForge (qui a évolué à partir de SourceForge). Ce logiciel
+offre aux développeurs l'accès à des outils faciles d'utilisation comme un
+suiveur de bogues, un gestionnaire de correctifs, un gestionnaire de tâches et
+de projets, un service d'hébergement de fichiers, des listes de diffusion, des
+dépôts CVS, etc. Tous ces outils sont gérés par une interface web.
+<p>
+Alioth est destiné à fournir des facilités pour des projets de logiciels
+soutenus ou dirigés par Debian, à faciliter les contributions de développeurs
+externes aux projets initiés par Debian et à aider des projets dont les buts
+sont de promouvoir Debian ou ses dérivés.
+<p>
+Pour plus d'informations, veuillez visiter <url id="&url-alioth;">.
<chapt id="pkgs">Gestion des paquets
<p>
@@ -1554,7 +1694,7 @@
personne travaille déjà dessus.
<item>D'autres personnes qui envisagent de travailler sur le même paquet
apprendront ainsi qu'il existe déjà un volontaire, l'effort peut alors
- être partagé.</item>
+ être partagé.
<item>Cela permet aux autres responsables de connaître le nouveau
paquet mieux que ne le permettent la description d'une ligne et l'habituelle
entrée de type changelog <em>Initial release</em> postée sur
@@ -1614,7 +1754,7 @@
jour.
<item>Exécutez <prgn>lintian</prgn> sur votre paquet. Vous pouvez exécuter
<prgn>lintian</prgn> comme suit : <tt>lintian -v
- <var>package-version</var>.changes</tt>. Ce programme fera une
+ <var>version-paquet</var>.changes</tt>. Ce programme fera une
vérification sur les paquets source et binaire. Si vous ne comprenez pas
les messages générés par <prgn>lintian</prgn>, essayez l'option
<tt>-i</tt>. Cette option rendra <prgn>lintian</prgn> beaucoup plus
@@ -1635,9 +1775,9 @@
</list>
-<sect id="sourcelayout">Disposition du paquet source
+ <sect id="sourcelayout">Disposition du paquet source
<p>
-Il existe deux types de paquets sources Debian :
+ Il existe deux types de paquets sources Debian :
<list>
<item>les paquets soi-disant appelés <em>natifs</em> pour lesquels il
n'y a pas de distinction entre les sources d'origine et les
@@ -1677,7 +1817,7 @@
un fichier <tt>tar</tt> identique à l'octet près à celui déjà présent dans
l'archive.
- <sect1 id="distribution">Choisir une distribution
+ <sect id="distribution">Choisir une distribution
<p>
Chaque envoi doit spécifier à quelle distribution le paquet est destiné. Le
processus de construction de paquet extrait cette information à partir de la
@@ -1698,8 +1838,8 @@
distributions. En particulier, il est absurde de combiner la distribution
<em>experimental</em> avec tout autre chose.
- <sect1 id="upload-stable">Mise à jour d'un paquet de la distribution
- <em>stable</em>
+ <sect1 id="upload-stable">Cas spécial mise à jour d'un paquet de
+ la distribution <em>stable</em>
<p>
Livrer un paquet pour la distribution <em>stable</em> signifie que le paquet
sera dirigé vers le répertoire <file>stable-proposed-updates</file> des
@@ -1710,20 +1850,22 @@
supplémentaires. Un paquet de cette distribution ne devrait être mis à jour
que dans les cas suivants :
<list>
-<item>un problème de sécurité (un avis de sécurité Debian<footnote>Debian
- security advisory</footnote>),
<item>un problème fonctionnel vraiment critique,
<item>un paquet devenu ininstallable,
<item>un paquet indisponible pour une architecture.
</list>
<p>
+Par le passé, des envois vers <em>stable</em> étaient également utilisés pour
+corriger les problèmes de sécurité. Cependant, cette pratique est dépréciée car
+les envois utilisés pour les avis de sécurité Debian<footnote>Debian security
+advisory</footnote> sont automatiquement copiés dans l'archive
+<file>proposed-updates</file> appropriée quand l'avis est publié. Reportez-vous
+à <ref id="bug-security"> pour des informations plus détaillées sur la gestion
+des problèmes de sécurité.
+<p>
Il est fortement déconseillé de changer quoi que ce soit si ce
n'est pas important car même une modification triviale peut provoquer un
- bogue. Livrer une nouvelle version amont d'un logiciel pour
- corriger un problème de sécurité est désapprouvé ; dans la plupart
- des cas, la bonne solution consiste à prendre le correctif correspondant de
- la nouvelle version amont et à l'appliquer à l'ancienne (faire un
- rétroportage<footnote><em>backport</em></footnote> du correctif).
+ bogue.
<p>
Les paquets livrés pour <em>stable</em> doivent être compilés avec la
distribution <em>stable</em> pour que leurs dépendances se limitent aux
@@ -1742,8 +1884,8 @@
décrivez, dans le fichier changelog, vos changements pour une livraison
vers <em>stable</em>, sinon le paquet ne sera pas pris en considération.
- <sect1 id="upload-t-p-u">Mise à jour d'un paquet de la distribution
- <em>testing-proposed-updates</em>
+ <sect1 id="upload-t-p-u">Cas spécial : Mise à jour d'un paquet de la
+ distribution <em>testing-proposed-updates</em>
<p>
La distribution <em>testing</em> est peuplée avec des paquets en provenance
d'<em>unstable</em> selon des règles expliquées dans <ref id="testing">.
@@ -1776,7 +1918,14 @@
que développeur Debian. Si vous utilisez <prgn>scp</prgn> ou
<prgn>rsync</prgn> pour télécharger vos paquets, placez-les dans
&us-upload-dir;. Si vous utilisez un FTP anonyme, placez-les dans
- &upload-queue;. Attention, il est préférable de transférer le fichier
+ &upload-queue;.
+<p>
+Si vous désirez utiliser la fonctionnalité de délai décrite dans <ref
+id="delayed-incoming">, vous devez effectuer votre envoi vers
+<tt>ftp-master</tt>. Il s'agit de la seule destination d'envoi supportant
+l'incoming différé.
+<p>
+Attention, il est préférable de transférer le fichier
<tt>changes</tt> en dernier. Dans le cas contraire, votre livraison pourrait
être rejetée car l'outil de maintenance de l'archive pourrait lire le fichier
<tt>changes</tt> et constater que les fichiers ne sont pas tous présents. Si
@@ -1981,7 +2130,7 @@
Les fonctionnalités du système de suivi des bogues qui intéressent les
développeurs sont décrites dans la <url id="&url-bts-devel;" name="documentation
du BTS pour les développeurs">. Ceci inclut la fermeture des bogues, l'envoi des
-messages de suivi, l'assignation des niveaux de gravité, des marques,
+messages de suivi, l'assignation des niveaux de gravité et des marques,
l'indication que les bogues ont été envoyés au développeur amont et autres
problèmes.
<p>
@@ -1997,7 +2146,7 @@
Si vous voulez être un bon responsable, consultez régulièrement la page du <url
id="&url-bts;" name="système de suivi des bogues">. Cette page contient tous
les rapports de bogue qui concernent vos paquets. Vous pouvez les vérifier avec
- cette page : <tt>http://&bugs-host;/<var>yourlogin</var>@debian.org</tt>.
+ cette page : <tt>http://&bugs-host;/<var>votre_compte</var>@debian.org</tt>.
<p>
Les responsables interagissent avec le système de suivi des bogues en utilisant
l'adresse électronique <tt>&bugs-host;</tt>. Vous trouverez une documentation
@@ -2017,7 +2166,8 @@
<sect1 id="bug-answering">Répondre à des rapports de bogue
<p>
-Assurez-vous que toutes vos discussions concernant les bogues sont envoyées au
+Lorsque vous répondez à des rapports de bogue, assurez-vous que toutes vos
+ discussions concernant les bogues sont envoyées au
rapporteur du bogue et au bogue lui-même (<email>123@&bugs-host;</email>
par exemple). Si vous rédigez un nouveau courrier et que vous ne vous souvenez
plus de l'adresse du rapporteur de bogue, vous pouvez utiliser l'adresse
@@ -2026,6 +2176,10 @@
dire que vous n'avez pas besoin d'envoyer une copie du courrier à
<email>123@&bugs-host;</email>).
<p>
+Si vous recevez un bogue mentionnant « FTBFS », cela veut dire
+« Fails To Build From Source » (Erreur de construction à partir du
+source). Les porteurs emploient fréquemment cet acronyme.
+<p>
Une fois que vous avez traité un rapport de bogue (i.e. que vous l'avez
corrigé), marquez-le comme <em>done</em> (fermez-le) en envoyant un message
d'explication à <email>123-done@&bugs-host;</email>. Si vous corrigez un
@@ -2198,14 +2352,11 @@
aider les responsables ayant des problèmes de sécurité ou pour les corriger
elle-même, pour envoyer les annonces de sécurité et pour maintenir le site
security.debian.org.
-
- <sect2 id="bug-security-you">Que faire si vous apprenez l'existence d'un
- problème de sécurité ?
<p>
Si vous prenez connaissance d'un bogue lié à un problème de sécurité sur un
paquet Debian, que vous soyez ou non le responsable, regroupez les
informations pertinentes sur le problème et contactez rapidement l'équipe de
- sécurité à &email-security-team;. Les informations utiles incluent, par
+ sécurité à &email-security-team; dès que possible. Les informations utiles incluent, par
exemple :
<list compact>
@@ -2220,7 +2371,12 @@
</item>
<item>
tout paquet corrigé que vous avez vous-même préparé (envoyez seulement les
- fichiers <file>.diff.gz</file> et <file>.dsc</file>),
+ fichiers <file>.diff.gz</file> et <file>.dsc</file> et lisez d'abord <ref
+ id="bug-security-building">),
+ </item>
+ <item>
+ toute assistance que vous pouvez fournir pour aider les tests (exploits,
+ tests de régression, etc.),
</item>
<item>
toute information nécessaire pour l'annonce de sécurité (voir <ref
@@ -2232,7 +2388,9 @@
<p>
À la différence de la plupart des autres activités au sein de Debian, les
informations sur les problèmes de sécurité doivent parfois être gardées en
- privé pour un certain temps. Cette décision dépend de la nature du problème
+ privé pour un certain temps. Ceci permet les distributeurs de logiciels de
+ coordonner leur dévoilement afin de minimiser l'exposition de leurs
+ utilisateurs. Cette décision dépend de la nature du problème
et de l'existence d'une solution correspondante et également s'il s'agit d'un
fait connu publiquement.
<p>
@@ -2258,13 +2416,12 @@
<list>
<item>
- si le problème est trivial (comme des fichiers temporaires non sécurisés),
- il n'y a pas besoin de garder le secret sur le problème et une correction
- devrait être effectuée et diffusée,
+ si l'exposition de sécurité est mineure, il n'y a parfois pas besoin de
+ garder le secret sur le problème et une correction devrait être effectuée
+ et diffusée,
</item>
<item>
- si le problème est grave (exploitable à distance, possibilité d'accéder
- aux privilèges d'administratation), il est préférable de partager cette
+ si le problème est grave, il est préférable de partager cette
information avec d'autres vendeurs et de coordonner une diffusion.
L'équipe de sécurité garde des contacts avec les différentes organisations
et individus et peut prendre soin des actions à mener.
@@ -2272,10 +2429,11 @@
</list>
<p>
-Dans tous les cas, si la personne qui indique le problème demande à ne pas
-diffuser l'information, cela devrait être respecté avec l'évidente exception
-d'informer l'équipe de sécurité (assurez-vous d'informer l'équipe de sécurité
-que l'information ne doit pas être révélée).
+Dans tous les cas, si la personne qui indique le problème demande à ce que
+l'information ne soit pas diffusée, cela devrait être respecté avec l'évidente exception
+d'informer l'équipe de sécurité pour qu'une correction puisse être effectuée
+pour la version stable de Debian. Quand vous envoyez des informations
+confidentielles à l'équipe de sécurité, assurez-vous de bien mentionner ce fait.
<p>Veuillez noter que si le secret est nécessaire, vous ne pourrez pas envoyer
un correctif vers <em>unstable</em> (ou ailleurs) puisque les informations de
@@ -2288,7 +2446,7 @@
<sect2 id="bug-security-advisories">Annonces de sécurité
<p>
Les annonces de sécurité ne sont émises que pour la distribution actuelle
- diffusée <em>stable</em>, pas pour <em>testing</em> ou <em>unstable</em>.
+ diffusée <em>stable</em>, <em>PAS</em> pour <em>testing</em> ou <em>unstable</em>.
Quand elle est diffusée, l'annonce est envoyée à la liste de diffusion
&email-debian-security-announce; et elle est postée sur <url
id="&url-debian-security-advisories;" name="la page de sécurité">. Les
@@ -2305,6 +2463,10 @@
etc.),
</item>
<item>
+ quels privilèges peuvent être gagnés et par qui (si c'est le
+ cas)
+ </item>
+ <item>
comment il peut être exploité,
</item>
<item>
@@ -2314,6 +2476,9 @@
comment le problème a été corrigé,
</item>
</list>
+ Ces informations permettent aux utilisateurs d'estimer la menace pesant
+ sur leurs systèmes.
+
</item>
<item>
les numéros de version des paquets affectés,
@@ -2322,7 +2487,8 @@
les numéros de version des paquets corrigés,
</item>
<item>
- une information sur la façon de récupérer les paquets mis à jour,
+ une information sur la façon de récupérer les paquets mis à jour
+ (habituellement l'archive de sécurité Debian),
</item>
<item>
des références à des annonces amont, des identifiants <url
@@ -2334,7 +2500,7 @@
<sect2 id="bug-security-building">
<heading>Préparer les paquets pour corriger des problèmes de sécurité
<p>
-Une façon d'aider l'équipe de sécurité dans ses travaux est de fournir des
+Une façon d'aider l'équipe de sécurité dans ses travaux est de leur fournir des
paquets corrigés convenables pour une annonce de sécurité pour la version
<em>stable</em> de Debian
<p>
@@ -2357,8 +2523,9 @@
Dans certains cas, il n'est pas possible de rétro-porter un correctif de
sécurité, par exemple, quand de grandes quantités de code source doivent être
modifiées ou réécrites. Si cela se produit, il peut être nécessaire de passer à
-une nouvelle version amont. Cependant, vous devez toujours coordonner cela avec
-l'équipe de sécurité au préalable.
+une nouvelle version amont. Cependant, ceci n'est fait que dans des situations
+extrêmes et vous devez toujours coordonner cela avec l'équipe de sécurité au
+préalable.
<p>
Il existe une autre règle de conduite liée à cela : testez toujours vos
changements. Si une exploitation du problème existe, essayez-la et
@@ -2386,6 +2553,12 @@
<var>distribution</var>-proposed-updates !
</item>
<item>
+ Fournissez des entrées de changelog descriptives et complètes. D'autres
+ personnes se baseront dessus pour déterminer si un bogue particulier a été
+ corrigé. Quand cela est possible, incluez une référence externe, de
+ préférence, un identifiant CVE, pour qu'elle puisse être recoupée.
+</item>
+<item>
Assurez-vous que le numéro de version est correct. Il doit être plus élevé
que celui du paquet actuel, mais moins que ceux des paquets des versions
des distributions suivantes. En cas de doute, testez-le avec <tt>dpkg
@@ -2413,7 +2586,7 @@
déplacer plus tard le correctif de sécurité dans l'archive principale.
</item>
<item>
- Assurez-vous, lors de la compilation du paquet, de compiler sur un système
+ Assurez-vous de compiler sur un système
propre, dont tous les paquets appartiennent à la distribution pour laquelle vous
construisez le paquet. Si vous n'avez pas un tel système, vous pouvez
utiliser l'une des machines de debian.org (voir <ref
@@ -2424,12 +2597,13 @@
<sect2 id="bug-security-upload">Mettre à jour le paquet corrigé
<p>
-Vous <em>NE DEVEZ PAS</em> envoyer un paquet dans la file d'attente des envois de sécurité
+Vous <em>NE</em> devez <em>PAS</em> envoyer un paquet dans la file d'attente des envois de sécurité
+(oldstable-security, stable-security, etc.)
sans l'accord préalable de l'équipe de sécurité. Si le paquet ne remplit pas
exactement les exigences de l'équipe, il causera beaucoup de problèmes, ainsi
que des délais dans la gestion de l'envoi indésirable.
<p>
-Vous <em>NE DEVEZ PAS</em> envoyer votre correction dans
+aVous <em>NE</em> devez <em>PAS</em> envoyer votre correction dans
<em>proposed-updates</em> sans vous coordonner avec l'équipe de sécurité. Les
paquets seront copiés de security.debian.org dans le répertoire
<file>proposed-updates</file> automatiquement. Si un paquet avec le même numéro
@@ -2685,7 +2859,7 @@
</item>
<item>
Vérifiez que votre paquet source est bon. Faites <tt>dpkg-source -x
- <var>package</var>.dsc</tt> pour vous assurer que le paquet se
+ <var>paquet</var>.dsc</tt> pour vous assurer que le paquet se
décompresse correctement. En utilisant le résultat de ce test,
construisez votre paquet binaire à l'aide de la commande
<prgn>dpkg-buildpackage</prgn>.
@@ -2723,7 +2897,7 @@
charte Debian. Vérifiez que ces cibles sont indépendantes l'une de
l'autre, c'est-à-dire, qu'il n'est pas nécessaire d'invoquer l'une de
ces cibles avant d'invoquer l'autre. Pour vérifier cela, essayez
- d'exécuter <tt>dpkg-buildpackage -b</tt>.
+ d'exécuter <tt>dpkg-buildpackage -B</tt>.
</item>
</enumlist>
@@ -3049,7 +3223,7 @@
gestion de paquets s'appuie sur ces numéros de version.
<p>
Si vous faites une mise à jour indépendante <em>(NMU)</em>, vous devez ajouter
- un numéro de version mineur à la partie <var>debian-revision</var> du numéro
+ un numéro de version mineur à la partie <var>révision-debian</var> du numéro
de version (la partie qui suit le dernier trait d'union). Ce numéro
supplémentaire débutera à « 1 ». Prenons pour exemple le paquet
« foo » qui porte le numéro de version 1.1-3. Dans l'archive, le
@@ -3065,7 +3239,7 @@
travail. Cela a aussi l'avantage de montrer clairement que le paquet n'a pas
été livré par le responsable officiel.
<p>
-S'il n'y a pas de partie <var>debian-revision</var> dans le numéro de version du
+S'il n'y a pas de partie <var>révision-debian</var> dans le numéro de version du
paquet, il faut en créer une en démarrant à « 0.1 ». S'il est
absolument nécessaire qu'une personne qui n'est pas responsable d'un paquet
fasse une livraison basée sur une nouvelle version amont, cette personne doit
@@ -3205,6 +3379,10 @@
appropriés.
</item>
</list>
+<p>
+La maintenance collaborative peut souvent être facilitée par l'utilisation
+d'outils sur Alioth (voir <ref id="alioth">).
+
<chapt id="best-pkging-practices">
<heading>Les meilleurs pratiques pour la construction des paquets
@@ -3557,7 +3735,7 @@
lors du lancement de foo avec l'option bar ; envoyez-moi plus
d'informations. »), ni celui de phrases génériques sur la vie, l'univers et
tout le reste (« Désolé, cet envoi m'a pris du temps, mais j'avais attrapé
-la grippe. ») ou celui de demandes d'aide (" La liste des bogues sur
+la grippe. ») ou celui de demandes d'aide (« La liste des bogues sur
ce paquet est énorme, donnez-moi un coup de main. »). Ceci ne sera
généralement pas remarqué par les personnes ciblées, mais peut ennuyer les
personnes qui désirent lire des informations sur les changements réels du
@@ -3724,11 +3902,10 @@
l'utilisateur des informations concernant la configuration du paquet. Il
faut maintenant éviter les interactions directes avec l'utilisateur et
préférer les interactions utilisant <package>debconf</package>. Ceci permettra
- à l'avenir des installations non interactives. <!-- pas de trait d'union
-entre non et adjectif -->
+ à l'avenir des installations non interactives.
<p>
Debconf est un bon outil, mais il est souvent mal utilisé. Plusieurs erreurs
- communes sont référencées dans la page de manuel <manref section="8"
+ communes sont référencées dans la page de manuel <manref section="7"
name="debconf-devel">. Vous devriez vraiment lire cette page si vous décidez
d'utiliser debconf.
</sect>
@@ -3959,7 +4136,7 @@
<p>
Assurez-vous que le bogue n'a pas déjà été rapporté. Chaque paquet dispose d'une
liste de bogues facilement accessible à
-<tt>http://&bugs-host;/<var>packagename</var></tt>. Des outils comme <manref
+<tt>http://&bugs-host;/<var>nom_paquet</var></tt>. Des outils comme <manref
name="querybts" section="1"> peuvent également vous fournir ces informations (et
<prgn>reportbug</prgn> invoquera également habituellement <prgn>querybts</prgn>
avant l'envoi).
@@ -3980,7 +4157,7 @@
bogues que vous avez rapportés. Saisissez cette occasion pour fermer les bogues
que vous ne pouvez plus reproduire. Pour trouver tous les bogues que vous avez
rapportés, vous avez simplement besoin d'aller à
- <tt>http://&bugs-host;/from:<var><your-email-addr></var></tt>.
+ <tt>http://&bugs-host;/from:<var><votre-adresse-de-courrier></var></tt>.
<sect1 id="submit-many-bugs">Ouvrir un grand nombre de rapports d'un seul
coup
@@ -4063,14 +4240,14 @@
<p>
Chercher l'adresse d'un responsable d'un paquet peut être fastidieux.
Heureusement, il existe un alias de courrier simple,
- <tt><package>@&packages-host;</tt>, qui fournit un moyen d'envoyer
+ <tt><paquet>@&packages-host;</tt>, qui fournit un moyen d'envoyer
un courrier à un responsable, quelle que soit son adresse (ou ses
- adresses). Remplacez <tt><package></tt> par le nom du paquet source
+ adresses). Remplacez <tt><paquet></tt> par le nom du paquet source
ou binaire.
<p>
Vous pouvez également vouloir contacter les personnes qui sont inscrites à un
paquet de source donné par le <ref id="pkg-tracking-system">. Vous pouvez le
- faire en utilisant l'adresse <tt><package-name>@&pts-host;</tt>.
+ faire en utilisant l'adresse <tt><nom-paquet>@&pts-host;</tt>.
<sect id="mia-qa">Gérer les responsables non joignables
@@ -4200,14 +4377,10 @@
paquet ne soit dans un état acceptable. Être un parrain veut dire être un
mentor.
<p>
-Une fois que le paquet a atteint les standards Debian, construisez le paquet
- avec
-<example>
- dpkg-buildpackage -us -uc
-</example>
- et signez-le avec
+Une fois que le paquet a atteint les standards Debian, construisez et signez le
+paquet avec
<example>
- debsign -m <var>"Nom complet</var> <var>votre-adresse-courrier</var> <var>changes-file</var>
+dpkg-buildpackage -k<var>KEY-ID</var>
</example>
avant de l'envoyer dans le répertoire Incoming.
<p>
@@ -4256,7 +4429,7 @@
La plupart des descriptions de ces outils proviennent des descriptions de leurs
paquets. Vous trouverez plus d'informations dans les documentations de ces
paquets. Vous pouvez aussi obtenir plus d'informations avec la commande
- <tt>apt-cache show <package_name></tt>.</p>
+ <tt>apt-cache show <nom_paquet></tt>.</p>
<sect id="tools-core">
Reply to: