Chapitre 8. Mise à jour de paquet

ajouter une nouvelle révision au début du fichier changelog Debian, par exemple avec dch -i, ou explicitement avec dch -v version-révision, et ajoutez ensuite les commentaires en utilisant votre éditeur favori ;^[76]

ajouter une courte description du bogue et de la solution dans l'entrée du changelog, suivie par Closes: #654321. De cette manière, le rapport de bogue sera automagiquement fermé par le logiciel de maintenance des archives une fois le paquet accepté dans l'archive Debian ;

répéter les opérations précédentes pour corriger plus de bogues tout en mettant à jour le fichier changelog avec dch selon votre besoin ;

recommencer ce qui a été fait en Section 6.1, « Reconstruction complète » et Chapitre 7, Contrôle des erreurs du paquet ;

une fois satisfait, modifier la valeur de distribution dans changelog d'UNRELEASED à la valeur de distribution cible unstable (ou même experimental) ; ^[77]

envoyer le paquet comme en Chapitre 9, Envoi de paquet. La différence est que cette fois, l'archive source originale ne sera pas incluse, car elle n'a pas été modifiée et est déjà dans l'archive Debian.

création d'une copie des sources amont dans un fichier toto_nouvelleversion.orig.tar.gz ;

mise à jour du ficher changelog Debian avec dch -v nouvelleversion-1 :

application de tous les correctifs en enlevant les approximations (« fuzz ») : while dquilt push; do dquilt refresh; done.

si un correctif appliqué aux sources a été intégré aux sources amont :

si un correctif appliqué aux sources entre en confit avec les nouvelles modifications des sources amont :

continuer comme d'habitude avec while dquilt push; do dquilt refresh; done.

si vous devez, pour quelque raison que ce soit, recréer des fichiers modèles qui avaient été effacés, vous pouvez exécuter dh_make à nouveau depuis le répertoire des sources Debian, avec l'option --addmissing. Puis modifiez-les de façon adéquate ;

si le paquet n'a pas été mis à jour pour utiliser la syntaxe dh de debhelper v7+ dans le fichier debian/rules, mettez-le à jour pour utiliser dh. Mettez à jour le fichier debian/control en conséquence ;

si vous voulez mettre à jour le fichier rules créé avec le mécanisme d'héritage Makefile du système de compilation usuel Debian (cdbs) vers la syntaxe dh, consultez les documents suivants pour comprendre ses variables de configuration DEB_* :

si vous avez un paquet source 1.0 sans fichier toto.diff.gz, vous pouvez le mettre à jour au récent format source 3.0 (native) en créant debian/source/format contenant 3.0 (native). Le reste des fichiers debian/* peut être simplement copié ;

si vous avez un paquet source 1.0 avec un fichier toto.diff.gz, vous pouvez le mettre à jour au récent format source 3.0 (quilt) en créant debian/source/format contenant 3.0 (quilt). Le reste des fichiers debian/* peut être simplement copié. Importez le fichier gros.diff créé par la commande filterdiff -z -x '*/debian/*' toto.diff.gz > gros.diff dans votre système quilt, au besoin ; ^[81]

si l'empaquetage a été créé en utilisant un autre système de correctif comme dpatch, dbs ou cdbs avec -p0, -p1 ou -p2, convertissez-le à quilt avec deb3 disponible en http://bugs.debian.org/581186 ;

si l'empaquetage a été créé avec la commande dh et le paramètre --with quilt ou les commandes dh_quilt_patch et dh_quilt_unpatch, supprimez-le et utilisez le nouveau format source 3.0 (native).

avec iconv(1) pour convertir l'encodage de fichiers texte :

iconv -f latin1 -t utf8 truc_entrée.txt > truc_sortie.txt

avec w3m(1) pour convertir les fichiers HTML en fichier texte UTF-8. Assurez-vous d'exécuter cette commande avec des paramètres régionaux en UTF-8 :

LC_ALL=en_US.UTF-8 w3m -o display_charset=UTF-8 \
        -cols 70 -dump -no-graph -T text/html \
        < truc_entrée.html > truc_sortie.txt

vérifiez dans le système de gestion de bogues (BTS) que personne n'a fourni de correctifs aux bogues ouverts ;

vérifiez le contenu du fichier .changes pour vous assurer que vous envoyez vers la bonne distribution, que les rapports de bogue refermés sont correctement listés dans les champs Closes, que les champs Maintainer et Changed-By correspondent, que le fichier est signé avec GPG, etc.