Gestire i warning

A differenza degli errori, i warning non bloccano la compilazione — ma vanno comunque letti, perché spesso segnalano problemi visibili nel PDF finale (spaziature strane, riferimenti mancanti, testo che esce dal margine).

Overfull/Underfull \hbox

Overfull \hbox (15.0pt too wide) in paragraph at lines 42--45
Underfull \hbox (badness 10000) in paragraph at lines 50--52

Indica che una riga di testo è troppo larga (overfull, sborda dal margine) o troppo "vuota" (underfull, gli spazi tra le parole sono stati allargati troppo per giustificare il testo) per essere composta bene.

Suggerimento

Le cause più comuni sono parole lunghe non sillababili (nomi propri, codice, URL) o tabelle/immagini più larghe della pagina. Il pacchetto microtype riduce drasticamente questi warning regolando in modo impercettibile la spaziatura dei caratteri.

Reference ? undefined

LaTeX Warning: Reference `eq:pythagorean' on page 3 undefined on input line 12.

Significa che si sta usando \ref{eq:pythagorean} (o \eqref, \cite, ecc.) ma non esiste nessun \label{eq:pythagorean} corrispondente nel documento — oppure il file .aux non è ancora aggiornato.

Attenzione

I riferimenti incrociati richiedono almeno due compilazioni: alla prima passata LaTeX scrive le posizioni in un file .aux, alla seconda le legge e le inserisce nel testo. Se il warning persiste dopo due compilazioni, il \label è davvero mancante o scritto male — vedi Riferimenti incrociati.

Font shape ... not available

LaTeX Font Warning: Font shape `OT1/cmr/bx/sc' undefined
(Font)              using `OT1/cmr/bx/n' instead

Si è chiesta una combinazione di font (ad esempio grassetto + maiuscoletto) che non esiste nel font correntemente caricato: LaTeX usa la variante più simile disponibile invece di generare un errore.

Citation ... undefined

LaTeX Warning: Citation `smith2020' undefined

Come per i riferimenti incrociati, ma per la bibliografia: la chiave citata con \cite{smith2020} non esiste nel file .bib, oppure la bibliografia non è stata ricompilata (con biblatex/biber serve un passaggio di compilazione dedicato, non solo pdflatex/lualatex).

Come non perdersi tra i warning

Suggerimento

Visual Studio Code con l'estensione LaTeX Workshop mostra i warning direttamente nel pannello "Problems", con il numero di riga cliccabile — molto più comodo che leggerli nel log grezzo del terminale.

Se si usa arara per orchestrare la compilazione, si può anche configurare un passaggio finale che segnali se sono rimasti warning non risolti, invece di doverli controllare manualmente ogni volta.