diff options
Diffstat (limited to 'Master/texmf-dist/doc/support/latexmk/latexmk.1')
-rw-r--r-- | Master/texmf-dist/doc/support/latexmk/latexmk.1 | 37 |
1 files changed, 36 insertions, 1 deletions
diff --git a/Master/texmf-dist/doc/support/latexmk/latexmk.1 b/Master/texmf-dist/doc/support/latexmk/latexmk.1 index c50258b3f28..ec5c9245afa 100644 --- a/Master/texmf-dist/doc/support/latexmk/latexmk.1 +++ b/Master/texmf-dist/doc/support/latexmk/latexmk.1 @@ -532,6 +532,12 @@ Note that simple "scalar" variables have names that begin with a $ character and array variables have names that begin with a @ character. Each statement ends with a semicolon. +Strings should be enclosed in single quotes. (You could use double +quotes, as in many programming languages. But then the \fIPerl\fR +programming language brings into play some special rules for +interpolating variables into strings. People not fluent in \fIPerl\fR +will want to avoid these complications.) + You can do much more complicated things, but for this you will need to consult a manual for the \fIPerl\fR programming language. @@ -582,6 +588,21 @@ to ps). .B %T The name of the primary tex file. .PP +If for some reason you need a literal % character in your string not +subject to the above rules, use a pair of these characters. Thus with +the command specification $ps_previewer = 'latex -ad=%%Sfile.ad %S', +the %%S will become %S when the command is executed, but the %S will +be replaced by the source filename, which in this case would be the +name of a postscript file to be viewed. +.PP +Appropriate quoting will be applied to the filename substitutions, so +you mustn't supply them yourself even if you the names of your have +spaces in them. (But if your TeX filenames have spaces in them, +beware that many versions of the TeX program cannot correctly handle +filenames containing spaces.) In case latexmk's quoting does not work +correctly on your system, you can turn it off -- see the documentation +for the variable \fI$quote_filenames\fR. +.PP The distinction between %B and %R needs a bit of care, since they are often the same, but not always. For example on a simple document, the basename of a bibtex run is the same as for the texfile. But in a @@ -1283,6 +1304,20 @@ The number of the signal that is sent to the pdf viewer when it is updated by sending a signal -- see \fI$ps_update_method\fR. The default value is the one appropriate for gv on a UNIX system. .TP +.B $quote_filenames [1] +This specifies whether substitutions for placeholders in command +specifications (as in \fI$pdflatex\fR) 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. +.PP +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 names contain spaces. Latexmk's +quoting only ensures that such filenames are correctly treated by the +operating system in passing arguments to programs.) +.TP .B $sleep_time [2] The time to sleep (in seconds) between checking for source file changes when running the \fB-pvc\fR option. @@ -1539,7 +1574,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 collins at node phys.psu.edu). -(Version 4.05). +(Version 4.05a). Released version can be obtained from CTAN: <http://www.tug.org/tex-archive/support/latexmk/>, and from the |