Aide à la gestion du fichier ChangeLog
Table des Matières
Chapitre I
Format standard d'un fichier ChangeLog
Le mieux et de voir ça à partir d'un exemple :
Change log for project XXX ========================== -- * add a new functionnality 2002-02-01 -- 0.1.1 * fix bug #435454 * fix bug #434356 2002-01-01 -- 0.1 * initial release
Il y a dans ce fichier 3 entrées, une pour chaque version déjà distribuées et une pour la prochaine version, l'entrée courante. Chaque entrée contient des messages correspondant aux changements effectués depuis la version précédente.
Il est important de noter que l'entrée courante ne possède pas encore de date ni de numéro de version.
Chaque ligne non vide avant la première entrée est considérée comme faisant parti du titre.
Chapitre II
L'utilitaire changelog
1. Description
Cette utilitaire permet de manipuler les fichiers ChangeLog au format décrit ci-dessus.
2. Synopsis
USAGE: changelog [OPTIONS] [COMMAND] [COMMAND_ARGS] OPTIONS: --help display this help message --pkg-dir <dir> base directory of the package --new create a new entry if no current entry found COMMAND COMMANDS_ARGS extract [release] extract messages for a given release. If no release is given, get messages for the current entry. lastrev retreive the latest version released add <message> add a message to the current entry update update the change log by fectching log entries from cvs close close the current entry (version is read from the package __init__.py file)
Ce script est appelé automatiquement par preparedistrib afin d'extraire les messages de la révision courante et de génerer l'annonce, puis de fermer l'entrée courante.
Chapitre III
Intégration avec [X]Emacs
Ce paquet fournit un mode Emacs pour notre format spécifique, écrit à l'aide de Pymacs. Afin d'utiliser ce format de change log dans [X]Emacs, il faut ajouter les lignes suivantes à votre .emacs (pensez à adapter les chemins !) :
;; Pymacs (autoload 'pymacs-load "pymacs" nil t) (autoload 'pymacs-eval "pymacs" nil t) (autoload 'pymacs-apply "pymacs") '(add-to-list 'pymacs-load-path "/home/syt/cvs_work/logilab") '(add-to-list 'pymacs-load-path "/home/syt/lib/python2.2/site-packages") ;; change log (load-library "changelog")
Si le paquet devtools n'est pas installé dans un répertoire standard, il faut qu'il soit accessible gràce à la liste pymacs-load-path (équivalent du PYTHONPATH pour pymacs).
Evidemment l'installation à l'aide de devtools à partir du paquet debian évite tout cela :o)