dpkg-parsechangelog - Analyse un fichier changelog Debian.
dpkg-parsechangelog [option...]
dpkg-parsechangelog lit et fait l'analyse du fichier
« changelog » d'une arborescence source
dépaquetée et affiche les informations qu'il contient sur la
sortie standard et sous une forme lisible par la machine.
- -l, --file
fichier-des-changements
- Indique le fichier des changements où trouver des renseignements.
Un « - » peut être utilisé pour
spécifier une lecture à partir de l'entrée standard.
Par défaut, c'est le fichier debian/changelog.
- -F
format-du-fichier-des-changements
- Indique le format du fichier changelog. Par défaut, c'est une ligne
spéciale, près de la fin du fichier, qui l'indique ; sinon,
on utilise le format classique debian. Voir aussi FORMATS DES
FICHIERS DE CHANGEMENTS.
- -L rep_lib
- Option obsolète sans effet (depuis dpkg 1.18.8). Fixer les
variables d'environnement de Perl PERL5LIB ou PERLLIB a un
effet similaire lors de la recherche des modules d'analyse de Perl.
- -S, --show-field
champ
- Indique le nom du champ à afficher (depuis dpkg 1.17.0). Le
nom du champ n'est pas affiché, mais seulement sa valeur.
- -?, --help
- Afficher un message d'aide puis quitter.
- --version
- Afficher le numéro de version puis quitter.
Les options suivantes peuvent être utilisées pour
influencer la sortie de l'analyseur du journal des modifications
(« changelog »), par exemple la gamme
d'entrées ou le format de sortie.
- --format
format-de-sortie
- Règle le format de sortie. Actuellement les valeurs
gérées sont dpkg et rfc822. dpkg est le
format classique de sortie (avant que cette option n'existe) et l'option
par défaut. Il se compose d'un paragraphe dans le format du fichier
de contrôle Debian (voir deb-control(5)). Si plus d'une
entrée est demandée, alors la plupart des champs sont
tirés de la première entrée (habituellement la plus
récente), sauf si c'est indiqué autrement.
- Source:
nom-du-paquet
- Version:
version
- Distribution:
distribution-cible
- Urgency:
priorité
- La priorité la plus élevée de toutes les
entrées incluses est utilisée, suivie par les commentaires
concaténés et séparés par des espaces pour
toutes les versions demandées.
- Maintainer:
auteur
- Date:
date
- La date de l'entrée sous forme d'une chaîne, telle qu'elle
apparaît dans le changelog. Avec un format strptime(3)
« %a, %d %b %Y %T %z »
mais où le nom du jour de la semaine pourrait ne pas vraiment
correspondre au jour réel obtenu à partir du reste de la
chaîne de date. Si une représentation plus précise du
jour est nécessaire, utilisez le champ Timestamp, mais il
faut prendre en compte qu'il pourrait ne pas être possible de la
faire correspondre à la valeur exacte de ce champ.
- Timestamp:
horodatage
- La date de l'entrée comme horodatage en secondes depuis
« l'epoch » (depuis dpkg 1.18.8).
- Closes:
numéro-bogue
- Les champs « Closes » de toutes les
entrées incluses sont fusionnés.
- Changes:
entrées-du-fichier-des-changements
- Les textes de toutes les entrées de changelog sont
concaténés. Pour faire de ce champ un champ de
contrôle Debian valable, les lignes multiples qui sont vides sont
remplacées par un point « . » et
toutes les lignes sont indentées par une seule espace. Le contenu
exact dépend du format du changelog.
Les champs Version, Distribution, Urgency,
Maintainer et Changes sont obligatoires.
Il est possible d'avoir d'autres champs qui sont définis
par l'utilisateur.
Le format rfc822 utilise les mêmes champs mais le
résultat est un paragraphe distinct pour chaque entrée du
changelog afin que toutes les métadonnées de chaque
entrée soit préservées.
- --reverse
- Inclut toutes les modifications en ordre inverse (depuis
dpkg 1.19.1).
Note : pour le format de dpkg, la
première entrée sera l'entrée la plus ancienne.
- --all
- Inclut toutes les modifications. Note : d'autres options
deviennent sans effet lorsque celle-ci est utilisée.
- -s, --since
version
- -v version
- Inclut tous les changements qui ont suivi la version.
- -u, --until
version
- Inclut tous les changements qui ont eu lieu avant la version.
- -f, --from
version
- Inclut tous les changements depuis la version (incluse).
- -t, --to
version
- Inclut tous les changements apportés jusqu'à la
version comprise.
- -c, --count
nombre
- -n nombre
- Inclut ce nombre d'entrées depuis le début (ou la fin
si le nombre est inférieur à 0).
- -o, --offset
nombre
- Modifie le point de départ pour --count, à compter du
début (ou la fin si le nombre est inférieur à
0).
Il est possible d'utiliser un format différent de celui
utilisé habituellement, en fournissant un analyseur pour le format
alternatif.
Afin que dpkg-parsechangelog utilise le nouvel analyseur,
il doit exister une ligne, parmi les 40 dernières du fichier, qui
corresponde à l'expression régulière Perl
“\schangelog-format:\s+([0-9a-z]+)\W (la partie entre
parenthèses doit être le nom du format). Exemple :
@@@ changelog-format: autreformat @@@
Les noms de formats de journaux de modifications sont des
chaînes non vides de caractères alphanumériques en
minuscules (« a-z0-9 »).
Si une telle ligne existe, dpkg-parsechangelog recherchera
l'analyseur sous le nom du module Perl
Dpkg::Changelog::autreformat ; s'il n'est pas présent,
c'est une condition d'erreur. Le nom de l'analyseur dans le module Perl sera
automatiquement mis en capitale. Le format de journaux de modifications par
défaut est debian et un analyseur pour ce format est fourni
par défaut.
L'analyseur doit être dérivé de la classe
Dpkg::Changelog et implémenter l'interface documentée
requise.
Si le format du journal des modifications analysé laisse
toujours ou presque une ligne blanche entre chaque changement, ces lignes
blanches devraient être retirées, afin de rendre l'affichage
de sortie plus compact.
Si le journal des modifications ne contient pas d'informations de
date ou de nom de paquet, cette information doit être omise de
l'affichage. L'analyseur ne doit pas essayer de les calculer ou de les
retrouver depuis d'autres sources.
Si le journal des modifications n'utilise pas le format attendu,
l'analyseur produira une erreur, plutôt que d'essayer de s'en tirer
comme il peut et produire une sortie incorrecte.
Un analyseur de journal de modifications ne doit pas du tout
interagir avec l'utilisateur.
Toutes les options d'analyse sauf -v sont
gérées par dpkg seulement depuis la version
1.14.16.
Analyse des options courtes avec des valeurs non-groupées,
disponible seulement à partir de dpkg 1.18.0.
- DPKG_COLORS
- Définit le mode de couleur (depuis dpkg 1.18.5). Les valeurs
actuellement acceptées sont auto (par défaut),
always et never.
- DPKG_NLS
- Si cette variable est définie, elle sera utilisée pour
décider l'activation de la prise en charge des langues (NLS
– Native Language Support), connu aussi comme la gestion de
l'internationalisation (ou i18n) (depuis dpkg 1.19.0). Les valeurs
permises sont : 0 et 1 (par défaut).
- debian/changelog
- Le journal des modifications ; on s'en sert pour connaître les
informations qui dépendent d'une version du paquet source, par
exemple l'urgence ou la distribution d'une installation sur le serveur,
les modifications faites depuis telle édition et le numéro
de la version source lui-même.
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe
Batailler, 2006. Nicolas François, 2006. Veuillez signaler toute
erreur à <debian-l10n-french@lists.debian.org>.