From: ahulin Date: Sat, 27 Oct 2001 05:56:22 +0000 (+0000) Subject: Synchronised with 1.70. X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=b316bb1f8886984de1a1a01329683f26a7463666;p=developers-reference.git Synchronised with 1.70. git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@1305 313b444b-1b9f-4f58-a734-7bb04f332e8d --- diff --git a/developers-reference.fr.sgml b/developers-reference.fr.sgml index 5fc9644..13e5ce9 100644 --- a/developers-reference.fr.sgml +++ b/developers-reference.fr.sgml @@ -5,12 +5,12 @@ %commondata; - + ]> @@ -1127,47 +1127,49 @@ distribution frozen appara Experimental -

-NOTE : experimental ne fonctionne plus depuis la mise en place du -package pool. Si la distribution experimental est remise en service -un jour, la présente section aura sûrement besoin d'une mise à jour. -

La distribution experimental est une distribution particulière. Ce n'est pas une distribution à part entière comme le sont stable et unstable. Elle est prévue pour servir de plate-forme de développement pour les projets expérimentaux qui ont de grandes chances de détruire le -système. Les utilisateurs qui téléchargent et installent des paquets depuis +système ou bien pour des logiciels qui sont vraiment trop instables pour être +inclus dans la distribution unstable (mais qui ont néanmoins une +bonne raison pour être mis en paquet). Les utilisateurs qui téléchargent et +installent des paquets depuis experimental sont prévenus : on ne peut pas faire confiance à la distribution experimental.

-Les responsables doivent être très sélectifs quant à l'utilisation de la -distribution experimental. Même très instable, un paquet peut aller -dans unstable ; ajoutez juste quelques avertissements dans la -description. Par contre, s'il y a une chance que le logiciel endommage -sérieusement le système, il est préférable de le mettre dans +S'il y a des chances pour qu'un logiciel cause des dégats importants, il sera +sûrement préférable de le mettre dans la distribution experimental. +Un système de fichier compressé, par exemple, devrait probablement aller dans experimental.

-Un système de fichier compressé, par exemple, devrait probablement aller dans -experimental. Une nouvelle version non finalisée d'un logiciel qui -utilise une méthode de configuration complètement différente pourrait aller -dans experimental à la discrétion du responsable. Un nouveau logiciel -qui a peu de chance d'endommager le système ira dans unstable. Si -vous travaillez sur un cas de mise à jour complexe ou incompatible vous pouvez -aussi utiliser experimental comme plate-forme d'intégration et ainsi -fournir un accès aux testeurs. +Une nouvelle version amont qui ajoute des nouvelles fonctions et en supprime +beaucoup de plus anciennes ne devra pas être téléchargée dans l'archive +Debian, elle pourra cependant être téléchargée dans experimental. Une +nouvelle version non finalisée d'un logiciel qui utilise une méthode de +configuration complètement différente pourrait aller dans +experimental à la discrétion du responsable. Si vous travaillez sur +un cas de mise à jour complexe ou incompatible vous pouvez aussi utiliser +experimental comme plate-forme d'intégration et ainsi fournir un +accès aux testeurs.

-Par contre, utiliser experimental comme plate-forme n'est pas -toujours la meilleure idée, surtout pour les paquets éphémères. -Vous ne pouvez pas effacer un paquet qui a été installé dans cet espace -vous même ; cela doit être fait par l'équipe d'administration de l'archive. -Une solution consiste à utiliser vos pages web personnelles sur le serveur -klecker.debian.org (c.-à-d. people.debian.org). +Quelques logiciels expérimentaux peuvent aller dans unstable, avec un +avertissement dans la description mais ce n'est pas recommandé car les paquets +de unstable se propagent dans testing et aboutissent dans +stable. +

+Un nouveau logiciel qui a peu de chance d'endommager le système ira +directement dans unstable. +

+Une alternative à experimental consiste à utiliser vos pages +personnelles sur le serveur people.debian.org +(klecker.debian.org). Les noms de distribution @@ -1295,14 +1297,47 @@ leurs intentions : + Vérifier le paquet avant la mise à jour +

+Avant de mettre à jour votre paquet vous ferez quelques tests de base. Vous +devrez au moins faire les tests suivants (il vous faut une ancienne version +du paquet pour cela) : + + + Installez le paquet et vérifiez que le logiciel fonctionne. Si le + paquet existait déjà dans une version plus ancienne, faites une mise à + jour. + + + Exécutez lintian sur votre paquet. Vous pouvez exécuter + lintian comme suit : lintian -v + package-version.changes. Ce programme fera une + vérification sur les paquets source et binaire. Si vous ne comprenez + par les messages générés par lintian essayez l'option + -i. Cette option rendra lintian beaucoup plus + bavard dans sa description du problème. +

+ En principe, un paquet pour lequel + lintian génère des erreurs (elles commencent par + E) ne doit pas être installé dans l'archive. +

+ Pour en savoir plus sur lintian reportez-vous à la + section lintian . + + + Faites régresser le paquet + vers sa version précédente si elle existe — cela permet de tester les + scripts postrm et prerm. + + Désinstallez le paquet et réinstallez-le. - Mettre à jour un paquet + - Générer le fichier « changes » + Générer le fichier « changes »

Chaque nouvelle version d'un paquet installé sur les archives FTP Debian doit être accompagnée d'un fichier .changes. Ce fichier explique à @@ -1323,41 +1358,10 @@ Debian. Vous pouvez consulter la liste des champs de contr pour connaître les valeurs que prennent ces champs. Vous pouvez fermer un rapport de bogue automatiquement avec le champ Description (voir ). Nous ne verrons ici que le champ Distribution -car il est directement lié aux règles d'administration de l'archive. - +id="upload-bugfix">). - - Choisir une distribution - -

-Le champ Distribution, qui provient du fichier -debian/changelog, indique à quelle distribution le paquet est -destiné. Il y a quatre valeurs possibles pour ce champ : stable, -unstable, frozen et experimental ; ces valeurs -peuvent aussi être combinées. Si, par exemple, Debian a été gelée et vous -voulez mettre à jour une correction de bogue sur frozen, il faudra -indiquer frozen unstable dans le champ distribution (se reporter à - pour savoir quand vous pouvez faire une mise à jour -sur frozen). Notez bien qu'il n'y a pas de raison de combiner -experimental avec quelque distribution que ce soit. - -

-Vous devriez éviter de combiner stable avec d'autres cibles à cause -des problèmes potentiels de dépendance de bibliothèque (pour votre paquet et -pour les paquets fabriqués par le démon de compilation pour les autres -architectures). Notez encore que choisir la valeur stable pour ce -champ signifie que le paquet sera dirigé vers le répertoire -proposed-update des archives Debian pour y être testé avant d'être -effectivement inclus dans stable. L'équipe responsable de la -distributionthe release team (joignable à -l'adresse &email-debian-release;) prendra la décision d'inclure ou de ne pas -inclure votre paquet dans la distribution stable. C'est pourquoi vous -pourrez choisir de leur envoyer un courrier expliquant les motifs qui vous ont -incité à faire une mise à jour pour stable, si votre fichier -changelog n'est pas suffisamment clair sur ce point. - + L'archive des sources amonts

La première fois qu'un paquet est installé dans l'archive pour une version amont donnée, le fichier tar de cette version amont doit être @@ -1384,9 +1388,38 @@ fichier doit + Choisir une distribution + +

+Le champ Distribution, qui provient de la première ligne du fichier +debian/changelog, indique à quelle distribution le paquet est +destiné. +

+Il y a quatre valeurs possibles pour ce champ : stable, +unstable, frozen et experimental . En temps +normal, les paquets sont téléchargés dans unstable. - Mettre à jour la distribution frozen +

+Ces valeurs peuvent être combinées mais seules quelques combinaisons ont +un sens. Si la distribution a été gelée et si vous voulez livrer une correction +de bogue sur frozen, il faudra indiquer frozen unstable dans +le champ distribution. Se reporter à pour en savoir +plus sur les mises à jour de frozen). + +

+Vous devriez éviter de combiner stable avec d'autres cibles à cause +des problèmes potentiels de dépendance de bibliothèque (pour votre paquet et +pour les paquets fabriqués par le démon de compilation pour les autres +architectures). Se reporter à pour savoir quand et +comment faire une mise à jour de stable. + +

+Notez bien que combiner experimental avec quelque distribution +que ce soit n'a pas de sens. + + + Mettre à jour un paquet de la distribution frozen

Le gel de la distribution est un moment crucial pour Debian. C'est l'occasion @@ -1445,45 +1478,57 @@ final. Il y a tr la gravité du bogue introduit par la correction. - - - Vérifier le paquet avant la mise à jour + Mettre à jour un paquet de la distribution stable

-Avant de mettre à jour votre paquet vous ferez quelques tests de base. Vous -devrez au moins faire les tests suivants (il vous faut une ancienne version -du paquet pour cela) : +Livrer un paquet pour la distribution stable signifie que le paquet +sera dirigé vers le répertoire proposed-updates des archives Debian +pour y être testé avant d'être effectivement inclus dans stable. - - - Installez le paquet et vérifiez que le logiciel fonctionne. Si le - paquet existait déjà dans une version plus ancienne, faites une mise à - jour. +

+Une livraison pour la distribution stable requière des soins +supplémentaires. Un paquet de cette distribution ne devrait être mis à jour +que dans les cas suivants : - - Exécutez lintian sur votre paquet. Vous pouvez exécuter - lintian comme suit : lintian -v - package-version.changes. Ce programme fera une - vérification sur les paquets source et binaire. Si vous ne comprenez - par les messages générés par lintian essayez l'option - -i. Cette option rendra lintian beaucoup plus - bavard dans sa description du problème.

Un paquet pour lequel - lintian génère des erreurs (elles commencent par - E) ne doit pas être installé dans l'archive. + + un problème de sécurité (un avis de sécurité + DebianDebian security advisory.), + un probleme fonctionnel vraiment critique, + un paquet devenu ininstallable, + un paquet indisponible pour une architecture. + -

- Pour en savoir plus sur lintian reportez-vous à la - section lintian . Faites régresser le paquet - vers sa version précédente si elle existe — cela permet de tester les - scripts postrm et prerm. +

+Il est fortement déconseillé de changer quoi que ce soit si ce n'est pas +important car même une modification triviale peut causer un bogue plus +tard. 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 patch correspondant de la +nouvelle version amont et à l'appliquer à l'ancienne (faire un +backport du patch). - - Désinstallez le paquet et réinstallez-le. +

+Les paquets livrés pour stable doivent être compilés avec la +distribution stable pour que leurs dépendances se limitent aux +bibliothèques (et autres paquets) disponibles dans stable ; +un paquet livré pour la distribution stable qui dépend d'une +librairie qui n'est disponible que dans unstable sera rejeté. +Modifier les dépendances d'autres paquets (en manipulant le champ +Provides ou les fichiers shlibs) et, peut-être, rendre ces paquets +ininstallables, est fortement déconseillé. - +

+L'équipe responsable de la distributionthe Release +team (joignable à l'adresse &email-debian-release;) évaluera +régulièrement le contenu de proposed-updates et décidera si votre +paquet peut être inclus dans la distribution stable. Soyez précis +(et, si nécéssaire, généreux) quand vous décrivez, dans le fichier changelog, +vos changements pour une livraison vers stable sinon le paquet ne +sera pas considéré. + Mettre à jour un paquet Installer un paquet sur @@ -1686,13 +1731,6 @@ S'il est mis experimental ou frozen, l'annonce est envoyée sur la liste &email-debian-devel-changes;. -

-De temps en temps, il est nécessaire de mettre à jour simultanément les -distributions stable et unstable ; cela est possible en -indiquant les deux distributions sur la ligne Distribution:. Dans ce -dernier cas, l'annonce sera faite sur les deux listes de diffusion citées -précédemment. -

Le programme dupload est suffisamment intelligent pour déterminer où devra aller l'annonce et pour envoyer le courrier sur la bonne liste. Voir ).

-La distribution stable ne peut recevoir que des corrections critiques ou des -mises à jour de sécurité. Quand une faille de sécurité est détectée, un -paquet corrigé doit être livré le plus tôt possible. Dans ce cas, le responsable de -sécurité DebianDebian Security Manager entrera en contact +Quand une faille de sécurité est détectée, un +paquet corrigé doit être livré le plus tôt possible. Dans ce cas, un membre de +l'équipe de sécurité DebianDebian Security officer +entrera en contact avec le responsable du paquet pour s'assurer qu'un paquet corrigé sera livré dans un délai raisonnable (moins de 48 heures). Si le mainteneur ne peut -fournir une mise à jour suffisamment vite ou s'il ne peut être joint à temps, le -responsable de sécurité pourra corriger le paquet (i.e. faire une mise à jour +fournir une mise à jour suffisamment vite ou s'il ne peut être joint à temps, +l'équipe de sécurité pourra corriger le paquet (i.e. faire une mise à jour indépendante source).