summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/latexdiff-vc.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-06-26 21:22:49 +0000
committerKarl Berry <karl@freefriends.org>2017-06-26 21:22:49 +0000
commitb41810159701157d4c4082233224c298a27f4574 (patch)
treea61fa5dc80943832d2f5eb7d18055771d21fb56c /Master/texmf-dist/doc/man/man1/latexdiff-vc.1
parent7837dac6397945497b0c4c0afd80c45099572453 (diff)
latexdiff (26jun17)
git-svn-id: svn://tug.org/texlive/trunk@44704 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/latexdiff-vc.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/latexdiff-vc.167
1 files changed, 54 insertions, 13 deletions
diff --git a/Master/texmf-dist/doc/man/man1/latexdiff-vc.1 b/Master/texmf-dist/doc/man/man1/latexdiff-vc.1
index e2475f33891..de15edbc0ec 100644
--- a/Master/texmf-dist/doc/man/man1/latexdiff-vc.1
+++ b/Master/texmf-dist/doc/man/man1/latexdiff-vc.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "LATEXDIFF-VC 1"
-.TH LATEXDIFF-VC 1 "2016-08-15" "perl v5.18.2" " "
+.TH LATEXDIFF-VC 1 "2017-06-22" "perl v5.18.2" " "
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -207,6 +207,52 @@ Note that if additional files are needed which are not included in the flatten p
The generic usage of this function is : \f(CW\*(C`latexdiff\-vc \-\-flatten \-r rev1 [\-r rev2] master.tex\*(C'\fR where master.tex is the project file containing the highest level of includes etc.
.Sp
With \f(CW\*(C`\-\-flatten=keep\-intermediate\*(C'\fR, the intermediate revision snapshots are kept in the current directory (Default is to store them in a temporary directory and delete them after generating the diff file.)
+.IP "\fB\-\-config var1=val1,var2=val2,...\fR or \fB\-c var1=val1,..\fR" 4
+.IX Item "--config var1=val1,var2=val2,... or -c var1=val1,.."
+.PD 0
+.IP "\fB\-\-only\-changes\fR" 4
+.IX Item "--only-changes"
+.PD
+Post-process the output such that only pages with changes on them are displayed. This requires the use of subtype \s-1ZLABEL \s0
+in latexdiff, which will be set automatically, but any manually set \-s option will be overruled (also requires zref package to
+be installed). (note that this option must be combined with \-\-ps or \-\-pdf to make sense)
+.IP "\fB\-\-force\fR" 4
+.IX Item "--force"
+Overwrite existing diff files without asking for confirmation. Default
+behaviour is to ask for confirmation before overwriting an existing difference
+file.
+.IP "\fB\-\-run\fR" 4
+.IX Item "--run"
+run latex command on diff file after generation of diff file.
+.IP "\fB\-\-dvi\fR" 4
+.IX Item "--dvi"
+run latex and dvixxx commands after generation of diff file.
+.IP "\fB\-c configfile\fR" 4
+.IX Item "-c configfile"
+Set configuration variables for latexdiff and latexdiff-vc. The option can be repeated to set different
+variables (as an alternative to the comma-separated list).
+Available variables for latexdiff-vc:
+.RS 4
+.ie n .IP """LATEXDIFF"" latexdiff command (e.g. latexdiff-fast, latexdiff-so). This command should support the option ""\-\-interaction=batchmode""" 8
+.el .IP "\f(CWLATEXDIFF\fR latexdiff command (e.g. latexdiff-fast, latexdiff-so). This command should support the option \f(CW\-\-interaction=batchmode\fR" 8
+.IX Item "LATEXDIFF latexdiff command (e.g. latexdiff-fast, latexdiff-so). This command should support the option --interaction=batchmode"
+.PD 0
+.ie n .IP """LATEX"" latex command (e.g. pdflatex, lualatex)" 8
+.el .IP "\f(CWLATEX\fR latex command (e.g. pdflatex, lualatex)" 8
+.IX Item "LATEX latex command (e.g. pdflatex, lualatex)"
+.ie n .IP """DVI2"" Command for conversion of dvi file (e.g. dvips, dvipdf)" 8
+.el .IP "\f(CWDVI2\fR Command for conversion of dvi file (e.g. dvips, dvipdf)" 8
+.IX Item "DVI2 Command for conversion of dvi file (e.g. dvips, dvipdf)"
+.ie n .IP """BIBTEX"" Command replacing bibtex" 8
+.el .IP "\f(CWBIBTEX\fR Command replacing bibtex" 8
+.IX Item "BIBTEX Command replacing bibtex"
+.RE
+.RS 4
+.PD
+.Sp
+All other config variables are passed to latexdiff. Explicity set configuration changes always override implicit
+changes by the following shortcut options \fB\-\-fast\fR, \fB\-\-so\fR, \fB\-\-ps\fR and \fB\-\-pdf\fR.
+.RE
.IP "\fB\-\-fast\fR or \fB\-\-so\fR" 4
.IX Item "--fast or --so"
Use \f(CW\*(C`latexdiff\-fast\*(C'\fR or \f(CW\*(C`latexdiff\-so\*(C'\fR, respectively (instead of \f(CW\*(C`latexdiff\*(C'\fR).
@@ -223,16 +269,11 @@ bibtex; latex; latex; dvips\*(C'\fR.
Generate pdf output from difference file using \f(CW\*(C`pdflatex\*(C'\fR. This will
run the sequence \f(CW\*(C`pdflatex; pdflatex\*(C'\fR on the difference file, or
\&\f(CW\*(C`pdflatex; bibtex; pdflatex; pdflatex\*(C'\fR for files requiring bibtex.
-.IP "\fB\-\-only\-changes\fR" 4
-.IX Item "--only-changes"
-Post-process the output such that only pages with changes on them are displayed. This requires the use of subtype \s-1ZLABEL \s0
-in latexdiff, which will be set automatically, but any manually set \-s option will be overruled (also requires zref package to
-be installsed). (note that this option must be combined with \-\-ps or \-\-pdf to make sense)
-.IP "\fB\-\-force\fR" 4
-.IX Item "--force"
-Overwrite existing diff files without asking for confirmation. Default
-behaviour is to ask for confirmation before overwriting an existing difference
-file.
+Note that this is not just a shortcut for setting configuration variable but also triggers
+some special behaviour.
+.IP "\fB\-\-show\-config\fR" 4
+.IX Item "--show-config"
+Show values of configuration variables.
.IP "\fB\-\-help\fR or \fB\-h\fR" 4
.IX Item "--help or -h"
Show help text
@@ -257,8 +298,8 @@ or send them to \fItilmann \*(-- \s-1AT\s0 \*(-- gfz\-potsdam.de\fR. Include th
(option \f(CW\*(C`\-\-version\*(C'\fR).
.SH "AUTHOR"
.IX Header "AUTHOR"
-Version 1.2.0
-Copyright (C) 2005\-2016 Frederik Tilmann
+Version 1.2.1
+Copyright (C) 2005\-2017 Frederik Tilmann
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the \s-1GNU\s0 General Public License Version 3