From 90d985dd123974027ec2b4e7da30f744b803b6bd Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 2 Jan 2015 21:32:25 +0000 Subject: latexmk (2jan15) git-svn-id: svn://tug.org/texlive/trunk@35947 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/latexmk.1 | 63 +- Master/texmf-dist/doc/man/man1/latexmk.man1.pdf | Bin 143481 -> 145184 bytes Master/texmf-dist/doc/support/latexmk/CHANGES | 22 + Master/texmf-dist/doc/support/latexmk/INSTALL | 11 +- Master/texmf-dist/doc/support/latexmk/README | 15 +- .../latexmk/example_rcfiles/Sweave_latexmkrc | 57 + .../latexmk/example_rcfiles/TeX4ht-latexmkrc | 33 + .../latexmk/example_rcfiles/mpost_latexmkrc | 16 +- .../latexmk/example_rcfiles/nomenclature_latexmkrc | 10 + Master/texmf-dist/doc/support/latexmk/latexmk.pdf | Bin 131801 -> 133117 bytes Master/texmf-dist/doc/support/latexmk/latexmk.txt | 1732 +++++++++--------- Master/texmf-dist/scripts/latexmk/latexmk.pl | 1857 +++++++++++--------- .../texmf-dist/source/support/latexmk/latexmk.bat | 10 +- 13 files changed, 2164 insertions(+), 1662 deletions(-) create mode 100644 Master/texmf-dist/doc/support/latexmk/example_rcfiles/Sweave_latexmkrc create mode 100644 Master/texmf-dist/doc/support/latexmk/example_rcfiles/TeX4ht-latexmkrc create mode 100644 Master/texmf-dist/doc/support/latexmk/example_rcfiles/nomenclature_latexmkrc (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/man/man1/latexmk.1 b/Master/texmf-dist/doc/man/man1/latexmk.1 index f9778ed60ca..a6d01b71c72 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 "2 December 2013" "" +.TH LATEXMK 1L "1 January 2015" "" .SH NAME latexmk \- generate LaTeX document .SH SYNOPSIS @@ -542,15 +542,15 @@ Turn off the automatic reading of initialization (rc) files. N.B. Normally the initialization files are read and obeyed, and then command line options are obeyed in the order they are encountered. -Then \fB-norc\fR is an exception to this rule: it is acted on first, -no matter where is occurs on the command line. +But \fB-norc\fR is an exception to this rule: it is acted on first, +no matter where it occurs on the command line. .TP .B -outdir=FOO or -output-directory=FOO Sets the directory for the output files of (pdf)latex. This achieves its effect by the \fB-output-directory\fR option of (pdf)latex, which -currently (Dec. 2011) is implemented on the common versions of +currently (Dec. 2011 and later) is implemented on the common versions of (pdf)latex, i.e., MiKTeX and TeXLive. It may not be present in other versions. @@ -807,12 +807,31 @@ documentation. These options are: \fB-jobname=STRING\fR, \fB-aux-directory=dir\fR, \fB-output-directory=DIR\fR, \fB-quiet\fR, and \fB-recorder\fR. +.TP +.B -logfilewarninglist +.B -logfilewarnings +After a run of (pdf)latex, give a list of warnings about +undefined citations and references (unless silent mode is on). + +See also the $silence_logfile_warnings configuration variable. + +.TP +.B -logfilewarninglist- +.B -logfilewarnings- +After a run of (pdf)latex, do not give a list of warnings about +undefined citations and references. (Default) + +See also the $silence_logfile_warnings configuration variable. + .TP .B -silent Run commands silently, i.e., with options that reduce the amount of diagnostics generated. For example, with the default settings, the command "latex -interaction=batchmode" is used for latex. +See also the \fB-logfilewarninglist\fR and \fB-logfilewarninglist-\fR +options. + Also reduce the number of informational messages that \fIlatexmk\fR generates. @@ -969,6 +988,8 @@ that of cygwin), \fIlatexmk\fR reads for the first it finds of "/opt/local/share/latexmk/LatexMk", "/usr/local/share/latexmk/LatexMk", "/usr/local/lib/latexmk/LatexMk". + In addition, it then tries the same set of locations, but with the +file name replaced "LatexMk" replaced by "latexmkrc". .PP 2) The user's RC file, "$HOME/.latexmkrc", if it exists. Here $HOME is the user's home directory. [\fILatexmk\fR determines the user's @@ -1301,7 +1322,7 @@ written. \fBImportant note\fR: The effect of \fI$aux_dir\fR, if different from \fI$out_dir\fR, is achieved by giving (pdf)latex the -\fB-aux-directory\fR. Currently (Dec. 2011) this only works on the +\fB-aux-directory\fR. Currently (Dec. 2011 and later) this only works on the MiKTeX version of (pdf)latex. See also the documentation of \fI$out_dir\fR for some complications on @@ -1519,6 +1540,11 @@ match. .B $dependents_list [0] Whether to display a list(s) of dependencies at the end of a run. .TP +.B $deps_file ["-"] +Name of file to receive list(s) of dependencies at the end of a run, +to be used if \fI$dependesnt_list\fR is set. If the filename is "-", +then the dependency list is set to stdout (i.e., normally the screen). +.TP .B $do_cd [0] Whether to change working directory to the directory specified for the main source file before processing it. The default behavior is not to @@ -1879,7 +1905,7 @@ The directory in which output files are to be written by a run of The effect of this variable (when non-blank) is achieved by using the \fB-output-directory\fR option of (pdf)latex. This exists in the -usual current (Dec. 2011) implementations of TeX, i.e., MiKTeX and +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 subdirectory @@ -2233,6 +2259,27 @@ you'll need to find out what is needed, and set for unusual operating systems that are not in the MSWin, Linux, OS-X, Unix collection.) +.TP +.B $silence_logfile_warnings [0] +Whether after a run of (pdf)latex to summarize warnings in the log +file about undefined citations and references. Setting +$silence_logfile_warnings=0 gives the summary of warnings (provided +silent mode isn't also set), and this is useful to locate undefined +citations and references without searching through the much more +verbose log file or the screen output of (pdf)latex. But the summary +can also be excessively annoying. The default is not to give these +warnings. The command line options +\fB-silence_logfile_warning_list\fR and +\fB-silence_logfile_warning_list-\fR also set this variable. + +Note that multiple occurrences for the same undefined object on the +same page and same line will be compressed to a single warning. + +.TP +.B $silent [0] +Whether to run silently. Setting $silent to 1 has the same effect as +the \fB-quiet\fR of \fB-silent\fR options on the command line. + .TP .B $sleep_time [2] The time to sleep (in seconds) between checking for source file @@ -2649,8 +2696,8 @@ suggestions that contributed to version 3, and Herbert Schulz. e-mail addresses are not written in their standard form to avoid being harvested by worms and viruses.) .SH AUTHOR -Current version, by John Collins (username collins at node phys.psu.edu). -(Version 4.39). +Current version, by John Collins (username jcc8 at node psu.edu). +(Version 4.41). Released version can be obtained from CTAN: , 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 88a913a54fb..333e9b8fa59 100644 Binary files a/Master/texmf-dist/doc/man/man1/latexmk.man1.pdf and b/Master/texmf-dist/doc/man/man1/latexmk.man1.pdf differ diff --git a/Master/texmf-dist/doc/support/latexmk/CHANGES b/Master/texmf-dist/doc/support/latexmk/CHANGES index 61c1db82295..6e3368f0a13 100644 --- a/Master/texmf-dist/doc/support/latexmk/CHANGES +++ b/Master/texmf-dist/doc/support/latexmk/CHANGES @@ -438,3 +438,25 @@ From v. 4.37 to 4.39 From v. 4.39 to 4.39 documentation update of 2 Dec 2013 Correct two errors in documentation and in the file COPYING. +From v. 4.39 to 4.40 + Fix failure to clean up correctly when root filename contains [, + which is a glob metacharacter. + +From v. 4.40 to 4.41 + -c also deletes $deps_file if it is used + Quote jobname when needed. + Change maintainer's preferred e-mail + Attempt to improve handling of errors from (pdf)latex. + Fix up for the making of -eps-converted-to.pdf + Improve listing of warning lines from log file. + Fix failure when using both -cd and -output-directory + If user's home directory can't be determined, then don't read ~/.latexmkrc + Introduce configuration variable $silence_logfile_warnings + In setting $pscmd, allow for non-existent environment variable USER + Correct subroutine Run for internal cmd w/o arguments + Experimental: Add analysis hook for aux file. + System initialization files: allow them to be named latexmkrc as + well as LatexMk, for more consistency with user directory names. + Keep both cases, to preserve backward compatibility. + Change sign-on message. Bug report info with help. + diff --git a/Master/texmf-dist/doc/support/latexmk/INSTALL b/Master/texmf-dist/doc/support/latexmk/INSTALL index a5d4b08ee36..00e50f8ca0b 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.39, 10 November 2013) + (Version 4.41, 1 January 2015) John Collins Physics Department @@ -11,8 +11,7 @@ http://www.phys.psu.edu/~collins/ http://www.phys.psu.edu/~collins/latexmk/ - username collins at node phys.psu.edu -(E-mail address obfuscated to avoid being harvested by worms and spammers) + username jcc8 at node psu.edu Latexmk is a "make" tool for building latex documents. It runs latex and/or pdflatex the appropriate number of times to resolve cross @@ -301,7 +300,7 @@ Other systems For other systems you are on your own. The instructions for UNIX/LINUX and MS-Windows should help you to see what to do. Let me -know (username collins at node phys.psu.edu) what happens, so that I +know (username jcc8 at node psu.edu) what happens, so that I can update these instructions and possibly latexmk as well. @@ -357,8 +356,8 @@ University of Michigan. Version 2 was modified by Evan McLean. -The current version is by John Collins (username collins at node -phys.psu.edu) -- other contact details at the top. It is copyright +The current version is by John Collins (username jcc8 at node +psu.edu) -- other contact details at the top. It is copyright 1998-2011 by John Collins, and the previous authors; see the copyright notice in the latexmk.pl file, which gives permission to use, copy, modify, and distribute this software and its documentation under the diff --git a/Master/texmf-dist/doc/support/latexmk/README b/Master/texmf-dist/doc/support/latexmk/README index 645f6ea20ca..238b1cfaed5 100644 --- a/Master/texmf-dist/doc/support/latexmk/README +++ b/Master/texmf-dist/doc/support/latexmk/README @@ -1,5 +1,5 @@ -Latexmk, version 4.39, 10 November 2013 ---------------------------------------- +Latexmk, version 4.41, 1 January 2015 +------------------------------------- Latexmk completely automates the process of generating a LaTeX document. Essentially, it is a highly specialized cousin of the @@ -38,8 +38,7 @@ written by David J. Musliner. Now it is supported by U.S.A. http://www.phys.psu.edu/~collins/ - username collins at node phys.psu.edu -(E-mail address obfuscated to reduce harvesting by worms and spammers.) + username jcc8 at node psu.edu The start of the script file has copyright notices and disclaimers. It also has a modification history for those who are interested. @@ -92,7 +91,7 @@ NOTES:- John Collins ---------------------------- "latexmk -h" ---------------------------- -Latexmk 4.39: Automatic LaTeX document generation routine +Latexmk 4.41: Automatic LaTeX document generation routine Usage: latexmk [latexmk_options] [filename ...] @@ -144,6 +143,10 @@ Usage: latexmk [latexmk_options] [filename ...] -latex= - set program used for latex. (replace '' by the program name) -latexoption=