git-latexdiff - Call latexdiff on two Git revisions of a file
Usage: git latexdiff [options] OLD [NEW]
git latexdiff [options] OLD --
git latexdiff [options] -- OLD
Call latexdiff on two Git revisions of a file.
OLD and NEW are Git revision identifiers. NEW defaults to HEAD.
If "--" is used for NEW, then diff against the working directory.
Options:
--help this help message
--help-examples show examples of usage
--main <file> name of the main LaTeX, R Sweave,
or Emacs Org mode file.
The search for the only file containing 'documentclass'
will be attempted, if not specified.
For non-LaTeX files, a reasonable `prepare` command
will be used unless explicitly provided
--no-view don't display the resulting PDF file
--latex run latex instead of pdflatex
--xelatex run xelatex instead of pdflatex
--lualatex run lualatex instead of pdflatex
--tectonic run tectonic instead of pdflatex
--bibtex, --bbl display changes in the bibliography
(runs bibtex to generate *.bbl files and
include them in the source file using
latexpand --expand-bbl before computing
the diff)
--biber like --bibtex, but runs biber instead.
--run-bibtex, -b run bibtex as well as latex to generate the PDF file
(pdflatex,bibtex,pdflatex,pdflatex)
NOTE: --bibtex usually works better
--run-biber run BibLaTex-Biber as well as latex to generate the PDF file
(pdflatex,biber,pdflatex,pdflatex)
NOTE: --biber usually works better
--view view the resulting PDF file
(default if -o is not used)
--pdf-viewer <cmd> use <cmd> to view the PDF file (default: $PDFVIEWER)
--no-cleanup don't cleanup temp dir after running
--no-flatten don't call latexpand to flatten the document
--cleanup MODE Cleanup temporary files according to MODE:
- keeppdf (default): keep only the
generated PDF file
- none: keep all temporary files
(may eat your diskspace)
- all: erase all generated files.
Problematic with --view when the
viewer is e.g. evince, and doesn't
like when the file being viewed is
deleted.
--latexmk use latexmk
--build-dir use pdfs from specific build directory
--latexopt pass additional options to latex (e.g. -shell-escape)
-o <file>, --output <file>
copy resulting PDF into <file> (usually ending with .pdf)
Implies "--cleanup all"
--tmpdirprefix where temporary directory will be created (default: /tmp).
Relative path will use repository root as a base
--verbose, -v give more verbose output
--quiet redirect output from subprocesses to log files
--prepare <cmd> run <cmd> before latexdiff (e.g. run make to generate
included files)
--filter <cmd> run <cmd> after latexdiff and before compilation
(e.g. to fix up latexdiff output)
--ln-untracked symlink uncommited files from the working directory
--version show git-latexdiff version.
--subtree checkout the tree at and below the main file
(enabled by default, disable with --whole-tree)
--whole-tree checkout the whole tree (contrast with --subtree)
--ignore-latex-errors keep on going even if latex gives errors, so long as
a PDF file is produced
--ignore-makefile ignore the Makefile, build as though it doesn't exist
-* other options are passed directly to latexdiff
--latexpand OPT pass option OPT to latexpand. Use multiple times like
--latexpand OPT1 --latexpand OPT2 to pass multiple options.
--latexdiff-flatten use --flatten from latexdiff instead of latexpand
Unrecognized options are passed unmodified to latexdiff.
Examples:
Diff the previous revision with the latest commit:
git latexdiff HEAD^
Diff the latest commit with the working tree:
git latexdiff HEAD --
Diff latest commit with branch master:
git latexdiff master HEAD
Pass --type=CHANGEBAR to latexdiff to get changebars in the margins
instead of red+trike/blue+underline diff:
git latexdiff --type=CHANGEBAR HEAD^
Use a specific latexdiff configuration file:
git latexdiff --config /path/to/file HEAD^