PLOTCHANGELOG(1) General Commands Manual PLOTCHANGELOG(1)
NOM
plotchangelog - Représenter les modifications Debian sous forme de gra-
phique
SYNOPSIS
plotchangelog [options] changelog ...
DESCRIPTION
plotchangelog est un outil qui aide à visualiser les informations d'un
fichier changelog. Ces informations sont affichées graphiquement avec
gnuplot(1), avec sur l'axe des abscisses la date des versions, et sur
l'axe des ordonnées le numéro de version Debian d'un paquet. Chaque
version individuelle d'un paquet est représentée par un point, dont la
couleur indique qui a fourni cette version. Le numéro de version amont
peut également être affiché sur le graphique.
L'axe des ordonnées peut également être configuré de manière à indiquer
la taille de l'entrée du fichier changelog pour chaque nouvelle ver-
sion. Il peut aussi être configuré de manière à indiquer approximative-
ment combien de bogues ont été corrigés par chaque nouvelle version.
Remarquez que s'il s'agit d'un paquet spécifique à Debian, l'axe des Y
utilisera les versions du paquet. Cela ne fonctionne pas toujours très
bien.
LECTURE DU GRAPHIQUE
La silhouette du graphique d'un paquet est en règle générale une série
de pics, démarrant à 1, allant jusqu'à n, et retournant à 1 juste
après. Plus un pic est important, plus le responsable a fourni de ver-
sions du paquet pour une version amont. Pour un paquet uniquement pour
Debian, son graphique sera croissant sans jamais redescendre (même si
un bogue du programme peut, à cause d'une mauvaise interprétation, le
faire redescendre, si la version passe par exemple de 0.9 à 0.10).
Si le graphique plonge à une valeur inférieure à 1, cela signifie que
quelqu'un a fait une NMU pour le paquet en même temps qu'une mise à
jour vers une nouvelle version amont, ce qui place la version Debian à
0. En règle générale, les NMU apparaissent comme des nombres à vir-
gule : 1.1, 2.1, etc. Une NMU peut également être facilement détectée
en regardant sur les points quel responsable a envoyé le paquet : un
point isolé d'un type différent des points précédents et suivants est
souvent le signe d'une NMU.
Il est également facile de trouver quand un paquet a changé de respon-
sable en jetant un coup d'oeil aux points.
OPTIONS
-l, --linecount
Au lieu d'utiliser le numéro de version Debian pour l'axe des
ordonnées, utilise le nombre de lignes de l'entrée du fichier
changelog pour chaque version. Cette option ne peut pas être
utilisée en même temps que --bugcount.
-b, --bugcount
Au lieu d'utiliser le numéro de version Debian pour l'axe des
ordonnées, utilise le nombre de bogues fermés par chaque entrée
du fichier changelog. Remarquez que ce nombre de bogues est
trouvé en recherchant "#dddd" dans le fichier changelog, et peut
donc être imprécis. Cette option ne peut pas être utilisée avec
--linecount.
-c, --cumulative
Lorsqu'elle est utilisée avec les options --bugcount ou --line-
count, effectue un décompte incrémental plutôt qu'un décompte
individuel pour chaque entrée du fichier changelog.
-v, --no-version
N'affiche pas les versions amont, ce qui est utile lorsque le
graphique est trop chargé.
-m, --no-maint
Ne fait pas de différence entre les différents responsables du
paquet.
-s fichier, --save=fichier
Sauver le graphe dans le fichier au format PostScript, au lieu
de l'afficher immédiatement.
-u, --urgency
Utilise des points plus gros pour les versions ayant un niveau
d'urgence plus important.
--verbose
Affiche le script qui est fourni à gnuplot (pour le débogage).
-gcommandes, --gnuplot=commandes
Ces options vous permettent d'insérer des commandes gnuplot(1)
dans le script gnuplot utilisé pour créer le graphique. Les com-
mandes sont placées après l'initialisation, mais avant la com-
mande plot finale. Elles peuvent être utilisées pour remplacer
l'apparence par défaut fournie par ce programme de façon arbi-
traire. Vous pouvez également utiliser quelque chose comme "set
terminal png color" pour modifier le type du fichier de sortie,
ce qui peut être utile avec l'option -s.
--help Affiche un résumé d'aide.
--version
Affiche la version, le nom de l'auteur et le copyright.
--noconf, --no-conf
Ne lit aucun fichier de configuration (voir ci-dessous).
changelog ...
Le fichier changelog dont on veut le graphique. Si plusieurs fi-
chiers sont indiqués, ils seront tous affichés sur le même gra-
phique. Les fichiers peuvent être compressés avec gzip. Tout
texte n'étant pas dans le format des fichiers changelog de De-
bian sera ignoré.
VARIABLES DE CONFIGURATION
Les deux fichiers de configuration /etc/devscripts.conf et ~/.devs-
cripts sont évalués dans cet ordre par un interpréteur de commandes
("shell") pour placer les variables de configuration. Des options de
ligne de commande peuvent être utilisées pour neutraliser les pa-
ramètres des fichiers de configuration. Les paramètres des variables
d'environnement sont ignorés à cette fin. Si la première option donnée
en ligne de commande est --no-conf, alors ces fichiers ne sont pas éva-
lués. Les variables actuellement identifiées sont :
PLOTCHANGELOG_OPTIONS
Liste d'options à toujours utiliser. Les options sont séparées
par des espaces. Par exemple, -l -b. N'incluez pas les options
-g ou --gnuplot dans cette liste, elles seraient ignorées ;
voyez plutôt l'option suivante.
PLOTCHANGELOG_GNUPLOT
Ce sont les commandes gnuplot qui sont utilisées avant toute
commande gnuplot fournie en ligne de commande.
VOIR AUSSI
devscripts.conf(5)
AUTEUR
Joey Hess <joey@kitenet.net>
TRADUCTION
Ce document est une traduction, maintenue à l'aide de l'outil po4a
<https://po4a.org/> par l'équipe de traduction francophone du projet
Debian.
Nicolas François, Guillaume Delacour, Cyril Brulebois, Thomas Huriaux
et David Prévot ont réalisé cette traduction.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. Veuillez signaler toute erreur de traduction en
écrivant à <debian-l10n-french@lists.debian.org> ou par un rapport de
bogue sur le paquet devscripts.
La version anglaise la plus à jour de ce document est toujours consul-
table en ajoutant l'option « -L C » à la commande man.
DEBIAN Utilitaires Debian PLOTCHANGELOG(1)
Generated by dwww version 1.15 on Sat Jun 29 01:39:06 CEST 2024.