latexmk 4.22b (11jan11)

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

2 files changed, 39 insertions, 26 deletions

diff --git a/Master/texmf/doc/man/man1/latexmk.1 b/Master/texmf/doc/man/man1/latexmk.1
index 7e0bc674c09..8b87e672467 100644
--- a/Master/texmf/doc/man/man1/latexmk.1
+++ b/Master/texmf/doc/man/man1/latexmk.1
@@ -1,4 +1,4 @@
-.TH LATEXMK 1L "28 December 2010" ""
+.TH LATEXMK 1L "9 January 2011" ""
 .SH NAME
 latexmk \- generate LaTeX document
 .SH SYNOPSIS
@@ -30,7 +30,7 @@ programs as necessary.  In particular, it will repeat the run of LaTeX
 (or pdflatex) often enough to resolve all cross references; depending
 on the macro packages used.  With some macro packages and document
 classes, four, or even more, runs may be needed. If necessary,
-\fIlatexmk\fR will also run bibtex and/or makeindex.  In addition,
+\fIlatexmk\fR will also run bibtex, biber, and/or makeindex.  In addition,
 \fIlatexmk\fR can be configured to generate other necessary files.
 For example, from an updated figure file it can automatically generate
 a file in encapsulated postscript or another suitable format for
@@ -104,37 +104,41 @@ is automatically added, just as LaTeX does.  Thus, if you specify:
 then \fIlatexmk\fR will operate on the file "foo.tex".  
 .TP
 .B -bibtex 
-When the source file uses bbl files for bibliography, run bibtex as needed
-to regenerate the bbl files.  
+When the source file uses bbl files for bibliography, run bibtex or
+biber as needed to regenerate the bbl files.  
 
 This property can also be configured by setting the \fI$bibtex_use\fR
 variable to 2 in a configuration file
 .TP
 .B -bibtex-
-Never run bibtex.  
+Never run bibtex or biber.  
 
 A common use for this option is when a document comes from an external
 source, complete with its bbl file(s), and the user does not have the
 corresponding bib files available.  In this situation use of the
 \fB-bibtex-\fR option will prevent \fIlatexmk\fR from trying to run
-\fIbibtex\fR, which would result in overwriting of the bbl files.
+\fIbibtex\fR or \fIbiber\fR, which would result in overwriting of the
+bbl files. 
 .TP
 .B -bibtex-cond
 When the source file uses bbl file(s) for the bibliography, run
-\fIbibtex\fR as needed to regenerate the bbl files, but only if the
+\fIbibtex\fR or \fIbiber\fR as needed to regenerate the bbl files, but
+only if the 
 relevant bib file(s) exist.  Thus when the bib files are not
-available, \fIbibtex\fR is not run, thereby avoiding overwriting of
+available, \fIbibtex\fR or \fIbiber\fR is not run, thereby avoiding
+overwriting of 
 the bbl file(s).  This is the default setting.
 
 (Note that it is possible for \fIlatexmk\fR to decide that the bib
 file does not exist, even though the bib file does exist and
-\fIbibtex\fR finds it.  The problem is that the bib file may not be in
+\fIbibtex\fR or \fIbiber\fR finds it.  The problem is that the bib
+file may not be in 
 the current directory but in some search path; the places
-\fIlatexmk\fR and \fIbibtex\fR cause to be searched need not be
+\fIlatexmk\fR and \fIbibtex\fR or \fIbiber\fR cause to be searched need not be
 identical.  On modern installations of TeX and related programs this
 problem should not arise, since \fIlatexmk\fR uses the \fIkpsewhich\fR
 program to do the search, and \fIkpsewhich\fR should use the same
-search path as \fIbibtex\fR.  If this problem arises, use the
+search path as \fIbibtex\fR and \fIbiber\fR.  If this problem arises, use the
 \fB-bibtex\fR option when invoking \fIlatexmk\fR.)
 .TP
 .B -bm <message>
@@ -163,7 +167,7 @@ exit.
 .TP 
 .B -c
 Clean up (remove) all regeneratable files generated by \fIlatex\fR and
-\fIbibtex\fR except dvi, postscript and pdf.  These files are a
+\fIbibtex\fR or \fIbiber\fR except dvi, postscript and pdf.  These files are a
 combination of log files, aux files, latexmk's database file of source
 file information, 
 and those with extensions
@@ -183,7 +187,7 @@ dependencies and are also deleted.  Otherwise these files are not deleted.
 .TP 
 .B -C
 Clean up (remove) all regeneratable files generated by \fIlatex\fR and
-\fIbibtex\fR.  This is the same as the \fB-c\fR option with the
+\fIbibtex\fR or \fIbiber\fR.  This is the same as the \fB-c\fR option with the
 addition of dvi, postscript and pdf files, and those with extensions
 in the \fI$clean_full_ext\fR configuration variable.
 
@@ -335,13 +339,14 @@ in its normal behavior that in preview-continuous mode it checks for
 an already-running previewer.  
 .TP
 .B -nobibtex
-Never run bibtex.
+Never run bibtex or biber.
 
 A common use for this option is when a document comes from an external
 source, complete with its bbl file(s), and the user does not have the
 corresponding bib files available.  In this situation use of the
 \fB-nobibtex\fR option will prevent \fIlatexmk\fR from trying to run
-\fIbibtex\fR, which would result in overwriting of the bbl files.
+\fIbibtex\fR or \fIbiber\fR, which would result in overwriting of the
+bbl files. 
 .TP
 .B -p
 Print out the document.  By default it is
@@ -502,6 +507,7 @@ generates.
 To change the options used to make the commands run silently, you need
 to configure \fIlatexmk\fR with changed values of its configuration
 variables, the relevant ones being \fI$bibtex_silent_switch\fR,
+\fI$biber_silent_switch\fR,
 \fI$dvips_silent_switch\fR, \fI$latex_silent_switch\fR, and
 \fI$pdflatex_silent_switch\fR.
 .TP
@@ -871,6 +877,12 @@ since it has a better method of searching for files using the
 kpsewhich command.  However, if your system is an unusual one without
 the kpsewhich command, you may need to set the variable \fI@BIBINPUTS\fR.
 .TP
+.B $biber ["biber %O %S"]
+The biber processing program.
+.TP
+.B $biber_silent_switch ["--onlylog"]
+\fBSwitch(es)\fR for the biber processing program when silent mode is on.
+.TP
 .B $bibtex ["bibtex %O %S"]
 The BibTeX processing program.
 .TP
@@ -878,19 +890,19 @@ The BibTeX processing program.
 \fBSwitch(es)\fR for the BibTeX processing program when silent mode is on.
 .TP
 .B $bibtex_use [1]
-Under what conditions to run BibTeX.  When \fIlatexmk\fR discovers
-from the log file that one (or more) BibTeX-generated bibliographies
-are used, it can run BibTeX whenever it appears necessary to
+Under what conditions to run BibTeX or biber.  When \fIlatexmk\fR discovers
+from the log file that one (or more) BibTeX/biber-generated bibliographies
+are used, it can run BibTeX or biber whenever it appears necessary to
 regenerate the bbl file(s) from their source bib database file(s).  
 
 But sometimes, the bib file(s) are not available (e.g., for a document
 obtained from an external archive), but the bbl files are provided.
-In that case use of BibTeX will result in incorrect overwriting of the
-precious bbl files.  The variable \fI$bibtex_use\fR controls whether
-this happens.  Its possible values are: 0: never use BibTeX.  1: only
-use BibTeX if the bib files exist.  2: run BibTeX whenever it appears
-necessary to update the bbl files, without testing for the existence
-of the bib files.
+In that case use of BibTeX or biber will result in incorrect
+overwriting of the precious bbl files.  The variable \fI$bibtex_use\fR
+controls whether this happens.  Its possible values are: 0: never use
+BibTeX or biber.  1: only use BibTeX or biber if the bib files exist.
+2: run BibTeX or biber whenever it appears necessary to update the bbl
+files, without testing for the existence of the bib files.
 .TP
 .B $cleanup_includes_cusdep_generated [0]
 If nonzero, specifies that cleanup also deletes files that are
@@ -1149,7 +1161,8 @@ function, e.g.,
 The program called to locate a source file when the name alone is not
 sufficient.  Most filenames used by \fIlatexmk\fR have sufficient path
 information to be found directly.  But sometimes, notably 
-when .bib files are found from the log file of a bibtex run, the name of
+when .bib files are found from the log file of a bibtex or biber run,
+the name of 
 the file, but not its path is known.  The program specified by
 $kpsewhich is used to find it.  
 
@@ -1755,7 +1768,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 collins at node phys.psu.edu).
-(Version 4.21).
+(Version 4.22b).
 
 Released version can be obtained from CTAN:
 <http://www.tug.org/tex-archive/support/latexmk/>, and from the
diff --git a/Master/texmf/doc/man/man1/latexmk.man1.pdf b/Master/texmf/doc/man/man1/latexmk.man1.pdf
index fd4d993bfd0..40af01556d7 100644
--- a/Master/texmf/doc/man/man1/latexmk.man1.pdf
+++ b/Master/texmf/doc/man/man1/latexmk.man1.pdf