From b6cf0d5c43c7ae353e0dca25fa8ceb521d5ba236 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 28 May 2019 21:25:12 +0000 Subject: latexmk (28may19) git-svn-id: svn://tug.org/texlive/trunk@51250 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/latexmk.1 | 39 +- Master/texmf-dist/doc/man/man1/latexmk.man1.pdf | Bin 215450 -> 215581 bytes Master/texmf-dist/doc/support/latexmk/CHANGES | 9 + Master/texmf-dist/doc/support/latexmk/INSTALL | 4 +- Master/texmf-dist/doc/support/latexmk/README | 4 +- .../latexmk/example_rcfiles/splitindex.latexmkrc | 29 + Master/texmf-dist/doc/support/latexmk/latexmk.pdf | Bin 188230 -> 189276 bytes Master/texmf-dist/doc/support/latexmk/latexmk.txt | 2998 ++++++++++---------- Master/texmf-dist/scripts/latexmk/latexmk.pl | 118 +- 9 files changed, 1703 insertions(+), 1498 deletions(-) create mode 100644 Master/texmf-dist/doc/support/latexmk/example_rcfiles/splitindex.latexmkrc (limited to 'Master') diff --git a/Master/texmf-dist/doc/man/man1/latexmk.1 b/Master/texmf-dist/doc/man/man1/latexmk.1 index 82cd96f1867..e8b174b6e97 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 1 "17 March 2019" "" +.TH LATEXMK 1 "21 May 2019" "" .SH NAME latexmk \- generate LaTeX document .SH SYNOPSIS @@ -80,9 +80,13 @@ This also extends the possibility of postprocessing generated files. \fILatexmk\fR is highly configurable, both from the command line and in configuration files, so that it can accommodate a wide variety of user needs and system configurations. Default values are set -according to the operating system, so \fIlatexmk\fR often works +according to the operating system, so \fIlatexmk\fR often works without special configuration on MS-Windows, cygwin, Linux, OS-X, and -other UNIX systems. +other UNIX systems. See the section "Configuration/Initialization +(rc) Files", and then the later sections "How to Set Variables in +Initialization Files", "Format of Command Specifications", "List of +Configuration Variables Usable in Initialization Files", "Custom +Dependencies", and "Advanced Configuration" .PP A very annoying complication handled very reliably by \fIlatexmk\fR, is that LaTeX is a multiple pass system. On each run, LaTeX reads in @@ -835,9 +839,9 @@ An example of the use of the \fB-pdfxelatex\fR option: Given that CODE is some TeX code, this options sets that code to be executed before inputting source file. This only works if the command for invoking the relevant \fI*latex\fR is suitably configured. See -the documentation of the variable \fI$pre_tex_cmd\fR, and the +the documentation of the variable \fI$pre_tex_code\fR, and the substitution strings %P and %U for more details. This option works by -setting the variable \fI$pre_tex_cmd\fR. +setting the variable \fI$pre_tex_code\fR. See also the \fB-usepretex\fR option. @@ -1368,6 +1372,13 @@ rule network is too radical to be readily handled automatically. .SH CONFIGURATION/INITIALIZATION (RC) FILES .PP +In this section is explained which configuration files are read by +\fIlatexmk\fR. Subsequent sections "How to Set Variables in +Initialization Files", "Format of Command Specifications", "List of +Configuration Variables Usable in Initialization Files", "Custom +Dependencies", and "Advanced Configuration" give details on what can +be configured and how. + \fILatexmk\fR can be customized using initialization files, which are read at startup in the following order: .PP @@ -1448,9 +1459,10 @@ http://mirror.ctan.org/support/latexmk/example_rcfiles). .SH HOW TO SET VARIABLES IN INITIALIZATION FILES .PP The important variables that can be configured are described in the -section "List of configuration variables usable in initialization -files". Syntax for setting these variables is of the following -forms: +section "List of configuration variables usable in initialization +files". (See the earlier section "Configuration/Initialization (rc) +Files" for the files where the configurations are done.) Syntax for +setting these variables is of the following forms: .PP $bibtex = 'bibtex %O %B'; .PP @@ -1737,6 +1749,11 @@ invoking the MS-Windows command-line processor \fIcmd.exe\fR. .SH LIST OF CONFIGURATION VARIABLES USABLE IN INITIALIZATION FILES .PP +In this section are specified the variables whose values can be +adjusted to configure \fIlatexmk\fR. (See the earlier section +"Configuration/Initialization (rc) Files" for the files where the +configurations are done.) + Default values are indicated in brackets. Note that for variables that are boolean in character, concerning whether \fIlatexmk\fR does or does not behave in a certain way, a non-zero value, normally 1, @@ -2827,13 +2844,13 @@ works if the relevant one of \fI$latex\fR, etc contains a suitable command line with a %P or %U substitution. For example you could do $latex = 'latex %O %P'; - $pre_tex_code = '\AtBeginDocument{An initial message\par}'; + $pre_tex_code = '\\AtBeginDocument{An initial message\\par}'; To set all of \fI$latex\fR, \fI$pdflatex\fR, \fI$lualatex\fR, and \fI$xelatex\fR you could use the subroutine \fIalt_tex_cmds\fR: &alt_tex_cmds; - $pre_tex_code = '\AtBeginDocument{An initial message\par}'; + $pre_tex_code = '\\AtBeginDocument{An initial message\\par}'; .TP @@ -3784,7 +3801,7 @@ e-mail addresses are not written in their standard form to avoid being harvested too easily.) .SH AUTHOR Current version, by John Collins (username jcc8 at node psu.edu). -(Version 4.63b). +(Version 4.64a). 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 566081325bd..918626dc9d4 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 b3d9f8c1cde..54c1adcd8e0 100644 --- a/Master/texmf-dist/doc/support/latexmk/CHANGES +++ b/Master/texmf-dist/doc/support/latexmk/CHANGES @@ -679,3 +679,12 @@ From v. 4.61 to 4.63b Implement placeholder for true basename of main tex file, and use it in jobname. Various bug fixes. + +From v. 4.63b to 4.64 + Fix problem that rules processing dvi and xdv did not always run after + rapid-fire changes in graphics files. + +From v. 4.64 to 4.64a + Fix incorrect listings by -rules and by -deps + + diff --git a/Master/texmf-dist/doc/support/latexmk/INSTALL b/Master/texmf-dist/doc/support/latexmk/INSTALL index c586319d324..065dc0a4e02 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.63b, 17 March 2019) + (Version 4.64a, 21 May 2019) John Collins Physics Department @@ -408,7 +408,7 @@ Version 2 was modified by Evan McLean. The current version is by John Collins (username jcc8 at node psu.edu) -- other contact details at the top. It is copyright -1998-2015 by John Collins, and the previous authors; see the copyright +1998-2019 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 terms of the GNU Public License v. 2. diff --git a/Master/texmf-dist/doc/support/latexmk/README b/Master/texmf-dist/doc/support/latexmk/README index 0f3d5993194..a527368d4e9 100644 --- a/Master/texmf-dist/doc/support/latexmk/README +++ b/Master/texmf-dist/doc/support/latexmk/README @@ -1,4 +1,4 @@ -Latexmk, version 4.63b, 17 Mar 2019 +Latexmk, version 4.64a, 21 May 2019 ----------------------------------- Latexmk completely automates the process of generating a LaTeX @@ -87,7 +87,7 @@ NOTES:- John Collins ---------------------------- "latexmk -h" ---------------------------- -Latexmk 4.63b: Automatic LaTeX document generation routine +Latexmk 4.64a: Automatic LaTeX document generation routine Usage: latexmk [latexmk_options] [filename ...] diff --git a/Master/texmf-dist/doc/support/latexmk/example_rcfiles/splitindex.latexmkrc b/Master/texmf-dist/doc/support/latexmk/example_rcfiles/splitindex.latexmkrc new file mode 100644 index 00000000000..4509538dd7e --- /dev/null +++ b/Master/texmf-dist/doc/support/latexmk/example_rcfiles/splitindex.latexmkrc @@ -0,0 +1,29 @@ +$clean_ext .= " %R-*.ind %R-*.idx %R-*.ilg %R-*.ind"; + +$makeindex = 'internal splitindex'; + +sub splitindex { + # Use splitindex instead of makeindex. + # The splitindex programe starts from an .idx file, makes a set of + # other .idx files for separate indexes, and then runs makeindex to + # make corresponding .ind files. + # However, it is possible that the document uses the splitindex + # package, but in a way compatible with the standard methods + # compatible with makeindex, i.e., with a single index and with the + # use of the \printindex command. + # Then we need to invoke makeindex. + # In addition, latexmk assumes that makeindex or its replacement makes + # an .ind file from an .idx file, and latexmk gives an error if it + # doesn't exist, we need to make an .ind file. + # Both problems are solved by running makeindex and then splitindex. + # Note: errors are returned by makeindex and splitindex for things + # like a missing input file. No error is returned for lines in an + # input file that are in an incorrect format; they are simply + # ignored. So no problem is caused by lines in the .idx file + # that are generated by splitindex in a format incompatible with + # makeindex. + my $ret1 = system( "makeindex", $$Psource ); + my $ret2 = system( "splitindex", $$Psource ); + return $ret1 || $ret2; +} + diff --git a/Master/texmf-dist/doc/support/latexmk/latexmk.pdf b/Master/texmf-dist/doc/support/latexmk/latexmk.pdf index b2bee5a0725..579ec22ce9a 100644 Binary files a/Master/texmf-dist/doc/support/latexmk/latexmk.pdf and b/Master/texmf-dist/doc/support/latexmk/latexmk.pdf differ diff --git a/Master/texmf-dist/doc/support/latexmk/latexmk.txt b/Master/texmf-dist/doc/support/latexmk/latexmk.txt index aabdeb362e5..084a6cc7c27 100644 --- a/Master/texmf-dist/doc/support/latexmk/latexmk.txt +++ b/Master/texmf-dist/doc/support/latexmk/latexmk.txt @@ -61,7 +61,7 @@ DESCRIPTION - 17 March 2019 1 + 21 May 2019 1 @@ -92,20 +92,25 @@ LATEXMK(1) General Commands Manual LATEXMK(1) figuration files, so that it can accommodate a wide variety of user needs and system configurations. Default values are set according to the operating system, so latexmk often works without special configura- - tion on MS-Windows, cygwin, Linux, OS-X, and other UNIX systems. - - A very annoying complication handled very reliably by latexmk, is that - LaTeX is a multiple pass system. On each run, LaTeX reads in informa- + tion on MS-Windows, cygwin, Linux, OS-X, and other UNIX systems. See + the section "Configuration/Initialization (rc) Files", and then the + later sections "How to Set Variables in Initialization Files", "Format + of Command Specifications", "List of Configuration Variables Usable in + Initialization Files", "Custom Dependencies", and "Advanced Configura- + tion" + + A very annoying complication handled very reliably by latexmk, is that + LaTeX is a multiple pass system. On each run, LaTeX reads in informa- tion generated on a previous run, for things like cross referencing and - indexing. In the simplest cases, a second run of LaTeX suffices, and - often the log file contains a message about the need for another pass. - However, there is a wide variety of add-on macro packages to LaTeX, - with a variety of behaviors. The result is to break simple-minded de- - terminations of how many runs are needed and of which programs. La- + indexing. In the simplest cases, a second run of LaTeX suffices, and + often the log file contains a message about the need for another pass. + However, there is a wide variety of add-on macro packages to LaTeX, + with a variety of behaviors. The result is to break simple-minded de- + terminations of how many runs are needed and of which programs. La- texmk has a highly general and efficient solution to these issues. The - solution involves retaining between runs information on the source - files, and a symptom is that latexmk generates an extra file (with ex- - tension .fdb_latexmk, by default) that contains the source file infor- + solution involves retaining between runs information on the source + files, and a symptom is that latexmk generates an extra file (with ex- + tension .fdb_latexmk, by default) that contains the source file infor- mation. @@ -117,17 +122,12 @@ LATEXMK OPTIONS AND ARGUMENTS ON COMMAND LINE All options can be introduced by single or double "-" characters, e.g., "latexmk -help" or "latexmk --help". - Note 1: In addition to the options in the list below, latexmk recog- + Note 1: In addition to the options in the list below, latexmk recog- nizes almost all the options recognized by the latex, pdflatex programs - (and their relatives) in their current TeXLive and MiKTeX implementa- - tions. Some of the options for these programs also trigger special ac- - tion or behavior by latexmk, in which case they have specific explana- - tions in this document. Otherwise, they are just passed through to a - called latex or pdflatex program. Run latexmk with the - 17 March 2019 2 + 21 May 2019 2 @@ -136,64 +136,64 @@ LATEXMK OPTIONS AND ARGUMENTS ON COMMAND LINE LATEXMK(1) General Commands Manual LATEXMK(1) - -showextraoptions to get a list of the options that latexmk accepts and - that are simply passed through to latex or pdflatex (etc). See also - the explanation of the -showextraoptions option for more information. - - Note 2: In this documentation, the program pdflatex is often referred - to. Users of programs like lualatex and xelatex should know that from - latexmk's point of view, these other programs behave very like pdfla- - tex, i.e., they make a pdf file from a tex file, etc. So whenever + (and their relatives) in their current TeXLive and MiKTeX implementa- + tions. Some of the options for these programs also trigger special ac- + tion or behavior by latexmk, in which case they have specific explana- + tions in this document. Otherwise, they are just passed through to a + called latex or pdflatex program. Run latexmk with the -showextraop- + tions to get a list of the options that latexmk accepts and that are + simply passed through to latex or pdflatex (etc). See also the expla- + nation of the -showextraoptions option for more information. + + Note 2: In this documentation, the program pdflatex is often referred + to. Users of programs like lualatex and xelatex should know that from + latexmk's point of view, these other programs behave very like pdfla- + tex, i.e., they make a pdf file from a tex file, etc. So whenever pdflatex is mentioned without mention of the other programs, the state- - ments apply equally to lualatex, xelatex, and any other similar pro- + ments apply equally to lualatex, xelatex, and any other similar pro- grams. Latexmk can be easily configured to use whichever of these pro- - grams is needed. See the documentation for the following options: - -pdflua, -pdfxe, -lualatex, and -xelatex, and also see the documenta- - tion for the $pdflatex, $lualatex, and $xelatex configuration vari- - ables. At present latexmk does not do automatic detection of which + grams is needed. See the documentation for the following options: + -pdflua, -pdfxe, -lualatex, and -xelatex, and also see the documenta- + tion for the $pdflatex, $lualatex, and $xelatex configuration vari- + ables. At present latexmk does not do automatic detection of which program is to be used. Definitions of options and arguments - file One or more files can be specified. If no files are specified, - latexmk will, by default, run on all files in the current work- - ing directory with a ".tex" extension. This behavior can be + file One or more files can be specified. If no files are specified, + latexmk will, by default, run on all files in the current work- + ing directory with a ".tex" extension. This behavior can be changed: see the description concerning the @default_files vari- - able in the section "List of configuration variables usable in + able in the section "List of configuration variables usable in initialization files". If a file is specified without an extension, then the ".tex" ex- - tension is automatically added, just as LaTeX does. Thus, if + tension is automatically added, just as LaTeX does. Thus, if you specify: latexmk foo then latexmk will operate on the file "foo.tex". - There are certain restrictions on what characters can be in a - filename; certain characters are either prohibited or problem- - atic for the latex etc programs. These characters are: "$", + There are certain restrictions on what characters can be in a + filename; certain characters are either prohibited or problem- + atic for the latex etc programs. These characters are: "$", "%", "\", "~", the double quote character, and the control char- - acters null, tab, form feed, carriage return, line feed, and - delete. In addition "&" is prohibited when it is the first + acters null, tab, form feed, carriage return, line feed, and + delete. In addition "&" is prohibited when it is the first character of a filename. - Latexmk gives a fatal error when it detects any of the above + Latexmk gives a fatal error when it detects any of the above characters in the TeX filename(s) specified on the command line. - However before testing for illegal characters, latexmk removes - matching pairs of double quotes from a filename. This matches - the behavior of latex etc, and deals with problems that occa- - sionally result from filenames that have been incorrectly quoted - on the command line. In addition, under Microsoft Windows, the - forward slash character "\" is a directory separator, so latexmk - replaces it by a backward slash "/", which is also a legal di- - rectory separator in Windows, and is accepted by latex etc. + However before testing for illegal characters, latexmk removes + matching pairs of double quotes from a filename. This matches + the behavior of latex etc, and deals with problems that - 17 March 2019 3 + 21 May 2019 3 @@ -202,6 +202,14 @@ LATEXMK(1) General Commands Manual LATEXMK(1) LATEXMK(1) General Commands Manual LATEXMK(1) + occasionally result from filenames that have been incorrectly + quoted on the command line. In addition, under Microsoft Win- + dows, the forward slash character "\" is a directory separator, + so latexmk replaces it by a backward slash "/", which is also a + legal directory separator in Windows, and is accepted by latex + etc. + + -auxdir=FOO or -aux-directory=FOO Sets the directory for auxiliary output files of (pdf)latex (.aux, .log etc). This achieves its effect by the -aux-direc- @@ -248,31 +256,31 @@ LATEXMK(1) General Commands Manual LATEXMK(1) if the relevant bib file(s) exist. Thus when the bib files are not available, bibtex or biber is not run, thereby avoiding overwriting of the bbl file(s). Also, always treat .bbl files - as precious, i.e., do not delete them in a cleanup operation. - This is the default setting. It can also be configured by set- - ting the $bibtex_use variable to 1 in a configuration file. - The reason for using this setting is that sometimes a .bbl file - is available containing the bibliography for a document, but the - .bib file is not available. An example would be for a + 21 May 2019 4 - 17 March 2019 4 +LATEXMK(1) General Commands Manual LATEXMK(1) -LATEXMK(1) General Commands Manual LATEXMK(1) + as precious, i.e., do not delete them in a cleanup operation. + This is the default setting. It can also be configured by set- + ting the $bibtex_use variable to 1 in a configuration file. - scientific journal where authors submit .tex and .bbl files, but - not the original .bib file. In that case, running bibtex or - biber would not work, and the .bbl file should be treated as a - user source file, and not as a file that can be regenerated on - demand. + The reason for using this setting is that sometimes a .bbl file + is available containing the bibliography for a document, but the + .bib file is not available. An example would be for a scien- + tific journal where authors submit .tex and .bbl files, but not + the original .bib file. In that case, running bibtex or biber + would not work, and the .bbl file should be treated as a user + source file, and not as a file that can be regenerated on de- + mand. (Note that it is possible for latexmk to decide that the bib file does not exist, even though the bib file does exist and @@ -314,26 +322,26 @@ LATEXMK(1) General Commands Manual LATEXMK(1) -bi How dark to print the banner message. A decimal number between - 0 and 1. 0 is black and 1 is white. The default is 0.95, which - is OK unless your toner cartridge is getting low. - -bs - A decimal number that specifies how large the banner message - will be printed. Experimentation is necessary to get the right - scale for your message, as a rule of thumb the scale should be + 21 May 2019 5 - 17 March 2019 5 +LATEXMK(1) General Commands Manual LATEXMK(1) -LATEXMK(1) General Commands Manual LATEXMK(1) + 0 and 1. 0 is black and 1 is white. The default is 0.95, which + is OK unless your toner cartridge is getting low. + -bs + A decimal number that specifies how large the banner message + will be printed. Experimentation is necessary to get the right + scale for your message, as a rule of thumb the scale should be about equal to 1100 divided by the number of characters in the message. The default is 220.0 which is just right for 5 charac- ter messages. @@ -381,23 +389,24 @@ LATEXMK(1) General Commands Manual LATEXMK(1) This cleanup is instead of a regular make. See the -gg option if you want to do a cleanup than a make. - See the -c option for the specification of whether or not .bbl - files are treated as non-regeneratable or regeneratable. - If $cleanup_includes_cusdep_generated is nonzero, regeneratable - files are considered as including those generated by custom de- - pendencies and are also deleted. Otherwise these files are not - deleted. + 21 May 2019 6 - 17 March 2019 6 +LATEXMK(1) General Commands Manual LATEXMK(1) -LATEXMK(1) General Commands Manual LATEXMK(1) + See the -c option for the specification of whether or not .bbl + files are treated as non-regeneratable or regeneratable. + + If $cleanup_includes_cusdep_generated is nonzero, regeneratable + files are considered as including those generated by custom de- + pendencies and are also deleted. Otherwise these files are not + deleted. -CA (Obsolete). Now equivalent to the -C option. See that option @@ -446,26 +455,25 @@ LATEXMK(1) General Commands Manual LATEXMK(1) latexmk -bm DRAFT - Note that if the -d option is specified, the -ps option is as- - sumed. - - -deps Show a list of dependent files after processing. This is in the - form of a dependency list of the form used by the make program, - and it is therefore suitable for use in a Makefile. It gives an - overall view of the files without listing intermediate files, as + 21 May 2019 7 - 17 March 2019 7 +LATEXMK(1) General Commands Manual LATEXMK(1) -LATEXMK(1) General Commands Manual LATEXMK(1) + Note that if the -d option is specified, the -ps option is as- + sumed. + -deps Show a list of dependent files after processing. This is in the + form of a dependency list of the form used by the make program, + and it is therefore suitable for use in a Makefile. It gives an + overall view of the files without listing intermediate files, as well as latexmk can determine them. By default the list of dependent files is sent to stdout (i.e., @@ -512,24 +520,25 @@ LATEXMK(1) General Commands Manual LATEXMK(1) Example usage: To use dviselect to select only the even pages of the dvi file: - latexmk -dF "dviselect even" foo.tex - -diagnostics - Print detailed diagnostics during a run. This may help for de- - bugging problems or to understand latexmk's behavior in diffi- - cult situations. + + 21 May 2019 8 - 17 March 2019 8 +LATEXMK(1) General Commands Manual LATEXMK(1) + latexmk -dF "dviselect even" foo.tex -LATEXMK(1) General Commands Manual LATEXMK(1) + -diagnostics + Print detailed diagnostics during a run. This may help for de- + bugging problems or to understand latexmk's behavior in diffi- + cult situations. -dvi Generate dvi version of document. @@ -577,27 +586,27 @@ LATEXMK(1) General Commands Manual LATEXMK(1) latexmk -e "$latex=q/latex %O -shell-escape %S/" file.tex - or - latexmk -e "$latex='latex %O -shell-escape %S'" file.tex - The last two examples will NOT work with UNIX/Linux command - shells. - (Note: the above examples show are to show how to use the -e to - specify initialization code to be executed. But the particular + 21 May 2019 9 - 17 March 2019 9 +LATEXMK(1) General Commands Manual LATEXMK(1) + or -LATEXMK(1) General Commands Manual LATEXMK(1) + latexmk -e "$latex='latex %O -shell-escape %S'" file.tex + The last two examples will NOT work with UNIX/Linux command + shells. + (Note: the above examples show are to show how to use the -e to + specify initialization code to be executed. But the particular effect can be achieved also by the use of the -latex option with less problems in dealing with quoting.) @@ -643,19 +652,10 @@ LATEXMK(1) General Commands Manual LATEXMK(1) default, which is the basename of the specified TeX file. (At present, STRING should not contain spaces.) - This is like the same option for current implementations of the - latex, pdflatex, etc, and the passing of this option to these - programs is part of latexmk's implementation of -jobname. - - There is one enhancement, that the STRING may contain the place- - holder '%A'. This will be substituted by the basename of the TeX - file. The primary purpose is when multiple files are specified - on the command line to latexmk, and you wish to use a jobname - with a different file-dependent value for each file. For - 17 March 2019 10 + 21 May 2019 10 @@ -664,8 +664,17 @@ LATEXMK(1) General Commands Manual LATEXMK(1) LATEXMK(1) General Commands Manual LATEXMK(1) - example, suppose you had .tex files test1.tex and test2.tex, and - you wished to compare the results of compilation by pdflatex and + This is like the same option for current implementations of the + latex, pdflatex, etc, and the passing of this option to these + programs is part of latexmk's implementation of -jobname. + + There is one enhancement, that the STRING may contain the place- + holder '%A'. This will be substituted by the basename of the TeX + file. The primary purpose is when multiple files are specified + on the command line to latexmk, and you wish to use a jobname + with a different file-dependent value for each file. For exam- + ple, suppose you had .tex files test1.tex and test2.tex, and you + wished to compare the results of compilation by pdflatex and those with xelatex. Then under a unix-type operating system you could use the command line @@ -711,23 +720,22 @@ LATEXMK(1) General Commands Manual LATEXMK(1) for latex) see the -pdflatex option. - -logfilewarninglist - -logfilewarnings After a run of (pdf)latex, give a list of warn- - ings about undefined citations and references (unless silent - mode is on). - - See also the $silence_logfile_warnings configuration variable. + 21 May 2019 11 - 17 March 2019 11 +LATEXMK(1) General Commands Manual LATEXMK(1) + -logfilewarninglist + -logfilewarnings After a run of (pdf)latex, give a list of warn- + ings about undefined citations and references (unless silent + mode is on). -LATEXMK(1) General Commands Manual LATEXMK(1) + See also the $silence_logfile_warnings configuration variable. -logfilewarninglist- @@ -777,23 +785,21 @@ LATEXMK(1) General Commands Manual LATEXMK(1) option turns off the default behavior. - -new-viewer- - The inverse of the -new-viewer option. It puts latexmk in its - normal behavior that in preview-continuous mode it checks for an - already-running previewer. - - + 21 May 2019 12 - 17 March 2019 12 +LATEXMK(1) General Commands Manual LATEXMK(1) -LATEXMK(1) General Commands Manual LATEXMK(1) + -new-viewer- + The inverse of the -new-viewer option. It puts latexmk in its + normal behavior that in preview-continuous mode it checks for an + already-running previewer. -nobibtex @@ -846,14 +852,8 @@ LATEXMK(1) General Commands Manual LATEXMK(1) turns them off. - -pdf Generate pdf version of document using pdflatex. (If you wish - to use lualatex or xelatex, you can use whichever of the options - -pdflua, -pdfxe, -lualatex or -xelatex applies.) To configure - latexmk to have such behavior by default, see the section on - - - 17 March 2019 13 + 21 May 2019 13 @@ -862,6 +862,10 @@ LATEXMK(1) General Commands Manual LATEXMK(1) LATEXMK(1) General Commands Manual LATEXMK(1) + -pdf Generate pdf version of document using pdflatex. (If you wish + to use lualatex or xelatex, you can use whichever of the options + -pdflua, -pdfxe, -lualatex or -xelatex applies.) To configure + latexmk to have such behavior by default, see the section on "Configuration/initialization (rc) files". @@ -913,13 +917,9 @@ LATEXMK(1) General Commands Manual LATEXMK(1) latexmk -pdf -pdflatex="pdflatex --shell-escape %O %S" foo.tex - The specification of the contents of the string are the same as - for the $pdflatex configuration variable. (The option -pdflatex - in fact sets the variable $pdflatex.) Depending on your - - 17 March 2019 14 + 21 May 2019 14 @@ -928,9 +928,12 @@ LATEXMK(1) General Commands Manual LATEXMK(1) LATEXMK(1) General Commands Manual LATEXMK(1) - operating system and the command-line shell you are using, you - may need to change the single quotes to double quotes (or some- - thing else). + The specification of the contents of the string are the same as + for the $pdflatex configuration variable. (The option -pdflatex + in fact sets the variable $pdflatex.) Depending on your operat- + ing system and the command-line shell you are using, you may + need to change the single quotes to double quotes (or something + else). To set the command for running latex (rather than the command for pdflatex) see the -latex option. @@ -964,9 +967,9 @@ LATEXMK(1) General Commands Manual LATEXMK(1) Given that CODE is some TeX code, this options sets that code to be executed before inputting source file. This only works if the command for invoking the relevant *latex is suitably config- - ured. See the documentation of the variable $pre_tex_cmd, and + ured. See the documentation of the variable $pre_tex_code, and the substitution strings %P and %U for more details. This op- - tion works by setting the variable $pre_tex_cmd. + tion works by setting the variable $pre_tex_code. See also the -usepretex option. @@ -979,13 +982,10 @@ LATEXMK(1) General Commands Manual LATEXMK(1) latexmk -usepretex='\AtBeginDocument{Message\par}' foo.tex - If you already have a suitable command configured, you only need - - latexmk -pretex='\AtBeginDocument{Message\par}' foo.tex - 17 March 2019 15 + 21 May 2019 15 @@ -994,6 +994,11 @@ LATEXMK(1) General Commands Manual LATEXMK(1) LATEXMK(1) General Commands Manual LATEXMK(1) + If you already have a suitable command configured, you only need + + latexmk -pretex='\AtBeginDocument{Message\par}' foo.tex + + -print=dvi, -print=ps, -print=pdf, -print=auto, Define which kind of file is printed. This option also ensures that the requisite file is made, and turns on printing. @@ -1043,15 +1048,10 @@ LATEXMK(1) General Commands Manual LATEXMK(1) -pv- Turn off -pv. - -pvc Run a file previewer and continually update the .dvi, .ps, - and/or .pdf files whenever changes are made to source files (see - the Description above). Which of these files is generated and - which is viewed is governed by the other options, and is the - same as for the -pv option. The preview-continuous option -pvc - 17 March 2019 16 + 21 May 2019 16 @@ -1060,6 +1060,11 @@ LATEXMK(1) General Commands Manual LATEXMK(1) LATEXMK(1) General Commands Manual LATEXMK(1) + -pvc Run a file previewer and continually update the .dvi, .ps, + and/or .pdf files whenever changes are made to source files (see + the Description above). Which of these files is generated and + which is viewed is governed by the other options, and is the + same as for the -pv option. The preview-continuous option -pvc can only work with one file. So in this case you will normally only specify one filename on the command line. It is also in- compatible with the -p and -pv options, so it turns these op- @@ -1109,24 +1114,23 @@ LATEXMK(1) General Commands Manual LATEXMK(1) Don't do timeout in pvc mode after inactivity. - -pvctimeoutmins=