summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/latexmk.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/latexmk.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/latexmk.163
1 files changed, 55 insertions, 8 deletions
diff --git a/Master/texmf-dist/doc/man/man1/latexmk.1 b/Master/texmf-dist/doc/man/man1/latexmk.1
index f9778ed60ca..a6d01b71c72 100644
--- a/Master/texmf-dist/doc/man/man1/latexmk.1
+++ b/Master/texmf-dist/doc/man/man1/latexmk.1
@@ -1,4 +1,4 @@
-.TH LATEXMK 1L "2 December 2013" ""
+.TH LATEXMK 1L "1 January 2015" ""
.SH NAME
latexmk \- generate LaTeX document
.SH SYNOPSIS
@@ -542,15 +542,15 @@ Turn off the automatic reading of initialization (rc) files.
N.B. Normally the initialization files are read and obeyed, and then
command line options are obeyed in the order they are encountered.
-Then \fB-norc\fR is an exception to this rule: it is acted on first,
-no matter where is occurs on the command line.
+But \fB-norc\fR is an exception to this rule: it is acted on first,
+no matter where it occurs on the command line.
.TP
.B -outdir=FOO or -output-directory=FOO
Sets the directory for the output files of (pdf)latex. This achieves
its effect by the \fB-output-directory\fR option of (pdf)latex, which
-currently (Dec. 2011) is implemented on the common versions of
+currently (Dec. 2011 and later) is implemented on the common versions of
(pdf)latex, i.e., MiKTeX and TeXLive. It may not be present in other
versions.
@@ -808,11 +808,30 @@ documentation. These options are:
\fB-output-directory=DIR\fR, \fB-quiet\fR, and \fB-recorder\fR.
.TP
+.B -logfilewarninglist
+.B -logfilewarnings
+After a run of (pdf)latex, give a list of warnings about
+undefined citations and references (unless silent mode is on).
+
+See also the $silence_logfile_warnings configuration variable.
+
+.TP
+.B -logfilewarninglist-
+.B -logfilewarnings-
+After a run of (pdf)latex, do not give a list of warnings about
+undefined citations and references. (Default)
+
+See also the $silence_logfile_warnings configuration variable.
+
+.TP
.B -silent
Run commands silently, i.e., with options that reduce the amount of
diagnostics generated. For example, with the default settings, the
command "latex -interaction=batchmode" is used for latex.
+See also the \fB-logfilewarninglist\fR and \fB-logfilewarninglist-\fR
+options.
+
Also reduce the number of informational messages that \fIlatexmk\fR
generates.
@@ -969,6 +988,8 @@ that of cygwin), \fIlatexmk\fR reads for the first it finds of
"/opt/local/share/latexmk/LatexMk",
"/usr/local/share/latexmk/LatexMk",
"/usr/local/lib/latexmk/LatexMk".
+ In addition, it then tries the same set of locations, but with the
+file name replaced "LatexMk" replaced by "latexmkrc".
.PP
2) The user's RC file, "$HOME/.latexmkrc", if it exists. Here $HOME
is the user's home directory. [\fILatexmk\fR determines the user's
@@ -1301,7 +1322,7 @@ written.
\fBImportant note\fR: The effect of \fI$aux_dir\fR, if different from
\fI$out_dir\fR, is achieved by giving (pdf)latex the
-\fB-aux-directory\fR. Currently (Dec. 2011) this only works on the
+\fB-aux-directory\fR. Currently (Dec. 2011 and later) this only works on the
MiKTeX version of (pdf)latex.
See also the documentation of \fI$out_dir\fR for some complications on
@@ -1519,6 +1540,11 @@ match.
.B $dependents_list [0]
Whether to display a list(s) of dependencies at the end of a run.
.TP
+.B $deps_file ["-"]
+Name of file to receive list(s) of dependencies at the end of a run,
+to be used if \fI$dependesnt_list\fR is set. If the filename is "-",
+then the dependency list is set to stdout (i.e., normally the screen).
+.TP
.B $do_cd [0]
Whether to change working directory to the directory specified for the
main source file before processing it. The default behavior is not to
@@ -1879,7 +1905,7 @@ The directory in which output files are to be written by a run of
The effect of this variable (when non-blank) is achieved by using the
\fB-output-directory\fR option of (pdf)latex. This exists in the
-usual current (Dec. 2011) implementations of TeX, i.e., MiKTeX and
+usual current (Dec. 2011 and later) implementations of TeX, i.e., MiKTeX and
TeXLive. But it may not be present in other versions.
Commonly, the directory specified for output files is a subdirectory
@@ -2234,6 +2260,27 @@ for unusual operating systems that are not in the MSWin, Linux, OS-X,
Unix collection.)
.TP
+.B $silence_logfile_warnings [0]
+Whether after a run of (pdf)latex to summarize warnings in the log
+file about undefined citations and references. Setting
+$silence_logfile_warnings=0 gives the summary of warnings (provided
+silent mode isn't also set), and this is useful to locate undefined
+citations and references without searching through the much more
+verbose log file or the screen output of (pdf)latex. But the summary
+can also be excessively annoying. The default is not to give these
+warnings. The command line options
+\fB-silence_logfile_warning_list\fR and
+\fB-silence_logfile_warning_list-\fR also set this variable.
+
+Note that multiple occurrences for the same undefined object on the
+same page and same line will be compressed to a single warning.
+
+.TP
+.B $silent [0]
+Whether to run silently. Setting $silent to 1 has the same effect as
+the \fB-quiet\fR of \fB-silent\fR options on the command line.
+
+.TP
.B $sleep_time [2]
The time to sleep (in seconds) between checking for source file
changes when running with the \fB-pvc\fR option. This is subject to a
@@ -2649,8 +2696,8 @@ suggestions that contributed to version 3, and Herbert Schulz.
e-mail addresses are not written in their standard form to avoid being
harvested by worms and viruses.)
.SH AUTHOR
-Current version, by John Collins (username collins at node phys.psu.edu).
-(Version 4.39).
+Current version, by John Collins (username jcc8 at node psu.edu).
+(Version 4.41).
Released version can be obtained from CTAN:
<http://www.ctan.org/tex-archive/support/latexmk/>, and from the