Find Overfull Boxes Tool

Use tools/find_overfull.py to find overfull hbox/vbox warnings in LaTeX log files.

Usage

Basic usage (parses .log file for a .tex file):

python tools/find_overfull.py $ARGUMENTS[0]

Filter by box type:

python tools/find_overfull.py <file>.tex --vbox-only  # vertical overflow (too tall)
python tools/find_overfull.py <file>.tex --hbox-only  # horizontal overflow (too wide)

Filter by severity:

python tools/find_overfull.py <file>.tex --min-badness 10  # only boxes > 10pt overfull

Output formats:

python tools/find_overfull.py <file>.tex --pages-only  # just page numbers, one per line
python tools/find_overfull.py <file>.tex --json        # JSON format

Output

The tool reports:

• Page number where overflow occurs
• Type (hbox = too wide, vbox = too tall)
• How much it overflows (in pt)
• Source line number in .tex file
• Context (problematic content)

Notes

• Requires the .log file to exist (run pdflatex first)
• Looks in build/ directory for log files by default