summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-02-22 22:04:48 +0000
committerKarl Berry <karl@freefriends.org>2015-02-22 22:04:48 +0000
commit0d90f2f36d4d8fde651668aaab3e48a2c6db80c1 (patch)
tree271511032392443cf6b595cced2b2608f2fb4d76 /Master/texmf-dist/doc/man/man1
parent23d33b3a33e4e066a0718491024c5c2ee8ec7f99 (diff)
latexmk (22feb15)
git-svn-id: svn://tug.org/texlive/trunk@36353 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1')
-rw-r--r--Master/texmf-dist/doc/man/man1/latexmk.147
-rw-r--r--Master/texmf-dist/doc/man/man1/latexmk.man1.pdfbin145217 -> 147760 bytes
2 files changed, 42 insertions, 5 deletions
diff --git a/Master/texmf-dist/doc/man/man1/latexmk.1 b/Master/texmf-dist/doc/man/man1/latexmk.1
index 5d2afc41803..a4e46dc36b3 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 "10 January 2015" ""
+.TH LATEXMK 1L "5 February 2015" ""
.SH NAME
latexmk \- generate LaTeX document
.SH SYNOPSIS
@@ -869,10 +869,15 @@ Print version number of \fIlatexmk\fR.
.B -verbose
Opposite of \fB-silent\fR. This is the default setting.
.TP
-.B -view=default, -view=dvi, -view=ps, -view=pdf
+.B -view=default, -view=dvi, -view=ps, -view=pdf, -view=none
Set the kind of file used when previewing is requested (e.g., by the
\fB-pv\fR or \fB-pvc\fR switches). The default is to view the "highest"
kind of requested file (in the order dvi, ps, pdf).
+
+Note the possibility \fB-view=none\fR where no viewer is opened at
+all. One example of is use is in conjunction with the \fB-pvc\fR
+option, when you want \fIlatexmk\fR to do a compilation automatically
+whenever source file(s) change, but do want a previewer to be opened.
.TP
.B -xelatex
@@ -1503,15 +1508,43 @@ compilation.
Custom dependency list -- see section on "Custom Dependencies".
.TP
+.B @default_excluded_files [()]
+When \fIlatexmk\fR is invoked with no files specified on the command
+line, then, by default, it will process all files in the current
+directory with the extension .tex. (In general, it will process the
+files specified in the \fI@default_files\fR variable.)
+
+But sometimes you want to exclude particular files from this default
+list. In that case you can specify the excluded files in the array
+\fI@default_excluded_files\fR. For example if you wanted to process
+all .tex files with the exception of common.tex, which is a not a
+standard alone LaTeX file but a file input by some or all of the
+others, you could do
+
+ @default_files = ("*.tex");
+
+ @default_excluded_files = ("common.tex");
+
+If you have a variable or large number of files to be processed, this
+method saves you from having to list them in detail in
+\fI@default_files\fR and having to update the list every time you
+change the set of files to be processed.
+
+Notes: 1. This variable has no effect except when no files are
+specified on the \fIlatexmk\fR command line. 2. Wildcards are allowed
+in \fI@default_excluded_files\fR.
+
+.TP
.B @default_files [("*.tex")]
Default list of files to be processed.
-Normally, if no filenames are specified on the command line,
+If no filenames are specified on the command line,
\fIlatexmk\fR processes all tex files specified in the \fI@default_files\fR
variable, which by default is set to all tex files ("*.tex") in the
current directory. This is a convenience: just run \fIlatexmk\fR and
it will process an appropriate set of files. But sometimes you want
-only some of these files to be processed. In this case you set the
+only some of these files to be processed. In this case you can list
+the files to be processed by setting
\fI@default_files\fR in an initialization file
(e.g., the file "latexmkrc" in the current directory). Then if no
files are specified on the command line then the files you specify by
@@ -1529,6 +1562,10 @@ Note that more than file may be given, and that the default extension
is ".tex". Wild cards are allowed. The parentheses are because
\fI@default_files\fR is an array variable, i.e., a sequence of
filename specifications is possible.
+
+If you want \fIlatexmk\fR to process all .tex files with a few
+exceptions, see the \fI@default_excluded_files\fR array variable.
+
.TP
.B $dependents_phony [0]
If a list of dependencies is output, this variable determines whether
@@ -2703,7 +2740,7 @@ 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 jcc8 at node psu.edu).
-(Version 4.42).
+(Version 4.43a).
Released version can be obtained from CTAN:
<http://www.ctan.org/tex-archive/support/latexmk/>, and from the
diff --git a/Master/texmf-dist/doc/man/man1/latexmk.man1.pdf b/Master/texmf-dist/doc/man/man1/latexmk.man1.pdf
index 4f26dc26443..7721ee89666 100644
--- a/Master/texmf-dist/doc/man/man1/latexmk.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/latexmk.man1.pdf
Binary files differ