.\" dpkg manual page - dpkg-parsechangelog(1) .\" .\" Copyright © 1995-1996 Ian Jackson .\" Copyright © 2000 Wichert Akkerman .\" Copyright © 2006, 2012-2013 Guillem Jover .\" Copyright © 2007-2008 Frank Lichtenheld .\" Copyright © 2009 Raphaël Hertzog .\" .\" This is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH dpkg\-parsechangelog 1 06\-07\-2013 "Projet Debian" "Utilitaires de dpkg" .SH NOM dpkg\-parsechangelog \- Analyse un fichier changelog Debian. . .SH SYNOPSIS \fBdpkg\-parsechangelog\fP [\fIoption\fP...] . .SH DESCRIPTION \fBdpkg\-parsechangelog\fP 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. . .SH OPTIONS .TP \fB\-l\fP\fIfichier\-des\-changements\fP 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 \fBdebian/changelog\fP. .TP \fB\-F\fP\fIformat\-du\-fichiers\-des\-changements\fP 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 \fIdebian\fP. Voir aussi \fBFORMATS DES FICHIERS DE CHANGEMENTS\fP. .TP \fB\-L\fP\fIrep_lib\fP Spécifie un répertoire supplémentaire pour la recherche de scripts d'analyse. Ce répertoire est examiné avant les répertoires par défaut qui sont \fB/usr/local/lib/dpkg/parsechangelog\fP et \fB/usr/lib/dpkg/parsechangelog\fP. .TP \fB\-S\fP, \fB\-\-show\-field\fP \fIchamp\fP Indique le nom du champ à afficher (depuis dpkg 1.17.0). Le nom du champ n'est pas affiché, mais seulement sa valeur. .TP \fB\-?\fP, \fB\-\-help\fP Affiche un message d'aide puis quitte. .TP \fB\-\-version\fP Affiche le numéro de version puis quitte. .SS "Options de filtrage" 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. Ils doivent être gérés par le script d'analyse en question. Voir aussi \fBNOTES\fP. .TP \fB\-\-file\fP\fI fichier\fP Définit le nom de fichier changelog à analyser. Par défaut c'est «\ \-\ » (entrée standard). .TP \fB\-l\fP, \fB\-\-label\fP \fIfichier\fP Définit le nom du fichier changelog à utiliser dans les messages d'erreur, plutôt que l'utilisation du nom de l'option \fB\-\-file\fP ou sa valeur par défaut. .TP \fB\-\-format\fP\fI format\-de\-sortie\fP Règle le format de sortie. Actuellement les valeurs gérées sont \fIdpkg\fP et \fIrfc822\fP. \fIdpkg\fP 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 \fBdeb\-control\fP(5)). Si plus d'une entrée est demandée, alors la plupart des champs sont tirés de l'entrée la plus récente, sauf si c'est indiqué autrement. .RS .TP \fBSource:\fP\fI nom\-du\-paquet\fP .TP \fBVersion:\fP\fI version\fP .TP \fBDistribution:\fP\fI distribution\-cible\fP .TP \fBUrgency:\fP\fI priorité\fP 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 une espace pour toutes les versions demandées. .TP \fBMaintainer:\fP\fI auteur\fP .TP \fBDate:\fP\fI date\fP .TP \fBCloses:\fP\fI numéro\-bogue\fP Les champs «\ Closes\ » de toutes les entrées incluses sont fusionnés. .TP \fBChanges:\fP\fI entrées\-du\-fichier\-des\-changements\fP Les textes de toutes les entrées de changelog sont concaténés. Pour faire de ce champ un champ de contrôle Debian valide, les lignes multiples qui sont vides sont remplacées par un point \fB«\ .\ »\fP et toutes les lignes sont indentées par une seule espace. Le contenu exact dépend du format du changelog. .RE .IP Les champs \fBVersion\fP, \fBDistribution\fP, \fBUrgency\fP, \fBMaintainer\fP et \fBChanges\fP sont obligatoires. .IP Il est possible d'avoir d'autres champs qui sont définis par l'utilisateur. .IP Le format \fBrfc822\fP 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. .TP \fB\-\-since\fP \fIversion\fP, \fB\-s\fP\fIversion\fP,\fB \-v\fP\fIversion\fP inclut tous les changements qui ont suivi la \fIversion\fP. .TP \fB\-\-until\fP \fIversion\fP, \fB\-u\fP\fIversion\fP inclut tous les changements qui ont eu lieu avant la \fIversion\fP. .TP \fB\-\-from\fP \fIversion\fP, \fB\-f\fP\fIversion\fP inclut tous les changements depuis la \fIversion\fP (incluse). .TP \fB\-\-to\fP \fIversion\fP, \fB\-t\fP\fIversion\fP inclut tous les changements apportés jusqu'à la \fIversion\fP comprise. .TP \fB\-\-count\fP \fInombre\fP, \fB\-c\fP\fInombre\fP, \fB\-n\fP\fInombre\fP inclut ce \fInombre\fP d'entrées depuis le début (ou la fin si le \fInombre\fP est inférieur à 0). .TP \fB\-\-offset\fP \fInombre\fP, \fB\-o\fP\fInombre\fP modifie le point de départ pour \fB\-\-count\fP, à compter du début (ou la fin si le \fInombre\fP est inférieur à 0). .TP \fB\-\-all\fP inclut toutes les modifications. Note\ :\ d'autres options deviennent sans effet lorsque celle\-ci est utilisée. . .SH "FORMATS DE JOURNAUX DE MODIFICATIONS" Il est possible d'utiliser un format différent de celui utilisé habituellement, en fournissant un analyseur pour le format alternatif. Afin que \fBdpkg\-parsechangelog\fP utilise le nouvel analyseur, il doit exister une ligne, parmi les 40 dernières du fichier, qui corresponde à l'expression régulière Perl \(lq\fB\eschangelog\-format:\es+([0\-9a\-z]+)\eW\fP\ (la partie entre parenthèses doit être le nom du format). Exemple\ : @@@ changelog\-format: \fIautreformat\fP @@@ Les noms de formats de journaux de modifications sont des chaînes non vides de caractères alphanumériques. Si une telle ligne existe, \fBdpkg\-parsechangelog\fP recherchera l'analyseur sous les noms \fB/usr/lib/dpkg/parsechangelog/\fP\fIautreformat\fP ou \fB/usr/local/lib/dpkg/parsechangelog/\fP\fIautreformat\fP\ ; si aucun de ces fichiers n'est présent et exécutable, c'est une condition d'erreur. Le format de journaux des modifications par défaut est \fBdebian\fP et un analyseur pour ce format est fourni par défaut. L'analyseur est invoqué avec le journal des modifications sur l'entrée standard en commençant à sa première ligne. Il doit lire le fichier (et y accéder) pour déterminer les informations nécessaires, puis retourner les informations analysées sur la sortie standard dans le format indiqué par l'option \fB\-\-format\fP. Il doit accepter toutes les \fBOptions d'analyse\fP. 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 doit se terminer avec un état de sortie non nul, 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. . .SH NOTES Toutes les \fBoptions d'analyse\fP sauf \fB\-v\fP sont gérées par \fBdpkg\fP seulement depuis la version 1.14.16. Les analyseurs tiers pour les formats de journaux de modifications autres que \fIdebian\fP ne gèrent peut\-être pas toutes les options. . .SH FICHIERS .TP \fBdebian/changelog\fP 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. .SH TRADUCTION Ariel VARDI , 2002. Philippe Batailler, 2006. Nicolas François, 2006. Veuillez signaler toute erreur à .