TAGS files

Definizione

I files TAGS sono file compilati che contengono tutte le definizioni di funzione relative ai files che vengono scandagliati con il comando che li crea, ad esempio:

etags *.el

Crea un file TAGS con tutte le definizioni di funzione trovate nei file *.el presenti nella directory in cui il comando viene eseguito. Se non viene impostato diversamente al boot di Emacs non è presente nessun file TAGS.

Ne possiamo impostare uno (o più di uno) eseguendo il seguente comando:

M-x visit-tags-file

La scorciatoria da tastiera M-. (che richiama la funzione xref-find-definitions) cerca nei files TAGS caricati con il comando precedente (visit-tags-file) una funzione con nome pari alla parola sotto al cursore (at-point). Se non è stato caricato nessun file TAGS all’avvio di Emacs ne richiede uno da selezionare.

Utilizzo

Nel mio caso sono andato nella directory /home/max/Downloads/emacs-28.1/lisp/ ed ho creato un file TAGS digitando:

etags *.el

In questo modo posso digitare la combinazione di tasti M-. (collegato alla funzione xref-find-definitions) e cercare la definizione di funzione delle varie funzioni di Emacs, per esempio mark-whole-buffer.

Caricare i file TAGS al boot

Per evitare di selezionare ogni volta il file TAGS posso caricarlo al boot di Emacs inserendo nel file di configurazione init.el il le seguenti linee di codice che impostano la variabile con tutti i percorsi ai vari files TAGS da caricare, ad esempio:

(setq tags-table-list
	'("~/.emacs.d"
		"/usr/local/lib/emacs/src"))