plotchangelog - représente les changements 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.

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.

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 téléchargé (« uploadé ») 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.

-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, fait 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

Sauve le graphique 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 debogage).

-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 spécifié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é.

Les deux fichiers de configuration /etc/devscripts.conf et ~/.devscripts sont évalués dans cet ordre par un interpréteur de commande (« 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 sur la ligne de commande.

devscripts.conf(5).

Joey Hess <joey@kitenet.net>

Ce document est une traduction, réalisée par Nicolas FRANÇOIS le 21 janvier 2005.

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.