Tag List sous vim

Une des fonctions les plus utiles pour naviguer dans un code source est la possibilité d’avoir une vue globale du fichier.
Il existe pour cela dans la plupart des IDE, une liste des fonctions/procédures.
Cette liste permet d’accéder directement à la fonction, souvent par un double-clic.

Vim permet de faire ceci grâce au greffon taglist.
taglist_vim

Après avoir décompressé le plugin dans votre répertoire ~/.vim/plugin/, vous pourrez ajouter aussi la documentation (doc/taglist.txt) au répertoire ~/.vim/doc. Comme déjà expliqué dans un article précédent, il faudra ensuite faire sous vim

:helptags ~/.vim/doc

.

Ouvrez votre fichier source, puis tapez maintenant :TlistToggle.
Cela fera apparaître une fenêtre de la liste de vos variables, fonctions, classes, tout ceci de manière hiérarchique.

Pour naviguer sur une fonction, il suffit de positionner son curseur sur la fonction et de faire Entrer.
Pour passer d’une fenêtre à l’autre, faire la combinaison Ctrl-W W.

Pour obtenir une petite aide rapide des raccourcis claviers, taper F1 dans la « Taglist ».
Vous pourrez voir comment ouvrir ou fermer une arborescence.

Par défaut la liste des tags est affichée dans l’ordre d’apparition du fichier source.
Lorsque vous chercherez une fonction dont vous connaissez le début du nom, vous souhaiterez plutôt un affichage par ordre alphabétique.
Rien de plus simple, il suffit de taper la touche s (sort) dans la taglist.
Si vous tapez de nouveau sur cette touche, on bascule de nouveau sur l’affichage classique.

Pour ouvrir un nouveau fichier, placez vous d’abord dans la fenêtre du fichier source existant puis taper :e nouveau_fichier.c.
Vous pouvez aussi taper la commande :TlistAddFiles nouveau_fichier.c. Cette commande permet aussi d’ouvrir plusieurs fichiers en même temps, en précisant *.c par exemple.

Pour fermer un fichier, il suffira de faire un :bdelete (buffer delete).
cf. article sur l’édition de plusieurs fichiers et la manipulation des buffers
Plus simplement, vous pouvez positionner le curseur sur le fichier dans la Taglist et appuer sur la touche d.

Petite astuce: pour ouvrir facilement la Taglist ajouter ce code dans .vimrc :

map <F8> :TlistToggle

Comme vous l’aurez compris, cela permet d’ouvrir la Taglist par la touche F8 : très pratique !

Laisser un commentaire