plotchangelog - Représenter les modifications Debian sous forme de
graphique
plotchangelog [
options]
changelog ...
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.
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.
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 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 à virgule : 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
responsable en jetant un coup d'oeil aux points.
-
-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 --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 créer
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 tous 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é.
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.
devscripts.conf(5)
Joey Hess <
[email protected]>
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 à <
[email protected]> ou par un rapport de bogue sur
le paquet devscripts.
La version anglaise la plus à jour de ce document est toujours
consultable en ajoutant l'option «
-L C » à la commande
man.