1GIT-LATEXDIFF(1) GIT-LATEXDIFF(1)
2
6 git-latexdiff - Call latexdiff on two Git revisions of a file
7
9 Usage: git latexdiff [options] OLD [NEW]
10 git latexdiff [options] OLD --
11 git latexdiff [options] -- OLD
12 Call latexdiff on two Git revisions of a file.
13 OLD and NEW are Git revision identifiers. NEW defaults to HEAD.
15 If "--" is used for NEW, then diff against the working directory.
16 Options:
18 --help this help message
19 --help-examples show examples of usage
20 --main <file> name of the main LaTeX, R Sweave,
21 or Emacs Org mode file.
22 The search for the only file containing 'documentclass'
23 will be attempted, if not specified.
24 For non-LaTeX files, a reasonable `prepare` command
25 will be used unless explicitly provided
26 --no-view don't display the resulting PDF file
27 --latex run latex instead of pdflatex
28 --xelatex run xelatex instead of pdflatex
29 --lualatex run lualatex instead of pdflatex
30 --tectonic run tectonic instead of pdflatex
31 --bibtex, --bbl display changes in the bibliography
32 (runs bibtex to generate *.bbl files and
33 include them in the source file using
34 latexpand --expand-bbl before computing
35 the diff)
36 --biber like --bibtex, but runs biber instead.
37 --run-bibtex, -b run bibtex as well as latex to generate the PDF file
38 (pdflatex,bibtex,pdflatex,pdflatex)
39 NOTE: --bibtex usually works better
40 --run-biber run BibLaTex-Biber as well as latex to generate the PDF file
41 (pdflatex,biber,pdflatex,pdflatex)
42 NOTE: --biber usually works better
43 --view view the resulting PDF file
44 (default if -o is not used)
45 --pdf-viewer <cmd> use <cmd> to view the PDF file (default: $PDFVIEWER)
46 --no-cleanup don't cleanup temp dir after running
47 --no-flatten don't call latexpand to flatten the document
48 --cleanup MODE Cleanup temporary files according to MODE:
49 - keeppdf (default): keep only the
51 generated PDF file
52 - none: keep all temporary files
54 (may eat your diskspace)
55 - all: erase all generated files.
57 Problematic with --view when the
58 viewer is e.g. evince, and doesn't
59 like when the file being viewed is
60 deleted.
61 --latexmk use latexmk
63 --build-dir use pdfs from specific build directory
64 --latexopt pass additional options to latex (e.g. -shell-escape)
65 -o <file>, --output <file>
66 copy resulting PDF into <file> (usually ending with .pdf)
67 Implies "--cleanup all"
68 --tmpdirprefix where temporary directory will be created (default: /tmp).
69 Relative path will use repository root as a base
70 --verbose, -v give more verbose output
71 --quiet redirect output from subprocesses to log files
72 --prepare <cmd> run <cmd> before latexdiff (e.g. run make to generate
73 included files)
74 --filter <cmd> run <cmd> after latexdiff and before compilation
75 (e.g. to fix up latexdiff output)
76 --ln-untracked symlink uncommited files from the working directory
77 --version show git-latexdiff version.
78 --subtree checkout the tree at and below the main file
79 (enabled by default, disable with --whole-tree)
80 --whole-tree checkout the whole tree (contrast with --subtree)
81 --ignore-latex-errors keep on going even if latex gives errors, so long as
82 a PDF file is produced
83 --ignore-makefile ignore the Makefile, build as though it doesn't exist
84 -* other options are passed directly to latexdiff
85 --latexpand OPT pass option OPT to latexpand. Use multiple times like
86 --latexpand OPT1 --latexpand OPT2 to pass multiple options.
87 --latexdiff-flatten use --flatten from latexdiff instead of latexpand
88 Unrecognized options are passed unmodified to latexdiff.
90 Examples:
92 Diff the previous revision with the latest commit:
94 git latexdiff HEAD^
96 Diff the latest commit with the working tree:
98 git latexdiff HEAD --
100 Diff latest commit with branch master:
102 git latexdiff master HEAD
104 Pass --type=CHANGEBAR to latexdiff to get changebars in the margins
106 instead of red+trike/blue+underline diff:
107 git latexdiff --type=CHANGEBAR HEAD^
109 Use a specific latexdiff configuration file:
111 git latexdiff --config /path/to/file HEAD^
113 03/30/2020 GIT-LATEXDIFF(1)