From 90a718a9a627aec0f396f31710b608bdc24ebf72 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 14 Apr 2020 14:53:54 +0000 Subject: git-latexdiff git-svn-id: svn://tug.org/texlive/trunk@54732 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/git-latexdiff.1 | 145 +++++++++++++++++++++ .../texmf-dist/doc/man/man1/git-latexdiff.man1.pdf | Bin 0 -> 17631 bytes 2 files changed, 145 insertions(+) create mode 100644 Master/texmf-dist/doc/man/man1/git-latexdiff.1 create mode 100644 Master/texmf-dist/doc/man/man1/git-latexdiff.man1.pdf (limited to 'Master/texmf-dist/doc/man') diff --git a/Master/texmf-dist/doc/man/man1/git-latexdiff.1 b/Master/texmf-dist/doc/man/man1/git-latexdiff.1 new file mode 100644 index 00000000000..f817d1c4356 --- /dev/null +++ b/Master/texmf-dist/doc/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 +.\" 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 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 use 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 , \-\-output + copy resulting PDF into (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 run before latexdiff (e\&.g\&. run make to generate + included files) + \-\-filter run 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 +.\} diff --git a/Master/texmf-dist/doc/man/man1/git-latexdiff.man1.pdf b/Master/texmf-dist/doc/man/man1/git-latexdiff.man1.pdf new file mode 100644 index 00000000000..3dab2da3b99 Binary files /dev/null and b/Master/texmf-dist/doc/man/man1/git-latexdiff.man1.pdf differ -- cgit v1.2.3