::
La risposta di Gustavo è esemplare; vorrei avere io le sue doti di comunicazione.
Tuttavia vorrei aggiungere qualcosa alle sue parole preziose.
Riguardando il primo messaggio di @mg42, mi pare di capire che egli usi un editor del tipo di TeXstudio o di Texmaker., che mostrano nela finestrina in basso un messaggio d’errore in parte scritto dal programma “TeX” (tra virgolette, perché non mi riferisco in particolare a latex, pdflatex, lualatex, xelatex,…, ma in generale a tutti i programmi di composizione del sistema TeX), e in parte abbellito con un poco di formattazione specifica dell’editor.
Questo modo di mostrare gli errori è comodo per l’utente finale, ma è troppo sintetico in caso di errori difficli come quello mostrato da @mg42.
Io raccomanderei alcune cose che per me stesso trovo molto utili:
1) suggerirei di modificare le impostazioni dell’editor affinché non lavori in scrollmode, ma in errorstopmode; sono opzioni per il programma “TeX” che vanno scritte nella stringa che l’editor invia al sistema operativo per eseguirolo. La sintassi esatta di queste opzioni è descritta nella documentazione di ogni programma, generalmente leggibile con texdoc seguito dal nome del programma, per esempio texdoc pdflatex
2) suggerirei di aggiungere o come prima cosa, prima ancora di \documentclass,, oppure subito dopo \documentclass, oppure subito prima di \begin{document}, oppure, infine, subito dopo \begin{document}, il comando `\errorcontextlines=9`(il numero di righe da mostrare, che o ho indicato col la cifra 9, potrebbe essere un numero maggiore a seconda delle proprie preferenze).
Che cosa succede con questa impostazione avendo specificato l’opzione errorstopmodoe? UNa cosa semplicissima: la compilazione si arresta in corrispondenza dell’errore e mostra nella console il numero di righe che contengono la macro che via via ha dato luogo all’errore; cioè si traccia l’operato del programma.
Tutto ciò potrebbe dare luogo, all’inizio, ad una senso di frustrazione nel leggere questo “tracciato”; tuttavia in casi semplici si scopre che si trattava di un errore di ortografia che può essere immediatamente corretto nel file sorgente, per non dimenticarsi di farlo in una secondo momento. Talvolta si tratta di una mancata chiusura di un ambiente e diventa facilissimo trovare quale ambiente manca del suo specifico comando \end. Talvolta il messaggio è più complesso perché dice che il file è terminato prima di aver completato al lettura degli argomenti di una dato comando, e ciò significa che si è dimenticata una graffa chiusa.
Talvolta come nel caso specifico di @mg42, si tratta di una operazione sbagliata, come quella descritta grazie alla sua LaTeX-sfera-di-cristallo da Gustavo, di un errore presente in un file ausiliario. Spesso questo genere di errori sono innocui e basta rispondere S alla richiesta del programma che si è temporaneamente arrestato; certo il programma prosegue come meglio può dopo avergli dato il comando S, e probabilmente si ferma con una altro messaggio di errore, ma spesso va alla fine senza ulteriori problemi e senza che si ripresentino alla successiva compilazione.
Queste cose, come dice Gustavo, si imparano se si cerca di risolvere i problemi da soli, se si ha l’abitudine di leggere la documentazione; se si fa attenzione ai vari Warning che vengono emessi durante ogni compilazione, eccetera. Insomma usare i programmi del sistema TeX non è facile, anche perché questi programmi fanno milioni di cose che gli altri programmi di videoscrittura non fanno. Sappiamo tutti guidare un’automobile, perché al giorno d’oggi si contano sulle dita coloro che non hanno la patente; tuttavia guidare senza conoscere il mezzo che che si sta guidando è pericoloso, molto più pericoloso che usare il sistema TeX senza conoscerlo. Ma anche nel caso dell’automobile bisogna stare attenti a rumori che fa; bisogna sapere che cosa indicano le varie spie sul cruscotto; bisogna spare se l’indicatore di direzione si trova a destra o a sinistra del volante (non ho mai capito perché i vari costruttori non si mettano d’accordo su queste cose) e via di questo passo; non è necessario andare contro un muro, incapaci di sterzare, perché non ci si è accorti che si è spezzata la cinghia dentata che alimenta la pompa idraulica del servosterzo; è una caso estremo? mica tanto; a me la cinghia dentata si è spezzata 5 volte, ma non ho mai avuto incidenti; ho solo deciso che quella vettura doveva essere gentilmente essere sottoposta alla sua eutanasia, portandola alla demolizione. Anche questo è un esempio di mancato aggiornamento dei mezzi a disposizione; si applica anche al sistema TeX.
.
