Provided by:
devscripts_2.10.39ubuntu7_i386 
NOM
plotchangelog - Représenter les changements sous forme de graphique
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
version. Il peut aussi être configuré de manière à indiquer
approximativement combien de bogues ont été corrigés par chaque
nouvelle version.
Notez 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
versions 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 un 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 à virgule : 1.1,
2.1, etc. Un NMU peut également être facilement détecté 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’un NMU.
Il est également facile de trouver quand un paquet a changé de
responsable 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. Notez 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
--linecount, 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 générer le graphique. Les
commandes sont placées après l’initialisation, mais avant la
commande « plot » finale. Elles peuvent être utilisées pour
remplacer l’apparence par défaut fournie par ce programme de
façon arbitraire. 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
fichiers sont indiqués, ils seront affichés sur le même
graphique. Les fichiers peuvent être compressés avec gzip. Tout
texte n’étant pas dans le format des fichiers changelog de
Debian sera ignoré.
VARIABLES DE CONFIGURATION
Les deux fichiers de configuration /etc/devscripts.conf et
~/.devscripts 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 paramè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 évalué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, réalisée par Nicolas François,
Guillaume Delacour, Cyril Brulebois et Thomas Huriaux.
L’équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité.
La version anglaise la plus à jour de ce document est toujours
consultable en ajoutant l’option « -L C » à la commande man.
N’hésitez pas à signaler à l’auteur ou à la liste de traduction
<debian-l10-french@lists.debian.org>, selon le cas, toute erreur dans
cette page de manuel.