latexmk (22feb15)

git-svn-id: svn://tug.org/texlive/trunk@36353 c570f23f-e606-0410-a88d-b1316a301751

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