NOM
plotchangelog - Reprsenter les changements sous forme de graphique
SYNOPSIS
plotchangelog [options] changelog ...
plotchangelog est un outil qui aide visualiser les informations d'un
fichier changelog. Ces informations sont affiches graphiquement avec
gnuplot(1), avec sur l'axe des abscisses la date des versions, et sur
l'axe des ordonnes le numro de version Debian d'un paquet. Chaque
version individuelle d'un paquet est reprsente par un point, dont la
couleur indique qui a fourni cette version. Le numro de version amont
peut galement tre affich sur le graphique.
L'axe des ordonnes peut galement tre configur de manire indiquer la
taille de l'entre du fichier changelog pour chaque nouvelle version. Il
peut aussi tre configur de manire indiquer approximativement combien
de bogues ont t corrigs par chaque nouvelle version.
Notez que s'il s'agit d'un paquet spcifique Debian, l'axe des Y
utilisera les versions du paquet. Cela ne fonctionne pas toujours trs
bien.
LECTURE DU GRAPHIQUE
La silhouette du graphique d'un paquet est en rgle gnrale une srie de
pics, dmarrant 1, allant jusqu' n, et retournant 1 juste aprs. 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 (mme si un bogue
du programme peut,
cause d'une mauvaise interprtation, le faire redescendre, si la
version passe par exemple de 0.9 0.10).
Si le graphique plonge une valeur infrieure 1, cela signifie que
quelqu'un a fait un NMU pour le paquet en mme temps qu'une mise jour
vers une nouvelle version amont, ce qui place la version Debian 0. En
rgle gnrale, les NMU apparaissent comme des nombres virgule : 1.1,
2.1, etc. Un NMU peut galement tre facilement dtect en regardant sur
les points quel responsable a envoy le paquet : un point isol d'un type
diffrent des points prcdents 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 numro de version Debian pour l'axe des
ordonnes, utilise le nombre de lignes de l'entre du fichier
changelog pour chaque version. Cette option ne peut pas tre
utilise en mme temps que --bugcount.
-b, --bugcount
Au lieu d'utiliser le numro de version Debian pour l'axe des
ordonnes, utilise le nombre de bogues ferms par chaque entre du
fichier changelog. Notez que ce nombre de bogues est trouv en
recherchant #dddd dans le fichier changelog, et peut donc tre
imprcis. Cette option ne peut pas tre utilise avec --linecount.
-c, --cumulative
Lorsqu'elle est utilise avec les options --bugcount ou
--linecount, effectue un dcompte incrmental plutt qu'un dcompte
individuel pour chaque entre 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 diffrence entre les diffrents responsables du
paquet.
-s fichier, --save=fichier
Sauver le graphe dans le fichier au format PostScript, au lieu
de l'afficher immdiatement.
-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 dbogage).
-gcommandes, --gnuplot="commandes"
Ces options vous permettent d'insrer des commandes gnuplot(1)
dans le script gnuplot utilis pour gnrer le graphique. Les
commandes sont places aprs l'initialisation, mais avant la
commande plot finale. Elles peuvent tre utilises pour
remplacer l'apparence par dfaut fournie par ce programme de faon
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 rsum 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 indiqus, ils seront affichs sur le mme graphique.
Les fichiers peuvent tre compresss 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 valus dans cet ordre par un interprteur de commandes
( shell ) pour placer les variables de configuration. Des options de
ligne de commande peuvent tre utilises pour neutraliser les paramtres
des fichiers de configuration. Les paramtres des variables
d'environnement sont ignors cette fin. Si la premire option donne en
ligne de commande est --no-conf, alors ces fichiers ne sont pas valus.
Les variables actuellement identifies sont :
PLOTCHANGELOG_OPTIONS
Liste d'options toujours utiliser. Les options sont spares par
des espaces. Par exemple, -l -b . N'incluez pas les options
-g ou --gnuplot dans cette liste, elles seraient ignores ;
voyez plutt l'option suivante.
PLOTCHANGELOG_GNUPLOT
Ce sont les commandes gnuplot qui sont utilises 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, ralise par Nicolas Franois, Guillaume
Delacour, Cyril Brulebois et Thomas Huriaux.
L'quipe de traduction a fait le maximum pour raliser une adaptation
franaise de qualit.
La version anglaise la plus jour de ce document est toujours
consultable en ajoutant l'option -L C la commande man.
N'hsitez 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.