Aide à la gestion du fichier ChangeLog
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
Cette utilitaire permet de manipuler les fichiers ChangeLog au format décrit
ci-dessus.
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)