summaryrefslogtreecommitdiff
path: root/support/git-latexdiff/man/man1/git-latexdiff.1
blob: f817d1c43562ee480460257de07d545ba03770e5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
'\" t
.\"     Title: git-latexdiff
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 03/30/2020
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "GIT\-LATEXDIFF" "1" "03/30/2020" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
git-latexdiff \- Call latexdiff on two Git revisions of a file
.SH "OPTIONS"
.sp
.if n \{\
.RS 4
.\}
.nf
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 \*(Aqdocumentclass\*(Aq
                            will be attempted, if not specified\&.
                            For non\-LaTeX files, a reasonable `prepare` command
                            will be used unless explicitly provided
    \-\-no\-view             don\*(Aqt 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\*(Aqt cleanup temp dir after running
    \-\-no\-flatten          don\*(Aqt 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\*(Aqt
                                  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\*(Aqt 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^
.fi
.if n \{\
.RE
.\}