summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-01-12 22:58:08 +0000
committerKarl Berry <karl@freefriends.org>2015-01-12 22:58:08 +0000
commit0d10ac09f153aab986a764b19809e4584693d6f7 (patch)
treeeebc833b48b78e3fe266ef68371dd7000d750718 /Master
parent3b7f3803ab9b97292d7c1bbdaa241d82239d3b21 (diff)
latexmk (12jan15)
git-svn-id: svn://tug.org/texlive/trunk@36039 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/doc/man/man1/latexmk.118
-rw-r--r--Master/texmf-dist/doc/man/man1/latexmk.man1.pdfbin145184 -> 145217 bytes
-rw-r--r--Master/texmf-dist/doc/support/latexmk/CHANGES4
-rw-r--r--Master/texmf-dist/doc/support/latexmk/INSTALL2
-rw-r--r--Master/texmf-dist/doc/support/latexmk/README10
-rw-r--r--Master/texmf-dist/doc/support/latexmk/example_rcfiles/README-rcfiles (renamed from Master/texmf-dist/doc/support/latexmk/example_rcfiles/README)0
-rw-r--r--Master/texmf-dist/doc/support/latexmk/example_rcfiles/sweave_latexmkrc (renamed from Master/texmf-dist/doc/support/latexmk/example_rcfiles/Sweave_latexmkrc)0
-rw-r--r--Master/texmf-dist/doc/support/latexmk/example_rcfiles/tex4ht-latexmkrc (renamed from Master/texmf-dist/doc/support/latexmk/example_rcfiles/TeX4ht-latexmkrc)0
-rw-r--r--Master/texmf-dist/doc/support/latexmk/extra-scripts/README-scripts (renamed from Master/texmf-dist/doc/support/latexmk/extra-scripts/README1)0
-rwxr-xr-xMaster/texmf-dist/doc/support/latexmk/extra-scripts/dvipdfm_call.bat36
-rwxr-xr-xMaster/texmf-dist/doc/support/latexmk/extra-scripts/dvipdfmx_call.bat36
-rw-r--r--Master/texmf-dist/doc/support/latexmk/latexmk.pdfbin133117 -> 133188 bytes
-rw-r--r--Master/texmf-dist/doc/support/latexmk/latexmk.txt338
-rwxr-xr-xMaster/texmf-dist/scripts/latexmk/latexmk.pl42
14 files changed, 237 insertions, 249 deletions
diff --git a/Master/texmf-dist/doc/man/man1/latexmk.1 b/Master/texmf-dist/doc/man/man1/latexmk.1
index a6d01b71c72..5d2afc41803 100644
--- a/Master/texmf-dist/doc/man/man1/latexmk.1
+++ b/Master/texmf-dist/doc/man/man1/latexmk.1
@@ -1,4 +1,4 @@
-.TH LATEXMK 1L "1 January 2015" ""
+.TH LATEXMK 1L "10 January 2015" ""
.SH NAME
latexmk \- generate LaTeX document
.SH SYNOPSIS
@@ -1900,7 +1900,8 @@ same file, and if one is running will not start a new one. If
.TP
.B $out_dir [""]
-The directory in which output files are to be written by a run of
+If non-blank, this variable specifies the directory in which output
+files are to be written by a run of
(pdf)latex. See also the variable \fI$aux_dir\fR.
The effect of this variable (when non-blank) is achieved by using the
@@ -1908,6 +1909,10 @@ The effect of this variable (when non-blank) is achieved by using the
usual current (Dec. 2011 and later) implementations of TeX, i.e., MiKTeX and
TeXLive. But it may not be present in other versions.
+If you also use the \fB-cd\fR option, and \fI$out_dir\fR (or \fI$aux_dir\fR) contains a
+relative path, then the path is interpreted relative to the document
+directory.
+
Commonly, the directory specified for output files is a subdirectory
of the current working directory. However, if you specify some other
directory, e.g., "/tmp/foo" or "../output", be aware that this could
@@ -1920,9 +1925,10 @@ TeX system that try to prevent malicious or errant TeX documents from
incorrectly messing with a user's files. If for \fI$out_dir\fR or
\fI$aux_dir\fR you really do need to specify an absolute pathname
(e.g., "/tmp/foo") or a path (e.g., "../output") that includes a
-higher-level directory, then you need to disable the security measures
-(and assume any risks). This can be done by temporarily setting the
-operating system's environment variable openout_any to "a" (as in
+higher-level directory, and you need to use \fImakeindex\fR or
+\fIbibtex\fR, then you need to disable the security measures
+(and assume any risks). One way of doing this is to temporarily set an
+operating system environment variable openout_any to "a" (as in
"all"), to override the default "paranoid" setting.
.TP
@@ -2697,7 +2703,7 @@ e-mail addresses are not written in their standard form to avoid being
harvested by worms and viruses.)
.SH AUTHOR
Current version, by John Collins (username jcc8 at node psu.edu).
-(Version 4.41).
+(Version 4.42).
Released version can be obtained from CTAN:
<http://www.ctan.org/tex-archive/support/latexmk/>, and from the
diff --git a/Master/texmf-dist/doc/man/man1/latexmk.man1.pdf b/Master/texmf-dist/doc/man/man1/latexmk.man1.pdf
index 333e9b8fa59..4f26dc26443 100644
--- a/Master/texmf-dist/doc/man/man1/latexmk.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/latexmk.man1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/latexmk/CHANGES b/Master/texmf-dist/doc/support/latexmk/CHANGES
index 6e3368f0a13..9d0b4094320 100644
--- a/Master/texmf-dist/doc/support/latexmk/CHANGES
+++ b/Master/texmf-dist/doc/support/latexmk/CHANGES
@@ -460,3 +460,7 @@ From v. 4.40 to 4.41
Keep both cases, to preserve backward compatibility.
Change sign-on message. Bug report info with help.
+From v. 4.41 to 4.42
+ Fix bugs associated with the -cd option
+ Add missfont.log and the generated synctex.gz to standard cleaned-up files
+
diff --git a/Master/texmf-dist/doc/support/latexmk/INSTALL b/Master/texmf-dist/doc/support/latexmk/INSTALL
index 00e50f8ca0b..6f142440fa0 100644
--- a/Master/texmf-dist/doc/support/latexmk/INSTALL
+++ b/Master/texmf-dist/doc/support/latexmk/INSTALL
@@ -1,6 +1,6 @@
INSTALLING latexmk
==================
- (Version 4.41, 1 January 2015)
+ (Version 4.42, 10 January 2015)
John Collins
Physics Department
diff --git a/Master/texmf-dist/doc/support/latexmk/README b/Master/texmf-dist/doc/support/latexmk/README
index 238b1cfaed5..289c996e983 100644
--- a/Master/texmf-dist/doc/support/latexmk/README
+++ b/Master/texmf-dist/doc/support/latexmk/README
@@ -1,5 +1,5 @@
-Latexmk, version 4.41, 1 January 2015
--------------------------------------
+Latexmk, version 4.42, 10 January 2015
+--------------------------------------
Latexmk completely automates the process of generating a LaTeX
document. Essentially, it is a highly specialized cousin of the
@@ -83,15 +83,15 @@ NOTES:-
versions under development.
7) Latexmk is archived on the CTAN tex archive --- see
- http://www.tug.org/ctan.html.
+ http://www.ctan.org/pkg/latexmk
8) [If for some reason you need to find the obsolete version 2, it can
also be found on CTAN, e.g., at
- http://ctan.org/tex-archive/obsolete/support/latexmk/]
+ http://mirror.ctan.org/obsolete/support/latexmk/]
John Collins
---------------------------- "latexmk -h" ----------------------------
-Latexmk 4.41: Automatic LaTeX document generation routine
+Latexmk 4.42: Automatic LaTeX document generation routine
Usage: latexmk [latexmk_options] [filename ...]
diff --git a/Master/texmf-dist/doc/support/latexmk/example_rcfiles/README b/Master/texmf-dist/doc/support/latexmk/example_rcfiles/README-rcfiles
index 61aa7832dba..61aa7832dba 100644
--- a/Master/texmf-dist/doc/support/latexmk/example_rcfiles/README
+++ b/Master/texmf-dist/doc/support/latexmk/example_rcfiles/README-rcfiles
diff --git a/Master/texmf-dist/doc/support/latexmk/example_rcfiles/Sweave_latexmkrc b/Master/texmf-dist/doc/support/latexmk/example_rcfiles/sweave_latexmkrc
index 19f046be6be..19f046be6be 100644
--- a/Master/texmf-dist/doc/support/latexmk/example_rcfiles/Sweave_latexmkrc
+++ b/Master/texmf-dist/doc/support/latexmk/example_rcfiles/sweave_latexmkrc
diff --git a/Master/texmf-dist/doc/support/latexmk/example_rcfiles/TeX4ht-latexmkrc b/Master/texmf-dist/doc/support/latexmk/example_rcfiles/tex4ht-latexmkrc
index de486d8d8be..de486d8d8be 100644
--- a/Master/texmf-dist/doc/support/latexmk/example_rcfiles/TeX4ht-latexmkrc
+++ b/Master/texmf-dist/doc/support/latexmk/example_rcfiles/tex4ht-latexmkrc
diff --git a/Master/texmf-dist/doc/support/latexmk/extra-scripts/README1 b/Master/texmf-dist/doc/support/latexmk/extra-scripts/README-scripts
index 0f67cb114dc..0f67cb114dc 100644
--- a/Master/texmf-dist/doc/support/latexmk/extra-scripts/README1
+++ b/Master/texmf-dist/doc/support/latexmk/extra-scripts/README-scripts
diff --git a/Master/texmf-dist/doc/support/latexmk/extra-scripts/dvipdfm_call.bat b/Master/texmf-dist/doc/support/latexmk/extra-scripts/dvipdfm_call.bat
index a0817015fe6..104bbabe858 100755
--- a/Master/texmf-dist/doc/support/latexmk/extra-scripts/dvipdfm_call.bat
+++ b/Master/texmf-dist/doc/support/latexmk/extra-scripts/dvipdfm_call.bat
@@ -1,19 +1,19 @@
-@echo off
-REM Run dvipdfm from dvipdf-style command-line
-REM Assume no options specified
-REM If this script is called from latexmk,
-REM we have %1=source.dvi, %2=dest.pdf
-REM But for safety, let's handle correctly a one argument call,
-REM i.e., %1=source, with no %2
-
-if "%2" == "" goto onearg
-
-:twoarg
-dvipdfm -o %2 %1
-goto done
-
-:onearg
-dvipdfm %1
-
-
+@echo off
+REM Run dvipdfm from dvipdf-style command-line
+REM Assume no options specified
+REM If this script is called from latexmk,
+REM we have %1=source.dvi, %2=dest.pdf
+REM But for safety, let's handle correctly a one argument call,
+REM i.e., %1=source, with no %2
+
+if "%2" == "" goto onearg
+
+:twoarg
+dvipdfm -o %2 %1
+goto done
+
+:onearg
+dvipdfm %1
+
+
:done \ No newline at end of file
diff --git a/Master/texmf-dist/doc/support/latexmk/extra-scripts/dvipdfmx_call.bat b/Master/texmf-dist/doc/support/latexmk/extra-scripts/dvipdfmx_call.bat
index 0068de2196d..01a140a65fe 100755
--- a/Master/texmf-dist/doc/support/latexmk/extra-scripts/dvipdfmx_call.bat
+++ b/Master/texmf-dist/doc/support/latexmk/extra-scripts/dvipdfmx_call.bat
@@ -1,19 +1,19 @@
-@echo off
-REM Run dvipdfmx from dvipdf-style command-line
-REM Assume no options specified
-REM If this script is called from latexmk,
-REM we have %1=source.dvi, %2=dest.pdf
-REM But for safety, let's handle correctly a one argument call,
-REM i.e., %1=source, with no %2
-
-if "%2" == "" goto onearg
-
-:twoarg
-dvipdfmx -o %2 %1
-goto done
-
-:onearg
-dvipdfmx %1
-
-
+@echo off
+REM Run dvipdfmx from dvipdf-style command-line
+REM Assume no options specified
+REM If this script is called from latexmk,
+REM we have %1=source.dvi, %2=dest.pdf
+REM But for safety, let's handle correctly a one argument call,
+REM i.e., %1=source, with no %2
+
+if "%2" == "" goto onearg
+
+:twoarg
+dvipdfmx -o %2 %1
+goto done
+
+:onearg
+dvipdfmx %1
+
+
:done \ No newline at end of file
diff --git a/Master/texmf-dist/doc/support/latexmk/latexmk.pdf b/Master/texmf-dist/doc/support/latexmk/latexmk.pdf
index 41cefde7cbb..79314cd37ef 100644
--- a/Master/texmf-dist/doc/support/latexmk/latexmk.pdf
+++ b/Master/texmf-dist/doc/support/latexmk/latexmk.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/latexmk/latexmk.txt b/Master/texmf-dist/doc/support/latexmk/latexmk.txt
index 73089bea4b6..f68f883268b 100644
--- a/Master/texmf-dist/doc/support/latexmk/latexmk.txt
+++ b/Master/texmf-dist/doc/support/latexmk/latexmk.txt
@@ -61,7 +61,7 @@ DESCRIPTION
- 1 January 2015 1
+ 10 January 2015 1
@@ -127,7 +127,7 @@ LATEXMK OPTIONS AND ARGUMENTS ON COMMAND LINE
- 1 January 2015 2
+ 10 January 2015 2
@@ -193,7 +193,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 3
+ 10 January 2015 3
@@ -259,7 +259,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 4
+ 10 January 2015 4
@@ -325,7 +325,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 5
+ 10 January 2015 5
@@ -391,7 +391,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 6
+ 10 January 2015 6
@@ -457,7 +457,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 7
+ 10 January 2015 7
@@ -523,7 +523,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 8
+ 10 January 2015 8
@@ -589,7 +589,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 9
+ 10 January 2015 9
@@ -655,7 +655,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 10
+ 10 January 2015 10
@@ -721,7 +721,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 11
+ 10 January 2015 11
@@ -787,7 +787,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 12
+ 10 January 2015 12
@@ -853,7 +853,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 13
+ 10 January 2015 13
@@ -919,7 +919,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 14
+ 10 January 2015 14
@@ -985,7 +985,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 15
+ 10 January 2015 15
@@ -1051,7 +1051,7 @@ EXAMPLES
- 1 January 2015 16
+ 10 January 2015 16
@@ -1117,7 +1117,7 @@ HOW TO CHANGE THE WAY LATEXMK BEHAVES, DEALING WITH PROBLEMS, ETC
- 1 January 2015 17
+ 10 January 2015 17
@@ -1183,7 +1183,7 @@ HOW TO SET VARIABLES IN INITIALIZATION FILES
- 1 January 2015 18
+ 10 January 2015 18
@@ -1249,7 +1249,7 @@ FORMAT OF COMMAND SPECIFICATIONS
- 1 January 2015 19
+ 10 January 2015 19
@@ -1315,7 +1315,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 20
+ 10 January 2015 20
@@ -1381,7 +1381,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 21
+ 10 January 2015 21
@@ -1447,7 +1447,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 22
+ 10 January 2015 22
@@ -1513,7 +1513,7 @@ LIST OF CONFIGURATION VARIABLES USABLE IN INITIALIZATION FILES
- 1 January 2015 23
+ 10 January 2015 23
@@ -1579,7 +1579,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 24
+ 10 January 2015 24
@@ -1645,7 +1645,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 25
+ 10 January 2015 25
@@ -1711,7 +1711,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 26
+ 10 January 2015 26
@@ -1777,7 +1777,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 27
+ 10 January 2015 27
@@ -1843,7 +1843,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 28
+ 10 January 2015 28
@@ -1909,7 +1909,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 29
+ 10 January 2015 29
@@ -1975,7 +1975,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 30
+ 10 January 2015 30
@@ -2041,7 +2041,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 31
+ 10 January 2015 31
@@ -2107,7 +2107,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 32
+ 10 January 2015 32
@@ -2173,7 +2173,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 33
+ 10 January 2015 33
@@ -2239,7 +2239,7 @@ LATEXMK(1L) LATEXMK(1L)
- 1 January 2015 34
+ 10 January 2015 34
@@ -2263,55 +2263,62 @@ LATEXMK(1L) LATEXMK(1L)
$out_dir [""]
- The directory in which output files are to be written by a run
- of (pdf)latex. See also the variable $aux_dir.
-
- The effect of this variable (when non-blank) is achieved by
- using the -output-directory option of (pdf)latex. This exists
- in the usual current (Dec. 2011 and later) implementations of
- TeX, i.e., MiKTeX and TeXLive. But it may not be present in
+ If non-blank, this variable specifies the directory in which
+ output files are to be written by a run of (pdf)latex. See also
+ the variable $aux_dir.
+
+ The effect of this variable (when non-blank) is achieved by
+ using the -output-directory option of (pdf)latex. This exists
+ in the usual current (Dec. 2011 and later) implementations of
+ TeX, i.e., MiKTeX and TeXLive. But it may not be present in
other versions.
- Commonly, the directory specified for output files is a subdi-
+ If you also use the -cd option, and $out_dir (or $aux_dir) con-
+ tains a relative path, then the path is interpreted relative to
+ the document directory.
+
+ Commonly, the directory specified for output files is a subdi-
rectory of the current working directory. However, if you spec-
- ify some other directory, e.g., "/tmp/foo" or "../output", be
- aware that this could cause problems, e.g., with makeindex or
- bibtex. This is because modern versions of these programs, by
- default, will refuse to work when they find that they are asked
- to write to a file in a directory that appears not to be the
+ ify some other directory, e.g., "/tmp/foo" or "../output", be
+ aware that this could cause problems, e.g., with makeindex or
+ bibtex. This is because modern versions of these programs, by
+ default, will refuse to work when they find that they are asked
+ to write to a file in a directory that appears not to be the
current working directory or one of its subdirectories. This is
- part of security measures by the whole TeX system that try to
+ part of security measures by the whole TeX system that try to
prevent malicious or errant TeX documents from incorrectly mess-
ing with a user's files. If for $out_dir or $aux_dir you really
- do need to specify an absolute pathname (e.g., "/tmp/foo") or a
+ do need to specify an absolute pathname (e.g., "/tmp/foo") or a
path (e.g., "../output") that includes a higher-level directory,
- then you need to disable the security measures (and assume any
- risks). This can be done by temporarily setting the operating
- system's environment variable openout_any to "a" (as in "all"),
- to override the default "paranoid" setting.
+ and you need to use makeindex or bibtex, then you need to dis-
+ able the security measures (and assume any risks). One way of
+ doing this is to temporarily set an operating system environment
+ variable openout_any to "a" (as in "all"), to override the
+ default "paranoid" setting.
$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 pdfla-
tex. If equal to 2, generate a pdf version of the document from
- the ps file, by using the command specified by the $ps2pdf vari-
- able. If equal to 3, generate a pdf version of the document
- from the dvi file, by using the command specified by the $dvipdf
- variable.
+ the ps file, by using the command specified by the $ps2pdf
+
- Equivalent to the -pdf-, -pdf, -pdfdvi, -pdfps options.
+ 10 January 2015 35
- 1 January 2015 35
+LATEXMK(1L) LATEXMK(1L)
+ variable. If equal to 3, generate a pdf version of the document
+ from the dvi file, by using the command specified by the $dvipdf
+ variable.
-LATEXMK(1L) LATEXMK(1L)
+ Equivalent to the -pdf-, -pdf, -pdfdvi, -pdfps options.
$pdflatex ["pdflatex %O %S"]
@@ -2362,23 +2369,22 @@ LATEXMK(1L) LATEXMK(1L)
remove_input_ext. They are used as in the following examples
are possible lines in an initialization file:
- remove_input_ext( 'pdflatex', 'tex' );
- removes the extension 'tex' from pdflatex_input_extensions
-
- add_input_ext( 'pdflatex', 'asdf' );
+ 10 January 2015 36
- 1 January 2015 36
+LATEXMK(1L) LATEXMK(1L)
+ remove_input_ext( 'pdflatex', 'tex' );
-LATEXMK(1L) LATEXMK(1L)
+ removes the extension 'tex' from pdflatex_input_extensions
+ add_input_ext( 'pdflatex', 'asdf' );
add the extension 'asdf to pdflatex_input_extensions. (Natu-
rally with such an extension, you should have made an appropri-
@@ -2427,27 +2433,27 @@ LATEXMK(1L) LATEXMK(1L)
fix the command by "start ", which flags to latexmk that it
should do the detaching of the previewer itself (by whatever
method is appropriate to the operating system). But sometimes
- letting latexmk do the detaching is not appropriate (for a vari-
- ety of non-trivial reasons), so you should put the "start " bit
- in yourself, whenever it is needed.
+ letting latexmk do the detaching is not appropriate (for a
- $pdf_update_command [""]
- When the pdf previewer is set to be updated by running a
+ 10 January 2015 37
- 1 January 2015 37
+LATEXMK(1L) LATEXMK(1L)
-LATEXMK(1L) LATEXMK(1L)
+ variety of non-trivial reasons), so you should put the "start "
+ bit in yourself, whenever it is needed.
- command, this is the command that is run. See the information
- for the variable $pdf_update_method.
+ $pdf_update_command [""]
+ When the pdf previewer is set to be updated by running a com-
+ mand, this is the command that is run. See the information for
+ the variable $pdf_update_method.
$pdf_update_method [1 under UNIX, 3 under MS-Windows]
How the pdf viewer updates its display when the pdf file has
@@ -2494,16 +2500,10 @@ LATEXMK(1L) LATEXMK(1L)
If nonzero, generate a postscript version of the document.
Equivalent to the -ps option.
- If some other request is made for which a postscript file is
- needed, then $postscript_mode will be set to 1.
-
- $preview_continuous_mode [0]
- If nonzero, run a previewer to view the document, and continue
- running latexmk to keep .dvi up-to-date. Equivalent to the -pvc
- 1 January 2015 38
+ 10 January 2015 38
@@ -2512,6 +2512,12 @@ LATEXMK(1L) LATEXMK(1L)
LATEXMK(1L) LATEXMK(1L)
+ If some other request is made for which a postscript file is
+ needed, then $postscript_mode will be set to 1.
+
+ $preview_continuous_mode [0]
+ If nonzero, run a previewer to view the document, and continue
+ running latexmk to keep .dvi up-to-date. Equivalent to the -pvc
option. Which previewer is run depends on the other settings,
see the command line options -view=, and the variable $view.
@@ -2561,15 +2567,9 @@ LATEXMK(1L) LATEXMK(1L)
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 whenever the postscript file changes, whereas ghostview
- does not. However, different versions of gv have slightly dif-
- ferent ways of writing this option. You can configure this
- variable appropriately.
-
- 1 January 2015 39
+ 10 January 2015 39
@@ -2578,6 +2578,12 @@ LATEXMK(1L) LATEXMK(1L)
LATEXMK(1L) LATEXMK(1L)
+ 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 dif-
+ ferent ways of writing this option. You can configure this
+ variable appropriately.
+
WARNING: 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.
@@ -2626,16 +2632,10 @@ LATEXMK(1L) LATEXMK(1L)
$quote_filenames [1]
This specifies whether substitutions for placeholders in command
- specifications (as in $pdflatex) are surrounded by double
- quotes. If this variable is 1 (or any other value Perl regards
- as true), then quoting is done. Otherwise quoting is omitted.
-
- The quoting method used by latexmk is tested to work correctly
- under UNIX systems (including Linux and Mac OS-X) and under MS-
- 1 January 2015 40
+ 10 January 2015 40
@@ -2644,6 +2644,12 @@ LATEXMK(1L) LATEXMK(1L)
LATEXMK(1L) LATEXMK(1L)
+ specifications (as in $pdflatex) are surrounded by double
+ quotes. If this variable is 1 (or any other value Perl regards
+ as true), then quoting is done. Otherwise quoting is omitted.
+
+ The quoting method used by latexmk is tested to work correctly
+ under UNIX systems (including Linux and Mac OS-X) and under MS-
Windows. It allows the use of filenames containing special
characters, notably spaces. (But note that many versions of
LaTeX and PdfLaTeX cannot correctly deal with TeX files whose
@@ -2692,16 +2698,10 @@ LATEXMK(1L) LATEXMK(1L)
operating systems (including Linux and OS-X) is ':'. Normally
the defaults give correct behavior. But there can be difficul-
ties if your operating system is of one kind, but some of your
- software is running under an emulator for the other kind of
- operating system; in that case you'll need to find out what is
- needed, and set $search_path_separator explicitly. (The same
- goes, of course, for unusual operating systems that are not in
- the MSWin, Linux, OS-X, Unix collection.)
-
- 1 January 2015 41
+ 10 January 2015 41
@@ -2710,6 +2710,13 @@ LATEXMK(1L) LATEXMK(1L)
LATEXMK(1L) LATEXMK(1L)
+ software is running under an emulator for the other kind of
+ operating system; in that case you'll need to find out what is
+ needed, and set $search_path_separator explicitly. (The same
+ goes, of course, for unusual operating systems that are not in
+ the MSWin, Linux, OS-X, Unix collection.)
+
+
$silence_logfile_warnings [0]
Whether after a run of (pdf)latex to summarize warnings in the
log file about undefined citations and references. Setting
@@ -2757,17 +2764,10 @@ LATEXMK(1L) LATEXMK(1L)
$tmpdir [See below for default]
Directory to store temporary files that latexmk may generate
- while running.
-
- The default under MSWindows (including cygwin), is to set
- $tmpdir 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, including OS-X), the default is the value of the
- 1 January 2015 42
+ 10 January 2015 42
@@ -2776,6 +2776,13 @@ LATEXMK(1L) LATEXMK(1L)
LATEXMK(1L) LATEXMK(1L)
+ while running.
+
+ The default under MSWindows (including cygwin), is to set
+ $tmpdir 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, including OS-X), the default is the value of the
system environment variable TMPDIR if it exists, otherwise
"/tmp".
@@ -2823,17 +2830,10 @@ CUSTOM DEPENDENCIES
The extension of the file we are converting from (e.g. "fig").
It is specified without a period.
- to extension:
- The extension of the file we are converting to (e.g. "eps"). It
- is specified without a period.
-
- must: If non-zero, the file from which we are converting must exist,
- if it doesn't exist latexmk will give an error message and exit
- unless the -f option is specified. If must is zero and the file
- 1 January 2015 43
+ 10 January 2015 43
@@ -2842,6 +2842,13 @@ CUSTOM DEPENDENCIES
LATEXMK(1L) LATEXMK(1L)
+ to extension:
+ The extension of the file we are converting to (e.g. "eps"). It
+ is specified without a period.
+
+ must: If non-zero, the file from which we are converting must exist,
+ if it doesn't exist latexmk will give an error message and exit
+ unless the -f option is specified. If must is zero and the file
we are converting from doesn't exist, then no action is taken.
function:
@@ -2889,17 +2896,10 @@ LATEXMK(1L) LATEXMK(1L)
Suppose latexmk is using this rule to convert a file "figure.fig" 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 Perl as $_[0]. In the example above, the subroutine
- uses the Perl command system to invoke the program fig2dev. The double
- quotes around the string are a Perl idiom that signify that each string
- of the form of a variable name, $_[0] in this case, is to be substi-
- tuted by its value.
-
- 1 January 2015 44
+ 10 January 2015 44
@@ -2908,6 +2908,13 @@ LATEXMK(1L) LATEXMK(1L)
LATEXMK(1L) LATEXMK(1L)
+ of each of the files (possibly with a path component). This argument
+ is referred to by Perl as $_[0]. In the example above, the subroutine
+ uses the Perl command system to invoke the program fig2dev. The double
+ quotes around the string are a Perl idiom that signify that each string
+ of the form of a variable name, $_[0] in this case, is to be substi-
+ tuted by its value.
+
If the return value of the subroutine is non-zero, then latexmk will
assume an error occurred during the execution of the subroutine. In
the above example, no explicit return value is given, and instead the
@@ -2956,16 +2963,9 @@ LATEXMK(1L) LATEXMK(1L)
show_cus_dep();
- in an initialization file.
-
- Another example of a custom dependency overcomes a limitation of
- latexmk concerning index files. The only index-file conversion built-
- in to latexmk is from an ".idx" file written on one run of latex/pdfla-
- tex to an ".ind" file to be read in on a subsequent run. But with the
-
- 1 January 2015 45
+ 10 January 2015 45
@@ -2974,6 +2974,12 @@ LATEXMK(1L) LATEXMK(1L)
LATEXMK(1L) LATEXMK(1L)
+ in an initialization file.
+
+ Another example of a custom dependency overcomes a limitation of
+ latexmk concerning index files. The only index-file conversion built-
+ in to latexmk is from an ".idx" file written on one run of latex/pdfla-
+ tex 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. Latexmk does not know how to deduce the extensions from the
information it has. But you can easily write a custom dependency. For
@@ -3022,16 +3028,10 @@ OLD METHOD OF DEFINING CUSTOM DEPENDENCIES
push @cus_dep_list, "fig eps 0 fig2eps";
sub fig2eps {
- system( "fig2dev -Lps \"$_[0].fig\" \"$_[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
-
- 1 January 2015 46
+ 10 January 2015 46
@@ -3040,6 +3040,12 @@ OLD METHOD OF DEFINING CUSTOM DEPENDENCIES
LATEXMK(1L) LATEXMK(1L)
+ system( "fig2dev -Lps \"$_[0].fig\" \"$_[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
preferable.
@@ -3089,15 +3095,9 @@ USING latexmk WITH make
%.pdf : %.tex FORCE_MAKE
latexmk -pdf -dvi- -ps- $<
- (Note: the last line must be introduced by a tab for the Makefile to
- function correctly!) Naturally, if making try.pdf from its associated
- LaTeX file try.tex were the only task to be performed, a direct use of
- latexmk without a Makefile would normally be better. The benefit of
- using a Makefile for a LaTeX document would be in a larger project,
-
- 1 January 2015 47
+ 10 January 2015 47
@@ -3106,6 +3106,11 @@ USING latexmk WITH make
LATEXMK(1L) LATEXMK(1L)
+ (Note: the last line must be introduced by a tab for the Makefile to
+ function correctly!) Naturally, if making try.pdf from its associated
+ LaTeX file try.tex were the only task to be performed, a direct use of
+ latexmk without a Makefile would normally be better. The benefit of
+ using a Makefile for a LaTeX document would be in a larger project,
where lines such as the above would be only be a small part of a larger
Makefile.
@@ -3154,16 +3159,11 @@ LATEXMK(1L) LATEXMK(1L)
the .deps subdirectory. The Makefile causes these dependency files to
be read by make, which now has the full dependency information for each
target .pdf file. To make things less trivial it is specificed that
- two files document1.pdf and document2.pdf are the targets. The depen-
- dency files are .deps/document1.pdfP and .deps/document2.pdfP.
-
- There is now no need for the phony prerequisite for the rule to make
- .pdf files from .tex files. But I have added a rule to make .pdf files
- from .fig files produced by the xfig program; these are commonly used
+ two files document1.pdf and document2.pdf are the targets. The
- 1 January 2015 48
+ 10 January 2015 48
@@ -3172,6 +3172,11 @@ LATEXMK(1L) LATEXMK(1L)
LATEXMK(1L) LATEXMK(1L)
+ dependency files are .deps/document1.pdfP and .deps/document2.pdfP.
+
+ There is now no need for the phony prerequisite for the rule to make
+ .pdf files from .tex files. But I have added a rule to make .pdf files
+ from .fig files produced by the xfig program; these are commonly used
for graphics insertions in LaTeX documents. Latexmk is arranged to
output a dependency file after each run. It is given the -recorder
option, which improves its detection of files generated during a run of
@@ -3220,16 +3225,11 @@ THANKS TO
Schulz. (Please note that the e-mail addresses are not written in
their standard form to avoid being harvested by worms and viruses.)
-AUTHOR
- Current version, by John Collins (username jcc8 at node psu.edu).
- (Version 4.41).
- Released version can be obtained from CTAN: <http://www.ctan.org/tex-
- archive/support/latexmk/>, and from the author's website
- 1 January 2015 49
+ 10 January 2015 49
@@ -3238,6 +3238,12 @@ AUTHOR
LATEXMK(1L) LATEXMK(1L)
+AUTHOR
+ Current version, by John Collins (username jcc8 at node psu.edu).
+ (Version 4.42).
+
+ Released version can be obtained from CTAN: <http://www.ctan.org/tex-
+ archive/support/latexmk/>, and from the author's website
<http://www.phys.psu.edu/~collins/software/latexmk/>.
Modifications and enhancements by Evan McLean (Version 2.0)
Original script called "go" by David J. Musliner (RCS Version 3.2)
@@ -3289,12 +3295,6 @@ LATEXMK(1L) LATEXMK(1L)
-
-
-
-
-
-
- 1 January 2015 50
+ 10 January 2015 50
diff --git a/Master/texmf-dist/scripts/latexmk/latexmk.pl b/Master/texmf-dist/scripts/latexmk/latexmk.pl
index 1dbe4e7c00e..20624bc554b 100755
--- a/Master/texmf-dist/scripts/latexmk/latexmk.pl
+++ b/Master/texmf-dist/scripts/latexmk/latexmk.pl
@@ -4,12 +4,6 @@
# N.B. !!!!!!!!!!! See 17 July 2012 comments !!!!!!!!!!!!!!!!!!
-# Re -cd issue !!!!!!!!!!!!! SEE "??!!" COMMENTS.
-# If relative path is given for $out_dir or $aux_dir, and -cd is
-# used, should it be interpreted w.r.t. initial cwd (i.e., cwd when
-# latexmk is started), or w.r.t. to document directory???????
-# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-
# On a UNIX-like system, the above enables latexmk to run independently
# of the location of the perl executable. This line relies on the
# existence of the program /usr/bin/env
@@ -118,13 +112,12 @@ use warnings;
$my_name = 'latexmk';
$My_name = 'Latexmk';
-$version_num = '4.41';
-$version_details = "$My_name, John Collins, 1 January 2015";
+$version_num = '4.42';
+$version_details = "$My_name, John Collins, 10 January 2015";
use Config;
use File::Basename;
use File::Copy;
-use Cwd 'abs_path';
use File::Glob ':glob'; # Better glob. Does not use space as item separator.
use File::Path 2.08 qw( make_path );
use FileHandle;
@@ -193,6 +186,10 @@ else {
##
## 12 Jan 2012 STILL NEED TO DOCUMENT some items below
##
+## 10 Jan 2015 John Collins Fix -cd-associated bugs
+## 9 Jan 2015 John Collins V. 4.42
+## Add missfont.log and synctex.gz to cleaned
+## up files
## 1 Jan 2015 John Collins V. 4.41
## 18 Dec 2014 John Collins -c also deletes $deps_file if it is used.
## 16 Dec 2014 John Collins Finish change of e-mail
@@ -1796,25 +1793,6 @@ if ( ($out_dir ne '') && ($aux_dir eq '') ){
$aux_dir = $out_dir;
}
-# Initially $aux_dir and $out_dir are either absolute or relative to CURRENT
-# directory.
-# If we'll cd to directory of TeX file to do our work, we'll need to convert
-# any relative directories to absolute, to preserve the user-requested
-# directories after a cd.
-# Otherwise, we need to normalize them in our standard way (to ensure
-# standardization in the places we use them.
-
-
-foreach ($out_dir, $aux_dir) {
- if ($do_cd) {
- $_ = abs_path( $_ );
- }
- else {
- # Remove aliases to cwd:
- $_ = normalize_filename( $_ );
- if ($_ eq '.' ) { $_ = ''; }
- }
-}
# Versions terminating in directory/path separator
$out_dir1 = $out_dir;
$aux_dir1 = $aux_dir;
@@ -2300,11 +2278,11 @@ foreach $filename ( @file_list )
show_array( " Yet other generated files:\n",
keys %generated_exts_all );
}
- &cleanup1( $aux_dir1, $fdb_ext, 'blg', 'ilg', 'log', 'aux.bak', 'idx.bak',
+ &cleanup1( $aux_dir1, $fdb_ext, 'blg', 'ilg', 'log', 'aux.bak', 'idx.bak', 'synctex.gz',
split('\s+',$clean_ext),
keys %generated_exts_all
);
- unlink_or_move( 'texput.log', "texput.aux",
+ unlink_or_move( 'texput.log', "texput.aux", "missfont.log",
keys %index_bibtex_generated,
keys %aux_files );
if ( $dependents_list && ( $deps_file ne '-' ) ) {
@@ -4520,12 +4498,12 @@ sub normalize_filename {
$cwd =~ s(\\)(/)g;
$file =~ s(\\)(/)g;
- # Remove current directory string:
- $file =~ s(^\./)();
# Remove initial component equal to current working directory.
# Use \Q and \E round directory name in regex to avoid interpretation
# of metacharacters in directory name:
$file =~ s(^\Q$cwd\E/)();
+ # Remove current directory string:
+ $file =~ s(^\./)();
return $file;
}