summaryrefslogtreecommitdiff
path: root/Master/texmf
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-01-11 23:19:49 +0000
committerKarl Berry <karl@freefriends.org>2011-01-11 23:19:49 +0000
commit021501855e5e14602a36bc34498435dbcea267df (patch)
tree9f7b2feba1a9c1cfe0862ab78fb7a27056f00d36 /Master/texmf
parent7bd702012caa7bf7f4c360eacb814e65773e38e0 (diff)
latexmk 4.22b (11jan11)
git-svn-id: svn://tug.org/texlive/trunk@21032 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf')
-rw-r--r--Master/texmf/doc/man/man1/latexmk.165
-rw-r--r--Master/texmf/doc/man/man1/latexmk.man1.pdfbin92907 -> 94058 bytes
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
Binary files differ