summaryrefslogtreecommitdiff
path: root/Master/texmf/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-09-10 23:08:24 +0000
committerKarl Berry <karl@freefriends.org>2010-09-10 23:08:24 +0000
commit0c0cbb6bdf8cafc26e784fc01c5554c79b92af50 (patch)
tree54ead87e617c1d82544e08186279a9c347519dd8 /Master/texmf/doc
parenta9664d38e2e1340141169de2acde8ff31735aaef (diff)
latexmk 4.18 (28jul10)
git-svn-id: svn://tug.org/texlive/trunk@19650 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc')
-rw-r--r--Master/texmf/doc/man/man1/latexmk.137
-rw-r--r--Master/texmf/doc/man/man1/latexmk.man1.pdfbin90633 -> 91067 bytes
2 files changed, 24 insertions, 13 deletions
diff --git a/Master/texmf/doc/man/man1/latexmk.1 b/Master/texmf/doc/man/man1/latexmk.1
index 9a1205a08ee..21bbc3766b7 100644
--- a/Master/texmf/doc/man/man1/latexmk.1
+++ b/Master/texmf/doc/man/man1/latexmk.1
@@ -1,4 +1,4 @@
-.TH LATEXMK 1L "18 May 2010" ""
+.TH LATEXMK 1L "27 July 2010" ""
.SH NAME
latexmk \- generate LaTeX document
.SH SYNOPSIS
@@ -228,7 +228,7 @@ Example usage: To use dviselect to select only the even pages of the dvi file:
.TP
.B -diagnostics
Print detailed diagnostics during a run. This may help for debugging
-problems or to understand \fI.latexmk\fR's behavior in difficult
+problems or to understand \fIlatexmk\fR's behavior in difficult
situations.
.TP
.B -dvi
@@ -431,7 +431,11 @@ option.
The preview-continuous option \fB-pvc\fR can only work with one file.
So in this case you will normally only specify one filename on
the command line. It is also incompatible with the
-\fB-p\fR and \fB-pv\fR options, so it turns these options off
+\fB-p\fR and \fB-pv\fR options, so it turns these options off.
+
+The \fB-pvc\fR option also turns off force mode (\fB-f\fR), as is
+normally best for continuous preview mode. If you really want force
+mode, use the options in the order \fB-pvc -f\fR.
With a good previewer the display will be automatically updated.
(Under \fIsome but not all\fR versions of UNIX/Linux "gv -watch" does
@@ -730,14 +734,21 @@ how I've handled the problem.
\fBCommand names containing spaces\fR: Under MS-Windows it is common
that the name of a command includes spaces, since software is often
-installed in a subdirectory of "C:\Program Files". Such command names
+installed in a subdirectory of "C:\\Program Files". Such command names
should be enclosed in double quotes, as in
.PP
$lpr_pdf = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p %S';
.PP
+(Note about the above example: Forward slashes are equivalent to
+backslashes in filenames under MS-Windows, provided that the filename
+is inside double quotes. It is easier to use forward slashes in
+examples like the one above, since then one does not have to worry
+about the rules for dealing with forward slashes in strings in the
+Perl language.)
+
\fBUsing MS-Windows file associations\fR: A useful trick under modern
-versions of MS-Windows (e.g., WinXP) is to use just the command
-'start' by itself:
+versions of MS-Windows (e.g., WinXP) is to use just the
+command 'start' by itself:
.PP
$dvi_previewer = 'start %S';
.PP
@@ -1122,13 +1133,13 @@ but also specify options to the program. E.g.,
This variable specifies the extensions tried by latexmk when it finds
that a LaTeX run resulted in an error that a file has not been found,
and the file is given without an extension. This typically happens when
-LaTeX commands of the form \input{file} or \includegraphics{figure},
+LaTeX commands of the form \\input{file} or \\includegraphics{figure},
when the relevant source file does not exist.
In this situation, latexmk searches for custom dependencies to make
the missing file(s), but restricts it to the extensions specified by
-the variable %latex_input_extensions. The default extensions are
-'tex' and 'eps'.
+the variable %latex_input_extensions. The default extensions
+are 'tex' and 'eps'.
(For Perl experts: %latex_input_extensions is a hash whose keys are
the extensions. The values are irrelevant.) Two subroutines are
@@ -1235,13 +1246,13 @@ of a dvi file.
This variable specifies the extensions tried by latexmk when it finds
that a pdfLaTeX run resulted in an error that a file has not been found,
and the file is given without an extension. This typically happens when
-LaTeX commands of the form \input{file} or \includegraphics{figure},
+LaTeX commands of the form \\input{file} or \\includegraphics{figure},
when the relevant source file does not exist.
In this situation, latexmk searches for custom dependencies to make
the missing file(s), but restricts it to the extensions specified by
-the variable %pdflatex_input_extensions. The default extensions are
-'tex', 'pdf', 'jpg, and 'png'.
+the variable %pdflatex_input_extensions. The default extensions
+are 'tex', 'pdf', 'jpg, and 'png'.
(For Perl experts: %pdflatex_input_extensions is a hash whose keys are
the extensions. The values are irrelevant.) Two subroutines are
@@ -1704,7 +1715,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.16a).
+(Version 4.17).
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 aabdd5954d1..9faf5bbb9d4 100644
--- a/Master/texmf/doc/man/man1/latexmk.man1.pdf
+++ b/Master/texmf/doc/man/man1/latexmk.man1.pdf
Binary files differ