- New version 4.01.
This commit is contained in:
parent
b022cd1d73
commit
2bad9e6dae
@ -1 +1 @@
|
||||
latexmk-400e.zip
|
||||
latexmk-401.zip
|
||||
|
@ -1,10 +1,10 @@
|
||||
diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
--- latexmk-4.00e.ORIG/latexmk.1 2008-03-12 09:34:24.000000000 -0600
|
||||
+++ latexmk-4.00e/latexmk.1 2008-09-24 10:05:29.000000000 -0600
|
||||
diff -dur latexmk-4.01.ORIG/latexmk.1 latexmk-4.01/latexmk.1
|
||||
--- latexmk-4.01.ORIG/latexmk.1 2008-09-28 14:14:18.000000000 -0600
|
||||
+++ latexmk-4.01/latexmk.1 2008-10-13 12:17:22.000000000 -0600
|
||||
@@ -1,9 +1,9 @@
|
||||
-.TH LATEXMK 1L "12 March 2008" ""
|
||||
-.TH LATEXMK 1L "28 September 2008" ""
|
||||
-.SH NAME
|
||||
+.TH "LATEXMK" "1L" "12 March 2008" "" ""
|
||||
+.TH "LATEXMK" "1L" "28 September 2008" "" ""
|
||||
+.SH "NAME"
|
||||
latexmk \- generate LaTeX document
|
||||
-.SH SYNOPSIS
|
||||
@ -15,18 +15,23 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
.I Latexmk
|
||||
completely automates the process of compiling a LaTeX document.
|
||||
Essentially, it is like a specialized relative of the general
|
||||
@@ -15,8 +15,8 @@
|
||||
document. It can also be set to run continuously with a suitable
|
||||
previewer; in that case the LaTeX program, etc, are rerun whenever one
|
||||
of the source files is modified, and the previewer updates the
|
||||
-on-screen view of the compiled document.
|
||||
@@ -13,12 +13,12 @@
|
||||
source file for a document, and it issues the appropriate sequence of
|
||||
commands to generate a .dvi, .ps, .pdf and/or hardcopy version of the
|
||||
document.
|
||||
-.PP
|
||||
+on\-screen view of the compiled document.
|
||||
+.PP
|
||||
\fILatexmk\fR can also be set to run continuously with a suitable
|
||||
previewer. In that case the LaTeX program, etc, are rerun whenever
|
||||
one of the source files is modified, and the previewer automatically
|
||||
-updates the on-screen view of the compiled document.
|
||||
-.PP
|
||||
+updates the on\-screen view of the compiled document.
|
||||
+.PP
|
||||
\fILatexmk\fR determines which are the source files by examining the
|
||||
log file. When \fIlatexmk\fR is run, it examines properties of the
|
||||
source files, and if any have been changed since the last document
|
||||
@@ -30,14 +30,14 @@
|
||||
@@ -32,14 +32,14 @@
|
||||
For example, from an updated figure file it can automatically generate
|
||||
a file in encapsulated postscript or another suitable format for
|
||||
reading by LaTeX.
|
||||
@ -45,7 +50,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
(mnemonic: "preview continuously"). In this case, \fIlatexmk\fR runs
|
||||
continuously, regularly monitoring all the source files to see if any
|
||||
have changed. Every time a change is detected, \fIlatexmk\fR runs all
|
||||
@@ -47,31 +47,31 @@
|
||||
@@ -49,31 +49,31 @@
|
||||
are written to disk, \fIlatexmk\fR completely automates the cycle of
|
||||
updating the .dvi (and possibly the .ps and .pdf) file, and refreshing
|
||||
the previewer's display. It's not quite WYSIWYG, but usefully close.
|
||||
@ -84,7 +89,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
of which programs. In its new version, \fIlatexmk\fR has a highly
|
||||
general and efficient solution to these issues. The solution involves
|
||||
retaining between runs information on the source files, and a symptom
|
||||
@@ -79,10 +79,10 @@
|
||||
@@ -81,10 +81,10 @@
|
||||
\fR.fdb_latexmk\fR, by default) that contains the source file
|
||||
information.
|
||||
|
||||
@ -99,7 +104,15 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
.B file
|
||||
One or more files can be specified. If no files are specified,
|
||||
\fIlatexmk\fR will, by default, run on all files in the current working directory
|
||||
@@ -97,32 +97,32 @@
|
||||
@@ -92,39 +92,39 @@
|
||||
description concerning the \fI@default_files\fR variable in the
|
||||
section "List of configuration variables usable in initialization
|
||||
files".
|
||||
-.PP
|
||||
+.PP
|
||||
If a file is specified without an extension, then the ".tex" extension
|
||||
is automatically added, just as LaTeX does. Thus, if you specify:
|
||||
|
||||
latexmk foo
|
||||
|
||||
then \fIlatexmk\fR will operate on the file "foo.tex".
|
||||
@ -141,7 +154,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
Clean up (remove) all regeneratable files generated by \fIlatex\fR and
|
||||
\fIbibtex\fR except dvi, postscript and pdf. These files are a
|
||||
combination of log files, aux files, and those with extensions
|
||||
@@ -131,44 +131,44 @@
|
||||
@@ -133,44 +133,44 @@
|
||||
removed. But the file containing a database of source file
|
||||
information is not removed.
|
||||
|
||||
@ -176,7 +189,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
.TP
|
||||
-.B -CF
|
||||
+.B \-CF
|
||||
Remove the file containing a database of source file information,
|
||||
Remove the file containing the database of source file information,
|
||||
before doing the other actions requested.
|
||||
.TP
|
||||
-.B -d
|
||||
@ -201,7 +214,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
Dvi file filtering. The argument to this option is a filter which will
|
||||
generate a filtered dvi file with the extension ".dviF". All extra
|
||||
processing (e.g. conversion to postscript, preview, printing) will then
|
||||
@@ -176,145 +176,145 @@
|
||||
@@ -178,150 +178,150 @@
|
||||
|
||||
Example usage: To use dviselect to select only the even pages of the dvi file:
|
||||
|
||||
@ -336,7 +349,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
-test sometimes fails (notably if there is an already-running previewer
|
||||
+test sometimes fails (notably if there is an already\-running previewer
|
||||
that is viewing a file of the same name as the current file, but in a
|
||||
different directory). This option turns off this default behavior.
|
||||
different directory). This option turns off the default behavior.
|
||||
-.TP
|
||||
-.B -new-viewer-
|
||||
-The inverse of the \fB-new-viewer\fR option. It puts \fIlatexmk\fR
|
||||
@ -351,19 +364,23 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
+an already\-running previewer.
|
||||
+.TP
|
||||
+.B \-p
|
||||
Print out the document. By default on a UNIX or Linux system, this is
|
||||
done using lpr after generating the postscript file. But you can use
|
||||
-the \fB-print=...\fR option to print the dvi or pdf files instead, and
|
||||
+the \fB\-print=...\fR option to print the dvi or pdf files instead, and
|
||||
you can configure this in a start up file (by setting the
|
||||
Print out the document. By default it is
|
||||
the generated postscript file that is printed. But you can use the
|
||||
-\fB-print=...\fR option to print the dvi or pdf files instead, and you
|
||||
+\fB\-print=...\fR option to print the dvi or pdf files instead, and you
|
||||
can configure this in a start up file (by setting the
|
||||
\fI$print_type\fR variable).
|
||||
|
||||
However, the correct behavior for printing very much depends on your
|
||||
-system's software. In particular, under MS-Windows you must have
|
||||
+system's software. In particular, under MS\-Windows you must have
|
||||
suitable program(s) available, and you must have configured the print
|
||||
-commands used by \fIlatexmk\fR. This can be non-trivial.
|
||||
+commands used by \fIlatexmk\fR. This can be non\-trivial.
|
||||
However, printing is enabled by default only under UNIX/LINUX systems,
|
||||
where the default is to use the lpr command. In general, the correct
|
||||
behavior for printing very much depends on your system's software. In
|
||||
-particular, under MS-Windows you must have suitable program(s)
|
||||
+particular, under MS\-Windows you must have suitable program(s)
|
||||
available, and you must have configured the print commands used by
|
||||
-\fIlatexmk\fR. This can be non-trivial. See the documentation on the
|
||||
+\fIlatexmk\fR. This can be non\-trivial. See the documentation on the
|
||||
\fI$lpr\fR, \fI$lpr_dvi\fR, and \fI$lpr_pdf\fR configuration variables
|
||||
to see how to set the commands for printing.
|
||||
|
||||
-This option is incompatible with the \fB-pv\fR and \fB-pvc\fR options,
|
||||
+This option is incompatible with the \fB\-pv\fR and \fB\-pvc\fR options,
|
||||
@ -397,7 +414,8 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
+.TP
|
||||
+.B \-print=dvi, \-print=ps, \-print=pdf
|
||||
Define which kind of file is printed. This option also ensures that
|
||||
the requisite file is made, and turns on printing.
|
||||
the requisite file is made, and turns on printing. The default is to
|
||||
print a postscript file.
|
||||
-.TP
|
||||
-.B -ps
|
||||
+.TP
|
||||
@ -418,7 +436,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
Postscript file filtering. The argument to this option is a filter
|
||||
which will generate a filtered postscript file with the extension
|
||||
".psF". All extra processing (e.g. preview, printing) will then be
|
||||
@@ -322,51 +322,51 @@
|
||||
@@ -329,52 +329,52 @@
|
||||
|
||||
Example of usage: Use psnup to print two pages on the one page:
|
||||
|
||||
@ -430,9 +448,10 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
- latexmk -ps -pF "psnup -2" foo.tex
|
||||
+ latexmk \-ps \-pF "psnup \-2" foo.tex
|
||||
|
||||
-Whether to use single or double quotes round the "psnup -2" will depend on
|
||||
+Whether to use single or double quotes round the "psnup \-2" will depend on
|
||||
your command interpreter, in particular on the operating system.
|
||||
-Whether to use single or double quotes round the "psnup -2" will
|
||||
+Whether to use single or double quotes round the "psnup \-2" will
|
||||
depend on your command interpreter, as used by the particular version
|
||||
of perl and the operating system on your computer.
|
||||
-.TP
|
||||
-.B -pv
|
||||
-Run file previewer. If the \fB-view\fR option is used, this will select
|
||||
@ -491,7 +510,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
|
||||
There are some other methods for arranging an update, notably useful
|
||||
for many versions of xdvi and xpdf. These are best set in
|
||||
@@ -374,26 +374,26 @@
|
||||
@@ -382,26 +382,26 @@
|
||||
|
||||
Note that if \fIlatexmk\fR dies or is stopped by the user, the
|
||||
"forked" previewer will continue to run. Successive invocations with
|
||||
@ -531,7 +550,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
override both the standard initialization files and \fIpreviously\fR
|
||||
specified options. But all of these can be overridden by \fIlater\fR
|
||||
options.
|
||||
@@ -401,48 +401,48 @@
|
||||
@@ -409,48 +409,48 @@
|
||||
The contents of the RC file just comprise a piece of code in the
|
||||
\fIPerl\fR programming language
|
||||
(typically a sequence of assignment statements); they are executed
|
||||
@ -603,9 +622,9 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
file, start a previewer. Then
|
||||
watch for changes in the source
|
||||
file thesis.tex and any files it
|
||||
@@ -452,37 +452,38 @@
|
||||
encounters an error, latexmk will
|
||||
keep running.
|
||||
@@ -461,37 +461,38 @@
|
||||
keep running, watching for
|
||||
source file changes.
|
||||
|
||||
-% \fBlatexmk -c\fR \fI# remove .aux, .log, .bbl, .blg, .dvi,
|
||||
+% \fBlatexmk \-c\fR \fI# remove .aux, .log, .bbl, .blg, .dvi,
|
||||
@ -628,7 +647,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
"/usr/local/lib/latexmk/LatexMk".
|
||||
- On a MS-WINDOWS system it looks for "C:\\latexmk\\LatexMk".
|
||||
-.PP
|
||||
+ On Fedora systems, it only looks for "/etc/latexmk.conf".
|
||||
+ On a Fedora system, it only looks for "/etc/latexmk.conf".
|
||||
+ On a MS\-WINDOWS system it looks for "C:\\latexmk\\LatexMk".
|
||||
+.PP
|
||||
2) The user's RC file, "$HOME/.latexmkrc", if it exists. Here $HOME
|
||||
@ -647,14 +666,14 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
+.PP
|
||||
+4) Any RC file(s) specified on the command line with the \fB\-r\fR option.
|
||||
+.PP
|
||||
Each RC file is a sequence of \fIPerl\fR commands. Naturally a user can use
|
||||
Each RC file is a sequence of \fIPerl\fR commands. Naturally, a user can use
|
||||
this in creative ways. But for most purposes, one simply uses a
|
||||
-sequence of assignment statements that override some of the built-in
|
||||
+sequence of assignment statements that override some of the built\-in
|
||||
settings of \fILatexmk\fR. Straightforward cases can be handled
|
||||
without knowledge of the \fIPerl\fR language by using the examples in this
|
||||
document as templates. Comment lines are introduced by the "#"
|
||||
@@ -490,27 +491,27 @@
|
||||
@@ -499,27 +500,27 @@
|
||||
|
||||
Note that command line options are obeyed in the order in which
|
||||
they are written; thus any RC file specified on the command line with
|
||||
@ -663,7 +682,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
overridden by later options on the command line. There is also the
|
||||
-\fB-e\fR option, which allows initialization code to be specified in
|
||||
+\fB\-e\fR option, which allows initialization code to be specified in
|
||||
\fIlatexm\fR's command line.
|
||||
\fIlatexmk\fR's command line.
|
||||
|
||||
-.SH HOW TO SET VARIABLES IN INITIALIZATION FILES
|
||||
-.PP
|
||||
@ -692,7 +711,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
for the setting of an array of strings. It is possible to append an
|
||||
item to an array variable as follows:
|
||||
|
||||
@@ -525,8 +526,7 @@
|
||||
@@ -534,8 +535,7 @@
|
||||
|
||||
|
||||
|
||||
@ -702,17 +721,19 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
Some of the variables set the commands that \fIlatexmk\fR uses for
|
||||
carrying out its work, for example to generate a dvi file from a tex
|
||||
file or to view a postscript file. This section describes some
|
||||
@@ -534,42 +534,42 @@
|
||||
@@ -543,42 +543,42 @@
|
||||
|
||||
\fBPlaceholders\fR: Supposed you wanted \fIlatexmk\fR to use the
|
||||
command elatex in place of the regular latex command, and suppose
|
||||
-moreover that you wanted to give it the option "--shell-escape". You
|
||||
+moreover that you wanted to give it the option "\-\-shell\-escape". You
|
||||
could do this by the following setting:
|
||||
|
||||
-.PP
|
||||
- $latex = 'elatex --shell-escape %O %S';
|
||||
-.PP
|
||||
+.PP
|
||||
+ $latex = 'elatex \-\-shell\-escape %O %S';
|
||||
|
||||
+.PP
|
||||
The two items starting with the % character are placeholders. These
|
||||
are substituted by appropriate values before the command is run. Thus
|
||||
%S will be replaced by the source file that elatex will be applied to,
|
||||
@ -756,7 +777,19 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
The distinction between %B and %R needs a bit of care, since they are
|
||||
often the same, but not always. For example on a simple document, the
|
||||
basename of a bibtex run is the same as for the texfile. But in a
|
||||
@@ -601,9 +601,9 @@
|
||||
@@ -586,9 +586,9 @@
|
||||
a variety of names. Since bibtex is invoked with the basename of the
|
||||
bibliography file, the setting for the bibtex command should therefore
|
||||
be
|
||||
-.PP
|
||||
+.PP
|
||||
$bibtex = 'bibtex %O %B';
|
||||
-.PP
|
||||
+.PP
|
||||
Generally, you should use %B rather than %R. Similarly for most
|
||||
purposes, the name %T of the primary texfile is not a useful
|
||||
placeholder.
|
||||
@@ -610,9 +610,9 @@
|
||||
the previewer running and then returns to its next task (or exits if
|
||||
there is nothing else to do). To achieve this effect of detaching a
|
||||
command, you need to precede the command name with "start ", as in
|
||||
@ -768,20 +801,26 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
This will be translated to whatever is appropriate for your operating
|
||||
system.
|
||||
|
||||
@@ -615,28 +615,28 @@
|
||||
of the command string, that is equivalent to having just one.
|
||||
|
||||
@@ -623,31 +623,31 @@
|
||||
start. (3) If the word start occurs more than once at the beginning
|
||||
of the command string, that is equivalent to having just one. (4)
|
||||
Under cygwin, some complications happen, since cygwin amounts to a
|
||||
-complicated merging of UNIX and MS-Windows. See the source code for
|
||||
+complicated merging of UNIX and MS\-Windows. See the source code for
|
||||
how I've handled the problem.
|
||||
|
||||
-\fBCommand names containing spaces\fR: Under MS-Windows it is common
|
||||
+\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
|
||||
should be enclosed in double quotes, as in
|
||||
|
||||
-.PP
|
||||
+.PP
|
||||
$lpr_pdf = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p %S';
|
||||
|
||||
-.PP
|
||||
-\fBUsing MS-Windows file associations\fR: A useful trick under modern
|
||||
-versions of MS-Windows (e.g., WinXP) is to use just the command
|
||||
+.PP
|
||||
+\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:
|
||||
@ -805,7 +844,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
This typically is used when an appropriate command does not exist on
|
||||
your system. The string after the "NONE" is effectively a comment.
|
||||
|
||||
@@ -646,9 +646,9 @@
|
||||
@@ -657,9 +657,9 @@
|
||||
Suppose you want \fIlatexmk\fR to use latex with source specials
|
||||
enabled. Then you might use the following line in an initialization
|
||||
file:
|
||||
@ -818,7 +857,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
|
||||
\fBAdvanced tricks\fR: Normally one specifies a single command for the
|
||||
commands invoked by \fIlatexmk\fR. Naturally, if there is some
|
||||
@@ -662,45 +662,45 @@
|
||||
@@ -673,45 +673,45 @@
|
||||
file from a tex file you need to run another program after pdflatex to
|
||||
perform some extra processing, you could do something like:
|
||||
|
||||
@ -877,7 +916,14 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
.B @BIBINPUTS
|
||||
This is an array variable, now mostly obsolete, that specifies
|
||||
directories where
|
||||
@@ -728,13 +728,13 @@
|
||||
@@ -733,44 +733,44 @@
|
||||
two and the second two examples are equivalent. Each backward slash
|
||||
should be doubled to avoid running afoul of \fIPerl\fR's rules for writing
|
||||
strings.
|
||||
-.PP
|
||||
+.PP
|
||||
\fIImportant note:\fR This variable is now mostly obsolete in the
|
||||
current version of \fIlatexmk\fR,
|
||||
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.
|
||||
@ -895,9 +941,11 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
.B $cleanup_mode [0]
|
||||
If nonzero, specifies cleanup mode: 1 for full cleanup, 2 for cleanup
|
||||
except for dvi, ps and pdf files, 3 for cleanup except for dep and aux
|
||||
@@ -743,21 +743,21 @@
|
||||
files. (There is also extra cleaning as specified by the
|
||||
\fI$clean_ext\fR, \fI$clean_full_ext\fR and \fI@generated_exts\fR
|
||||
variables.)
|
||||
|
||||
-.PP
|
||||
+.PP
|
||||
This variable is equivalent to specifying one of
|
||||
-the \fB-c\fR, \fB-c1\fR, or \fB-C\fR options. But there should be no need
|
||||
+the \fB\-c\fR, \fB\-c1\fR, or \fB\-C\fR options. But there should be no need
|
||||
@ -907,8 +955,10 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
.B $clean_ext [""]
|
||||
Extra extensions of files for \fIlatexmk\fR to remove when any of the
|
||||
-clean-up options (\fB-c\fR, \fB-c1\fR, or \fB-C\fR) is selected.
|
||||
-.TP
|
||||
+clean\-up options (\fB\-c\fR, \fB\-c1\fR, or \fB\-C\fR) is selected.
|
||||
The value of this variable is a string containing the extensions
|
||||
separated by spaces.
|
||||
-.TP
|
||||
+.TP
|
||||
.B $clean_full_ext [""]
|
||||
-Extra extensions of files for \fIlatexmk\fR to remove when the \fB-C\fR
|
||||
@ -923,11 +973,11 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
-.TP
|
||||
+Custom dependency list \-\- see section on "Custom Dependencies".
|
||||
+.TP
|
||||
.B @default_files [('*.tex')]
|
||||
.B @default_files [("*.tex")]
|
||||
Default list of files to be processed.
|
||||
|
||||
@@ -784,56 +784,56 @@
|
||||
is '.tex'. Wild cards are allowed. The parentheses are because
|
||||
@@ -797,63 +797,63 @@
|
||||
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.
|
||||
-.TP
|
||||
@ -966,15 +1016,14 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
Command to convert dvi to pdf file. A common reconfiguration is to
|
||||
use the dvipdfm command, which needs its arguments in a different order:
|
||||
|
||||
- $dvipdf = 'dvipdfm %O -o %D %S';
|
||||
+ $dvipdf = 'dvipdfm %O \-o %D %S';
|
||||
- $dvipdf = "dvipdfm %O -o %D %S";
|
||||
+ $dvipdf = "dvipdfm %O \-o %D %S";
|
||||
|
||||
WARNING: The default dvipdf script generates pdf files with bitmapped
|
||||
fonts, which do not look good when viewed by acroread. That script
|
||||
-should be modified to give dvips the options "-P pdf" to ensure that
|
||||
+should be modified to give dvips the options "\-P pdf" to ensure that
|
||||
type 1 fonts are used in the pdf file.
|
||||
|
||||
-.TP
|
||||
-.B $dvips ["dvips %O -o %D %S"]
|
||||
+.TP
|
||||
@ -983,7 +1032,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
If pdf is going to be generated from pdf, then the value of the
|
||||
-$dvips_pdf_switch -- see below -- will be included in the options
|
||||
+$dvips_pdf_switch \-\- see below \-\- will be included in the options
|
||||
substituted for '%O'.
|
||||
substituted for "%O".
|
||||
-.TP
|
||||
-.B $dvips_landscape ["dvips -tlandscape %O -o %D %S"]
|
||||
+.TP
|
||||
@ -1006,10 +1055,9 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
.B $dvi_update_command [""]
|
||||
When the dvi previewer is set to be updated by running a command, this
|
||||
is the command that is run. See the information for the variable
|
||||
@@ -841,8 +841,8 @@
|
||||
\fI$dvi_update_method\fR for further information, and see information
|
||||
on the variable \fI$pdf_update_method\fR for an example for the
|
||||
analogous case of a pdf previewer.
|
||||
|
||||
-.TP
|
||||
-.B $dvi_update_method [2 under UNIX, 1 under MS-Windows]
|
||||
+.TP
|
||||
@ -1017,9 +1065,9 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
How the dvi viewer updates its display when the dvi file has changed.
|
||||
The values here apply equally to the \fI$pdf_update_method\fR and to
|
||||
the \fI$ps_update_method\fR variables.
|
||||
@@ -852,38 +852,38 @@
|
||||
2 => Send the signal, whose number is in the variable
|
||||
\fI$dvi_update_signal\fR. The default value under UNIX is suitable for xdvi.
|
||||
@@ -864,37 +864,37 @@
|
||||
\fI$dvi_update_signal\fR. The default value under UNIX is
|
||||
suitable for xdvi.
|
||||
3 => Viewer cannot do an update, because it locks the file. (As with
|
||||
-acroread under MS-Windows.)
|
||||
+acroread under MS\-Windows.)
|
||||
@ -1028,7 +1076,6 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
|
||||
See information on the variable \fI$pdf_update_method\fR for an
|
||||
example of updating by command.
|
||||
|
||||
-.TP
|
||||
-.B $dvi_update_signal [Under UNIX: SIGUSR1, which is a system-dependent value]
|
||||
+.TP
|
||||
@ -1053,7 +1100,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
-.TP
|
||||
+\fB\-f\fR option.
|
||||
+.TP
|
||||
.B @generated_exts [( 'aux', 'bbl', 'idx', 'ind', 'lof', 'lot', 'out', 'toc', $fdb_ext )]
|
||||
.B @generated_exts [( "aux", "bbl", "idx", "ind", "lof", "lot", "out", "toc", $fdb_ext )]
|
||||
This contains a list of extensions for files that are generated during
|
||||
a LaTeX run and that are read in by LaTeX in later runs, either
|
||||
directly or indirectly.
|
||||
@ -1066,7 +1113,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
rerun of (pdf)LaTeX is needed after a run that gives an error.
|
||||
|
||||
(Normally, a change of a source file during a run should provoke a
|
||||
@@ -892,7 +892,7 @@
|
||||
@@ -903,7 +903,7 @@
|
||||
an error, a new run should occur until the user has made a change in
|
||||
the files. But the user may have corrected an error in a source .tex
|
||||
file during the run. So \fIlatexmk\fR needs to distinguish
|
||||
@ -1075,8 +1122,8 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
automatically generated files as those with extensions in the list in
|
||||
@generated_exts.)
|
||||
|
||||
@@ -905,11 +905,11 @@
|
||||
adds the extension 'end' to the list of predefined generated
|
||||
@@ -916,11 +916,11 @@
|
||||
adds the extension "end" to the list of predefined generated
|
||||
extensions. (This extension is used by the RevTeX package, for
|
||||
example.)
|
||||
-.TP
|
||||
@ -1086,11 +1133,30 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
-equivalent to the \fB-g\fR option.
|
||||
-.TP
|
||||
+equivalent to the \fB\-g\fR option.
|
||||
+.TP
|
||||
.B %hash_calc_ignore_pattern
|
||||
\fB!!!This variable is for experts only!!!\fR
|
||||
|
||||
@@ -940,15 +940,15 @@
|
||||
$hash_calc_ignore_pattern{'eps'} = '^%%CreationDate: ';
|
||||
|
||||
This creates a rule for files with extension \fI.eps\fR about lines to
|
||||
-ignore. The left-hand side is a \fIPerl\fR idiom for setting an item
|
||||
+ignore. The left\-hand side is a \fIPerl\fR idiom for setting an item
|
||||
in a hash. Note that the file extension is specified without a
|
||||
-period. The value, on the right-hand side, is a string containing a
|
||||
+period. The value, on the right\-hand side, is a string containing a
|
||||
regular expresssion. (See documentation on \fIPerl\fR for how they
|
||||
are to be specified in general.) This particular regular expression
|
||||
specifies that lines beginning with "%%CreationDate: " are to be
|
||||
ignored in deciding whether a file of the given extension \fI.eps\fR
|
||||
has changed.
|
||||
-.TP
|
||||
+.TP
|
||||
.B $kpsewhich ["kpsewhich %S"]
|
||||
The program called to locate a source file when the name alone is not
|
||||
sufficient. Most filenames used by \fIlatexmk\fR have sufficient path
|
||||
@@ -921,28 +921,28 @@
|
||||
@@ -960,28 +960,28 @@
|
||||
See also the \fI@BIBINPUTS\fR variable for another way that \fIlatexmk\fR
|
||||
also uses to try to locate files; it applies only in the case of .bib
|
||||
files.
|
||||
@ -1108,31 +1174,31 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
can use this variable not just to change the name of the program used,
|
||||
but also specify options to the program. E.g.,
|
||||
|
||||
- $latex = 'latex --src-specials';
|
||||
- $latex = "latex --src-specials";
|
||||
-.TP
|
||||
-.B $latex_silent_switch ["-interaction=batchmode"]
|
||||
+ $latex = 'latex \-\-src\-specials';
|
||||
+ $latex = "latex \-\-src\-specials";
|
||||
+.TP
|
||||
+.B $latex_silent_switch ["\-interaction=batchmode"]
|
||||
Switch(es) for the LaTeX processing program when silent mode is on.
|
||||
-Under MS-Windows, the default value is changed to
|
||||
-"-interaction=batchmode -c-style-errors", as used by MikTeX and fpTeX.
|
||||
-.TP
|
||||
-.B $lpr ["lpr %O %S", or "NONE lpr" under MS-WINDOWS]
|
||||
-.B $lpr ["lpr %O %S" under UNIX/LINUX, \(dqNONE lpr\(dq under MS-WINDOWS]
|
||||
+Under MS\-Windows, the default value is changed to
|
||||
+"\-interaction=batchmode \-c\-style\-errors", as used by MikTeX and fpTeX.
|
||||
+.TP
|
||||
+.B $lpr ["lpr %O %S", or "NONE lpr" under MS\-WINDOWS]
|
||||
+.B $lpr ["lpr %O %S" under UNIX/LINUX, \(dqNONE lpr\(dq under MS\-WINDOWS]
|
||||
The command to print postscript files.
|
||||
|
||||
-Under MS-Windows (unlike UNIX/LINUX), there is no standard program for
|
||||
+Under MS\-Windows (unlike UNIX/LINUX), there is no standard program for
|
||||
printing files. But there are ways you can do it. For example, if
|
||||
you have gsview installed, you could use it with the option '/p':
|
||||
you have gsview installed, you could use it with the option "/p":
|
||||
|
||||
@@ -956,14 +956,14 @@
|
||||
@@ -995,14 +995,14 @@
|
||||
the command obeyed; this is necessary because one part of the command
|
||||
name ('Program Files') contains a space which would otherwise be
|
||||
name ("Program Files") contains a space which would otherwise be
|
||||
misinterpreted.
|
||||
-.TP
|
||||
+.TP
|
||||
@ -1148,8 +1214,8 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
e.g.,
|
||||
|
||||
$lpr = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p';
|
||||
@@ -973,18 +973,18 @@
|
||||
is necessary because one part of the command name ('Program Files')
|
||||
@@ -1012,27 +1012,27 @@
|
||||
is necessary because one part of the command name ("Program Files")
|
||||
contains a space which would otherwise be misinterpreted.
|
||||
|
||||
-.TP
|
||||
@ -1158,6 +1224,17 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
+.B $makeindex ["makeindex %O \-o %D %S"]
|
||||
The index processing program.
|
||||
-.TP
|
||||
+.TP
|
||||
.B $max_repeat [5]
|
||||
The maximum number of times \fIlatexmk\fR will run latex/pdflatex
|
||||
before deciding that there may be an infinite loop and that it needs
|
||||
to bail out, rather than rerunning latex/pdflatex again to resolve
|
||||
-cross-references, etc. The default value covers all normal cases.
|
||||
+cross\-references, etc. The default value covers all normal cases.
|
||||
|
||||
(Note that the "etc" covers a lot of cases where one run of
|
||||
latex/pdflatex generates files to be read in on a later run.)
|
||||
-.TP
|
||||
+.TP
|
||||
.B $new_viewer_always [0]
|
||||
This variable applies to \fIlatexmk\fR \fBonly\fR in
|
||||
@ -1173,7 +1250,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
.B $pdf_mode [0]
|
||||
If zero, do NOT generate a pdf version of the document.
|
||||
If equal to 1, generate a pdf version of the document using pdflatex.
|
||||
@@ -993,39 +993,39 @@
|
||||
@@ -1041,39 +1041,39 @@
|
||||
If equal to 3, generate a pdf version of the document from the dvi
|
||||
file, by using the command specified by the \fI$dvipdf\fR variable.
|
||||
|
||||
@ -1228,7 +1305,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
How the pdf viewer updates its display when the pdf file has
|
||||
changed. See the information on the variable \fI$dvi_update_method\fR
|
||||
for the codes. (Note that information needs be changed slightly so
|
||||
@@ -1034,95 +1034,95 @@
|
||||
@@ -1082,64 +1082,64 @@
|
||||
value 2, to specify update by signal, the signal is specified by
|
||||
\fI$pdf_update_signal\fR.)
|
||||
|
||||
@ -1239,14 +1316,14 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
Arranging to use a command to get a previewer explicitly updated
|
||||
requires three variables to be set. For example:
|
||||
|
||||
- $pdf_previewer = 'start xpdf -remote %R %O %S';
|
||||
+ $pdf_previewer = 'start xpdf \-remote %R %O %S';
|
||||
- $pdf_previewer = "start xpdf -remote %R %O %S";
|
||||
+ $pdf_previewer = "start xpdf \-remote %R %O %S";
|
||||
$pdf_update_method = 4;
|
||||
- $pdf_update_command = 'xpdf -remote %R -reload';
|
||||
+ $pdf_update_command = 'xpdf \-remote %R \-reload';
|
||||
- $pdf_update_command = "xpdf -remote %R -reload";
|
||||
+ $pdf_update_command = "xpdf \-remote %R \-reload";
|
||||
|
||||
The first setting arranges for the xpdf program to be used in its
|
||||
'remote server mode', with the server name specified as the rootname
|
||||
"remote server mode", with the server name specified as the rootname
|
||||
of the TeX file. The second setting arranges for updating to be done
|
||||
in response to a command, and the third setting sets the update command.
|
||||
|
||||
@ -1260,15 +1337,10 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
\fI$pdf_update_method\fR. The default value is the one appropriate
|
||||
for gv on a UNIX system.
|
||||
-.TP
|
||||
-.B $pid_position = [1 under UNIX, -1 under MS-Windows]
|
||||
-.B $pid_position[1 under UNIX, -1 under MS-Windows]
|
||||
+.TP
|
||||
+.B $pid_position = [1 under UNIX, \-1 under MS\-Windows]
|
||||
Command used to get all the processes currently run by the user. The
|
||||
--pvc option uses the command specified by the variable \fI$pscmd\fR to
|
||||
+\-pvc option uses the command specified by the variable \fI$pscmd\fR to
|
||||
determine if there is an already running previewer, and to find the
|
||||
process ID (needed if \fIlatexmk\fR needs to signal the previewer
|
||||
about file changes). The variable \fI$pid_position\fR is used to
|
||||
+.B $pid_position[1 under UNIX, \-1 under MS\-Windows]
|
||||
The variable \fI$pid_position\fR is used to
|
||||
specify which word in lines of the output from \fI$pscmd\fR
|
||||
corresponds to the process ID. The first word in the line is numbered
|
||||
0. The default value of 1 (2nd word in line) is correct for Solaris
|
||||
@ -1311,27 +1383,30 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
-.TP
|
||||
+.TP
|
||||
.B $print_type = ["ps"]
|
||||
Type of file to printout: possibilities are "dvi", "none", "pdf", or
|
||||
"ps".
|
||||
Type of file to printout: possibilities are "dvi", "none", "pdf", or "ps".
|
||||
-.TP
|
||||
+.TP
|
||||
.B $pscmd
|
||||
-[On UNIX, the default is "ps -f -u $ENV{USER}", with changes for Linux
|
||||
-and OS-X.
|
||||
-On MS-WINDOWS the default in "NONE pscmd".]
|
||||
+[On UNIX, the default is "ps \-f \-u $ENV{USER}", with changes for Linux
|
||||
+and OS\-X.
|
||||
+On MS\-WINDOWS the default in "NONE pscmd".]
|
||||
Command used to get all the processes currently run by the user. The
|
||||
--pvc option uses the command specified by the variable \fI$pscmd\fR to
|
||||
+\-pvc option uses the command specified by the variable \fI$pscmd\fR to
|
||||
determine if there is an already running previewer, and to find the
|
||||
process ID (needed if \fIlatexmk\fR needs to signal the previewer
|
||||
about file changes).
|
||||
@@ -1148,27 +1148,27 @@
|
||||
one process. See the \fI$pid_position\fR variable for how the process
|
||||
number is determined.
|
||||
|
||||
Command used to get a list all the processes currently run by the user. This
|
||||
-is used by the -pvc option to determine if there is an already running
|
||||
+is used by the \-pvc option to determine if there is an already running
|
||||
previewer.
|
||||
The command line options for this command under the different flavors of
|
||||
UNIX are quite variable. The command given above is suitable for Solaris
|
||||
2.6 and above, and \fIlatexmk\fR corrects it for Linux and OSX.
|
||||
|
||||
NOTE: The variable \fI$pid_position\fR must also be set; see its description.
|
||||
-The default for \fIpscmd\fR is "NONE" under MS-Windows and cygwin
|
||||
-(i.e., the command is not used), "ps --width 200 -f -u $ENV{USER}"
|
||||
-under linux, "ps -ww -u $ENV{USER}" under darwin (Macintosh OS-X), and
|
||||
-"ps -f -u $ENV{USER}" under other operating systems (including other
|
||||
+The default for \fIpscmd\fR is "NONE" under MS\-Windows and cygwin
|
||||
+(i.e., the command is not used), "ps \-\-width 200 \-f \-u $ENV{USER}"
|
||||
+under linux, "ps \-ww \-u $ENV{USER}" under darwin (Macintosh OS\-X), and
|
||||
+"ps \-f \-u $ENV{USER}" under other operating systems (including other
|
||||
flavors of UNIX). In these specifications "$ENV{USER}" is substituted
|
||||
by the username.
|
||||
-.TP
|
||||
+.TP
|
||||
.B $ps2pdf ["ps2pdf %O %S %D"]
|
||||
@ -1344,35 +1419,30 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
+file before other processing. Equivalent to specifying the \fB\-pF\fR
|
||||
option.
|
||||
-.TP
|
||||
-.B $ps_previewer ["start gv %O %S", but \(dqstart %O %S" under MS-WINDOWS]
|
||||
-The command to invoke a ps-previewer. (The default under MS-WINDOWS
|
||||
+.TP
|
||||
.B $ps_previewer ["start gv %O %S"]
|
||||
-The command to invoke a ps-previewer.
|
||||
-[Default is "start" on MS-WINDOWS; under more recent versions of
|
||||
+The command to invoke a ps\-previewer.
|
||||
+[Default is "start" on MS\-WINDOWS; under more recent versions of
|
||||
Windows, this will cause to be run whatever command the system has
|
||||
associated with .ps files.]
|
||||
+.B $ps_previewer ["start gv %O %S", but \(dqstart %O %S" under MS\-WINDOWS]
|
||||
+The command to invoke a ps\-previewer. (The default under MS\-WINDOWS
|
||||
will cause to be run whatever command the system has associated
|
||||
with .ps files.)
|
||||
|
||||
-Note that gv could be used with the -watch option updates its display
|
||||
+Note that gv could be used with the \-watch option updates its display
|
||||
whenever the postscript file changes, whereas ghostview does not.
|
||||
However, different versions of gv have slightly different ways of
|
||||
writing this option. Moreover, you can always configure gv to do this
|
||||
@@ -1131,19 +1131,19 @@
|
||||
writing this option. You can configure this variable apppropriately.
|
||||
@@ -1176,16 +1176,16 @@
|
||||
\fBWARNING\fR: Linux systems may have installed one (or more) versions
|
||||
of gv under different names, e.g., ggv, kghostview, etc, but perhaps
|
||||
not one called gv.
|
||||
-.TP
|
||||
-.B $ps_previewer_landscape ["start gv -swap %O %S"]
|
||||
-.B $ps_previewer_landscape ["start gv -swap %O %S", but \(dqstart %O %S" under MS-WINDOWS]
|
||||
-The command to invoke a ps-previewer in landscape mode.
|
||||
-[Default is "start" on MS-WINDOWS; under more recent versions of
|
||||
+.TP
|
||||
+.B $ps_previewer_landscape ["start gv \-swap %O %S"]
|
||||
+The command to invoke a ps\-previewer in landscape mode.
|
||||
+[Default is "start" on MS\-WINDOWS; under more recent versions of
|
||||
Windows, this will cause to be run whatever command the system has
|
||||
associated with .ps files.]
|
||||
-.TP
|
||||
+.TP
|
||||
+.B $ps_previewer_landscape ["start gv \-swap %O %S", but \(dqstart %O %S" under MS\-WINDOWS]
|
||||
+The command to invoke a ps\-previewer in landscape mode.
|
||||
+.TP
|
||||
.B $ps_update_command [""]
|
||||
When the postscript previewer is set to be updated by running a command, this
|
||||
@ -1385,7 +1455,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
How the postscript viewer updates its display when the ps file has
|
||||
changed. See the information on the variable \fI$dvi_update_method\fR
|
||||
for the codes. (Note that information needs be changed slightly so
|
||||
@@ -1152,25 +1152,25 @@
|
||||
@@ -1194,25 +1194,25 @@
|
||||
value 2, to specify update by signal, the signal is specified by
|
||||
\fI$ps_update_signal\fR.)
|
||||
|
||||
@ -1413,13 +1483,13 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
-\fI$texfile_search\fR, it is a string of space-separated filenames, and
|
||||
+\fI$texfile_search\fR, it is a string of space\-separated filenames, and
|
||||
then \fIlatexmk\fR replaces \fI@default_files\fR with the filenames in
|
||||
\fI$texfile_search\fR to which is added '*.tex'.
|
||||
\fI$texfile_search\fR to which is added "*.tex".
|
||||
-.TP
|
||||
+.TP
|
||||
.B $tmpdir [See below for default]
|
||||
Directory to store temporary files that \fIlatexmk\fR may generate while
|
||||
running.
|
||||
@@ -1179,54 +1179,54 @@
|
||||
@@ -1221,20 +1221,20 @@
|
||||
\fI$tmpdir\fR to the value of the first of whichever of the system
|
||||
environment variables TMPDIR or TEMP exists, otherwise to the current
|
||||
directory. Under other operating systems (expected to be UNIX/Linux,
|
||||
@ -1430,8 +1500,8 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
+.TP
|
||||
.B $view ["default"]
|
||||
Which kind of file is to be previewed if a previewer is used. The
|
||||
possible values are 'default', 'dvi', 'ps', 'pdf'. The value of
|
||||
"default" means that the "highest" of the kinds of file generated is
|
||||
possible values are "default", "dvi", "ps", "pdf". The value
|
||||
of "default" means that the "highest" of the kinds of file generated is
|
||||
to be used (among dvi, ps and pdf).
|
||||
|
||||
-.SH CUSTOM DEPENDENCIES
|
||||
@ -1442,17 +1512,23 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
file with one extension to a file with another. An example use of this
|
||||
-would be to allow \fIlatexmk\fR to convert a \fI.fig\fR file to
|
||||
+would be to allow \fIlatexmk\fR to convert a \fI.fi g\fR file to
|
||||
\fI.eps\fR to be included in the \fI.tex\fR file. A table of custom
|
||||
dependencies are set up by using the \fB@cus_dep_list\fR array. Each
|
||||
string in the array has four arguments, separated by a space:
|
||||
\fI.eps\fR to be included in the \fI.tex\fR file.
|
||||
|
||||
The old method of configuring \fIlatexmk\fR was to directly manipulate
|
||||
@@ -1249,35 +1249,35 @@
|
||||
|
||||
The custom dependency is a list of rules, each of which is specified
|
||||
as follow:
|
||||
-.TP
|
||||
+.TP
|
||||
.B from extension:
|
||||
The extension of the file we are converting from (e.g. "fig").
|
||||
It is specified without a period.
|
||||
-.TP
|
||||
+.TP
|
||||
.B to extension:
|
||||
The extension of the file we are converting to (e.g. "eps").
|
||||
It is specified without a period.
|
||||
-.TP
|
||||
+.TP
|
||||
.B must:
|
||||
@ -1471,36 +1547,141 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
declared in the syntax of \fIPerl\fR. The function should return 0 if
|
||||
it was successful and a nonzero number if it failed.
|
||||
-.PP
|
||||
-Example in an RC file to ensure automatic conversion of \fI.fig\fR
|
||||
+.PP
|
||||
+Example in an RC file to ensure automatic conversion of \fI.fi g\fR
|
||||
files to \fI.eps\fR files:
|
||||
It is invoked whenever \fIlatexmk\fR detects that a run of
|
||||
latex/pdflatex needs to read a file, like a graphics file, whose
|
||||
-extension is the to-extension of a custom dependency. Then
|
||||
+extension is the to\-extension of a custom dependency. Then
|
||||
\fIlatexmk\fR examines whether a file exists with the same name, but
|
||||
-with the corresponding from-extension, as specified in the
|
||||
-custom-dependency rule. If it does, then whenever the destination
|
||||
-file (the one with the to-extension) is out-of-date with respect to
|
||||
+with the corresponding from\-extension, as specified in the
|
||||
+custom\-dependency rule. If it does, then whenever the destination
|
||||
+file (the one with the to\-extension) is out\-of\-date with respect to
|
||||
the corresponding source file.
|
||||
|
||||
push @cus_dep_list, "fig eps 0 fig2eps";
|
||||
To make the new destination file, the \fIPerl\fR subroutine specified in the
|
||||
@@ -1287,7 +1287,7 @@
|
||||
even by those without knowledge of the \fIPerl\fR programming language. Of
|
||||
course, experts could do something much more elaborate.
|
||||
|
||||
-One other item in each custom-dependency rule labelled "must" above
|
||||
+One other item in each custom\-dependency rule labelled "must" above
|
||||
specifies how the rule should be applied when the source file fails to
|
||||
exist.
|
||||
|
||||
@@ -1295,19 +1295,19 @@
|
||||
|
||||
add_cus_dep( 'fig', 'eps', 0, 'fig2eps' );
|
||||
sub fig2eps {
|
||||
- system("fig2dev -Lps $_[0].fig $_[0].eps");
|
||||
+ system("fig2dev \-Lps $_[0].fi g $_[0].eps");
|
||||
- system("fig2dev -Leps $_[0].fig $_[0].eps");
|
||||
+ system("fig2dev \-Leps $_[0].fi g $_[0].eps");
|
||||
}
|
||||
|
||||
The first line specifies the custom dependency, which specifies that
|
||||
-the subroutine \fIfig2eps\fR will be called if the \fI.fig\fR file has
|
||||
+the subroutine \fIfig2eps\fR will be called if the \fI.fi g\fR file has
|
||||
changed since the \fI.eps\fR file was last made, or if the \fI.eps\fR
|
||||
file does not exist. The remaining lines define this subroutine.
|
||||
When it is called, this subroutine will have one argument which is the
|
||||
@@ -1236,7 +1236,7 @@
|
||||
\fIPerl\fR idiom that signify that each string of the form of a variable
|
||||
name, $_[0] in this case, is to be substituted by its value.
|
||||
The first line adds a custom dependency that converts a file with
|
||||
extension "fig", as created by the xfig program, to an encapsulated
|
||||
postscript file, with extension "eps". The remaining lines define a
|
||||
subroutine that carries out the conversion. If a rule for converting
|
||||
-"fig" to "eps" files already exists (e.g., from a previously read-in
|
||||
+"fig" to "eps" files already exists (e.g., from a previously read\-in
|
||||
initialization file), the \fIlatexmk\fR will delete this rule before
|
||||
making the new one.
|
||||
|
||||
Suppose \fIlatexmk\fR is using this rule to convert a file
|
||||
-"figure.fig" to "figure.eps". Then it will invoke the fig2eps
|
||||
+"figure.fi g" to "figure.eps". Then it will invoke the fig2eps
|
||||
subroutine defined in the above code with a single argument "figure",
|
||||
which is the basename of each of the files (possibly with a path
|
||||
component). This argument is referred to by \fIPerl\fR as $_[0]. In
|
||||
@@ -1316,7 +1316,7 @@
|
||||
are a \fIPerl\fR idiom that signify that each string of the form of a
|
||||
variable name, $_[0] in this case, is to be substituted by its value.
|
||||
|
||||
-If the return value of the subroutine is non-zero, then \fIlatexmk\fR
|
||||
+If the return value of the subroutine is non\-zero, then \fIlatexmk\fR
|
||||
will assume an error occurred during the execution of the subroutine.
|
||||
In the above example, no explicit return value is given, and instead
|
||||
the return value is the value returned by the last (and only)
|
||||
@@ -1244,9 +1244,9 @@
|
||||
on success.
|
||||
@@ -1330,7 +1330,7 @@
|
||||
|
||||
add_cus_dep( 'fig', 'eps', 0, 'fig2eps' );
|
||||
sub fig2eps {
|
||||
- system("fig2dev -Lps '$_[0].fig' '$_[0].eps'");
|
||||
+ system("fig2dev \-Lps '$_[0].fi g' '$_[0].eps'");
|
||||
}
|
||||
|
||||
This causes the invocation of the \fIfig2dev\fR program to have quoted
|
||||
@@ -1346,7 +1346,7 @@
|
||||
|
||||
add_cus_dep( 'fig', 'pdf, 0, 'fig2pdf' );
|
||||
sub fig2pdf {
|
||||
- system("fig2dev -Lpdf $_[0].fig $_[0].pdf");
|
||||
+ system("fig2dev \-Lpdf $_[0].fi g $_[0].pdf");
|
||||
}
|
||||
|
||||
If you have some general custom dependencies defined in the system or
|
||||
@@ -1365,8 +1365,8 @@
|
||||
in an initialization file.
|
||||
|
||||
Another example of a custom dependency overcomes a limitation of
|
||||
-\fIlatexmk\fR concerning index files. The only index-file conversion
|
||||
-built-in to \fIlatexmk\fR is from an ".idx" file written on one run of
|
||||
+\fIlatexmk\fR concerning index files. The only index\-file conversion
|
||||
+built\-in to \fIlatexmk\fR is from an ".idx" file written on one run of
|
||||
latex/pdflatex to an ".ind" file to be read in on a subsequent run.
|
||||
But with the index.sty package you can create extra indexes with
|
||||
extensions that you configure. \fILatexmk\fR does not know how to
|
||||
@@ -1379,7 +1379,7 @@
|
||||
|
||||
add_cus_dep('ndx', 'nnd', 0, 'makendx2nnd');
|
||||
sub makendx2nnd {
|
||||
- system("makeindex -o $_[0].nnd $_[0].ndx");
|
||||
+ system("makeindex \-o $_[0].nnd $_[0].ndx");
|
||||
}
|
||||
|
||||
(You will need to modify this code if you use filenames
|
||||
@@ -1388,7 +1388,7 @@
|
||||
Those of you with experience with Makefiles, will undoubtedly be
|
||||
concerned that the \fI.ndx\fR file is written during a run of
|
||||
latex/pdflatex and is always later than the \fI.nnd\fR last read in.
|
||||
-Thus the \fI.nnd\fR appears to be perpetually out-of-date. This
|
||||
+Thus the \fI.nnd\fR appears to be perpetually out\-of\-date. This
|
||||
situation, of circular dependencies, is endemic to latex, and
|
||||
\fIlatexmk\fR in its current version works correctly with circular
|
||||
dependencies. It examines the contents of the files (by use of an md5
|
||||
@@ -1402,32 +1402,32 @@
|
||||
|
||||
Glossaries can be dealt with similarly.
|
||||
|
||||
-.SH OLD METHOD OF DEFINING CUSTOM DEPENDENCIES
|
||||
+.SH "OLD METHOD OF DEFINING CUSTOM DEPENDENCIES"
|
||||
In previous versions of \fIlatexmk\fR, the only method of defining
|
||||
custom dependencies was to directly manipulate the table of custom
|
||||
dependencies. This is contained in the \fB@cus_dep_list\fR array. It
|
||||
is an array of strings, and each string in the array has four items in
|
||||
-it, each separated by a space, the from-extension, the to-extension,
|
||||
+it, each separated by a space, the from\-extension, the to\-extension,
|
||||
the "must" item, and the name of the subroutine for the custom
|
||||
dependency. These were all defined above.
|
||||
-.PP
|
||||
+.PP
|
||||
An example of the old method of defining custom dependencies is as
|
||||
follows. It is the code in an RC file to ensure automatic conversion
|
||||
-of \fI.fig\fR files to \fI.eps\fR files:
|
||||
+of \fI.fi g\fR files to \fI.eps\fR files:
|
||||
|
||||
push @cus_dep_list, "fig eps 0 fig2eps";
|
||||
sub fig2eps {
|
||||
- system("fig2dev -Lps $_[0].fig $_[0].eps");
|
||||
+ system("fig2dev \-Lps $_[0].fi g $_[0].eps");
|
||||
}
|
||||
|
||||
This method still works, and is equivalent to the earlier code using
|
||||
the add_cus_dep subroutine, except that it doesn't delete any previous
|
||||
-custom-dependency for the same conversion. So the new method is
|
||||
+custom\-dependency for the same conversion. So the new method is
|
||||
preferable.
|
||||
|
||||
-.SH SEE ALSO
|
||||
+.SH "SEE ALSO"
|
||||
@ -1510,7 +1691,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
Sometimes a viewer (gv) tries to read an updated .ps or .pdf file
|
||||
after its creation is started but before the file is complete. Work
|
||||
around: manually refresh (or reopen) display. Or use one of the other
|
||||
@@ -1258,32 +1258,32 @@
|
||||
@@ -1439,31 +1439,31 @@
|
||||
Gv on UNIX/LINUX works for both postscript and pdf.
|
||||
Ghostview on UNIX/LINUX needs a manual update (reopen); it views
|
||||
postscript and pdf.
|
||||
@ -1521,23 +1702,22 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
and reopened to view an updated version.
|
||||
-Under MS-Windows, acroread locks its input file and so the
|
||||
+Under MS\-Windows, acroread locks its input file and so the
|
||||
pdf file cannot be updated. (Remedy: configure \fIlatexmk\fR use gsview
|
||||
pdf file cannot be updated. (Remedy: configure \fIlatexmk\fR to use gsview
|
||||
instead.)
|
||||
-.SH THANKS TO
|
||||
+.SH "THANKS TO"
|
||||
Authors of previous versions. Many users with their feedback, and
|
||||
especially
|
||||
David Coppit (username david at node coppit.org) who made many useful
|
||||
suggestions that contributed to version 3.
|
||||
suggestions that contributed to version 3, and Herbert Schulz.
|
||||
(Please note that the
|
||||
-e-mail addresses are not written in their standard form to avoid being
|
||||
+e\-mail addresses are not written in their standard form to avoid being
|
||||
harvested by worms and viruses.)
|
||||
-.SH AUTHOR
|
||||
+.SH "AUTHOR"
|
||||
Current version, with substantial modifications, enhancements and bug
|
||||
fixes by John Collins (username collins at node phys.psu.edu).
|
||||
(Version 4.00).
|
||||
Current version, by John Collins (username collins at node phys.psu.edu).
|
||||
(Version 4.01).
|
||||
|
||||
It can be obtained from CTAN:
|
||||
-<http://www.tug.org/tex-archive/support/latexmk/>, and from the
|
||||
@ -1551,10 +1731,10 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
||||
Original script called "go" by David J. Musliner (RCS Version 3.2)
|
||||
|
||||
\" LocalWords: fR fIlatexmk dvi ps fILatexmk pdflatex bibtex makeindex fB pv
|
||||
diff -dur latexmk-4.00e.ORIG/latexmk.pl latexmk-4.00e/latexmk.pl
|
||||
--- latexmk-4.00e.ORIG/latexmk.pl 2008-09-22 16:45:08.000000000 -0600
|
||||
+++ latexmk-4.00e/latexmk.pl 2008-09-24 10:06:40.000000000 -0600
|
||||
@@ -777,10 +777,8 @@
|
||||
diff -dur latexmk-4.01.ORIG/latexmk.pl latexmk-4.01/latexmk.pl
|
||||
--- latexmk-4.01.ORIG/latexmk.pl 2008-09-24 16:30:39.000000000 -0600
|
||||
+++ latexmk-4.01/latexmk.pl 2008-10-13 12:15:17.000000000 -0600
|
||||
@@ -643,10 +643,8 @@
|
||||
## /usr/local/share, depending on the local conventions.
|
||||
## /usr/local/lib/latexmk/LatexMk is put in the list for
|
||||
## compatibility with older versions of latexmk.
|
||||
|
@ -1,4 +1,4 @@
|
||||
# This is the system-wide configuration file for latexmk version 3.20.
|
||||
# This is the system-wide configuration file for latexmk version 4.01.
|
||||
# See the latexmk(1) man page for more information.
|
||||
#
|
||||
# The following options are given their default values.
|
||||
|
@ -1,12 +1,12 @@
|
||||
Name: latexmk
|
||||
Version: 4.00e
|
||||
Version: 4.01
|
||||
Release: 1%{?dist}
|
||||
Summary: A make-like utility for LaTeX files
|
||||
|
||||
Group: Applications/Publishing
|
||||
License: GPLv2+
|
||||
URL: http://www.phys.psu.edu/~collins/software/latexmk-jcc/
|
||||
Source0: http://www.phys.psu.edu/~collins/software/latexmk-jcc/latexmk-400e.zip
|
||||
Source0: http://www.phys.psu.edu/~collins/software/latexmk-jcc/latexmk-401.zip
|
||||
Source1: latexmk.conf
|
||||
Source2: latexmk-README.fedora
|
||||
# Change the system-wide configuration file to /etc/latexmk.conf and fix the
|
||||
@ -58,6 +58,9 @@ rm -rf $RPM_BUILD_ROOT
|
||||
%doc CHANGES COPYING INSTALL README README.fedora extra-scripts
|
||||
|
||||
%changelog
|
||||
* Mon Oct 13 2008 Jerry James <loganjerry@gmail.com> - 4.01-1
|
||||
- New version 4.01.
|
||||
|
||||
* Wed Sep 24 2008 Jerry James <loganjerry@gmail.com> - 4.00e-1
|
||||
- New version 4.00e.
|
||||
- Drop the perl patch; the script finds it just fine
|
||||
|
Loading…
Reference in New Issue
Block a user