GIT-LATEXDIFF(1)

NAME
git-latexdiff - Call latexdiff on two Git revisions of a file

OPTIONS

    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^