From 9f8c30ed2974bbc9b7661ad6be74ed06d7b58e24 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 18 Apr 2020 20:56:25 +0000 Subject: latexmk (18apr20) git-svn-id: svn://tug.org/texlive/trunk@54786 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/latexmk.1 | 66 ++++++++++++++++++------ Master/texmf-dist/doc/man/man1/latexmk.man1.pdf | Bin 218127 -> 215231 bytes 2 files changed, 49 insertions(+), 17 deletions(-) (limited to 'Master/texmf-dist/doc/man') diff --git a/Master/texmf-dist/doc/man/man1/latexmk.1 b/Master/texmf-dist/doc/man/man1/latexmk.1 index 5c8ff04439e..2266b4df6e7 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 "26 December 2019" "" +.TH LATEXMK 1 "17 April 2020" "" .SH NAME latexmk \- generate LaTeX document .SH SYNOPSIS @@ -693,6 +693,32 @@ file. If you use the dependents list in a Makefile, the dummy rules work around errors the program \fImake\fR gives if you remove header files without updating the Makefile to match. +.TP +.B -MSWinBackSlash +This option only has an effect when \fIlatexmk\fR is running under +MS-Windows. This is that when \fIlatexmk\fR runs a command under +MS-Windows, the Windows standard directory separator "\\" is used to +separate directory components in a file name. Internally, \fIlatexmk\fR +uses "/" for the directory separator character, which is the character used +by Unix-like systems. + +This is the default behavior. However the default may have been overridden +by a configuration file (latexmkrc file) which sets +\fI$MSWin_back_slash=0\fR. + +.TP +.B -MSWinBackSlash- +This option only has an effect when \fIlatexmk\fR is running under +MS-Windows. This is that when \fIlatexmk\fR runs a command under +MS-Windows, the substitution of "\\" for the separator character between +directory components of a file name is \fInot\fR done. Instead the forward +slash "/" is used, the same as on Unix-like systems. This is acceptable in +most situations under MS-Windows, provided that filenames are properly +quoted, as \fIlatexmk\fR does by default. + +See the documentation for the configuration variable +\fI$MSWin_back_slash\fR for more details. + .TP .B -new-viewer When in continuous-preview mode, always start a new viewer to view the @@ -2677,20 +2703,26 @@ latex/pdflatex generates files to be read in on a later run.) .TP .B $MSWin_back_slash [1] This configuration variable only has an effect when \fIlatexmk\fR is -running under MS-Windows. It determines whether, when a command is -executed under MS-Windows, there should be substituted "\\" for the -separator character between components of a directory name. -Internally, \fIlatexmk\fR uses "/" for the directory separator -character, which is the character used by Unix-like systems. - -For many programs under MS-Windows, both "\\" and "/" are acceptable -as the directory separator character. But some programs only accept -"\\" on the command line. So for safety \fIlatexmk\fR makes a -translation, by default. -It is conceivable that under certain situations this is undesirable, -so the configuration can be changed. (A possible example might be -when some of the software is implemented using Cygwin, which provides -a Unix-like environment inside MS-Windows.) +running under MS-Windows. With the default value of 1 for this variable, +when a command is executed under MS-Windows, \fIlatexmk\fR substitutes "\\" +for the separator character between components of a directory name. +Internally, \fIlatexmk\fR uses "/" for the directory separator character, +which is the character used by Unix-like systems. + +For almost all programs and for almost all filenames under MS-Windows, both +"\\" and "/" are acceptable as the directory separator character, provided +at least that filenames are properly quoted. But it is possible that +programs exist that only accept "\\" on the command line, since that is the +standard directory separator for MS-Windows. So for safety \fIlatexmk\fR +makes the substitution from "/" to "\\", by default. + +However there are also programs on MS-Windows for which a back slash "\\" +is interpreted differently than as a directory separator; for these the +directory separator should be "/". Programs with this behavior include all +the *latex programs in the TeXLive implementation (but not the MiKTeX +implementation). Hence if you use TeXLive on MS-Windows, then +\fI$MSWin_back_slash\fR should be set to zero. + .TP .B $new_viewer_always [0] This variable applies to \fIlatexmk\fR \fBonly\fR in @@ -3181,7 +3213,7 @@ is set. (The foregoing explanation is rather complicated, because commands isn't set.) .TP -.B $xdvipdfmx ["xdvipdfmx -o %D %O %S"] +.B $xdvipdfmx ["xdvipdfmx -E -o %D %O %S"] The program to make a pdf file from an xdv file (used in conjunction with \fIxelatex\fR when \fI$pdf_mode\fR=5). @@ -3842,7 +3874,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.67). +(Version 4.69a). 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 dfbebf8e086..64953b74f1d 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 -- cgit v1.2.3