summaryrefslogtreecommitdiff
path: root/support/git-latexdiff/man/man1/git-latexdiff.1
diff options
context:
space:
mode:
Diffstat (limited to 'support/git-latexdiff/man/man1/git-latexdiff.1')
-rw-r--r--support/git-latexdiff/man/man1/git-latexdiff.1145
1 files changed, 145 insertions, 0 deletions
diff --git a/support/git-latexdiff/man/man1/git-latexdiff.1 b/support/git-latexdiff/man/man1/git-latexdiff.1
new file mode 100644
index 0000000000..f817d1c435
--- /dev/null
+++ b/support/git-latexdiff/man/man1/git-latexdiff.1
@@ -0,0 +1,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
+.\}