- 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
|
diff -dur latexmk-4.01.ORIG/latexmk.1 latexmk-4.01/latexmk.1
|
||||||
--- latexmk-4.00e.ORIG/latexmk.1 2008-03-12 09:34:24.000000000 -0600
|
--- latexmk-4.01.ORIG/latexmk.1 2008-09-28 14:14:18.000000000 -0600
|
||||||
+++ latexmk-4.00e/latexmk.1 2008-09-24 10:05:29.000000000 -0600
|
+++ latexmk-4.01/latexmk.1 2008-10-13 12:17:22.000000000 -0600
|
||||||
@@ -1,9 +1,9 @@
|
@@ -1,9 +1,9 @@
|
||||||
-.TH LATEXMK 1L "12 March 2008" ""
|
-.TH LATEXMK 1L "28 September 2008" ""
|
||||||
-.SH NAME
|
-.SH NAME
|
||||||
+.TH "LATEXMK" "1L" "12 March 2008" "" ""
|
+.TH "LATEXMK" "1L" "28 September 2008" "" ""
|
||||||
+.SH "NAME"
|
+.SH "NAME"
|
||||||
latexmk \- generate LaTeX document
|
latexmk \- generate LaTeX document
|
||||||
-.SH SYNOPSIS
|
-.SH SYNOPSIS
|
||||||
@ -15,18 +15,23 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
|||||||
.I Latexmk
|
.I Latexmk
|
||||||
completely automates the process of compiling a LaTeX document.
|
completely automates the process of compiling a LaTeX document.
|
||||||
Essentially, it is like a specialized relative of the general
|
Essentially, it is like a specialized relative of the general
|
||||||
@@ -15,8 +15,8 @@
|
@@ -13,12 +13,12 @@
|
||||||
document. It can also be set to run continuously with a suitable
|
source file for a document, and it issues the appropriate sequence of
|
||||||
previewer; in that case the LaTeX program, etc, are rerun whenever one
|
commands to generate a .dvi, .ps, .pdf and/or hardcopy version of the
|
||||||
of the source files is modified, and the previewer updates the
|
document.
|
||||||
-on-screen view of the compiled document.
|
|
||||||
-.PP
|
-.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
|
+.PP
|
||||||
\fILatexmk\fR determines which are the source files by examining the
|
\fILatexmk\fR determines which are the source files by examining the
|
||||||
log file. When \fIlatexmk\fR is run, it examines properties of 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
|
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
|
For example, from an updated figure file it can automatically generate
|
||||||
a file in encapsulated postscript or another suitable format for
|
a file in encapsulated postscript or another suitable format for
|
||||||
reading by LaTeX.
|
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
|
(mnemonic: "preview continuously"). In this case, \fIlatexmk\fR runs
|
||||||
continuously, regularly monitoring all the source files to see if any
|
continuously, regularly monitoring all the source files to see if any
|
||||||
have changed. Every time a change is detected, \fIlatexmk\fR runs all
|
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
|
are written to disk, \fIlatexmk\fR completely automates the cycle of
|
||||||
updating the .dvi (and possibly the .ps and .pdf) file, and refreshing
|
updating the .dvi (and possibly the .ps and .pdf) file, and refreshing
|
||||||
the previewer's display. It's not quite WYSIWYG, but usefully close.
|
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
|
of which programs. In its new version, \fIlatexmk\fR has a highly
|
||||||
general and efficient solution to these issues. The solution involves
|
general and efficient solution to these issues. The solution involves
|
||||||
retaining between runs information on the source files, and a symptom
|
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
|
\fR.fdb_latexmk\fR, by default) that contains the source file
|
||||||
information.
|
information.
|
||||||
|
|
||||||
@ -99,7 +104,15 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
|||||||
.B file
|
.B file
|
||||||
One or more files can be specified. If no files are specified,
|
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
|
\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
|
latexmk foo
|
||||||
|
|
||||||
then \fIlatexmk\fR will operate on the file "foo.tex".
|
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
|
Clean up (remove) all regeneratable files generated by \fIlatex\fR and
|
||||||
\fIbibtex\fR except dvi, postscript and pdf. These files are a
|
\fIbibtex\fR except dvi, postscript and pdf. These files are a
|
||||||
combination of log files, aux files, and those with extensions
|
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
|
removed. But the file containing a database of source file
|
||||||
information is not removed.
|
information is not removed.
|
||||||
|
|
||||||
@ -176,7 +189,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
|||||||
.TP
|
.TP
|
||||||
-.B -CF
|
-.B -CF
|
||||||
+.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.
|
before doing the other actions requested.
|
||||||
.TP
|
.TP
|
||||||
-.B -d
|
-.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
|
Dvi file filtering. The argument to this option is a filter which will
|
||||||
generate a filtered dvi file with the extension ".dviF". All extra
|
generate a filtered dvi file with the extension ".dviF". All extra
|
||||||
processing (e.g. conversion to postscript, preview, printing) will then
|
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:
|
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
|
||||||
+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
|
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
|
-.TP
|
||||||
-.B -new-viewer-
|
-.B -new-viewer-
|
||||||
-The inverse of the \fB-new-viewer\fR option. It puts \fIlatexmk\fR
|
-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.
|
+an already\-running previewer.
|
||||||
+.TP
|
+.TP
|
||||||
+.B \-p
|
+.B \-p
|
||||||
Print out the document. By default on a UNIX or Linux system, this is
|
Print out the document. By default it is
|
||||||
done using lpr after generating the postscript file. But you can use
|
the generated postscript file that is printed. But you can use the
|
||||||
-the \fB-print=...\fR option to print the dvi or pdf files instead, and
|
-\fB-print=...\fR option to print the dvi or pdf files instead, and you
|
||||||
+the \fB\-print=...\fR option to print the dvi or pdf files instead, and
|
+\fB\-print=...\fR option to print the dvi or pdf files instead, and you
|
||||||
you can configure this in a start up file (by setting the
|
can configure this in a start up file (by setting the
|
||||||
\fI$print_type\fR variable).
|
\fI$print_type\fR variable).
|
||||||
|
|
||||||
However, the correct behavior for printing very much depends on your
|
However, printing is enabled by default only under UNIX/LINUX systems,
|
||||||
-system's software. In particular, under MS-Windows you must have
|
where the default is to use the lpr command. In general, the correct
|
||||||
+system's software. In particular, under MS\-Windows you must have
|
behavior for printing very much depends on your system's software. In
|
||||||
suitable program(s) available, and you must have configured the print
|
-particular, under MS-Windows you must have suitable program(s)
|
||||||
-commands used by \fIlatexmk\fR. This can be non-trivial.
|
+particular, under MS\-Windows you must have suitable program(s)
|
||||||
+commands used by \fIlatexmk\fR. This can be non\-trivial.
|
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,
|
||||||
+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
|
+.TP
|
||||||
+.B \-print=dvi, \-print=ps, \-print=pdf
|
+.B \-print=dvi, \-print=ps, \-print=pdf
|
||||||
Define which kind of file is printed. This option also ensures that
|
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
|
-.TP
|
||||||
-.B -ps
|
-.B -ps
|
||||||
+.TP
|
+.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
|
Postscript file filtering. The argument to this option is a filter
|
||||||
which will generate a filtered postscript file with the extension
|
which will generate a filtered postscript file with the extension
|
||||||
".psF". All extra processing (e.g. preview, printing) will then be
|
".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:
|
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
|
||||||
+ 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
|
||||||
+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
|
||||||
your command interpreter, in particular on the operating system.
|
depend on your command interpreter, as used by the particular version
|
||||||
|
of perl and the operating system on your computer.
|
||||||
-.TP
|
-.TP
|
||||||
-.B -pv
|
-.B -pv
|
||||||
-Run file previewer. If the \fB-view\fR option is used, this will select
|
-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
|
There are some other methods for arranging an update, notably useful
|
||||||
for many versions of xdvi and xpdf. These are best set in
|
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
|
Note that if \fIlatexmk\fR dies or is stopped by the user, the
|
||||||
"forked" previewer will continue to run. Successive invocations with
|
"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
|
override both the standard initialization files and \fIpreviously\fR
|
||||||
specified options. But all of these can be overridden by \fIlater\fR
|
specified options. But all of these can be overridden by \fIlater\fR
|
||||||
options.
|
options.
|
||||||
@@ -401,48 +401,48 @@
|
@@ -409,48 +409,48 @@
|
||||||
The contents of the RC file just comprise a piece of code in the
|
The contents of the RC file just comprise a piece of code in the
|
||||||
\fIPerl\fR programming language
|
\fIPerl\fR programming language
|
||||||
(typically a sequence of assignment statements); they are executed
|
(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
|
file, start a previewer. Then
|
||||||
watch for changes in the source
|
watch for changes in the source
|
||||||
file thesis.tex and any files it
|
file thesis.tex and any files it
|
||||||
@@ -452,37 +452,38 @@
|
@@ -461,37 +461,38 @@
|
||||||
encounters an error, latexmk will
|
keep running, watching for
|
||||||
keep running.
|
source file changes.
|
||||||
|
|
||||||
-% \fBlatexmk -c\fR \fI# remove .aux, .log, .bbl, .blg, .dvi,
|
-% \fBlatexmk -c\fR \fI# remove .aux, .log, .bbl, .blg, .dvi,
|
||||||
+% \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".
|
"/usr/local/lib/latexmk/LatexMk".
|
||||||
- On a MS-WINDOWS system it looks for "C:\\latexmk\\LatexMk".
|
- On a MS-WINDOWS system it looks for "C:\\latexmk\\LatexMk".
|
||||||
-.PP
|
-.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".
|
+ On a MS\-WINDOWS system it looks for "C:\\latexmk\\LatexMk".
|
||||||
+.PP
|
+.PP
|
||||||
2) The user's RC file, "$HOME/.latexmkrc", if it exists. Here $HOME
|
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
|
+.PP
|
||||||
+4) Any RC file(s) specified on the command line with the \fB\-r\fR option.
|
+4) Any RC file(s) specified on the command line with the \fB\-r\fR option.
|
||||||
+.PP
|
+.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
|
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
|
||||||
+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
|
settings of \fILatexmk\fR. Straightforward cases can be handled
|
||||||
without knowledge of the \fIPerl\fR language by using the examples in this
|
without knowledge of the \fIPerl\fR language by using the examples in this
|
||||||
document as templates. Comment lines are introduced by the "#"
|
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
|
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
|
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
|
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
|
||||||
+\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
|
-.SH HOW TO SET VARIABLES IN INITIALIZATION FILES
|
||||||
-.PP
|
-.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
|
for the setting of an array of strings. It is possible to append an
|
||||||
item to an array variable as follows:
|
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
|
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
|
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
|
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
|
\fBPlaceholders\fR: Supposed you wanted \fIlatexmk\fR to use the
|
||||||
command elatex in place of the regular latex command, and suppose
|
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
|
||||||
+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:
|
could do this by the following setting:
|
||||||
|
-.PP
|
||||||
- $latex = 'elatex --shell-escape %O %S';
|
- $latex = 'elatex --shell-escape %O %S';
|
||||||
|
-.PP
|
||||||
|
+.PP
|
||||||
+ $latex = 'elatex \-\-shell\-escape %O %S';
|
+ $latex = 'elatex \-\-shell\-escape %O %S';
|
||||||
|
+.PP
|
||||||
The two items starting with the % character are placeholders. These
|
The two items starting with the % character are placeholders. These
|
||||||
are substituted by appropriate values before the command is run. Thus
|
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,
|
%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
|
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
|
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
|
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
|
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
|
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
|
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
|
This will be translated to whatever is appropriate for your operating
|
||||||
system.
|
system.
|
||||||
|
|
||||||
@@ -615,28 +615,28 @@
|
@@ -623,31 +623,31 @@
|
||||||
of the command string, that is equivalent to having just one.
|
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
|
||||||
+\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
|
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
|
should be enclosed in double quotes, as in
|
||||||
|
-.PP
|
||||||
|
+.PP
|
||||||
$lpr_pdf = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p %S';
|
$lpr_pdf = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p %S';
|
||||||
|
-.PP
|
||||||
-\fBUsing MS-Windows file associations\fR: A useful trick under modern
|
-\fBUsing MS-Windows file associations\fR: A useful trick under modern
|
||||||
-versions of MS-Windows (e.g., WinXP) is to use just the command
|
-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
|
+\fBUsing MS\-Windows file associations\fR: A useful trick under modern
|
||||||
+versions of MS\-Windows (e.g., WinXP) is to use just the command
|
+versions of MS\-Windows (e.g., WinXP) is to use just the command
|
||||||
'start' by itself:
|
'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
|
This typically is used when an appropriate command does not exist on
|
||||||
your system. The string after the "NONE" is effectively a comment.
|
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
|
Suppose you want \fIlatexmk\fR to use latex with source specials
|
||||||
enabled. Then you might use the following line in an initialization
|
enabled. Then you might use the following line in an initialization
|
||||||
file:
|
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
|
\fBAdvanced tricks\fR: Normally one specifies a single command for the
|
||||||
commands invoked by \fIlatexmk\fR. Naturally, if there is some
|
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
|
file from a tex file you need to run another program after pdflatex to
|
||||||
perform some extra processing, you could do something like:
|
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
|
.B @BIBINPUTS
|
||||||
This is an array variable, now mostly obsolete, that specifies
|
This is an array variable, now mostly obsolete, that specifies
|
||||||
directories where
|
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
|
since it has a better method of searching for files using the
|
||||||
kpsewhich command. However, if your system is an unusual one without
|
kpsewhich command. However, if your system is an unusual one without
|
||||||
the kpsewhich command, you may need to set the variable \fI@BIBINPUTS\fR.
|
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]
|
.B $cleanup_mode [0]
|
||||||
If nonzero, specifies cleanup mode: 1 for full cleanup, 2 for cleanup
|
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
|
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.)
|
variables.)
|
||||||
|
-.PP
|
||||||
|
+.PP
|
||||||
This variable is equivalent to specifying one of
|
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
|
||||||
+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 [""]
|
.B $clean_ext [""]
|
||||||
Extra extensions of files for \fIlatexmk\fR to remove when any of the
|
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.
|
-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.
|
+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
|
+.TP
|
||||||
.B $clean_full_ext [""]
|
.B $clean_full_ext [""]
|
||||||
-Extra extensions of files for \fIlatexmk\fR to remove when the \fB-C\fR
|
-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
|
-.TP
|
||||||
+Custom dependency list \-\- see section on "Custom Dependencies".
|
+Custom dependency list \-\- see section on "Custom Dependencies".
|
||||||
+.TP
|
+.TP
|
||||||
.B @default_files [('*.tex')]
|
.B @default_files [("*.tex")]
|
||||||
Default list of files to be processed.
|
Default list of files to be processed.
|
||||||
|
|
||||||
@@ -784,56 +784,56 @@
|
@@ -797,63 +797,63 @@
|
||||||
is '.tex'. Wild cards are allowed. The parentheses are because
|
is ".tex". Wild cards are allowed. The parentheses are because
|
||||||
\fI@default_files\fR is an array variable, i.e., a sequence of
|
\fI@default_files\fR is an array variable, i.e., a sequence of
|
||||||
filename specifications is possible.
|
filename specifications is possible.
|
||||||
-.TP
|
-.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
|
Command to convert dvi to pdf file. A common reconfiguration is to
|
||||||
use the dvipdfm command, which needs its arguments in a different order:
|
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
|
WARNING: The default dvipdf script generates pdf files with bitmapped
|
||||||
fonts, which do not look good when viewed by acroread. That script
|
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
|
||||||
+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.
|
type 1 fonts are used in the pdf file.
|
||||||
|
|
||||||
-.TP
|
-.TP
|
||||||
-.B $dvips ["dvips %O -o %D %S"]
|
-.B $dvips ["dvips %O -o %D %S"]
|
||||||
+.TP
|
+.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
|
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
|
||||||
+$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
|
-.TP
|
||||||
-.B $dvips_landscape ["dvips -tlandscape %O -o %D %S"]
|
-.B $dvips_landscape ["dvips -tlandscape %O -o %D %S"]
|
||||||
+.TP
|
+.TP
|
||||||
@ -1006,10 +1055,9 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
|||||||
.B $dvi_update_command [""]
|
.B $dvi_update_command [""]
|
||||||
When the dvi previewer is set to be updated by running a command, this
|
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
|
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
|
on the variable \fI$pdf_update_method\fR for an example for the
|
||||||
analogous case of a pdf previewer.
|
analogous case of a pdf previewer.
|
||||||
|
|
||||||
-.TP
|
-.TP
|
||||||
-.B $dvi_update_method [2 under UNIX, 1 under MS-Windows]
|
-.B $dvi_update_method [2 under UNIX, 1 under MS-Windows]
|
||||||
+.TP
|
+.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.
|
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 values here apply equally to the \fI$pdf_update_method\fR and to
|
||||||
the \fI$ps_update_method\fR variables.
|
the \fI$ps_update_method\fR variables.
|
||||||
@@ -852,38 +852,38 @@
|
@@ -864,37 +864,37 @@
|
||||||
2 => Send the signal, whose number is in the variable
|
\fI$dvi_update_signal\fR. The default value under UNIX is
|
||||||
\fI$dvi_update_signal\fR. The default value under UNIX is suitable for xdvi.
|
suitable for xdvi.
|
||||||
3 => Viewer cannot do an update, because it locks the file. (As with
|
3 => Viewer cannot do an update, because it locks the file. (As with
|
||||||
-acroread under MS-Windows.)
|
-acroread under MS-Windows.)
|
||||||
+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
|
See information on the variable \fI$pdf_update_method\fR for an
|
||||||
example of updating by command.
|
example of updating by command.
|
||||||
|
|
||||||
-.TP
|
-.TP
|
||||||
-.B $dvi_update_signal [Under UNIX: SIGUSR1, which is a system-dependent value]
|
-.B $dvi_update_signal [Under UNIX: SIGUSR1, which is a system-dependent value]
|
||||||
+.TP
|
+.TP
|
||||||
@ -1053,7 +1100,7 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
|||||||
-.TP
|
-.TP
|
||||||
+\fB\-f\fR option.
|
+\fB\-f\fR option.
|
||||||
+.TP
|
+.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
|
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
|
a LaTeX run and that are read in by LaTeX in later runs, either
|
||||||
directly or indirectly.
|
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.
|
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
|
(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
|
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
|
the files. But the user may have corrected an error in a source .tex
|
||||||
file during the run. So \fIlatexmk\fR needs to distinguish
|
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
|
automatically generated files as those with extensions in the list in
|
||||||
@generated_exts.)
|
@generated_exts.)
|
||||||
|
|
||||||
@@ -905,11 +905,11 @@
|
@@ -916,11 +916,11 @@
|
||||||
adds the extension 'end' to the list of predefined generated
|
adds the extension "end" to the list of predefined generated
|
||||||
extensions. (This extension is used by the RevTeX package, for
|
extensions. (This extension is used by the RevTeX package, for
|
||||||
example.)
|
example.)
|
||||||
-.TP
|
-.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.
|
-equivalent to the \fB-g\fR option.
|
||||||
-.TP
|
-.TP
|
||||||
+equivalent to the \fB\-g\fR option.
|
+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
|
+.TP
|
||||||
.B $kpsewhich ["kpsewhich %S"]
|
.B $kpsewhich ["kpsewhich %S"]
|
||||||
The program called to locate a source file when the name alone is not
|
The program called to locate a source file when the name alone is not
|
||||||
sufficient. Most filenames used by \fIlatexmk\fR have sufficient path
|
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
|
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
|
also uses to try to locate files; it applies only in the case of .bib
|
||||||
files.
|
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,
|
can use this variable not just to change the name of the program used,
|
||||||
but also specify options to the program. E.g.,
|
but also specify options to the program. E.g.,
|
||||||
|
|
||||||
- $latex = 'latex --src-specials';
|
- $latex = "latex --src-specials";
|
||||||
-.TP
|
-.TP
|
||||||
-.B $latex_silent_switch ["-interaction=batchmode"]
|
-.B $latex_silent_switch ["-interaction=batchmode"]
|
||||||
+ $latex = 'latex \-\-src\-specials';
|
+ $latex = "latex \-\-src\-specials";
|
||||||
+.TP
|
+.TP
|
||||||
+.B $latex_silent_switch ["\-interaction=batchmode"]
|
+.B $latex_silent_switch ["\-interaction=batchmode"]
|
||||||
Switch(es) for the LaTeX processing program when silent mode is on.
|
Switch(es) for the LaTeX processing program when silent mode is on.
|
||||||
-Under MS-Windows, the default value is changed to
|
-Under MS-Windows, the default value is changed to
|
||||||
-"-interaction=batchmode -c-style-errors", as used by MikTeX and fpTeX.
|
-"-interaction=batchmode -c-style-errors", as used by MikTeX and fpTeX.
|
||||||
-.TP
|
-.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
|
+Under MS\-Windows, the default value is changed to
|
||||||
+"\-interaction=batchmode \-c\-style\-errors", as used by MikTeX and fpTeX.
|
+"\-interaction=batchmode \-c\-style\-errors", as used by MikTeX and fpTeX.
|
||||||
+.TP
|
+.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.
|
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
|
||||||
+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
|
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
|
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.
|
misinterpreted.
|
||||||
-.TP
|
-.TP
|
||||||
+.TP
|
+.TP
|
||||||
@ -1148,8 +1214,8 @@ diff -dur latexmk-4.00e.ORIG/latexmk.1 latexmk-4.00e/latexmk.1
|
|||||||
e.g.,
|
e.g.,
|
||||||
|
|
||||||
$lpr = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p';
|
$lpr = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p';
|
||||||
@@ -973,18 +973,18 @@
|
@@ -1012,27 +1012,27 @@
|
||||||
is necessary because one part of the command name ('Program Files')
|
is necessary because one part of the command name ("Program Files")
|
||||||
contains a space which would otherwise be misinterpreted.
|
contains a space which would otherwise be misinterpreted.
|
||||||
|
|
||||||
-.TP
|
-.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"]
|
+.B $makeindex ["makeindex %O \-o %D %S"]
|
||||||
The index processing program.
|
The index processing program.
|
||||||
-.TP
|
-.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
|
+.TP
|
||||||
.B $new_viewer_always [0]
|
.B $new_viewer_always [0]
|
||||||
This variable applies to \fIlatexmk\fR \fBonly\fR in
|
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]
|
.B $pdf_mode [0]
|
||||||
If zero, do NOT generate a pdf version of the document.
|
If zero, do NOT generate a pdf version of the document.
|
||||||
If equal to 1, generate a pdf version of the document using pdflatex.
|
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
|
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.
|
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
|
How the pdf viewer updates its display when the pdf file has
|
||||||
changed. See the information on the variable \fI$dvi_update_method\fR
|
changed. See the information on the variable \fI$dvi_update_method\fR
|
||||||
for the codes. (Note that information needs be changed slightly so
|
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
|
value 2, to specify update by signal, the signal is specified by
|
||||||
\fI$pdf_update_signal\fR.)
|
\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
|
Arranging to use a command to get a previewer explicitly updated
|
||||||
requires three variables to be set. For example:
|
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_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
|
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
|
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.
|
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
|
\fI$pdf_update_method\fR. The default value is the one appropriate
|
||||||
for gv on a UNIX system.
|
for gv on a UNIX system.
|
||||||
-.TP
|
-.TP
|
||||||
-.B $pid_position = [1 under UNIX, -1 under MS-Windows]
|
-.B $pid_position[1 under UNIX, -1 under MS-Windows]
|
||||||
+.TP
|
+.TP
|
||||||
+.B $pid_position = [1 under UNIX, \-1 under MS\-Windows]
|
+.B $pid_position[1 under UNIX, \-1 under MS\-Windows]
|
||||||
Command used to get all the processes currently run by the user. The
|
The variable \fI$pid_position\fR is used to
|
||||||
--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
|
|
||||||
specify which word in lines of the output from \fI$pscmd\fR
|
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
|
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
|
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
|
||||||
+.TP
|
+.TP
|
||||||
.B $print_type = ["ps"]
|
.B $print_type = ["ps"]
|
||||||
Type of file to printout: possibilities are "dvi", "none", "pdf", or
|
Type of file to printout: possibilities are "dvi", "none", "pdf", or "ps".
|
||||||
"ps".
|
|
||||||
-.TP
|
-.TP
|
||||||
+.TP
|
+.TP
|
||||||
.B $pscmd
|
.B $pscmd
|
||||||
-[On UNIX, the default is "ps -f -u $ENV{USER}", with changes for Linux
|
Command used to get all the processes currently run by the user. The
|
||||||
-and OS-X.
|
--pvc option uses the command specified by the variable \fI$pscmd\fR to
|
||||||
-On MS-WINDOWS the default in "NONE pscmd".]
|
+\-pvc option uses the command specified by the variable \fI$pscmd\fR to
|
||||||
+[On UNIX, the default is "ps \-f \-u $ENV{USER}", with changes for Linux
|
determine if there is an already running previewer, and to find the
|
||||||
+and OS\-X.
|
process ID (needed if \fIlatexmk\fR needs to signal the previewer
|
||||||
+On MS\-WINDOWS the default in "NONE pscmd".]
|
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
|
-The default for \fIpscmd\fR is "NONE" under MS-Windows and cygwin
|
||||||
-is used by the -pvc option to determine if there is an already running
|
-(i.e., the command is not used), "ps --width 200 -f -u $ENV{USER}"
|
||||||
+is used by the \-pvc option to determine if there is an already running
|
-under linux, "ps -ww -u $ENV{USER}" under darwin (Macintosh OS-X), and
|
||||||
previewer.
|
-"ps -f -u $ENV{USER}" under other operating systems (including other
|
||||||
The command line options for this command under the different flavors of
|
+The default for \fIpscmd\fR is "NONE" under MS\-Windows and cygwin
|
||||||
UNIX are quite variable. The command given above is suitable for Solaris
|
+(i.e., the command is not used), "ps \-\-width 200 \-f \-u $ENV{USER}"
|
||||||
2.6 and above, and \fIlatexmk\fR corrects it for Linux and OSX.
|
+under linux, "ps \-ww \-u $ENV{USER}" under darwin (Macintosh OS\-X), and
|
||||||
|
+"ps \-f \-u $ENV{USER}" under other operating systems (including other
|
||||||
NOTE: The variable \fI$pid_position\fR must also be set; see its description.
|
flavors of UNIX). In these specifications "$ENV{USER}" is substituted
|
||||||
|
by the username.
|
||||||
-.TP
|
-.TP
|
||||||
+.TP
|
+.TP
|
||||||
.B $ps2pdf ["ps2pdf %O %S %D"]
|
.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
|
+file before other processing. Equivalent to specifying the \fB\-pF\fR
|
||||||
option.
|
option.
|
||||||
-.TP
|
-.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
|
+.TP
|
||||||
.B $ps_previewer ["start gv %O %S"]
|
+.B $ps_previewer ["start gv %O %S", but \(dqstart %O %S" under MS\-WINDOWS]
|
||||||
-The command to invoke a ps-previewer.
|
+The command to invoke a ps\-previewer. (The default under MS\-WINDOWS
|
||||||
-[Default is "start" on MS-WINDOWS; under more recent versions of
|
will cause to be run whatever command the system has associated
|
||||||
+The command to invoke a ps\-previewer.
|
with .ps files.)
|
||||||
+[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.]
|
|
||||||
|
|
||||||
-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
|
||||||
+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.
|
whenever the postscript file changes, whereas ghostview does not.
|
||||||
However, different versions of gv have slightly different ways of
|
However, different versions of gv have slightly different ways of
|
||||||
writing this option. Moreover, you can always configure gv to do this
|
writing this option. You can configure this variable apppropriately.
|
||||||
@@ -1131,19 +1131,19 @@
|
@@ -1176,16 +1176,16 @@
|
||||||
\fBWARNING\fR: Linux systems may have installed one (or more) versions
|
\fBWARNING\fR: Linux systems may have installed one (or more) versions
|
||||||
of gv under different names, e.g., ggv, kghostview, etc, but perhaps
|
of gv under different names, e.g., ggv, kghostview, etc, but perhaps
|
||||||
not one called gv.
|
not one called gv.
|
||||||
-.TP
|
-.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.
|
-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
|
||||||
|
+.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
|
+.TP
|
||||||
.B $ps_update_command [""]
|
.B $ps_update_command [""]
|
||||||
When the postscript previewer is set to be updated by running a command, this
|
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
|
How the postscript viewer updates its display when the ps file has
|
||||||
changed. See the information on the variable \fI$dvi_update_method\fR
|
changed. See the information on the variable \fI$dvi_update_method\fR
|
||||||
for the codes. (Note that information needs be changed slightly so
|
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
|
value 2, to specify update by signal, the signal is specified by
|
||||||
\fI$ps_update_signal\fR.)
|
\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
|
||||||
+\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
|
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
|
||||||
+.TP
|
+.TP
|
||||||
.B $tmpdir [See below for default]
|
.B $tmpdir [See below for default]
|
||||||
Directory to store temporary files that \fIlatexmk\fR may generate while
|
Directory to store temporary files that \fIlatexmk\fR may generate while
|
||||||
running.
|
running.
|
||||||
@@ -1179,54 +1179,54 @@
|
@@ -1221,20 +1221,20 @@
|
||||||
\fI$tmpdir\fR to the value of the first of whichever of the system
|
\fI$tmpdir\fR to the value of the first of whichever of the system
|
||||||
environment variables TMPDIR or TEMP exists, otherwise to the current
|
environment variables TMPDIR or TEMP exists, otherwise to the current
|
||||||
directory. Under other operating systems (expected to be UNIX/Linux,
|
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
|
+.TP
|
||||||
.B $view ["default"]
|
.B $view ["default"]
|
||||||
Which kind of file is to be previewed if a previewer is used. The
|
Which kind of file is to be previewed if a previewer is used. The
|
||||||
possible values are 'default', 'dvi', 'ps', 'pdf'. The value of
|
possible values are "default", "dvi", "ps", "pdf". The value
|
||||||
"default" means that the "highest" of the kinds of file generated is
|
of "default" means that the "highest" of the kinds of file generated is
|
||||||
to be used (among dvi, ps and pdf).
|
to be used (among dvi, ps and pdf).
|
||||||
|
|
||||||
-.SH CUSTOM DEPENDENCIES
|
-.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
|
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.fig\fR file to
|
||||||
+would be to allow \fIlatexmk\fR to convert a \fI.fi g\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
|
\fI.eps\fR to be included in the \fI.tex\fR file.
|
||||||
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:
|
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
|
||||||
+.TP
|
+.TP
|
||||||
.B from extension:
|
.B from extension:
|
||||||
The extension of the file we are converting from (e.g. "fig").
|
The extension of the file we are converting from (e.g. "fig").
|
||||||
|
It is specified without a period.
|
||||||
-.TP
|
-.TP
|
||||||
+.TP
|
+.TP
|
||||||
.B to extension:
|
.B to extension:
|
||||||
The extension of the file we are converting to (e.g. "eps").
|
The extension of the file we are converting to (e.g. "eps").
|
||||||
|
It is specified without a period.
|
||||||
-.TP
|
-.TP
|
||||||
+.TP
|
+.TP
|
||||||
.B must:
|
.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
|
declared in the syntax of \fIPerl\fR. The function should return 0 if
|
||||||
it was successful and a nonzero number if it failed.
|
it was successful and a nonzero number if it failed.
|
||||||
-.PP
|
-.PP
|
||||||
-Example in an RC file to ensure automatic conversion of \fI.fig\fR
|
|
||||||
+.PP
|
+.PP
|
||||||
+Example in an RC file to ensure automatic conversion of \fI.fi g\fR
|
It is invoked whenever \fIlatexmk\fR detects that a run of
|
||||||
files to \fI.eps\fR files:
|
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 {
|
sub fig2eps {
|
||||||
- system("fig2dev -Lps $_[0].fig $_[0].eps");
|
- system("fig2dev -Leps $_[0].fig $_[0].eps");
|
||||||
+ system("fig2dev \-Lps $_[0].fi g $_[0].eps");
|
+ system("fig2dev \-Leps $_[0].fi g $_[0].eps");
|
||||||
}
|
}
|
||||||
|
|
||||||
The first line specifies the custom dependency, which specifies that
|
The first line adds a custom dependency that converts a file with
|
||||||
-the subroutine \fIfig2eps\fR will be called if the \fI.fig\fR file has
|
extension "fig", as created by the xfig program, to an encapsulated
|
||||||
+the subroutine \fIfig2eps\fR will be called if the \fI.fi g\fR file has
|
postscript file, with extension "eps". The remaining lines define a
|
||||||
changed since the \fI.eps\fR file was last made, or if the \fI.eps\fR
|
subroutine that carries out the conversion. If a rule for converting
|
||||||
file does not exist. The remaining lines define this subroutine.
|
-"fig" to "eps" files already exists (e.g., from a previously read-in
|
||||||
When it is called, this subroutine will have one argument which is the
|
+"fig" to "eps" files already exists (e.g., from a previously read\-in
|
||||||
@@ -1236,7 +1236,7 @@
|
initialization file), the \fIlatexmk\fR will delete this rule before
|
||||||
\fIPerl\fR idiom that signify that each string of the form of a variable
|
making the new one.
|
||||||
name, $_[0] in this case, is to be substituted by its value.
|
|
||||||
|
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
|
||||||
+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.
|
will assume an error occurred during the execution of the subroutine.
|
||||||
In the above example, no explicit return value is given, and instead
|
In the above example, no explicit return value is given, and instead
|
||||||
the return value is the value returned by the last (and only)
|
the return value is the value returned by the last (and only)
|
||||||
@@ -1244,9 +1244,9 @@
|
@@ -1330,7 +1330,7 @@
|
||||||
on success.
|
|
||||||
|
|
||||||
|
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
|
||||||
+.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
|
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
|
after its creation is started but before the file is complete. Work
|
||||||
around: manually refresh (or reopen) display. Or use one of the other
|
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.
|
Gv on UNIX/LINUX works for both postscript and pdf.
|
||||||
Ghostview on UNIX/LINUX needs a manual update (reopen); it views
|
Ghostview on UNIX/LINUX needs a manual update (reopen); it views
|
||||||
postscript and pdf.
|
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.
|
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
|
||||||
+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.)
|
instead.)
|
||||||
-.SH THANKS TO
|
-.SH THANKS TO
|
||||||
+.SH "THANKS TO"
|
+.SH "THANKS TO"
|
||||||
Authors of previous versions. Many users with their feedback, and
|
Authors of previous versions. Many users with their feedback, and
|
||||||
especially
|
especially
|
||||||
David Coppit (username david at node coppit.org) who made many useful
|
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
|
(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
|
||||||
+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.)
|
harvested by worms and viruses.)
|
||||||
-.SH AUTHOR
|
-.SH AUTHOR
|
||||||
+.SH "AUTHOR"
|
+.SH "AUTHOR"
|
||||||
Current version, with substantial modifications, enhancements and bug
|
Current version, by John Collins (username collins at node phys.psu.edu).
|
||||||
fixes by John Collins (username collins at node phys.psu.edu).
|
(Version 4.01).
|
||||||
(Version 4.00).
|
|
||||||
|
|
||||||
It can be obtained from CTAN:
|
It can be obtained from CTAN:
|
||||||
-<http://www.tug.org/tex-archive/support/latexmk/>, and from the
|
-<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)
|
Original script called "go" by David J. Musliner (RCS Version 3.2)
|
||||||
|
|
||||||
\" LocalWords: fR fIlatexmk dvi ps fILatexmk pdflatex bibtex makeindex fB pv
|
\" LocalWords: fR fIlatexmk dvi ps fILatexmk pdflatex bibtex makeindex fB pv
|
||||||
diff -dur latexmk-4.00e.ORIG/latexmk.pl latexmk-4.00e/latexmk.pl
|
diff -dur latexmk-4.01.ORIG/latexmk.pl latexmk-4.01/latexmk.pl
|
||||||
--- latexmk-4.00e.ORIG/latexmk.pl 2008-09-22 16:45:08.000000000 -0600
|
--- latexmk-4.01.ORIG/latexmk.pl 2008-09-24 16:30:39.000000000 -0600
|
||||||
+++ latexmk-4.00e/latexmk.pl 2008-09-24 10:06:40.000000000 -0600
|
+++ latexmk-4.01/latexmk.pl 2008-10-13 12:15:17.000000000 -0600
|
||||||
@@ -777,10 +777,8 @@
|
@@ -643,10 +643,8 @@
|
||||||
## /usr/local/share, depending on the local conventions.
|
## /usr/local/share, depending on the local conventions.
|
||||||
## /usr/local/lib/latexmk/LatexMk is put in the list for
|
## /usr/local/lib/latexmk/LatexMk is put in the list for
|
||||||
## compatibility with older versions of latexmk.
|
## 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.
|
# See the latexmk(1) man page for more information.
|
||||||
#
|
#
|
||||||
# The following options are given their default values.
|
# The following options are given their default values.
|
||||||
|
@ -1,12 +1,12 @@
|
|||||||
Name: latexmk
|
Name: latexmk
|
||||||
Version: 4.00e
|
Version: 4.01
|
||||||
Release: 1%{?dist}
|
Release: 1%{?dist}
|
||||||
Summary: A make-like utility for LaTeX files
|
Summary: A make-like utility for LaTeX files
|
||||||
|
|
||||||
Group: Applications/Publishing
|
Group: Applications/Publishing
|
||||||
License: GPLv2+
|
License: GPLv2+
|
||||||
URL: http://www.phys.psu.edu/~collins/software/latexmk-jcc/
|
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
|
Source1: latexmk.conf
|
||||||
Source2: latexmk-README.fedora
|
Source2: latexmk-README.fedora
|
||||||
# Change the system-wide configuration file to /etc/latexmk.conf and fix the
|
# 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
|
%doc CHANGES COPYING INSTALL README README.fedora extra-scripts
|
||||||
|
|
||||||
%changelog
|
%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
|
* Wed Sep 24 2008 Jerry James <loganjerry@gmail.com> - 4.00e-1
|
||||||
- New version 4.00e.
|
- New version 4.00e.
|
||||||
- Drop the perl patch; the script finds it just fine
|
- Drop the perl patch; the script finds it just fine
|
||||||
|
Loading…
Reference in New Issue
Block a user