diff -Nru latexmk-4.24/CHANGES latexmk-4.35/CHANGES
--- latexmk-4.24/CHANGES	2011-05-07 22:32:50.000000000 +0000
+++ latexmk-4.35/CHANGES	2012-11-11 08:39:34.000000000 +0000
@@ -257,3 +257,141 @@
     aren't in the current directory (by use of kpsewhich).  This was
     previously done for bibtex but not biber.
 
+From v. 4.24 to v. 4.25
+    Fix to evade apparent cygwin bug that prevented system
+       rc-file from being read.
+    Diagnostic for unreadable rc-file.
+    Add deps output file to target part of dependency information
+
+From v. 4.25 to v. 4.26
+    Make compatible with biber 0.9.4.
+    Fix some bugs in error reporting.
+
+From v. 4.26 to v. 4.27a
+    Deal with problem that making of ps or pdf file via a temporary
+       file fails if the command making it has no %D placeholder
+    Add png to list of graphics extensions for pdflatex
+    Add -norc option that prevents auto reading of rc files.
+    Options -aux-directory -output-directory like those of (pdf)latex, 
+       to set the output directories of (pdf)latex.  (-aux-directory
+       is MiKTeX only).  Corresponding configuration variables, and
+       placeholders for command specification.
+
+From v. 4.27a to 4.28
+    Correct handling of situations where some file(s) needed by bibtex
+       (or biber) don't exist.  Previously latexmk incorrectly stopped
+       with an error message instead of continuing.
+
+From v. 4.28 to 4.28a
+    Correct duplicate making of view file
+
+From v. 4.28a to 4.28c
+    When biber doesn't find the bib file, latexmk treats this as a
+       warning rather than a fatal error, so further processing
+       can continue normally.
+    Latexmk now parses correctly error messages from biber v. 0.9.7.
+
+From v. 4.28c to 4.29a
+    Latexmk now works with the feynmp package and mpost,
+       provided a suitable custom dependency is defined.  (See the
+       example latexmkrc fragment mpost_latexmkrc in the
+       example_rcfiles directory in the latexmk distribution.)
+    If output directory is set, arrange that dvips can find files
+      there.
+    In  searching for cus-deps that can make a missing file, look in
+      $out_dir.
+    Solves problem that sometimes dvips and dvipdf weren't run when
+      they should have been.  (The problem only arose with certain 
+      changes in eps files being made within a minute of the previous
+      run.)
+
+From v. 4.29a to 4.30a
+    Fix use of bibtex so that it works correctly when $aux_dir and/or
+       $out_dir are set.
+    Use OS-dependent search path separator when when manipulating
+       TEXINPUTS, etc. Then use of -output-directory and
+       -aux-directory options should work on MSWin systems.
+    Documentation of $search_path_separator variable.
+
+From v. 4.30a to 4.31
+    Add -M -MP and -MF options, like gcc.
+    Recorder option is now on by default.
+    Add options reproducing most options of (pdf)latex (list from both
+       TeXLive and MikTeX versions).  
+       Options NOT implemented by latexmk at all:
+           -ini and -initialize  since they refer to operations
+                                 not supported by latexmk
+           -includedirectory=dir its support needs extra code in
+                                 latexmk, not currently written
+      Options differently processed by latexmk:
+           -help
+           -version
+           -quiet
+      Options that are passed to (pdf)latex but that also have special
+      processing by latexmk
+           -aux-directory=dir
+           -output-directory=dir
+           -recorder
+    Add -latexoption=... option to latexmk
+    Add -xelatex option for use of xelatex
+    Change OS-X default for pdf previewer command to open
+    Command specification string can start with "include routine" to
+       invoke a Perl subroutine instead of an external cmd.
+    Viewers are detached by default.  (The start keyword is now normally
+      superfluous in command specifications.)
+    Keyword nostart added in command specification.
+    Add configuration variables $compiling_cmd, $success_cmd,
+      $failure_cmd.  These specify external commands (if any) to be
+      executed during latexmk's continuous preview mode at the
+      following points: $compiling_cmd at the start of compilation,
+      $success_cmd at the end of a successful compilation, and
+      $failure_cmd at the end of an unsuccessful compilation.  They
+      can be used, for example, to show the progress of compilation by
+      setting the titles of editor and/or previewer windows.
+    If aux and/or output directories are specified but don't exist,
+      make them.
+    Remove excessive repetition of tests for changes of source files
+      (improves performance of latexmk in some situations).
+    Documentation improvements.
+    Minor bug corrections.
+
+From v. 4.31 to 4.33a
+   Improve operation under MSWindows: substitute "\" for "/" for
+     directory separator in command lines, deal consistently with
+     directory separator, which can be both "\" and "/".
+   Correct some bugs that interfered with use of auxiliary directory
+     and output directory for files generated by (pdf)latex,
+     especially with MiKTeX.
+   Fix problems caused because in the log and fls files MiKTeX writes
+     absolute path for many filenames at and below current directory,
+     and is inconsistent in its use of "/" vs. "\" as directory
+     separator. 
+   Add $dvipdf_silent_switch configuration variable.
+   Improve handling of errors in (pdf)latex; previously latexmk would
+     give up processing in some situations continuing is correct.
+   Documentation corrections/improvements.
+   Reduce number of warnings in silent operation.
+   Cure slowness of v. 4.33 under Cygwin.
+
+From v. 4.33a to 4.33b
+   Documentation improvements.
+   Improve text displayed by using -showextraoptions option.
+
+From v. 4.33b to 4.33c
+   Correct infinite loop when maximum passes through latex/pdflatex
+      are exceeded
+
+From v. 4.33c to 4.34
+   Correct non-optimality that if (pdf)latex reads a file only after
+      it has been written in the same run, the file is not a true
+      source file, but nevertheless latexmk treats it as a source
+      file.  Thus changes in the file sometimes caused latexmk to make
+      unnecessary (but otherwise innocuous) extra runs of (pdflatex).
+
+From v. 4.34 to 4.35
+   Correct bug in parsing fls file from native MS-Windows LaTeX (e.g.,
+      MiKTeX) when latexmk is run under cygwin.  (The names of some
+      files used by latexmk incorrectly contained a CR character.)
+   Correct bug that when the --gg option is used, the rule database
+      from the old fdb file was used instead of being cleared.
+
diff -Nru latexmk-4.24/INSTALL latexmk-4.35/INSTALL
--- latexmk-4.24/INSTALL	2011-05-07 22:33:58.000000000 +0000
+++ latexmk-4.35/INSTALL	2012-11-11 08:35:56.000000000 +0000
@@ -1,6 +1,6 @@
             INSTALLING latexmk
             ==================
-      (Version 4.24, 7 May 2011)
+      (Version 4.35, 11 November 2012)
 
             John Collins
             Physics Department
diff -Nru latexmk-4.24/README latexmk-4.35/README
--- latexmk-4.24/README	2011-05-07 22:34:26.000000000 +0000
+++ latexmk-4.35/README	2012-11-12 13:43:10.000000000 +0000
@@ -1,5 +1,5 @@
-Latexmk, version 4.24, 7 May 2011
----------------------------------
+Latexmk, version 4.35, 11 November 2012
+---------------------------------------
 
 Latexmk completely automates the process of generating a LaTeX
 document.  Essentially, it is a highly specialized cousin of the
@@ -92,14 +92,17 @@
 
 John Collins
 ---------------------------- "latexmk -h" ----------------------------
-Latexmk 4.24: Automatic LaTeX document generation routine
+Latexmk 4.35: Automatic LaTeX document generation routine
 
 Usage: latexmk [latexmk_options] [filename ...]
 
   Latexmk_options:
-   -bibtex         - use bibtex when needed (default)
-   -bibtex-        - never use bibtex
-   -bibtex-cond    - use bibtex when needed, but only if the bib files exist
+   -aux-directory=dir or -auxdir=dir 
+                 - set name of directory for auxiliary files (aux, log)
+                 - Currently this only works with MiKTeX
+   -bibtex       - use bibtex when needed (default)
+   -bibtex-      - never use bibtex
+   -bibtex-cond  - use bibtex when needed, but only if the bib files exist
    -bm <message> - Print message across the page when converting to postscript
    -bi <intensity> - Set contrast or intensity of banner
    -bs <scale> - Set scale for banner
@@ -140,10 +143,17 @@
    -l-    - turn off -l
    -latex=<program> - set program used for latex.
                       (replace '<program>' by the program name)
+   -latexoption=<option> - add the given option to the (pdf)latex command
+   -M     - Show list of dependent files after processing
+   -MF file - Specifies name of file to receives list dependent files
+   -MP    - List of dependent files includes phony target for each source file.
    -new-viewer    - in -pvc mode, always start a new viewer
    -new-viewer-   - in -pvc mode, start a new viewer only if needed
    -nobibtex      - never use bibtex
    -nodependents  - Do not show list of dependent files after processing
+   -norc          - omit automatic reading of system, user and project rc files
+   -output-directory=dir or -outdir=dir
+                  - set name of directory for output files
    -pdf   - generate pdf by pdflatex
    -pdfdvi - generate pdf by dvipdf
    -pdflatex=<program> - set program used for pdflatex.
@@ -164,12 +174,17 @@
                 on force mode, so errors do not cause latexmk to stop.)
             (Side effect: turn off ordinary preview mode.)
    -pvc-  - turn off -pvc
+   -quiet    - silence progress messages from called programs
    -r <file> - Read custom RC file
+               (N.B. This file could override options specified earlier
+               on the command line.)
    -recorder - Use -recorder option for (pdf)latex
                (to give list of input and output files)
    -recorder- - Do not use -recorder option for (pdf)latex
    -rules    - Show list of rules after processing
    -rules-   - Do not show list of rules after processing
+   -showextraoptions  - Show other allowed options that are simply passed
+               as is to latex and pdflatex
    -silent   - silence progress messages from called programs
    -time     - show CPU time used
    -time-    - don't show CPU time used
@@ -183,11 +198,15 @@
    -view=none    - no viewer is used
    -view=ps      - viewer is for ps
    -view=pdf     - viewer is for pdf
+   -xelatex      - use xelatex for processing files to pdf
+
    filename = the root filename of LaTeX document
 
 -p, -pv and -pvc are mutually exclusive
 -h, -c and -C override all other options.
 -pv and -pvc require one and only one filename specified
 All options can be introduced by '-' or '--'.  (E.g., --help or -help.)
-Contents of RC file specified by -r overrides options specified
-  before the -r option on the command line
+ 
+In addition, latexmk recognizes many other options that are passed to
+latex and/or pdflatex without interpretation by latexmk.  Run latexmk
+with the option -showextraoptions to see a list of these
diff -Nru latexmk-4.24/debian/changelog latexmk-4.35/debian/changelog
--- latexmk-4.24/debian/changelog	2012-12-27 17:24:14.000000000 +0000
+++ latexmk-4.35/debian/changelog	2012-12-27 17:10:50.000000000 +0000
@@ -1,3 +1,141 @@
+latexmk (1:4.35-0ubuntu1) raring; urgency=low
+
+  * New upstream release.
+  * Upstream ChangeLog:
+    - 4.35 dated 11 November 2012.
+      * Corrects bug that fls file is incorrectly parsed when using a
+        combination of cygwin and a native MS-Windows TeX program.
+      * Corrects bug that old dependency information was retained when using
+        the --gg option. 
+    - 4.34 dated 1 October 2012.
+      * Corrects non-optimality that latexmk may do extra runs of (pdf)latex
+        when a file is read and written during a run of (pdf)latex, but the
+        file is only read after being written. 
+    - 4.33c dated 19 August 2012.
+      * Corrects infinite loop in error messages when the maximum number of
+        passes through latex/pdflatex is exceeded. 
+    - 4.33b dated 12 August 2012.
+      * Documentation improvements, including documentation of the many
+        options for the (pdf)latex programs that are supported by latexmk. 
+    - 4.33a dated 8 August 2012.
+      * Fix slowness of v. 4.33 under Cygwin. 
+    - 4.33 dated 6 August 2012.
+      * Improve operation under MSWindows: substitute "\" for "/" for
+        directory separator in command lines, deal consistently with
+        directory separator, which can be both "\" and "/".
+      * Correct some bugs that interfered with use of auxiliary directory
+        and output directory for files generated by (pdf)latex, especially
+        with MiKTeX.
+      * Fix problems caused because in the log and fls files MiKTeX writes
+        absolute path for many filenames at and below current directory, and
+        is inconsistent in its use of "/" vs. "\" as directory separator.
+      * Add $dvipdf_silent_switch configuration variable.
+      * Improve handling of errors in (pdf)latex; previously latexmk would
+        give up processing in some situations continuing is correct.
+      * Documentation corrections/improvements.
+      * Reduce number of warnings in silent operation. 
+    - 4.31 dated 30 March 2012.
+      * Implement most options allowed by latex and pdflatex.
+      * Add -M -MP and -MF options, like gcc.
+      * Recorder option is now on by default.
+      * Add -latexoption=... option to latexmk.
+      * Add -xelatex option for use of xelatex.
+      * Change OS-X default for pdf previewer command to open.
+      * Command specification string can start with "include routine" to
+        invoke a Perl subroutine instead of an external cmd.
+      * Viewers are detached by default. (The start keyword is now normally
+        superfluous in command specifications.)
+      * Keyword nostart added in command specification.
+      * Add configuration variables $compiling_cmd, $success_cmd,
+        $failure_cmd. These specify external commands (if any) to be
+        executed during latexmk's continuous preview mode at the following
+        points: $compiling_cmd at the start of compilation, $success_cmd at
+        the end of a successful compilation, and $failure_cmd at the end of
+        an unsuccessful compilation. They can be used, for example, to show
+        the progress of compilation by setting the titles of editor and/or
+        previewer windows.
+      * If aux and/or output directories are specified but don't exist, make
+        them.
+      * Remove excessive repetition of tests for changes of source files
+        (improves performance of latexmk in some situations).
+      * Documentation improvements.
+      * Minor bug corrections. 
+    - 4.30a dated 9 December 2011.
+      * Fix use of bibtex so that it works correctly when $aux_dir and/or
+        $out_dir are set.
+      * Use OS-dependent search path separator when when manipulating
+        TEXINPUTS, etc. Then use of -output-directory and -aux-directory
+        options should work correctly on MSWin systems.
+      * Documentation of $search_path_separator variable.
+      * Correct some bugs in v. 4.30 that manifested themselves under MSWin
+        especially with Cygwin. 
+    - 4.29a dated 7 December 2011.
+      * Latexmk now works with the feynmp package and mpost, provided a
+        suitable custom dependency is defined. (See the example latexmkrc
+        fragment mpost_latexmkrc in the example_rcfiles directory in the
+        latexmk distribution.)
+      * If output directory is set, arrange that dvips can find files there.
+      * In searching for cus-deps that can make a missing file, look in
+        $out_dir. 
+    - 4.28c dated 1 December 2011.
+      * When biber doesn't find the bib file, latexmk treats this as a
+        warning rather than a fatal error, so further processing can
+        continue normally.
+      * Latexmk now parses correctly error messages from biber v. 0.9.7. 
+    - 4.28a dated 28 November 2011.
+      * Correct handling of situations where some file(s) needed by bibtex
+        (or biber) don't exist. Previously latexmk incorrectly stopped with
+        an error message instead of continuing.
+      * Correct duplicate invocations of dvipdf, ps2pdf 
+    - 4.27a dated 10 October 2011.
+      * Deal with problem that making of ps or pdf file via a temporary file
+        fails if the command making it has no %D placeholder
+      * Add png to list of graphics extensions for pdflatex
+      * Add -norc option that prevents auto reading of rc files.
+      * Options -aux-directory -output-directory like those of (pdf)latex,
+        to set the output directories of (pdf)latex. (-aux-directory is
+        MiKTeX only). Corresponding configuration variables, and
+        placeholders for command specification. 
+    - 4.26 dated 9 August 2011.
+      * Make compatible with biber 0.9.4.
+      * Fix some bugs in error reporting. 
+    - 4.25 dated 7 July 2011.
+      * Fix to evade apparent cygwin bug that prevented system rc-file from
+        being read.
+      * Diagnostic for unreadable rc-file.
+      * Add deps output file to target part of dependency information. 
+  * debian/patches:
+    - Refreshed
+
+ -- Matthieu Baerts (matttbe) <matttbe@ubuntu.com>  Thu, 27 Dec 2012 17:50:41 +0100
+
+latexmk (1:4.24-1.2ubuntu1) raring; urgency=low
+
+  * debian/patches/rc-system-files.patch:
+    - This file has a wrong name according to debian/patches/series
+
+ -- Matthieu Baerts (matttbe) <matttbe@ubuntu.com>  Thu, 27 Dec 2012 17:45:42 +0100
+
+latexmk (1:4.24-1.2) unstable; urgency=low
+
+  [ Antonio Ospite ]
+  * Added debian/watch file
+
+ -- Matthieu Baerts (matttbe) <matttbe@ubuntu.com>  Thu, 27 Dec 2012 17:15:34 +0100
+
+latexmk (1:4.24-1.1) unstable; urgency=low
+
+  * Non-maintainer upload.
+  * Remove deprecated dpatch and upgrade to packaging format "3.0 quilt".
+  * Update to Standards-Version to 3.9.3 and debhelper to 9.
+  * Add required build-arch and build-indep targets to rules file.
+  * Fix old-fsf-address-in-copyright-file (Lintian).
+  * Fix copyright-refers-to-symlink-license (Lintian).
+  * Fix capitalization-error-in-description LaTeX (Lintian).
+  * Fix no-homepage-field (Lintian).
+
+ -- Jari Aalto <jari.aalto@cante.net>  Sun, 15 Apr 2012 20:25:54 +0300
+
 latexmk (1:4.24-1) unstable; urgency=low
 
   * New upstream release (Closes: #564199).
diff -Nru latexmk-4.24/debian/compat latexmk-4.35/debian/compat
--- latexmk-4.24/debian/compat	2012-12-27 17:24:14.000000000 +0000
+++ latexmk-4.35/debian/compat	2012-12-27 16:11:50.000000000 +0000
@@ -1 +1 @@
-5
+9
diff -Nru latexmk-4.24/debian/control latexmk-4.35/debian/control
--- latexmk-4.24/debian/control	2012-12-27 17:24:14.000000000 +0000
+++ latexmk-4.35/debian/control	2012-12-27 16:27:54.000000000 +0000
@@ -1,9 +1,11 @@
 Source: latexmk
 Section: tex
 Priority: optional
-Build-Depends: debhelper (>= 5.0.0), dpatch
-Maintainer: OHURA Makoto <ohura@debian.org>
-Standards-Version: 3.9.2
+Build-Depends: debhelper (>= 9)
+Maintainer: Ubuntu Developers <ubuntu-devel-discuss@lists.ubuntu.com>
+XSBC-Original-Maintainer: OHURA Makoto <ohura@debian.org>
+Standards-Version: 3.9.3
+Homepage: http://www.phys.psu.edu/~collins/software/latexmk-jcc
 
 Package: latexmk
 Architecture: all
@@ -14,6 +16,6 @@
  Latexmk runs LaTeX the correct number of times to resolve cross references,
  etc; it also runs auxiliary programs (bibtex, makeindex if necessary, and
  dvips and/or a previewer as requested). It has a number of other useful
- capabilities, for example to start a previewer and then run latex whenever the
+ capabilities, for example to start a previewer and then run LaTeX whenever the
  source files are updated, so that the previewer gives an up-to-date view of
  the document.
diff -Nru latexmk-4.24/debian/copyright latexmk-4.35/debian/copyright
--- latexmk-4.24/debian/copyright	2012-12-27 17:24:14.000000000 +0000
+++ latexmk-4.35/debian/copyright	2012-12-27 16:11:50.000000000 +0000
@@ -28,10 +28,5 @@
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 
-You should have received a copy of the GNU General Public License
-along with this program; if not, write to the Free Software
-Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
-
-
 On Debian GNU/Linux systems, the complete text of the GNU General
-Public License can be found in `/usr/share/common-licenses/GPL'.
+Public License can be found in `/usr/share/common-licenses/GPL-2'.
diff -Nru latexmk-4.24/debian/patches/00list latexmk-4.35/debian/patches/00list
--- latexmk-4.24/debian/patches/00list	2012-12-27 17:24:14.000000000 +0000
+++ latexmk-4.35/debian/patches/00list	1970-01-01 00:00:00.000000000 +0000
@@ -1 +0,0 @@
-rc_system_files
diff -Nru latexmk-4.24/debian/patches/rc-system-files.patch latexmk-4.35/debian/patches/rc-system-files.patch
--- latexmk-4.24/debian/patches/rc-system-files.patch	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/debian/patches/rc-system-files.patch	2012-12-27 17:10:50.000000000 +0000
@@ -0,0 +1,18 @@
+From: Florian Ragwitz <rafl@debian.org>
+Subject: add /etc/LatexMk to @rc_system_files
+
+
+Index: latexmk/latexmk.pl
+===================================================================
+--- latexmk.orig/latexmk.pl	2012-12-27 17:50:00.211349000 +0100
++++ latexmk/latexmk.pl	2012-12-27 17:55:02.858109192 +0100
+@@ -895,7 +895,8 @@
+     ## /usr/local/lib/latexmk/LatexMk is put in the list for
+     ## compatibility with older versions of latexmk.
+     @rc_system_files = 
+-     ( '/opt/local/share/latexmk/LatexMk', 
++     ( '/etc/LatexMk',
++       '/opt/local/share/latexmk/LatexMk', 
+        '/usr/local/share/latexmk/LatexMk',
+        '/usr/local/lib/latexmk/LatexMk' );
+ 
diff -Nru latexmk-4.24/debian/patches/rc_system_files.dpatch latexmk-4.35/debian/patches/rc_system_files.dpatch
--- latexmk-4.24/debian/patches/rc_system_files.dpatch	2012-12-27 17:24:14.000000000 +0000
+++ latexmk-4.35/debian/patches/rc_system_files.dpatch	1970-01-01 00:00:00.000000000 +0000
@@ -1,20 +0,0 @@
-#! /bin/sh /usr/share/dpatch/dpatch-run
-## rc_system_files.dpatch by Florian Ragwitz <rafl@debian.org>
-##
-## All lines beginning with `## DP:' are a description of the patch.
-## DP: add /etc/LatexMk to @rc_system_files
-
-@DPATCH@
-
---- latexmk-307a.orig/latexmk.pl	2006-06-12 01:39:17.959196512 +0200
-+++ latexmk-307a/latexmk.pl	2006-06-12 01:39:56.378355912 +0200
-@@ -537,7 +537,8 @@
-     ## /usr/local/lib/latexmk/LatexMk is put in the list for
-     ## compatibility with older versions of latexmk.
-     @rc_system_files = 
--     ( '/opt/local/share/latexmk/LatexMk', 
-+     ( '/etc/LatexMk',
-+       '/opt/local/share/latexmk/LatexMk', 
-        '/usr/local/share/latexmk/LatexMk',
-        '/usr/local/lib/latexmk/LatexMk' );
- 
diff -Nru latexmk-4.24/debian/patches/series latexmk-4.35/debian/patches/series
--- latexmk-4.24/debian/patches/series	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/debian/patches/series	2012-12-27 16:11:50.000000000 +0000
@@ -0,0 +1 @@
+rc-system-files.patch
diff -Nru latexmk-4.24/debian/rules latexmk-4.35/debian/rules
--- latexmk-4.24/debian/rules	2012-12-27 17:24:14.000000000 +0000
+++ latexmk-4.35/debian/rules	2012-12-27 16:11:50.000000000 +0000
@@ -1,28 +1,21 @@
 #!/usr/bin/make -f
 
-clean: clean1 unpatch
-clean1:
+clean:
 	dh_testdir
 	dh_testroot
 	rm -f install-stamp
 	dh_clean
 
-build: patch
+build-arch: build
+build-indep: build
 
-patch: patch-stamp
-patch-stamp:
-	dpatch apply-all
-	touch patch-stamp
-
-unpatch:
-	dpatch deapply-all
-	rm -rf patch-stamp debian/patched
+build:
 
 install: install-stamp
 install-stamp:
 	dh_testdir
 	dh_testroot
-	dh_clean -k
+	dh_prep
 	dh_installdirs
 	install -m755 $(CURDIR)/latexmk.pl    $(CURDIR)/debian/latexmk/usr/bin/latexmk
 	install -m644 $(CURDIR)/debian/config $(CURDIR)/debian/latexmk/etc/LatexMk
@@ -45,4 +38,4 @@
 
 binary: binary-arch binary-indep
 
-.PHONY: clean build install binary-indep binary-arch binary patch unpatch
+.PHONY: clean build install binary-indep binary-arch binary
diff -Nru latexmk-4.24/debian/source/format latexmk-4.35/debian/source/format
--- latexmk-4.24/debian/source/format	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/debian/source/format	2012-12-27 17:24:14.596466830 +0000
@@ -0,0 +1 @@
+3.0 (quilt)
diff -Nru latexmk-4.24/debian/watch latexmk-4.35/debian/watch
--- latexmk-4.24/debian/watch	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/debian/watch	2012-12-27 16:40:11.000000000 +0000
@@ -0,0 +1,8 @@
+version=3
+
+# In the pattern below the first digit is isolated so to have a dotted
+# version number in the debian packages, the upstream uses this dotted
+# form in the changelog but removes the dot in the file names.
+http://www.phys.psu.edu/~collins/software/latexmk-jcc/versions.html \
+  latexmk-([\d])([\d]+[a-z]*).zip \
+  debian uupdate
diff -Nru latexmk-4.24/example_rcfiles/README latexmk-4.35/example_rcfiles/README
--- latexmk-4.24/example_rcfiles/README	2010-02-18 14:46:30.000000000 +0000
+++ latexmk-4.35/example_rcfiles/README	2012-08-04 08:20:16.000000000 +0000
@@ -20,3 +20,16 @@
    examples.  (The file Latexmk321jTeXShop.zip is the one you want.)
    It shows how to use glossaries, epstopdf, pdftricks and pst-pdf.
 
+4. I have generally arranged for filenames to be quoted on command
+   lines, e.g., 
+
+       system( "makeindex -o \"$_[0].lnd\" \"$_[0].ldx\"" );
+
+   In many cases the quotes may be omitted, as in 
+
+       system( "makeindex -o $_[0].lnd $_[0].ldx" );
+
+   But it is preferable to leave the quotes in, since they provide
+   safety against special characters in filenames.  The double quotes
+   appear not to cause problems in all situations that I have tried.
+
diff -Nru latexmk-4.24/example_rcfiles/Sweave_latexmkrc latexmk-4.35/example_rcfiles/Sweave_latexmkrc
--- latexmk-4.24/example_rcfiles/Sweave_latexmkrc	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/example_rcfiles/Sweave_latexmkrc	2011-12-14 16:57:18.000000000 +0000
@@ -0,0 +1,57 @@
+# This is to allow the use of Sweave with latexmk, and in addition to
+#    make synctex work properly with it.  
+# SEE THE IMPORTANT NOTES below.
+#
+# Sweave (http://www.stat.uni-muenchen.de/~leisch/Sweave/) is a tool
+# that allows to embed the R code for complete data analyses in latex
+# documents.  The user edits a file with an extension like .Rnw, and
+# the .tex file is generated from this.
+#
+# Four problems are solved by the code below:
+# 1. Generate the .tex file automatically.
+# 2. Arrange not to re-run unmodified chunks of R code.  (A pure
+#    optimization.)
+# 3. Fix the execution environment for (pdf)latex.
+# 4. Deal with synctex: If the user wants to use synctex
+#    (www.tug.org/TUGboat/tb29-3/tb93laurens.pdf) to synchronize the
+#    pdf file with the source file, by default synctex does the
+#    synchronization with the generated .tex file, not the original 
+#    source file.  Postprocessing of the .synctex.gz file is necessary
+#    to fix this.
+#
+# The following version was worked out and  tested by a user (thanks
+# to Brian Beitzel) on MSWindows.  It will need at least one change to
+# work on UNIX-like operating systems (which include Linux and OS-X).
+
+# N.B. ===> IMPORTANT NOTES <===
+#
+# 1. The patchDVI package for R needs to be installed from R-Forge, as
+#    follows:
+#
+#  install.packages("patchDVI", repos="http://R-Forge.R-project.org")
+#
+# 2. In all Sweave (.Rnw) documents, the following lines must be included:
+#
+#         \usepackage{Sweave}
+#         \SweaveOpts{concordance=TRUE}
+
+
+# Fix the pdflatex command to run Sweave first, and to postprocess the
+#  .synctex.gz file:
+# !!!!! THIS IS THE VERSION FOR MS-WINDOWS, with && as a command
+# separator
+$pdflatex = "cmd /c "
+       . "Rscript -e \"library(cacheSweave); setCacheDir(getwd()); "
+       . "Sweave('%S', driver=cacheSweaveDriver)\""
+       . " && R CMD pdflatex -interaction=nonstopmode -synctex=1 %O %B.tex"
+       . " && Rscript -e "
+       . "\"library('patchDVI');patchSynctex('%B.synctex.gz')\"";
+#
+# !!!TO FIX THIS FOR Linux/OS-X/UNIX, try uncommenting the following:
+#  (this version hasn't been tested).
+#$pdflatex = "Rscript -e \"library(cacheSweave); setCacheDir(getwd()); "
+#       . "Sweave('%S', driver=cacheSweaveDriver)\""
+#       . " ; R CMD pdflatex -interaction=nonstopmode -synctex=1 %O %B.tex"
+#       . " ; Rscript -e "
+#       . "\"library('patchDVI');patchSynctex('%B.synctex.gz')\"";
+
diff -Nru latexmk-4.24/example_rcfiles/TeX4ht-latexmkrc latexmk-4.35/example_rcfiles/TeX4ht-latexmkrc
--- latexmk-4.24/example_rcfiles/TeX4ht-latexmkrc	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/example_rcfiles/TeX4ht-latexmkrc	2012-10-02 12:10:34.000000000 +0000
@@ -0,0 +1,33 @@
+# Sometime in the future, latexmk will directly support the use of
+# TeX4ht to obtain html from tex.  Meanwhile, here is how to use
+# latexmk with TeX4ht.  There is a script htlatex supplied by the
+# TeX4ht package: It simply runs latex a fixed number of times and
+# then the programs tex4ht and t4ht.  To use latexmk to get optimal
+# processing use the following instructions (under UNIX-like operating
+# systems, e.g., OS-X and linux):
+#
+#  1. Put the scripts htlatexonly and myhtlatex2 somewhere in the PATH
+#     for executables (and make sure they have excutable permissions
+#     set).
+#  2. Set up an initialization file for latexmk like this one.
+#
+#  3. To process file.tex to make file.html, run
+#
+#             myhtlatex2 file
+#
+
+# Since these instructions use scripts that are UNIX shell scripts,
+# the instructions work as written for UNIX-like operating
+# systems. Users of other operating systems will have to adjust them
+# and modify the scripts suitably.
+
+
+warn "latexmkrc for htlatex\n";
+
+$dvi_mode = 1;
+$pdf_mode = 0;
+$quote_filenames = 0;
+$latex = 'htlatexonly %S';
+
+$clean_ext .= ' 4ct 4tc idv lg tmp xref';
+$clean_full_ext .= ' css html';
diff -Nru latexmk-4.24/example_rcfiles/asymptote_latexmkrc latexmk-4.35/example_rcfiles/asymptote_latexmkrc
--- latexmk-4.24/example_rcfiles/asymptote_latexmkrc	2010-08-07 01:57:30.000000000 +0000
+++ latexmk-4.35/example_rcfiles/asymptote_latexmkrc	2012-08-04 07:32:54.000000000 +0000
@@ -21,7 +21,7 @@
 
 # The following lines are taken from the documentation for V. 2.03 of
 # asymptote:
-sub asy {return system("asy '$_[0]'");}
+sub asy {return system("asy \"$_[0]\"");}
 add_cus_dep("asy","eps",0,"asy");
 add_cus_dep("asy","pdf",0,"asy");
 add_cus_dep("asy","tex",0,"asy");
diff -Nru latexmk-4.24/example_rcfiles/glossary_latexmkrc latexmk-4.35/example_rcfiles/glossary_latexmkrc
--- latexmk-4.24/example_rcfiles/glossary_latexmkrc	2010-10-29 16:06:15.000000000 +0000
+++ latexmk-4.35/example_rcfiles/glossary_latexmkrc	2012-08-04 08:02:12.000000000 +0000
@@ -10,18 +10,18 @@
 
 # 1. For glossaries using glossary package
 
-add_cus_dep('glo', 'gls', 0, 'makeglo2gls');
+add_cus_dep( 'glo', 'gls', 0, 'makeglo2gls' );
 sub makeglo2gls {
-    system("makeindex -s '$_[0]'.ist -t '$_[0]'.glg -o '$_[0]'.gls '$_[0]'.glo");
+    system("makeindex -s \"$_[0].ist\" -t \"$_[0].glg\" -o \"$_[0].gls\" \"$_[0].glo\"" );
 }
 
 
 
 # 2. For acronyms using glossary package:
 
-add_cus_dep('acr', 'acn', 0, 'makeacr2acn');
+add_cus_dep( 'acr', 'acn', 0, 'makeacr2acn' );
 sub makeacr2acn {
-    system("makeindex -s '$_[0]'.ist -t '$_[0]'.alg -o '$_[0]'.acn '$_[0]'.acr");
+    system( "makeindex -s \"$_[0].ist\" -t \"$_[0].alg\" -o \"$_[0].acn\" \"$_[0].acr\"" );
 }
 
 
@@ -31,8 +31,8 @@
 # 4. If you use the glossaries package and have the makeglossaries
 #    script installed, then you can do something simpler:
 
-   add_cus_dep('glo', 'gls', 0, 'makeglossaries');
+   add_cus_dep( 'glo', 'gls', 0, 'makeglossaries' );
    sub makeglossaries {
-      system("makeglossaries $_[0]");
+      system( "makeglossaries \"$_[0]\"" );
    }
 
diff -Nru latexmk-4.24/example_rcfiles/mpost_latexmkrc latexmk-4.35/example_rcfiles/mpost_latexmkrc
--- latexmk-4.24/example_rcfiles/mpost_latexmkrc	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/example_rcfiles/mpost_latexmkrc	2012-08-04 08:12:58.000000000 +0000
@@ -0,0 +1,26 @@
+# This shows how to use mpost, as used by the feynmp package.
+# The feynmp package writes files with extension .mp, e.g., foo.mp,
+# and these are to be converted by mpost to make postscript files,
+# e.g., foo.1, which are later read in by dvips.
+#
+# A more complicated custom dependency is needed than normal, because:
+# if the output directory ($out_dir) or the auxiliary directory
+# ($out_dir) is set, mpost doesn't put its output in the correct
+# place.
+
+add_cus_dep( 'mp', '1', 0, 'mpost' );
+
+
+sub mpost {
+    my $file = $_[0];
+    my ($name, $path) =  fileparse( $file );
+    my $return = system "mpost \"$file\"";
+        # Fix the problem that mpost puts its output and log files
+        # in the current directory, not in the auxiliary directory
+        # (which is often the same as the output directory):
+    if ( ($path ne '') && ($path ne '.\\') && ($path ne './') ) {
+        foreach ( "$name.1", "$name.log" ) { move $_, $aux_dir; }
+    }
+    return $return;
+}
+
diff -Nru latexmk-4.24/example_rcfiles/pdflatexmkrc latexmk-4.35/example_rcfiles/pdflatexmkrc
--- latexmk-4.24/example_rcfiles/pdflatexmkrc	2008-05-06 17:09:10.000000000 +0000
+++ latexmk-4.35/example_rcfiles/pdflatexmkrc	2012-08-04 08:09:12.000000000 +0000
@@ -6,72 +6,72 @@
 
 # Custom dependency for glossary/glossaries package
 # if you make custom glossaries you may have to add items to the @cus_dep_list and corresponding sub-routines
-add_cus_dep('glo', 'gls', 0, 'makeglo2gls');
-		sub makeglo2gls {
-				system("makeindex -s $_[0].ist -t $_[0].glg -o $_[0].gls $_[0].glo");
-		}
+add_cus_dep( 'glo', 'gls', 0, 'makeglo2gls' );
+sub makeglo2gls {
+    system( "makeindex -s \"$_[0].ist\" -t \"$_[0].glg\" -o \"$_[0].gls\" \"$_[0].glo\"" );
+}
 # The glossaries package, with the [acronym] option, produces a .acn file when processed with (xe/pdf)latex and
 # then makeindex to process the .acn into .acr and finally runs of (xe/pdf)latex to read in the .acr file. Unfortunately
 # the glossary package does just the reverse; i.e. (xe/pdf)latex processing produces a .acr files and makeindex then
 # is used to convert the .acr file to a .acn file which is then ... . This dependency assumes the glossaries package.
-add_cus_dep('acn', 'acr', 0, 'makeacn2acr');
-		sub makeacn2acr {
-				system("makeindex -s $_[0].ist -t $_[0].alg -o $_[0].acr $_[0].acn");
-		}
+add_cus_dep( 'acn', 'acr', 0, 'makeacn2acr' );
+sub makeacn2acr {
+    system( "makeindex -s \"$_[0].ist\" -t \"$_[0].alg\" -o \"$_[0].acr\" \"$_[0].acn\"" );
+}
 # for glossary package (Sigh...) --- they can co-exist!		
-add_cus_dep('acr', 'acn', 0, 'makeacr2acn');
-		sub makeacr2acn {
-				system("makeindex -s $_[0].ist -t $_[0].alg -o $_[0].acn $_[0].acr");
-		}
+add_cus_dep( 'acr', 'acn', 0, 'makeacr2acn' );
+sub makeacr2acn {
+    system( "makeindex -s \"$_[0].ist\" -t \"$_[0].alg\" -o \"$_[0].acn\" \"$_[0].acr\"" );
+}
 # example of an added custom glossary type that is used in some of the glossary/glossaries example files:
 # this is for the new glossary type command \newglossary[nlg]{notation}{not}{ntn}{Notation} from the glossaries package
 # NOTE: the glossary package uses a very different command: the <in-ext> and <out-ext>
 # are reversed in the calling sequence :-(
-add_cus_dep('ntn', 'not', 0, 'makentn2not');
-		sub makentn2not {
-				system("makeindex -s $_[0].ist -t $_[0].nlg -o $_[0].not $_[0].ntn");
-		}
+add_cus_dep( 'ntn', 'not', 0, 'makentn2not' );
+sub makentn2not {
+    system("makeindex -s \"$_[0].ist\" -t \"$_[0].nlg\" -o \"$_[0].not\" \"$_[0].ntn\"" );
+}
 # for the	glossary package (Sigh...) --- they can co-exist!
-add_cus_dep('not', 'ntn', 0, 'makenot2ntn');
-		sub makenot2ntn {
-				system("makeindex -s $_[0].ist -t $_[0].nlg -o $_[0].ntn $_[0].not");
-		}
+add_cus_dep( 'not', 'ntn', 0, 'makenot2ntn' );
+sub makenot2ntn {
+    system("makeindex -s \"$_[0].ist\" -t \"$_[0].nlg\" -o \"$_[0].ntn\" \"$_[0].not\"" );
+}
 
 # dependencies for custom indexes using the index package
 # examples for sample.tex for index package:
- add_cus_dep('adx', 'and', 0, 'makeadx2and');
- 		sub makeadx2and {
- 				system("makeindex -o $_[0].and $_[0].adx");
- 		}
- add_cus_dep('ndx', 'nnd', 0, 'makendx2nnd');
- 		sub makendx2nnd {
- 				system("makeindex -o $_[0].nnd $_[0].ndx");
- 		}
- add_cus_dep('ldx', 'lnd', 0, 'makeldx2lnd');
- 		sub makeldx2lnd {
- 				system("makeindex -o $_[0].lnd $_[0].ldx");
- 		}
+ add_cus_dep( 'adx', 'and', 0, 'makeadx2and' );
+sub makeadx2and {
+    system( "makeindex -o \"$_[0].and\" \"$_[0].adx\"" );
+}
+add_cus_dep( 'ndx', 'nnd', 0, 'makendx2nnd' );
+sub makendx2nnd {
+    system( "makeindex -o \"$_[0].nnd\" \"$_[0].ndx\"" );
+}
+add_cus_dep( 'ldx', 'lnd', 0, 'makeldx2lnd' );
+sub makeldx2lnd {
+    system( "makeindex -o \"$_[0].lnd\" \"$_[0].ldx\"" );
+}
 
 # Custom dependency and function for nomencl package
-add_cus_dep('nlo', 'nls', 0, 'makenlo2nls');
-		sub makenlo2nls {
-				system("makeindex -s nomencl.ist -o $_[0].nls $_[0].nlo");
-		}
+add_cus_dep( 'nlo', 'nls', 0, 'makenlo2nls' );
+sub makenlo2nls {
+    system( "makeindex -s nomencl.ist -o \"$_[0].nls\" \"$_[0].nlo\"" );
+}
 
 # Custom dependency and function(s) for epstopdf package
 
 # FOR USERS OF epstopf v1.4 and before: should also work with v1.5 and later
 # note: you may get extras runs if you use the .eps extension in the \includgraphics command
 # deletes an outdated pdf-image, and triggers a pdflatex-run
-add_cus_dep('eps', 'pdf', 0, 'cus_dep_delete_dest');
+add_cus_dep( 'eps', 'pdf', 0, 'cus_dep_delete_dest' );
 
 # FOR USERS OF epstopdf v1.5 and later only:
 # load it as \usepackage[update,prepend]{epstopdf}
 # detects an outdated pdf-image, and triggers a pdflatex-run
-#add_cus_dep('eps', 'pdf', 0, 'cus_dep_require_primary_run');
+#add_cus_dep( 'eps', 'pdf', 0, 'cus_dep_require_primary_run' );
 
 # Custom dependecy to convert tif to png
-add_cus_dep('tif', 'png', 0, 'maketif2png');
-		sub maketif2png {
-				system("convert $_[0].tif $_[0].png");
-		}
+add_cus_dep( 'tif', 'png', 0, 'maketif2png' );
+sub maketif2png {
+    system( "convert \"$_[0].tif\" \"$_[0].png\"" );
+}
diff -Nru latexmk-4.24/example_rcfiles/sagetex_latexmkrc latexmk-4.35/example_rcfiles/sagetex_latexmkrc
--- latexmk-4.24/example_rcfiles/sagetex_latexmkrc	2010-02-18 14:43:43.000000000 +0000
+++ latexmk-4.35/example_rcfiles/sagetex_latexmkrc	2012-08-04 08:15:44.000000000 +0000
@@ -14,8 +14,8 @@
 # changed. 
 
 
-add_cus_dep('sage', 'sout', 0, 'makesout');
+add_cus_dep( 'sage', 'sout', 0, 'makesout' );
 $hash_calc_ignore_pattern{'sage'} = '^( _st_.goboom|print .SageT)';
 sub makesout {
-   system("sage '$_[0].sage'");
+   system( "sage \"$_[0].sage\"" );
 }
\ No newline at end of file
diff -Nru latexmk-4.24/example_rcfiles/sweave_latexmkrc latexmk-4.35/example_rcfiles/sweave_latexmkrc
--- latexmk-4.24/example_rcfiles/sweave_latexmkrc	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/example_rcfiles/sweave_latexmkrc	2011-12-14 19:57:18.000000000 +0000
@@ -0,0 +1,57 @@
+# This is to allow the use of Sweave with latexmk, and in addition to
+#    make synctex work properly with it.  
+# SEE THE IMPORTANT NOTES below.
+#
+# Sweave (http://www.stat.uni-muenchen.de/~leisch/Sweave/) is a tool
+# that allows to embed the R code for complete data analyses in latex
+# documents.  The user edits a file with an extension like .Rnw, and
+# the .tex file is generated from this.
+#
+# Four problems are solved by the code below:
+# 1. Generate the .tex file automatically.
+# 2. Arrange not to re-run unmodified chunks of R code.  (A pure
+#    optimization.)
+# 3. Fix the execution environment for (pdf)latex.
+# 4. Deal with synctex: If the user wants to use synctex
+#    (www.tug.org/TUGboat/tb29-3/tb93laurens.pdf) to synchronize the
+#    pdf file with the source file, by default synctex does the
+#    synchronization with the generated .tex file, not the original 
+#    source file.  Postprocessing of the .synctex.gz file is necessary
+#    to fix this.
+#
+# The following version was worked out and  tested by a user (thanks
+# to Brian Beitzel) on MSWindows.  It will need at least one change to
+# work on UNIX-like operating systems (which include Linux and OS-X).
+
+# N.B. ===> IMPORTANT NOTES <===
+#
+# 1. The patchDVI package for R needs to be installed from R-Forge, as
+#    follows:
+#
+#  install.packages("patchDVI", repos="http://R-Forge.R-project.org")
+#
+# 2. In all Sweave (.Rnw) documents, the following lines must be included:
+#
+#         \usepackage{Sweave}
+#         \SweaveOpts{concordance=TRUE}
+
+
+# Fix the pdflatex command to run Sweave first, and to postprocess the
+#  .synctex.gz file:
+# !!!!! THIS IS THE VERSION FOR MS-WINDOWS, with && as a command
+# separator
+$pdflatex = "cmd /c "
+       . "Rscript -e \"library(cacheSweave); setCacheDir(getwd()); "
+       . "Sweave('%S', driver=cacheSweaveDriver)\""
+       . " && R CMD pdflatex -interaction=nonstopmode -synctex=1 %O %B.tex"
+       . " && Rscript -e "
+       . "\"library('patchDVI');patchSynctex('%B.synctex.gz')\"";
+#
+# !!!TO FIX THIS FOR Linux/OS-X/UNIX, try uncommenting the following:
+#  (this version hasn't been tested).
+#$pdflatex = "Rscript -e \"library(cacheSweave); setCacheDir(getwd()); "
+#       . "Sweave('%S', driver=cacheSweaveDriver)\""
+#       . " ; R CMD pdflatex -interaction=nonstopmode -synctex=1 %O %B.tex"
+#       . " ; Rscript -e "
+#       . "\"library('patchDVI');patchSynctex('%B.synctex.gz')\"";
+
diff -Nru latexmk-4.24/example_rcfiles/xelatex_latexmkrc latexmk-4.35/example_rcfiles/xelatex_latexmkrc
--- latexmk-4.24/example_rcfiles/xelatex_latexmkrc	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/example_rcfiles/xelatex_latexmkrc	2012-08-04 08:14:40.000000000 +0000
@@ -0,0 +1,20 @@
+# This shows how to use xelatex (http://en.wikipedia.org/wiki/XeTeX)
+# with latexmk.  Xelatex uses Unicode and "supporting modern font
+# technologies such as OpenType or Apple Advanced Typography.
+#
+#   WARNING: latexmk.pl is changing, and plans to have internal
+#     support for xelatex.
+#
+# Since xelatex only produces pdf files, it is a replacement for
+# pdflatex.  To make it your default typesetting engine within latexmk
+# you will not only need to set the $pdflatex variable to require the
+# use of xelatex, but also to turn on production of pdf files and to
+# turn off the production of dvi and ps files, as in the following
+# code: 
+
+
+$pdflatex = 'xelatex %O %S';
+$pdf_mode = 1;
+$postscript_mode = $dvi_mode = 0;
+
+
diff -Nru latexmk-4.24/extra-scripts/htlatexonly latexmk-4.35/extra-scripts/htlatexonly
--- latexmk-4.24/extra-scripts/htlatexonly	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/extra-scripts/htlatexonly	2012-10-02 12:10:10.000000000 +0000
@@ -0,0 +1,10 @@
+#!/bin/sh
+
+# Replacement for latex executable when latexmk is used for htlatex
+# See TeX4ht-latexmkrc in the example-rcfiles directory of the latexmk
+# distribution for how to use this.
+#
+# This is a shell script suitable for UNIX-like operating systems (including
+# OS-X and linux, and presumably Cygwin under MS-Windows).
+
+latex --recorder $5 '\makeatletter\def\HCode{\futurelet\HCode\HChar}\def\HChar{\ifx"\HCode\def\HCode"##1"{\Link##1}\expandafter\HCode\else\expandafter\Link\fi}\def\Link#1.a.b.c.{\g@addto@macro\@documentclasshook{\RequirePackage[#1,html]{tex4ht}}\let\HCode\documentstyle\def\documentstyle{\let\documentstyle\HCode\expandafter\def\csname tex4ht\endcsname{#1,html}\def\HCode####1{\documentstyle[tex4ht,}\@ifnextchar[{\HCode}{\documentstyle[tex4ht]}}}\makeatother\HCode '$2'.a.b.c.\input ' $1
diff -Nru latexmk-4.24/extra-scripts/myhtlatex2 latexmk-4.35/extra-scripts/myhtlatex2
--- latexmk-4.24/extra-scripts/myhtlatex2	1970-01-01 00:00:00.000000000 +0000
+++ latexmk-4.35/extra-scripts/myhtlatex2	2012-10-02 12:10:24.000000000 +0000
@@ -0,0 +1,19 @@
+#!/bin/sh
+
+# This is a replacement for htlatex from the TeX4ht package. It allows
+# latexmk to be used to do the latex part of the processing.  
+# See TeX4ht-latexmkrc in the example-rcfiles directory of the latexmk
+# distribution for how to use this.
+#
+# This is a shell script suitable for UNIX-like operating systems (including
+# OS-X and linux, and presumably Cygwin under MS-Windows).
+
+if [[ $# -lt 1  ||  $1 == "--help"  ||  $1 == "-help"  ||  $1 == "-h" ]]; then
+   echo "Convert tex file to html.  Simplest usage"
+   echo "    myhtlatex2 file"
+   exit 1
+fi
+
+latexmk $1
+tex4ht -f/$1  -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/$3
+t4ht -f/$1 $4 ## -d~/WWW/temp/ -m644 
diff -Nru latexmk-4.24/latexmk.1 latexmk-4.35/latexmk.1
--- latexmk-4.24/latexmk.1	2011-05-07 22:34:19.000000000 +0000
+++ latexmk-4.35/latexmk.1	2012-11-11 08:36:10.000000000 +0000
@@ -1,4 +1,4 @@
-.TH LATEXMK 1L "7 May 2011" ""
+.TH LATEXMK 1L "11 November 2012" ""
 .SH NAME
 latexmk \- generate LaTeX document
 .SH SYNOPSIS
@@ -24,9 +24,9 @@
 .PP
 \fILatexmk\fR determines which are the source files by examining the
 log file.  (Optionally, it also examines the list of input and output
-files generated by the \fI-recorder\fR option of modern versions of
+files generated by the \fB-recorder\fR option of modern versions of
 \fIlatex\fR and \fIpdflatex\fR.  See the documentation for the
-\fI-recorder\fR option of \fIlatexmk\fR below.)
+\fB-recorder\fR option of \fIlatexmk\fR below.)
 When \fIlatexmk\fR is run, it examines properties of the
 source files, and if any have been changed since the last document
 generation, \fIlatexmk\fR will run the various LaTeX processing
@@ -63,8 +63,16 @@
 .PP
 \fILatexmk\fR has the ability to print a banner in gray diagonally
 across each page when making the postscript file.  It can also, if
-needed, call an external program to do other postprocessing on the
-generated files.
+needed, call an external program to do other postprocessing on
+generated dvi and postscript files.  (See the options \fB-dF\fR and
+\fB-pF\fR, and the documentation for the \fI$dvi_filter\fR and
+\fI$ps_filter\fR configuration variables.)  These capabilities are
+leftover from older versions of \fIlatexmk\fR.  More flexibility can
+be obtained in current versions, since the command strings for running
+latex, pdflatex, etc can now be configured to run multiple commands.
+This also extends the possibility of postprocessing generated files to
+pdf files.
+files.
 .PP
 \fILatexmk\fR is highly configurable, both from the command line and
 in configuration files, so that it can accommodate a wide variety of
@@ -89,8 +97,28 @@
 information.
 
 .SH LATEXMK OPTIONS AND ARGUMENTS ON COMMAND LINE
-(All options can be introduced by single or double "-" characters,
-e.g., "latexmk -help" or "latexmk --help".)
+In general the command line to invoke \fIlatexmk\fR has the form
+
+	latexmk [options] [file]
+
+All options can be introduced by single or double "-" characters,
+e.g., "latexmk -help" or "latexmk --help".
+
+\fBNote\fR: In addition to the options in the list below,
+\fIlatexmk\fR recognizes almost all the options recognized by the
+\fIlatex\fR and \fIpdflatex\fR programs in one of both of their
+current TeXLive and MiKTeX implementations.  Some of the options for
+these programs also trigger special action or behavior by
+\fIlatexmk\fR, in which case they are in this list.  Otherwise, they
+are just passed through to a called \fIlatex\fR or \fIpdflatex\fR
+program. Run \fIlatexmk\fR with the \fB-showextraoptions\fR to get a
+list of the options that \fIlatexmk\fR accepts and that are simply
+passed through to \fIlatex\fR or \fIpdflatex\fR.  See also the
+explanation of the \fB-showextraoptions\fR option for more
+information. 
+
+\fBDefinitions of options and arguments\fR
+
 .TP
 .B file
 One or more files can be specified.  If no files are specified,
@@ -107,6 +135,23 @@
 
 then \fIlatexmk\fR will operate on the file "foo.tex".  
 .TP
+
+.B -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 \fB-aux-directory\fR option of (pdf)latex,
+which currently is only implemented on the MiKTeX version of
+(pdf)latex.
+
+See also the \fB-outdir\fR/\fB-output-directory\fR options, and the
+\fI$aux_dir\fR, \fI$out_dir\fR, and \fI$search_path_separator\fR
+configuration variables of \fIlatexmk\fR.  In particular, see the
+documentation of \fI$out_dir\fR for some complications on what
+directory names are suitable.
+
+.TP
+
 .B -bibtex 
 When the source file uses bbl files for bibliography, run bibtex or
 biber as needed to regenerate the bbl files.  
@@ -172,8 +217,8 @@
 .B -c
 Clean up (remove) all regeneratable files generated by \fIlatex\fR and
 \fIbibtex\fR or \fIbiber\fR except dvi, postscript and pdf.  These files are a
-combination of log files, aux files, latexmk's database file of source
-file information, 
+combination of log files, aux files, \fIlatexmk\fR's database file of
+source file information, 
 and those with extensions
 specified in the \fI@generated_exts\fR configuration variable.  In addition,
 files with extensions by the \fI$clean_ext\fR configuration variable are
@@ -233,30 +278,32 @@
 \fIlatexmk\fR can determine them.
 
 By default the list of dependent files is sent to stdout (i.e.,
-normally to the screen unless you've redirected latexmk's output).
-But you can set the filename where the list is sent by the
-\fI-deps-out=\fR option.
+normally to the screen unless you've redirected \fIlatexmk\fR's
+output). But you can set the filename where the list is sent by the
+\fB-deps-out=\fR option.
 
 See the section "USING \fIlatexmk\fR WITH \fImake\fR" for
 an example of how to use a dependency list with \fImake\fR.  
 
 Users familiar with GNU \fIautomake\fR and \fIgcc\fR will find that
-the \fI-deps\fR option is very similar in its purpose and results to
-the \fI-M\fR option to \fIgcc\fR.
+the \fB-deps\fR option is very similar in its purpose and results to
+the \fB-M\fR option to \fIgcc\fR.  (In fact, \fIlatexmk\fR also has
+options \fB-M\fR, \fB-MF\fR, and \fB-MP\fR options that behave like
+those of \fIgcc\fR.)
 .TP
 .B  -dependents
-Equivalent to \fI-deps\fR.
+Equivalent to \fB-deps\fR.
 .TP
 .B   -deps-  
 Do not show a list of dependent files after processing.  (This is the
 default.) 
 .TP
 .B  -dependents-
-Equivalent to \fI-deps-\fR.
+Equivalent to \fB-deps-\fR.
 .TP
 .B   -deps-out=FILENAME  
 Set the filename to which the list of dependent files is written.  If
-the FILENAME argument is omitted or set to '-', then the output is
+the FILENAME argument is omitted or set to "-", then the output is
 sent to stdout. 
 
 Use of this option also turns on the output of the list of dependent
@@ -270,7 +317,7 @@
 
 Example usage: To use dviselect to select only the even pages of the dvi file:
 
-	latexmk -dF 'dviselect even' foo.tex
+	latexmk -dF "dviselect even" foo.tex
 .TP
 .B -diagnostics
 Print detailed diagnostics during a run.  This may help for debugging
@@ -356,6 +403,16 @@
 .B -h, -help
 Print help information.
 .TP
+.B -jobname=STRING
+Set the basename of output files(s) to STRING, instead of the default,
+which is the basename of the specified TeX file.
+
+This is like the same option for current implementations of the
+\fIlatex\fR and \fIpdflatex\fR, and the passing of this option to
+these programs is part of \fIlatexmk\fR's implementation of
+\fB-jobname\fR.
+
+.TP
 .B -l
 Run in landscape mode, using the landscape mode for the previewers and
 the dvi to postscript converters.  This option is not normally needed
@@ -365,6 +422,40 @@
 .B -l-
 Turn off \fB-l\fR.
 .TP
+.B -latex="COMMAND"
+This sets the string specifying the command to run latex, and is
+typically used to add desired options.  Since the string normally
+contains spaces, it should be quoted, e.g.,
+
+     latex -latex="latex --shell-escape %O %S"  foo.tex
+
+The specification of the contents of the string are the same as for
+the \fI$latex\fR configuration variable.  Depending on your
+operating 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 pdflatex (rather than the command for
+latex) see the \fB-pdflatex\fR option.
+
+Note that the effect of this option can also be achieved by using
+the \fB-e\fR option with a suitable line of Perl code to set the
+\fI$latex\fR variable.  See the explanation of the \fB-e\fR option.
+.TP
+.B -M
+Show list of dependent files after processing.  This is equivalent to
+the \fB-deps\fR option.
+.TP
+.B -MF file
+If a list of dependents is made, the \fB-MF\fR specifies the file to
+write it to. 
+.TP
+.B -MP
+If a list of dependents is made, includes phony target for each source
+file.  If you use the dependents list in a Makefile, the dummy rules
+work around errors make gives if you remove header files without
+updating the Makefile to match.
+.TP
 .B -new-viewer
 When in continuous-preview mode, always start a new viewer to view the
 generated file.  By default, \fIlatexmk\fR will, in continuous-preview
@@ -389,6 +480,31 @@
 \fIbibtex\fR or \fIbiber\fR, which would result in overwriting of the
 bbl files. 
 .TP
+.B -norc
+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.
+.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
+(pdf)latex, i.e., MiKTeX and TeXLive.  It may not be present in other
+versions. 
+
+See also the \fB-auxdir\fR/\fB-aux-directory\fR options, and the
+\fI$aux_dir\fR, \fI$out_dir\fR, and \fI$search_path_separator\fR
+configuration variables of \fIlatexmk\fR.  In particular, see the
+documentation of \fI$out_dir\fR for some complications on what
+directory names are suitable.
+
+.TP
+
 .B -p
 Print out the document.  By default it is
 the generated postscript file that is printed.  But you can use the
@@ -409,7 +525,9 @@
 so it turns them off. 
 .TP
 .B -pdf
-Generate pdf version of document using pdflatex.
+Generate pdf version of document using pdflatex.  (See the
+\fB-xelatex\fR if you wish to use \fIxelatex\fR to make your pdf
+file(s).) 
 .TP
 .B -pdfdvi
 Generate pdf version of document from the dvi file, by default using dvipdf.
@@ -424,6 +542,26 @@
 It may get overridden if some other option requires the generation of
 a pdf file.)
 .TP
+.B -pdflatex="COMMAND"
+This sets the string specifying the command to run pdflatex, and is
+typically used to add desired options.  Since the string normally
+contains spaces, it should be quoted, e.g.,
+
+     latex -pdf -pdflatex="pdflatex --shell-escape %O %S"  foo.tex
+
+The specification of the contents of the string are the same as for
+the \fI$pdflatex\fR configuration variable.  Depending on your
+operating 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 \fB-latex\fR option.
+
+Note that the effect of this option can also be achieved by using
+the \fB-e\fR option with a suitable line of Perl code to set the
+\fI$pdflatex\fR variable. See the explanation of the \fB-e\fR option.
+.TP
 .B -print=dvi, -print=ps, -print=pdf
 Define which kind of file is printed.  This option also ensures that
 the requisite file is made, and turns on printing.  The default is to
@@ -491,11 +629,11 @@
 bug in gv that causes an error when the newly updated pdf file is
 read.)  Many other previewers will need a manual update.
 
-Important note: the acroread program on MS-Windows locks the pdf file,
+\fBImportant note\fR: the acroread program on MS-Windows locks the pdf file,
 and prevents new versions being written, so it is a bad idea to use
-acroread to view pdf files in preview-continuous mode.  It is better
-to use a dvi or ps viewer, as set by one of the \fB-view=dvi\fR and
-\fB-view=ps\fR options.
+acroread to view pdf files in preview-continuous mode.  
+It is better to use a different viewer: SumatraPDF and gsview are
+good possibilities. 
 
 There are some other methods for arranging an update, notably useful
 for many versions of xdvi and xpdf.  These are best set in
@@ -558,6 +696,39 @@
 Do not show a list of \fIlatexmk\fR's rules and dependencies after
 processing.  (This is the default.)
 .TP
+.B -showextraoptions
+Show the list of extra \fIlatex\fR and \fIpdflatex\fR options that
+\fIlatexmk\fR recognizes.  These are options for the \fIlatex\fR and
+\fIpdflatex\fR that \fIlatexmk\fR recognizes, but simply passes
+through to these programs when they are run.  These options are
+(currently) a combination of those allowed by the TeXLive and MiKTeX
+implementations.  (If a particular option is given to \fIlatexmk\fR
+but is not handled by the particular implementation of \fIlatex\fR or
+\fIpdflatex\fR that is being used, that program will probably give an
+error message.)  These options are very numerous, but are not listed
+in this documentation because they have no effect on \fIlatexmk\fR's
+actions.
+
+There are a few options (\fB-includedirectory=dir\fR,
+\fB-initialize\fR, \fB-ini\fR) that are not recognized, either because
+they don't fit with \fIlatexmk\fR's intended operations, or because
+they need special processing by \fIlatexmk\fR that isn't implemented
+(at least, not yet).
+
+There are also options that are accepted by \fIlatex\fR etc, but
+instead trigger actions by \fIlatexmk\fR: \fB-help\fR,
+\fB-version\fR. 
+
+Finally, there are certain options for \fIlatex\fR and \fIpdflatex\fR
+(e.g., \fB-recorder\fR) that trigger special actions or behavior by
+\fIlatexmk\fR itself as well as being passed in some form to the
+called \fIlatex\fR and \fIpdflatex\fR program, or that affect other
+programs as well.  These options do have entries in this
+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 -silent
 Run commands silently, i.e., with options that reduce the amount of
 diagnostics generated.  For example, with the default settings, the
@@ -569,9 +740,9 @@
 To change the options used to make the commands run silently, you need
 to configure \fIlatexmk\fR with changed values of its configuration
 variables, the relevant ones being \fI$bibtex_silent_switch\fR,
-\fI$biber_silent_switch\fR,
-\fI$dvips_silent_switch\fR, \fI$latex_silent_switch\fR, and
-\fI$pdflatex_silent_switch\fR.
+\fI$biber_silent_switch\fR, \fI$dvipdf_silent_switch\fR, 
+\fI$dvips_silent_switch\fR, \fI$latex_silent_switch\fR, 
+\fI$makeindex_silent_switch\fR, and \fI$pdflatex_silent_switch\fR.
 .TP
 .B -use-make
 When after a run of \fIlatex\fR or \fIpdflatex\fR, there are warnings
@@ -604,6 +775,14 @@
 Set the kind of file used when previewing is requested (e.g., by the
 \fB-pv\fR or \fB-pvc\fR switches).  The default is to view the "highest"
 kind of requested file (in the order dvi, ps, pdf).  
+.TP
+.B -xelatex
+Use xelatex.  That is, use xelatex to process the source file(s) to
+pdf (in place of pdflatex).  This option is exactly equivalent to
+specifying the following sequence of options: 
+
+     -pdflatex="xelatex %O %S" -pdf -dvi- -ps
+
 .PP
 The preview-continuous option \fB-pvc\fR can only work with one file.
 So in this case you will normally only specify one filename on
@@ -647,16 +826,19 @@
    "/usr/local/lib/latexmk/LatexMk".
    On a MS-WINDOWS system it looks for "C:\\latexmk\\LatexMk".
    On a cygwin system (i.e., a MS-Windows system in which perl is
-   that of cygwin), \fIlatexmk\fR reads for the first it finds of
+that of cygwin), \fIlatexmk\fR reads for the first it finds of
    "/cygdrive/c/latexmk/LatexMk",
    "/opt/local/share/latexmk/LatexMk",
    "/usr/local/share/latexmk/LatexMk",
    "/usr/local/lib/latexmk/LatexMk".
 .PP
 2) The user's RC file, "$HOME/.latexmkrc", if it exists.  Here $HOME
-is the value of the environment variable HOME.  On UNIX and clones
-(including LINUX), this variable is set by the system; on MS-Windows,
-the user may choose to set it.
+is the user's home directory.  [\fILatexmk\fR determines the user's
+home directory as follows:  It is the value of the environment variable
+HOME, if this variable exists, which normally is the case on UNIX-like
+systems (including LINUX and OS-X).  Otherwise the environment
+variable USERPROFILE is used, if it exists, which normally is the case
+on MS-Windows systems. Otherwise a blank string is used instead of $HOME.]
 .PP
 3) The RC file in the current working directory.  This file can be
 named either "latexmkrc" or ".latexmkrc", and the first of these to be
@@ -679,6 +861,12 @@
 \fB-e\fR option, which allows initialization code to be specified in
 \fIlatexmk\fR's command line.
 
+\fI
+For possible examples of code for in an RC file, see the directory
+example_rcfiles in the distribution of latexmk (e.g., at
+http://ctan.tug.org/tex-archive/support/latexmk/example_rcfiles).
+\fR
+
 .SH HOW TO SET VARIABLES IN INITIALIZATION FILES
 .PP
 The important variables that can be configured are described in the
@@ -759,6 +947,20 @@
 .TP
 .B %T
 The name of the primary tex file.
+.TP
+.B %Y
+Name of directory for auxiliary output files (see the configuration
+variable \fI$aux_dir\fR).  A directory separation character ('/') is
+appended if \fI$aux_dir\fR is non-empty and does not end in a suitable
+character, with suitable characters being those appropriate to UNIX
+and MS-Windows, i.e., ':', '/' and '\\'. 
+.TP
+.B %Z
+Name of directory for output files (see the configuration
+variable \fI$out_dir\fR).  A directory separation character ('/') is
+appended if \fI$out_dir\fR is non-empty and does not end in a suitable
+character, with suitable characters being those appropriate to UNIX
+and MS-Windows, i.e., ':', '/' and '\\'. 
 .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
@@ -768,7 +970,7 @@
 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
+you mustn't supply them yourself even if the names of your files 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
@@ -828,6 +1030,9 @@
 should be enclosed in double quotes, as in
 .PP
      $lpr_pdf = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p %S';
+     $pdf_previewer = 'start "c:/Program Files/SumatraPDF/SumatraPDF.exe" %O %S';
+     $pdf_previewer = 'start "c:/Program Files/SumatraPDF (x86)/SumatraPDF.exe" %O %S';
+
 .PP
 (Note about the above example: Forward slashes are equivalent to
 backslashes in filenames under MS-Windows, provided that the filename
@@ -836,6 +1041,14 @@
 about the rules for dealing with forward slashes in strings in the
 Perl language.)
 
+\fBCommand names under Cygwin\fR: If latexmk is executed by Cygwin's
+perl, \fI be particularly certain that pathnames in commands have
+\fBforward\fI slashes\fR not the usual backslashes for the separator
+of pathname components.  See the above examples.  Backslashes often
+get misinterpreted by the Unix shell used by Cygwin's Perl to execute
+external commands.  Forward slashes don't suffer from this problem,
+and (when quoted, as above) are equally acceptable to MS-Windows.
+
 \fBUsing MS-Windows file associations\fR: A useful trick under modern
 versions of MS-Windows (e.g., WinXP) is to use just the 
 command 'start' by itself:
@@ -844,7 +1057,11 @@
 .PP
 Under recent versions of MS-Windows, this will cause to be run
 whatever program the system has associated with dvi files.  (The same
-applies for a postscript viewer and a pdf viewer.)  
+applies for a postscript viewer and a pdf viewer.)  But note that this
+trick is not always suitable for the pdf previwer, if your system has
+acroread for the default pdf viewer.  As explained elsewhere, acroread
+under MS-Windows does not work well with \fIlatex\fR and
+\fIlatexmk\fR, because acroread locks the pdf file.
 
 \fBNot using a certain command\fR: If a command is not to be run, the
 command name NONE is used, as in
@@ -864,6 +1081,17 @@
      $latex = 'latex --src-specials %O %S';
 .PP
 
+\fBRunning a subroutine instead of an external command\fR: Use a
+specification starting with "internal", as in 
+.PP
+     $latex = 'internal mylatex %O %S';
+     sub mylatex {
+         my @args = @_;
+         # Possible preprocessing here
+         return system 'latex', @args;
+     }
+.PP
+
 \fBAdvanced tricks\fR: Normally one specifies a single command for the
 commands invoked by \fIlatexmk\fR.  Naturally, if there is some
 complicated additional processing you need to do in your special
@@ -878,10 +1106,20 @@
 
      $pdflatex = 'pdflatex --shell-escape %O %S; pst2pdf_for_latexmk %B';
 
-This definition assumes you are using a UNIX-like system, so that the
+This definition assumes you are using a UNIX-like system (which
+includes Linux and OS-X), so that the
 two commands to be run are separated by the semicolon in the middle of
-the string.  
+the string.
+
+If you are using MS-Windows, you would replace the above line by 
+
+   $pdflatex = 'cmd /c pdflatex --shell-escape %O %S'
+               . '&& pst2pdf_for_latexmk %B';
 
+Here, the UNIX command separator ; is replaced by &&.  In addition,
+there is a problem that some versions of \fIPerl\fR on MS-Windows do
+not obey the command separator; this problem is overcome by explicitly
+invoking the MS-Windows command-line processor \fIcmd.exe\fR.
 
 .SH LIST OF CONFIGURATION VARIABLES USABLE IN INITIALIZATION FILES
 .PP
@@ -904,6 +1142,34 @@
 file is created. 
 
 .TP
+.B $auto_rc_use [1]
+Whether to automatically read the standard initialization (rc) files,
+which are the system RC file, the user's RC file, and the RC file in
+the current directory.  The command line option \fB-norc\fR can be
+used to turn this setting off.  Each RC file could also turn this
+setting off, i.e., it could set \fI$auto_rc_use\fR to zero to prevent
+automatic reading of the later RC files.
+
+This variable does not affect the reading of RC files specified on the
+command line by the \fB-r\fR option.
+
+.TP
+.B $aux_dir [""]
+The directory in which auxiliary files (aux, log, etc) are to be
+written by a run of (pdf)latex.  If this variable is not set, but 
+\fI$out_dir\fR is set, then \fI$aux_dir\fR is set to \fI$out_dir\fR,
+which is the directory to which general output files are to be
+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
+MiKTeX version of (pdf)latex.
+
+See also the documentation of \fI$out_dir\fR for some complications on
+what directory names are suitable.
+
+.TP
 .B $banner [0]
 If nonzero, the banner message is printed across each page when
 converting the dvi file to postscript.  Without modifying the variable
@@ -953,7 +1219,7 @@
 two and the second two examples are equivalent.  Each backward slash
 should be doubled to avoid running afoul of \fIPerl\fR's rules for writing
 strings. 
-.PP
+
 \fIImportant note:\fR This variable is now mostly obsolete in the
 current version of \fIlatexmk\fR, 
 since it has a better method of searching for files using the
@@ -990,7 +1256,7 @@
 .B $cleanup_includes_cusdep_generated [0]
 If nonzero, specifies that cleanup also deletes files that are
 generated by custom dependencies.
-(When doing a clean up, e.g., by use of the \fI-C\fR option, custom
+(When doing a clean up, e.g., by use of the \fB-C\fR option, custom
 dependencies are those listed in the \fI.fdb_latexmk\fR file from a
 previous run.)
 .TP
@@ -1006,7 +1272,7 @@
 files.  (There is also extra cleaning as specified by the
 \fI$clean_ext\fR, \fI$clean_full_ext\fR and \fI@generated_exts\fR
 variables.)
-.PP
+
 This variable is equivalent to specifying one of
 the \fB-c\fR or \fB-C\fR options.  But there should be no need
 to set this variable from an RC file.
@@ -1032,9 +1298,50 @@
 Extra extensions of files for \fIlatexmk\fR to remove when the \fB-C\fR
 option is selected, i.e., extensions of files to remove when the .dvi,
 etc files are to be cleaned-up.
+
+More general patterns are allowed, as for \fI$clean_ext\fR.
+
+.TP
+.B $compiling_cmd [undefined], $failure_cmd [undefined], $success_cmd [undefined]
+
+These variables specify commands that are executed at certain points
+of compilations during preview-continuous mode.  One motivation for
+their existance is to allow convenient visual indications of
+compilation status even when the window receiving the screen output of
+the compilation is hidden.
+
+The commands are executed at the following points:
+$compiling_cmd at the start of compilation, $success_cmd at the end of
+a successful compilation, and $failure_cmd at the end of an
+unsuccessful compilation.  If any of above variables is undefined (the
+default situation) or blank, then the corresponding command is not
+executed.  
+
+An example of a typical setting of these variables is as follows
+
+    $compiling_cmd = "xdotool search --name \\"%D\\" set_window --name \\"%D compiling\\"";
+    $success_cmd   = "xdotool search --name \\"%D\\" set_window --name \\"%D OK\\"";
+    $failure_cmd   = "xdotool search --name \\"%D\\" set_window --name \\"%D FAILURE\\"";
+
+These assume that the program \fIxdotool\fR is installed, that the
+previewer is using an X-Window system for display, and that the title
+of the window contains the name of the displayed file, as it normally
+does.  When the commands are executed, the placeholder string %D is replaced by
+the name of the destination file, which is the previewed file.  The
+above commands result in an appropriate string being appended to the
+filename in the window title: " compiling", " OK", or " FAILURE".  
+
+Other placeholders that can be used are %S, %T, and %R, with %S and %T
+normally being identical. These can be useful for a command changing
+the title of the edit window. The visual indication in a window title
+can useful, since the user does not have to keep shifting attention to
+the (possibly hidden) compilation window to know the status of the
+compilation.
+
 .TP
 .B @cus_dep_list [()]
 Custom dependency list -- see section on "Custom Dependencies".
+
 .TP
 .B @default_files [("*.tex")]
 Default list of files to be processed.  
@@ -1063,6 +1370,13 @@
 \fI@default_files\fR is an array variable, i.e., a sequence of
 filename specifications is possible.
 .TP
+.B $dependents_phony [0]
+If a list of dependencies is output, this variable determines whether
+to include a phony target for each source file.  If you use the
+dependents list in a Makefile, the dummy rules work around errors make
+gives if you remove header files without updating the Makefile to
+match.
+.TP
 .B $dependents_list [0]
 Whether to display a list(s) of dependencies at the end of a run.
 .TP
@@ -1073,7 +1387,7 @@
 .B $dvi_mode [See below for default]
 If nonzero, generate a dvi version of the document.  
 Equivalent to the \fB-dvi\fR option.
-.PP
+
 The variable $dvi_mode defaults to 0, but if no explicit requests are
 made for other types of file (postscript, pdf), then $dvi_mode will be
 set to 1.  In addition, if a request for a file for which a .dvi file
@@ -1083,7 +1397,18 @@
 The command to invoke a dvi-previewer.
 [Default is "start" under MS-WINDOWS; under more recent versions of
 Windows, this will cause to be run whatever command the system has
-associated with .dvi files.] 
+associated with .dvi files.]
+
+\fBImportant note\fR: Normally you will want to have a previewer run
+detached, so that \fIlatexmk\fR doesn't wait for the previewer to
+terminate before continuing its work.  So normally you should prefix
+the command by "start ", which flags to \fIlatexmk\fR that it should
+do the detaching of the previewer itself (by whatever method is
+appropriate to the operating system).  But sometimes letting
+\fIlatexmk\fR do the detaching is not appropriate (for a variety of
+non-trivial reasons), so you should put the "start " bit in
+yourself, whenever it is needed.
+
 .TP
 .B $dvi_previewer_landscape ["start xdvi %O %S"]
 The command to invoke a dvi-previewer in landscape mode.
@@ -1102,6 +1427,14 @@
 should be modified to give dvips the options "-P pdf" to ensure that
 type 1 fonts are used in the pdf file.
 .TP
+.B $dvipdf_silent_switch ["-q"]
+Switch(es) for dvipdf program when silent mode is on.
+
+N.B. The standard dvipdf program runs silently, so adding the silent
+switch has no effect, but is actually innocuous.  But if an
+alternative program is used, e.g., dvipdfmx, then the silent switch
+has an effect.  The default setting is correct for dvipdfm and dvipdfmx.
+.TP
 .B $dvips ["dvips %O -o %D %S"]
 The program to used as a filter to convert a .dvi file to a .ps file.  
 If pdf is going to be generated from pdf, then the value of the
@@ -1150,6 +1483,9 @@
 \fI$dvi_update_method\fR.  The default value is the one appropriate
 for xdvi on a UNIX system.
 .TP
+.B $failure_cmd [undefined]
+See the documentation for $compiling_cmd.
+.TP
 .B $fdb_ext ["fdb_latexmk"]
 The extension of the file which \fIlatexmk\fR generates to contain a
 database of information on source files.  You will not normally need
@@ -1353,6 +1689,9 @@
 .B $makeindex ["makeindex %O -o %D %S"]
 The index processing program.
 .TP
+.B $makeindex_silent_switch ["-q"]
+\fBSwitch(es)\fR for the index processing program when silent mode is on.
+.TP
 .B $max_repeat  [5]
 The maximum number of times \fIlatexmk\fR will run latex/pdflatex
 before deciding that there may be an infinite loop and that it needs
@@ -1362,6 +1701,23 @@
 (Note that the "etc" covers a lot of cases where one run of
 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
+"\\".  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
+an Unix-like environment inside MS-Windows.)
+
+.TP
 .B $new_viewer_always [0]
 This variable applies to \fIlatexmk\fR \fBonly\fR in
 continuous-preview mode.  If \fI$new_viewer_always\fR is 0,
@@ -1370,6 +1726,34 @@
 \fI$new_viewer_always\fR is non-zero, this check will be skipped, and
 \fIlatexmk\fR will behave as if no viewer is running.
 .TP
+
+.B $out_dir [""]
+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
+\fB-output-directory\fR option of (pdf)latex.  This exists in the
+usual current (Dec. 2011) 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
+of the current working directory.  However, if you specify some other
+directory, e.g., "/tmp/foo" or "../output", be aware that this could
+cause problems, e.g., with \fImakeindex\fR or \fIbibtex\fR.  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 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
+"all"), to override the default "paranoid" setting.
+.TP
+
 .B $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 pdflatex.  
@@ -1381,9 +1765,24 @@
 Equivalent to the \fB-pdf-\fR, \fB-pdf\fR, \fB-pdfdvi\fR, 
 \fB-pdfps\fR options.
 .TP
+
 .B $pdflatex ["pdflatex %O %S"]
 The LaTeX processing program in the version that makes a pdf file instead
 of a dvi file.
+
+An example of the use of this variable is to arrange for \fIxelatex\fR
+to be used instead of \fIpdflatex\fR, when you could set
+
+     $pdflatex = "xelatex %O %S";
+
+Note that \fIxelatex\fR only produces .pdf files (and not .dvi), so to
+use it you will also need to turn on production of .pdf files, and to
+turn off the production of .dvi (and .ps) files, either by command
+line options or by the following settings in an initialization file
+
+    $pdf_mode = 1; $postscript_mode = $dvi_mode = 0;
+
+
 .TP
 .B %pdflatex_input_extensions
 This variable specifies the extensions tried by latexmk when it finds
@@ -1431,17 +1830,36 @@
 .TP
 .B $pdf_previewer ["start acroread %O %S"]
 The command to invoke a pdf-previewer.
-[Default is changed to "start" on MS-WINDOWS; under more recent versions of
+
+On MS-WINDOWS, the default is changed to "cmd /c start """; under more recent versions of
 Windows, this will cause to be run whatever command the system has
-associated with .pdf files.]  
+associated with .pdf files.  But this may be undesirable if this
+association is to \fIacroread\fR -- see the notes in the explanation
+of the \fB-pvc\fR option.]  
+
+On OS-X the default is changed to "open %S", which results in OS-X
+starting up (and detaching) the viewer associated with the file.  By
+default, for pdf files this association is to OS-X's preview, which is
+quite satisfactory.
 
-\fBWARNING\fR: Potential problem under MS-Windows:
+\fBWARNING\fR:  Problem under MS-Windows:
 if acroread is used as the pdf previewer, and it is
 actually viewing a pdf file, the pdf file cannot be updated.  Thus
 makes acroread a bad choice of previewer if you use \fIlatexmk\fR's
 previous-continuous mode (option \fB-pvc\fR) under MS-windows.
-This problem does not occur if ghostview, gv or gsview is used to
-view pdf files.
+This problem does not occur if, for example, SumatraPDF or gsview is
+used to view pdf files.
+
+\fBImportant note\fR: Normally you will want to have a previewer run
+detached, so that \fIlatexmk\fR doesn't wait for the previewer to
+terminate before continuing its work.  So normally you should prefix
+the command by "start ", which flags to \fIlatexmk\fR that it should
+do the detaching of the previewer itself (by whatever method is
+appropriate to the operating system).  But sometimes letting
+\fIlatexmk\fR do the detaching is not appropriate (for a variety of
+non-trivial reasons), so you should put the "start " bit in
+yourself, whenever it is needed.
+
 .TP
 .B $pdf_update_command [""]
 When the pdf previewer is set to be updated by running a command, this
@@ -1490,7 +1908,7 @@
 .B $postscript_mode [0]
 If nonzero, generate a postscript version of the document.  
 Equivalent to the \fB-ps\fR option.
-.PP
+
 If some other request is made for which a postscript file is needed,
 then $postscript_mode will be set to 1.
 .TP
@@ -1541,7 +1959,7 @@
 file before other processing.  Equivalent to specifying the \fB-pF\fR
 option.
 .TP
-.B $ps_previewer ["start gv %O %S", but \(dqstart %O %S" under MS-WINDOWS]
+.B $ps_previewer ["start gv %O %S", but "start %O %S" under MS-WINDOWS]
 The command to invoke a ps-previewer.  (The default under MS-WINDOWS
 will cause to be run whatever command the system has associated 
 with .ps files.)
@@ -1554,8 +1972,19 @@
 \fBWARNING\fR: 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.  
+
+\fBImportant note\fR: Normally you will want to have a previewer run
+detached, so that \fIlatexmk\fR doesn't wait for the previewer to
+terminate before continuing its work.  So normally you should prefix
+the command by "start ", which flags to \fIlatexmk\fR that it should
+do the detaching of the previewer itself (by whatever method is
+appropriate to the operating system).  But sometimes letting
+\fIlatexmk\fR do the detaching is not appropriate (for a variety of
+non-trivial reasons), so you should put the "start " bit in
+yourself, whenever it is needed.
+
 .TP
-.B $ps_previewer_landscape ["start gv -swap %O %S", but \(dqstart %O %S" under MS-WINDOWS]
+.B $ps_previewer_landscape ["start gv -swap %O %S", but "start %O %S" under MS-WINDOWS]
 The command to invoke a ps-previewer in landscape mode.
 .TP
 .B $ps_update_command [""]
@@ -1589,7 +2018,7 @@
 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
@@ -1599,7 +2028,7 @@
 operating system in passing arguments to programs.)
 .TP
 .B $recorder [0]
-Whether to use the \fI-recorder\fR option to \fIlatex\fR and
+Whether to use the \fB-recorder\fR option to \fIlatex\fR and
 \fIpdflatex\fR. Use of this option results in a file of extension
 \fI.fls\fR containing a list of the files that these programs have
 read and written.  \fILatexmk\fR will then use this file to improve
@@ -1618,6 +2047,33 @@
 named for the program, i.e., latex.fls or pdflatex.fls.  In this
 second case, \fIlatexmk\fR copies the latex.fls or pdflatex.fls to a
 file with the basename of the main LaTeX document, e.g., Document.fls.
+
+.TP
+.B $search_path_separator [See below for default]
+The character separating paths in the environment variables TEXINPUTS,
+BIBINPUTS, and BSTINPUTS.  This variable is mainly used by
+\fIlatexmk\fR when the \fB-outdir\fR, \fB-output-directory\fR,
+\fB-auxdir\fR, and/or \fB-aux-directory\fR options are used.  In that
+case \fIlatexmk\fR needs to communicate appropriately modified search
+paths to $\fIbibtex\fR, \fIdvipdf\fR, \fIdvips\fR, and
+\fI(pdf)latex\fR.  
+
+[Comment to technically savvy readers: \fI(pdf)latex\fR doesn't
+actually need the modified search path, because it corrects it
+internally.  But, surprisingly, \fIdvipdf\fR and \fIdvips\fR do,
+because sometimes graphics files get generated in the output or aux
+directories.] 
+
+The default under MSWin and Cygwin is ';' and under UNIX-like
+operating systems (including Linux and OS-X) is ':'.  Normally the
+defaults give correct behavior.  But there can be difficulties 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
+\fI$search_path_separator\fR explicitly.  (The same goes, of course,
+for unusual operating systems that are not in the MSWin, Linux, OS-X,
+Unix collection.)
+
 .TP
 .B $sleep_time [2]
 The time to sleep (in seconds) between checking for source file
@@ -1635,6 +2091,11 @@
 \fI$texfile_search\fR, it is a string of space-separated filenames, and
 then \fIlatexmk\fR replaces \fI@default_files\fR with the filenames in
 \fI$texfile_search\fR to which is added "*.tex".
+
+.TP
+.B $success_cmd [undefined]
+See the documentation for $compiling_cmd.
+
 .TP
 .B $tmpdir [See below for default]
 Directory to store temporary files that \fIlatexmk\fR may generate while
@@ -1732,7 +2193,7 @@
 
     add_cus_dep( 'fig', 'eps', 0, 'fig2eps' );
     sub fig2eps {
-        system("fig2dev -Leps $_[0].fig $_[0].eps"); 
+        system( "fig2dev -Leps \"$_[0].fig\" \"$_[0].eps\"" ); 
     }
 
 The first line adds a custom dependency that converts a file with
@@ -1760,32 +2221,35 @@
 statement, i.e., the invocation of system, which returns the value 0
 on success.
 
-If you use filenames with spaces in them, and if your LaTeX system and
-all other relevant software correctly handle such filenames, then you
-could put single quotes around filenames in the command line that is
-executed:
-
-    add_cus_dep( 'fig', 'eps', 0, 'fig2eps' );
-    sub fig2eps {
-        system("fig2dev -Lps '$_[0].fig' '$_[0].eps'");
-    }
-
-This causes the invocation of the \fIfig2dev\fR program to have quoted
-filenames; it should therefore work with filenames containing spaces.
-\fBHowever, not all software deals correctly with filenames that
-contain spaces.  Moreover, the rules, if any, for quoting filenames
-vary between operating systems, command shells and individual pieces
-of software, so this code may not always work.\fR
-
 If you use pdflatex instead of latex, then you will probably prefer to
 convert your graphics files to pdf format, in which case you would
 replace the above code in an initialization file by
 
     add_cus_dep( 'fig', 'pdf, 0, 'fig2pdf' );
     sub fig2pdf {
-        system("fig2dev -Lpdf $_[0].fig $_[0].pdf"); 
+        system( "fig2dev -Lpdf \"$_[0].fig\" \"$_[0].pdf\"" ); 
     }
 
+\fBNote 1:\fR In the command lines given in the system commands in the
+above examples, double quotes have been inserted around the file names
+(implemented by '\"' in the Perl language).  They immunize the running
+of the program against special characters in filenames.  Very often
+these quotes are not necessary, i.e., they can be omitted.  But it is
+normally safer to keep them in.  Even though the rules for quoting
+vary between operating systems, command shells and individual pieces
+of software, the quotes in the above examples do not cause problems in
+the cases I have tested.
+
+\fBNote 2:\fR One case in which the quotes are important is when the
+files are in a subdirectory and your operating system is Microsoft
+Windows.  Then the separator character for directory components can be
+either a forward slash '/' or Microsoft's more usual backward slash
+'\\'.  Forward slashes are generated by latexmk, to maintain its
+sanity from software like MiKTeX that mixes both directory
+separators; but their correct use normally requires quoted filenames. 
+(See a log file from a run of MiKTeX (at least in v. 2.9) for an
+example of the use of both directory separators.)
+
 If you have some general custom dependencies defined in the system or
 user initialization file, you may find that for a particular project
 they are undesirable.  So you might want to delete the unneeded ones.
@@ -1816,7 +2280,7 @@
 
     add_cus_dep('ndx', 'nnd', 0, 'makendx2nnd');
     sub makendx2nnd {
-        system("makeindex -o $_[0].nnd $_[0].ndx");
+        system( "makeindex -o \"$_[0].nnd\" \"$_[0].ndx"\" );
     }
 
 (You will need to modify this code if you use filenames
@@ -1854,7 +2318,7 @@
 
     push @cus_dep_list, "fig eps 0 fig2eps";
     sub fig2eps {
-        system("fig2dev -Lps $_[0].fig $_[0].eps");
+        system( "fig2dev -Lps \"$_[0].fig\" \"$_[0].eps\"" );
     }
 
 This method still works, and is equivalent to the earlier code using
@@ -1977,11 +2441,11 @@
 make .pdf files from .fig files produced by the \fIxfig\fR program;
 these are commonly used for graphics insertions in LaTeX documents.
 \fILatexmk\fR is arranged to output a dependency file after each run.
-It is given the \fI-recorder\fR option, which improves its detection
+It is given the \fB-recorder\fR option, which improves its detection
 of files generated during a run of \fIpdflatex\fR; such files should
-not be in the dependency list.  The \fI-e\fR options are used to turn
+not be in the dependency list.  The \fB-e\fR options are used to turn
 off all custom dependencies, and to document this.  Instead the
-\fI-use-make\fR is used to delegate the making of missing files to
+\fB-use-make\fR is used to delegate the making of missing files to
 \fImake\fR itself.
 
 Suppose in the LaTeX file there is a command \\includegraphics{graph},
@@ -2015,8 +2479,8 @@
 Acroread under UNIX/LINUX views pdf, but the file needs to be closed
 and reopened to view an updated version.
 Under MS-Windows, acroread locks its input file and so the
-pdf file cannot be updated.  (Remedy: configure \fIlatexmk\fR to use gsview
-instead.) 
+pdf file cannot be updated.  (Remedy: configure \fIlatexmk\fR to use
+\fIsumatrapdf\fR instead.) 
 .SH THANKS TO
 Authors of previous versions.  Many users with their feedback, and
 especially 
@@ -2027,7 +2491,7 @@
 harvested by worms and viruses.)
 .SH AUTHOR
 Current version, by John Collins (username collins at node phys.psu.edu).
-(Version 4.24).
+(Version 4.35).
 
 Released version can be obtained from CTAN:
 <http://www.tug.org/tex-archive/support/latexmk/>, and from the
diff -Nru latexmk-4.24/latexmk.bat latexmk-4.35/latexmk.bat
--- latexmk-4.24/latexmk.bat	2001-06-10 18:51:40.000000000 +0000
+++ latexmk-4.35/latexmk.bat	2001-06-10 09:51:40.000000000 +0000
@@ -1,5 +1,5 @@
-Rem Execute latexmk.pl, searching for it in the PATH
-Rem Assume perl is in the PATH.  If not, you should replace 'perl' by 
-Rem the full pathname of the perl executable, e.g., 'C:\perl\bin\perl.exe'
-
-perl -S latexmk.pl %1 %2 %3 %4 %5 %6 %7 %8 %9
+Rem Execute latexmk.pl, searching for it in the PATH
+Rem Assume perl is in the PATH.  If not, you should replace 'perl' by 
+Rem the full pathname of the perl executable, e.g., 'C:\perl\bin\perl.exe'
+
+perl -S latexmk.pl %1 %2 %3 %4 %5 %6 %7 %8 %9
Binary files /tmp/3J34oUFB2b/latexmk-4.24/latexmk.pdf and /tmp/ysXb_AkP2f/latexmk-4.35/latexmk.pdf differ
diff -Nru latexmk-4.24/latexmk.pl latexmk-4.35/latexmk.pl
--- latexmk-4.24/latexmk.pl	2011-05-07 22:33:06.000000000 +0000
+++ latexmk-4.35/latexmk.pl	2012-11-11 08:12:34.000000000 +0000
@@ -1,4 +1,8 @@
 #!/usr/bin/env perl
+
+# N.B. !!!!!!!!!!!  See 17 July 2012 comments !!!!!!!!!!!!!!!!!!
+
+
 # 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
@@ -9,7 +13,6 @@
 
 # with the path of the perl executable adjusted for your system. 
 
-
 use warnings;
 
 # Delete #??!! when working
@@ -22,6 +25,7 @@
 ## (I have hooks for this).
 
 
+
 #=======================================
 
 #??  Force mode doesn't appear to do force (if error in latex file)
@@ -107,15 +111,15 @@
 
 $my_name = 'latexmk';
 $My_name = 'Latexmk';
-$version_num = '4.24';
-$version_details = "$My_name, John Collins, 7 May 2011";
-
+$version_num = '4.35';
+$version_details = "$My_name, John Collins, 11 Nov. 2012";
 
 use Config;
 use File::Copy;
 use File::Basename;
 use FileHandle;
 use File::Find;
+use List::Util qw( max );
 use Cwd;            # To be able to change cwd
 use Cwd "chdir";    # Ensure $ENV{PWD}  tracks cwd
 use Digest::MD5;
@@ -141,7 +145,7 @@
    warn "Something wrong with the perl configuration: No signals?\n";
 }
 
-## Copyright John Collins 1998-2011
+## Copyright John Collins 1998-2012
 ##           (username collins at node phys.psu.edu)
 ##      (and thanks to David Coppit (username david at node coppit.org) 
 ##           for suggestions) 
@@ -175,37 +179,94 @@
 ##     5.  Parsing of log file instead of source file is used to
 ##         obtain dependencies, by default.
 ##
-##   Modification log from 1 Jan 2011 onwards in detail
+##   Modification log from 9 Dec 2011 onwards in detail
 ##
-##      7 May 2011, John Collins  With biber, use kpsewhich to find source
-##                                   files (e.g., .bib)
-##     24 Mar 2011, John Collins  Correct bug in detection of source files
-##                                   listed in .fls
-##     21 Mar 2011, John Collins  Add 'bcf' to list of generated extensions
-##                                Deal with case that fls files are latex.fls
-##                                   and pdflatex.fls
-##     19--21 Mar 2011, John Collins  -deps and -rules options
-##                                $use_make_for_missing_files
-##                                -recorder option
-##     12 Mar 2011, John Collins  Deal with problem that if maximum number of
-##                                runs of (pdf)latex is exceeded, -pvc mode
-##                                infinitely repeats (pdf)latex
-##     11 Mar 2011, John Collins  Fix problem that changes in generated files
-##                                during run of (pdf)latex may not be detected
-##                                if the run is shorter than the granularity 
-##                                of file times.
-##     28 Feb 2011, John Collins  Corrections of comments and messages
-##     22 Feb 2011, John Collins  Documentation improvement.
-##     16 Feb 2011, John Collins  Correctly parse blg files of biber 0.8
-##                                Version 4.23.
-##      3 Feb 2011, John Collins  Correct handling of errors in rc files
-##     23 Jan 2011, John Collins  Fix detection of makeindex files with
-##                                   MiKTeX v >= 2.8
-##     23 Jan 2011, John Collins  Fix detection of biber use with MiKTeX 
-##                            (which doesn't put openout lines in log file).
-##      9 Jan 2011, John Collins  Correct parsing of blg file for biber 0.7.2
-##      3 Jan 2011, John Collins  Small correction on reading .fdb_file
-##      1 Jan 2011, John Collins  Biber implementation
+##   12 Jan 2012 STILL NEED TO DOCUMENT some items below
+##     11 Nov 2012  John Collins  V. 4.35
+##                                Correct bug that under some combinations of
+##                                   MS-Windows, cygwin and distributions of
+##                                   TeX, line endings in fls file (CRLF v. LF)
+##                                   were misparsed, resulting in source
+##                                   filenames that incorrectly contained CR
+##                                   characters.
+##                                Correct bug that when --gg mode is on, the
+##                                   rule database contained items from the OLD
+##                                   fdb file.  Using --gg mode implies that
+##                                   the rules in the OLD fdb file must be
+##                                   ignored (since they may be wrong).
+##      1 Oct 2012  John Collins  V. 4.34
+##                                Correct problem that if a file is read by
+##                                   latex only after being written, it is
+##                                   not a true source file.
+##     19 Aug 2012  John Collins  V. 4.33c
+##                                Correct infinite loop when maximum passes
+##                                   exceeded.
+##                                Improve error messages
+##     12 Aug 2012  John Collins  V. 4.33b
+##                                Improve text displayed by -showextraoptions
+##      8 Aug 2012  John Collins  V. 4.33a
+##                                Fix problem that with Cygwin,
+##                                   latexmk runs very slowly, because 
+##                                   subroutine good_cwd() runs the
+##                                   program cygpath on every
+##                                   invocation.  Solution: cach cwd.
+##      6 Aug 2012  John Collins  Version number to 4.33
+##      4 Aug 2012  John Collins  Further fixes of filename treatment:
+##                                   normalize_filename routine to remove
+##                                   string for current directory, and
+##                                   convert '\' directory separator to '/'
+##                                   (Note MiKTeX uses BOTH, see e.g., its
+##                                   log file, so MSWin systems are NOT
+##                                   guaranteed to be consistent.  But latexmk
+##                                   needs to treat filenames differing by
+##                                   change of directory separator as equivalent.
+##                                   Warning: SOME MWWin programs, e.g., current
+##                                   cmd.exe (as tested yesterday on PSU computer
+##                                   in library) do not accept '/' as directory
+##                                   separator, so it may be worth allowing conversion
+##                                   to '\' in executed files.)
+##                                Also improve running when $silent is on:
+##                                   don't print warnings about undefined references
+##                                   and citations, but simply display a summary, whose
+##                                   criterion for being shown had to be fixed.
+##      3 Aug 2012  John Collins  Fix finding of files in aux-dir
+##      1 Aug 2012  John Collins  Handle aliasing of cwd in output file
+##                                to avoid unnecessary warnings about
+##                                actual o/p file .ne. expected with MiKTeX
+##                                Clean up subroutine names:
+##                       parse_logB to parse_log
+##                       make_preview_continuousB to make_preview_continuous
+##                       rdb_find_new_filesB to rdb_find_new_files
+##                       rdb_set_dependentsA to rdb_set_dependents
+##                       rdb_makeB to rdb_make
+##                       rdb_makeB1 to rdb_make1
+##                       rdb_one_depA to rdb_one_dep
+##                       rdb_recurseA to rdb_recurse
+##                       rdb_update_filesA to rdb_update_files
+##     28, 29, 30 Jul 2012  John Collins  Try better file-name normalization in reading fls file.
+##     18 Jul 2012  John Collins  Change ver. to 4.32d.
+##                                Merge changes from 29 June 2012:
+##                                Add $dvipdf_silent_switch
+##     17 Jul 2012  John Collins  Try better fix for error/rerun and retest issue.
+##                                Now rdb_primary_run doesn't have so many complications
+##                                rdb_makeB's PASS loop is simpler
+##                                rdb_submakeB is unneeded.
+##                                See the lines starting #??
+##                                See comments nearby
+##                                Compare w/ v. 4.32a
+##                                V. 4.32b
+##     17 Jul 2012  John Collins  Fix problem that after finding error in a run
+##                                  of (pdf)latex, latexmk didn't check for
+##                                  changed files before giving up.
+##                                  To do that, I reverted some changes in
+##                                  rdb_primary_run to pre v. 4.31
+##                                Remove unused code
+##                                v. 4.32a
+##      8 May 2012  John Collins  Possibility to substitute backslashes for
+##                                  forward slashes in file and directory
+##                                  names in executed command line,
+##                                  for MSWin
+##      5 May 2012  John Collins  Comment on ctrl/C handling in WAIT loop
 ##
 ##   1998-2010, John Collins.  Many improvements and fixes.
 ##       See CHANGE-log.txt for full list, and CHANGES for summary
@@ -325,6 +386,7 @@
     '^LaTeX Warning: File `([^\\\']*)\\\' not found',
     '^Package .* [fF]ile `([^\\\']*)\\\' not found',
     'Error: pdflatex \(file ([^\)]*)\): cannot find image file',
+    ': File (.*) not found:\s*$',
 );
 
 ## Hash mapping file extension (w/o period, e.g., 'eps') to a single regexp,
@@ -369,9 +431,152 @@
 #        'pdflatex' => { 'tex' => 1, 'pdf' => 1, 'jpg' => 1, 'png' => 1 }; );
 # Instead we'll exercise the user-friendly access routines:
 add_input_ext( 'latex', 'tex', 'eps' );
-add_input_ext( 'pdflatex', 'tex', 'jpg', 'pdf' );
+add_input_ext( 'pdflatex', 'tex', 'jpg', 'pdf', 'png' );
 #show_input_ext( 'latex' ); show_input_ext( 'pdflatex' );
 
+# Information about options to latex and pdflatex that latexmk will simply
+#   pass through to (pdf)latex
+# Option without arg. maps to itself.
+# Option with arg. maps the option part to the full specification
+#  e.g., -kpathsea-debug => -kpathsea-debug=NUMBER
+%allowed_latex_options = ();
+%allowed_latex_options_with_arg = ();
+foreach ( 
+  #####
+  # TeXLive options
+    "-draftmode              switch on draft mode (generates no output PDF)",
+    "-enc                    enable encTeX extensions such as \\mubyte",
+    "-etex                   enable e-TeX extensions",
+    "-file-line-error        enable file:line:error style messages",
+    "-no-file-line-error     disable file:line:error style messages",
+    "-fmt=FMTNAME            use FMTNAME instead of program name or a %& line",
+    "-halt-on-error          stop processing at the first error",
+    "-interaction=STRING     set interaction mode (STRING=batchmode/nonstopmode/\n".
+    "                           scrollmode/errorstopmode)",
+    "-ipc                    send DVI output to a socket as well as the usual\n".
+    "                           output file",
+    "-ipc-start              as -ipc, and also start the server at the other end",
+    "-kpathsea-debug=NUMBER  set path searching debugging flags according to\n".
+    "                           the bits of NUMBER",
+    "-mktex=FMT              enable mktexFMT generation (FMT=tex/tfm/pk)",
+    "-no-mktex=FMT           disable mktexFMT generation (FMT=tex/tfm/pk)",
+    "-mltex                  enable MLTeX extensions such as \charsubdef",
+    "-output-comment=STRING  use STRING for DVI file comment instead of date\n".
+    "                           (no effect for PDF)",
+    "-output-format=FORMAT   use FORMAT for job output; FORMAT is `dvi\" or `pdf\"",
+    "-parse-first-line       enable parsing of first line of input file",
+    "-no-parse-first-line    disable parsing of first line of input file",
+    "-progname=STRING        set program (and fmt) name to STRING",
+    "-shell-escape           enable \\write18{SHELL COMMAND}",
+    "-no-shell-escape        disable \\write18{SHELL COMMAND}",
+    "-shell-restricted       enable restricted \\write18",
+    "-src-specials           insert source specials into the DVI file",
+    "-src-specials=WHERE     insert source specials in certain places of\n".
+    "                           the DVI file. WHERE is a comma-separated value\n".
+    "                           list: cr display hbox math par parend vbox",
+    "-synctex=NUMBER         generate SyncTeX data for previewers if nonzero",
+    "-translate-file=TCXNAME use the TCX file TCXNAME",
+    "-8bit                   make all characters printable by default",
+
+  #####
+  # MikTeX options not in TeXLive
+    "-alias=app              pretend to be app",
+    "-buf-size=n             maximum number of characters simultaneously present\n".
+    "                           in current lines",
+    "-c-style-errors         C-style error messages",
+    "-disable-installer      disable automatic installation of missing packages",
+    "-disable-pipes          disable input (output) from (to) child processes",
+    "-disable-write18        disable the \\write18{command} construct",
+    "-dont-parse-first-line  disable checking whether the first line of the main\n".
+    "                           input file starts with %&",
+    "-enable-enctex          enable encTeX extensions such as \\mubyte",
+    "-enable-installer       enable automatic installation of missing packages",
+    "-enable-mltex           enable MLTeX extensions such as \charsubdef",
+    "-enable-pipes           enable input (output) from (to) child processes",
+    "-enable-write18         fully enable the \\write18{command} construct",
+    "-error-line=n           set the width of context lines on terminal error\n".
+    "                           messages",
+    "-extra-mem-bot=n        set the extra size (in memory words) for large data\n".
+    "                           structures",
+    "-extra-mem-top=n        set the extra size (in memory words) for chars,\n".
+    "                           tokens, et al",
+    "-font-max=n             set the maximum internal font number",
+    "-font-mem-size=n        set the size, in TeX memory words, of the font memory",
+    "-half-error-line=n      set the width of first lines of contexts in terminal\n".
+    "                           error messages",
+    "-hash-extra=n           set the extra space for the hash table of control\n".
+    "                           sequences",
+    "-job-time=file          set the time-stamp of all output files equal to\n".
+    "                           file'stime-stamp",
+    "-main-memory=n          change the total size (in memory words) of the main\n".
+    "                           memory array",
+    "-max-in-open=n          set the maximum number of input files and error\n".
+    "                           insertions that can be going on simultaneously",
+    "-max-print-line=n       set the width of longest text lines output",
+    "-max-strings=n          set the maximum number of strings",
+    "-nest-size=n            set the maximum number of semantic levels\n".
+    "                           simultaneously active",
+    "-no-c-style-errors      standard error messages",
+    "-param-size=n           set the the maximum number of simultaneous macro\n".
+    "                           parameters",
+    "-pool-size=n            set the maximum number of characters in strings",
+    "-record-package-usages=file record all package usages and write them into\n".
+    "                           file",
+    "-restrict-write18       partially enable the \\write18{command} construct",
+    "-save-size=n            set the the amount of space for saving values\n".
+    "                           outside of current group",
+    "-stack-size=n           set the maximum number of simultaneous input sources",
+    "-string-vacancies=n     set the minimum number of characters that should be\n".
+    "                           available for the user's control sequences and font\n".
+    "                           names",
+    "-tcx=name               process the TCX table name",
+    "-time-statistics        show processing time statistics",
+    "-trace                  enable trace messages",
+    "-trace=tracestreams     enable trace messages. The tracestreams argument is\n".
+    "                           a comma-separated list of trace stream names",
+    "-trie-size=n            set the amount of space for hyphenation patterns",
+    "-undump=name            use name as the name of the format to be used,\n".
+    "                           instead of the name by which the program was\n".
+    "                           called or a %& line.",
+
+  #####
+    # Options passed to (pdf)latex that have special processing by latexmk,
+    #   so they are commented out here.
+    #-jobname=STRING         set the job name to STRING
+    #-aux-directory=dir    Set the directory dir to which auxiliary files are written
+    #-output-directory=DIR   use existing DIR as the directory to write files in
+    #-quiet
+    #-recorder               enable filename recorder
+    #
+    # Options with different processing by latexmk than (pdf)latex
+    #-help
+    #-version
+    #
+    # Options NOT used by latexmk
+    #-includedirectory=dir    prefix dir to the search path
+    #-initialize              become the INI variant of the compiler
+    #-ini                     be pdfinitex, for dumping formats; this is implicitly
+    #                          true if the program name is `pdfinitex'
+) {
+    if ( /^([^\s=]+)=/ ) {
+        $allowed_latex_options_with_arg{$1} = $_;
+    }
+    elsif ( /^([^\s=]+)\s/ ) {
+        $allowed_latex_options{$1} = $_;
+    }
+    else {
+        $allowed_latex_options{$_} = $_;
+    }
+}
+
+# Arrays of options that will be added to latex and pdflatex.
+# These need to be stored until after the command line parsing is finished,
+#  in case the values of $latex and/or $pdflatex change after an option
+#  is added.
+@extra_latex_options = ();
+@extra_pdflatex_options = ();
+
+
 ## Command to invoke biber & bibtex
 $biber  = 'biber %O %B';
 $bibtex  = 'bibtex %O %B';
@@ -394,6 +599,12 @@
 
 ## Command to convert dvi file to pdf file directly:
 $dvipdf  = 'dvipdf %O %S %D';
+# N.B. Standard dvipdf runs dvips and gs with their silent switch, so for
+#      standard dvipdf $dvipdf_silent_switch is unneeded, but innocuous. 
+#      But dvipdfmx can be used instead, and it has a silent switch (-q).
+#      So implementing $dvipdf_silent_switch is useful.
+
+$dvipdf_silent_switch  = '-q';
 
 ## Command to convert dvi file to ps file:
 $dvips  = 'dvips %O -o %D %S';
@@ -428,6 +639,10 @@
 ## Current tex's treat extensions like UNIX teTeX:
 $extension_treatment = 'unix';
 
+## Substitute backslashes in file and directory names for
+##  MSWin command line
+$MSWin_back_slash = 1;
+
 $dvi_update_signal = undef;
 $ps_update_signal = undef;
 $pdf_update_signal = undef;
@@ -442,7 +657,8 @@
 
 $quote_filenames = 1;       # Quote filenames in external commands
 
-
+$del_dir = '';        # Directory into which cleaned up files are to be put.
+                      # If $del_dir is '', just delete the files
 
 #########################################################################
 
@@ -459,7 +675,7 @@
 $MSWin_fudge_break = 1; # Give special treatment to ctrl/C and ctrl/break
                         #    in -pvc mode under MSWin
                         # Under MSWin32 (at least with perl 5.8 and WinXP)
-                        #   when latemk is running another program, and the 
+                        #   when latexmk is running another program, and the 
                         #   user gives ctrl/C or ctrl/break, to stop the 
                         #   daughter program, not only does it reach
                         #   the daughter, but also latexmk/perl, so
@@ -570,7 +786,7 @@
     #     example).
     #     Cygwin executables for tex and latex may only know cygwin
     #     filenames. 
-    # 4.  The BIBINPUTS and TEXINPUTS environment variables may be
+    # 4.  The BIBINPUTS environment variables may be
     #     UNIX-style or MSWin-style depending on whether native NT or
     #     cygwin executables are used.  They are therefore parsed
     #     differently.  Here is the clash:
@@ -763,12 +979,29 @@
     }
     elsif ( $^O eq "darwin" ) {
         # OS-X on Macintosh
-        $lpr_pdf  = 'lpr %O %S';  
+        # open starts command associated with a file.
+        # For pdf, this is set by default to OS-X's preview, which is suitable.
+        #     Manual update is simply by clicking on window etc, which is OK.
+        # For ps, this is set also to preview.  This works, but since it
+        #     converts the file to pdf and views the pdf file, it doesn't
+        #     see updates, and a refresh cannot be done.  This is far from
+        #     optimal.
+        # For a full installation of MacTeX, which is probably the most common
+        #     on OS-X, an association is created between dvi files and TeXShop.
+        #     This also converts the file to pdf, so again while it works, it
+        #     does not deal with changed dvi files, as far as I can see.
+        $pdf_previewer = 'open %S';
+        $pdf_update_method = 1;     # manual
+        $dvi_previewer = $dvi_previewer_landscape = 'NONE';
+        $ps_previewer = $ps_previewer_landscape = 'NONE';
+        # Others
+        $lpr_pdf  = 'lpr %O %S';
         $pscmd = "ps -ww -u $ENV{USER}"; 
     }
 }
 
 ## default parameters
+$auto_rc_use = 1;       # Whether to read rc files automatically
 $max_repeat = 5;        # Maximum times I repeat latex.  Normally
                         # 3 would be sufficient: 1st run generates aux file,
                         # 2nd run picks up aux file, and maybe toc, lof which 
@@ -824,10 +1057,14 @@
                         # command line has same effect as with current
                         # tex, etc.  (If $jobname is non-empty, then
                         # the --jobname=... option is used on tex.)
+$out_dir = '';          # Directory for output files.  
+                        # Cf. --output-directory of current (pdf)latex
+$aux_dir = '';          # Directory for aux files (log, aux, etc).
+                        # Cf. --aux-directory of current (pdf)latex in MiKTeX.
 
 
 ## default flag settings.
-$recorder = 0;          # Whether to use recorder option on latex/pdflatex
+$recorder = 1;          # Whether to use recorder option on latex/pdflatex
 $silent = 0;            # silence latex's messages?
 $landscape_mode = 0;	# default to portrait mode
 
@@ -873,9 +1110,14 @@
 $do_cd = 0;     # Do not do cd to directory of source file.
                 #   Thus behave like latex.
 $dependents_list = 0;   # Whether to display list(s) of dependencies
+$dependents_phony = 0;  # Whether list(s) of dependencies includes phony targets
+                        # (as with 'gcc -MP').
 $deps_file = '-';       # File for dependency list output.  Default stdout.
-$rules_list = 0;   # Whether to display list(s) of dependencies
-@dir_stack = (); # Stack of pushed directories.
+$rules_list = 0;        # Whether to display list(s) of dependencies
+@dir_stack = ();        # Stack of pushed directories, each of form of 
+			# pointer to array  [ cwd, good_cwd ], where
+			# good_cwd differs from cwd by being converted
+			# to native MSWin path when cygwin is used.
 $cleanup_mode = 0;      # No cleanup of nonessential LaTex-related files.
                         # $cleanup_mode = 0: no cleanup
                         # $cleanup_mode = 1: full cleanup 
@@ -925,21 +1167,22 @@
 $bad_reference = 0;
 $bad_citation = 0;
 
+# Cache of expensive-to-compute state variables, e.g., cwd in form
+# fixed to deal with cygwin issues.
+%cache = ();
+&cache_good_cwd;
 
 # Set search paths for includes.
 # Set them early so that they can be overridden
 $BIBINPUTS = $ENV{'BIBINPUTS'};
 if (!$BIBINPUTS) { $BIBINPUTS = '.'; }
-#?? OBSOLETE
-$TEXINPUTS = $ENV{'TEXINPUTS'};
-if (!$TEXINPUTS) { $TEXINPUTS = '.'; }
 
 # Convert search paths to arrays:
 # If any of the paths end in '//' then recursively search the
 # directory.  After these operations, @BIBINPUTS  should
 # have all the directories that need to be searched
 
-@BIBINPUTS = find_dirs1 ($BIBINPUTS);
+@BIBINPUTS = find_dirs1( $BIBINPUTS );
 
 
 ######################################################################
@@ -1060,7 +1303,7 @@
 %primaries = ();    # Hash of rules for primary part of make.  Keys are 
                     # currently 'latex', 'pdflatex' or both.  Value is
                     # currently irrelevant.  Use hash for ease of lookup
-   # Make remove this later, if use makeB
+   # Make remove this later, if use rdb_makeB
 
 # Hashes, whose keys give names of particular kinds of rule.  We use
 # hashes for ease of lookup.
@@ -1077,7 +1320,9 @@
                     # Rule data:
                     #   0: [ cmd_type, ext_cmd, int_cmd, test_kind, 
                     #       source, dest, base,
-		    #       out_of_date, out_of_date_user, time_of_last_run, changed
+		    #       out_of_date, out_of_date_user,
+                    #       time_of_last_run, time_of_last_file_check,
+                    #       changed
                     #       last_result, last_message,
                     #       default_extra_generated
                     #      ]
@@ -1087,7 +1332,8 @@
                     #       with substitutions (%D for destination, %S
 		    #       for source, %B for base of current rule,
 		    #       %R for base of primary tex file, %T for
-		    #       texfile name, and %O for options.
+		    #       texfile name, %O for options,
+                    #       %Y for $aux_dir1, and %Z for $out_dir1
                     #     int_cmd specifies any internal command to be
 		    #       used to implement the application of the
 		    #       rule.  If this is present, it overrides
@@ -1135,6 +1381,8 @@
 		    #              last applied.  (In standard units
 		    #              from perl, to be directly compared
 		    #              with file modification times.)
+                    #     time_of_last_file_check = last time that a check
+                    #              was made for changes in source files.
                     #     changed flags whether special changes have been made
                     #          that require file-existence status to be ignored
                     #     last_result is 
@@ -1143,11 +1391,15 @@
                     #                  1 if last run was successful, but
                     #                    failed to create an output file
                     #                  2 if last run failed
+                    #                  200 if last run gave a warning that is
+                    #                    important enough to be reported with 
+                    #                    the error summary.  The warning
+                    #                    message is stored in last_message.
                     #     last_message is error message for last run
                     #     default_extra_generated is a reference to an array
                     #       of specifications of extra generated files (beyond
                     #       the main dest file.  Standard place holders are used.
-                    #       Example ['%R.log'] for (pdf)latex, and ['%R.blg'] 
+                    #       Example ['%Y%R.log'] for (pdf)latex, and ['%R.blg'] 
                     #          for bibtex.  (There's no need for '%R.aux', here,
                     #          since such generated files are detected dynamically.)
                     #   1: {Hash sourcefile -> [source-file data] }
@@ -1185,9 +1437,6 @@
 %fdb_current = ();  # Fdb-hash for all files used.
 
 
-#==================================================
-## Read rc files:
-
 # User's home directory
 $HOME = '';
 if (exists $ENV{'HOME'} ) {
@@ -1198,6 +1447,19 @@
 }
 
 
+#==================================================
+
+# Options that are to be obeyed before rc files are read:
+
+foreach $_ ( @ARGV )
+{
+    if (/^-{1,2}norc$/ ) {
+        $auto_rc_use = 0;
+    }
+}
+
+#==================================================
+## Read rc files with this subroutine
 
 sub read_first_rc_file_in_list {
     foreach my $rc_file ( @_ ) {
@@ -1210,33 +1472,37 @@
     }
 }
 
-# Read system rc file:
-read_first_rc_file_in_list( @rc_system_files );
-# Read user rc file.
-read_first_rc_file_in_list( "$HOME/.latexmkrc" );
-# Read rc file in current directory.
-read_first_rc_file_in_list( "latexmkrc", ".latexmkrc" );
-
-#==================================================
-
-if ($bibtex_use > 1) {
-    push @generated_exts, 'bbl';
+# Note that each rc file may unset $auto_rc_use to
+# prevent lower-level rc files from being read.
+# So test on $auto_rc_use in each case.
+if ( $auto_rc_use ) {
+    # System rc file:
+    read_first_rc_file_in_list( @rc_system_files );
+}
+if ( $auto_rc_use ) {
+    # User rc file:
+    read_first_rc_file_in_list( "$HOME/.latexmkrc" );
+}
+if ( $auto_rc_use ) { 
+    # Rc file in current directory:
+    read_first_rc_file_in_list( "latexmkrc", ".latexmkrc" );
 }
 
-#show_array ("BIBINPUTS", @BIBINPUTS); die;
-
 ## Process command line args.
 @command_line_file_list = ();
 $bad_options = 0;
 
-#print "Command line arguments:\n"; for ($i = 0; $i <= $#ARGV; $i++ ) {  print "$i: '$ARGV[$i]'\n"; }
-
 while ($_ = $ARGV[0])
 {
-  # Make -- and - equivalent at beginning of option:
+  # Make -- and - equivalent at beginning of option,
+  # but save original for possible use in (pdf)latex command line
+  $original = $_;
   s/^--/-/;
   shift;
-  if (/^-bibtex$/) { $bibtex_use = 2; }
+  if ( /^-aux-directory=(.*)$/ || /^-auxdir=(.*)$/ ) {
+      $aux_dir = $1;
+  }
+  elsif (/^-bibtex$/) { $bibtex_use = 2; }
   elsif (/^-bibtex-$/) { $bibtex_use = 0; }
   elsif (/^-nobibtex$/) { $bibtex_use = 0; }
   elsif (/^-bibtex-cond$/) { $bibtex_use = 1; }
@@ -1247,12 +1513,13 @@
   elsif (/^-cd-$/)   { $do_cd = 0; }
   elsif (/^-commands$/) { &print_commands; exit; }
   elsif (/^-d$/)     { $banner = 1; }
-  elsif (/^-dependents$/ || /^-deps$/ ) { $dependents_list = 1; }
+  elsif (/^-dependents$/ || /^-deps$/ || /^-M$/ ) { $dependents_list = 1; }
   elsif (/^-nodependents$/ || /^-dependents-$/ || /^-deps-$/) { $dependents_list = 0; }
   elsif (/^-deps-out=(.*)$/) {
       $deps_file = $1;
       $dependents_list = 1; 
   }
+  elsif (/^-diagnostics/) { $diagnostics = 1; }
   elsif (/^-dvi$/)   { $dvi_mode = 1; }
   elsif (/^-dvi-$/)  { $dvi_mode = 0; }
   elsif (/^-f$/)     { $force_mode = 1; }
@@ -1263,7 +1530,6 @@
      $go_mode = 2; $cleanup_mode = 1; $cleanup_fdb = 1; $cleanup_only = 0; 
   }
   elsif ( /^-h$/ || /^-help$/ )   { &print_help; exit;}
-  elsif (/^-diagnostics/) { $diagnostics = 1; }
   elsif (/^-jobname=(.*)$/) {
       $jobname = $1;
   }
@@ -1272,24 +1538,44 @@
   elsif (/^-latex=(.*)$/) {
       $latex = $1;
   }
-  elsif (/^-pdflatex=(.*)$/) {
-      $pdflatex = $1;
+  elsif (/^-latexoption=(.*)$/) {
+      push @extra_latex_options, $1;
+      push @extra_pdflatex_options, $1;
+  }
+# See above for -M
+  elsif (/^-MF$/) {
+     if ( $ARGV[0] eq '' ) {
+	&exit_help( "No file name specified after -MF switch");
+     }
+     $deps_file = $ARGV[0];
+     shift; 
   }
+  elsif ( /^-MP$/ ) { $dependents_phony = 1; }
   elsif (/^-new-viewer$/) {
-                       $new_viewer_always = 1; 
+      $new_viewer_always = 1; 
   }
   elsif (/^-new-viewer-$/) {
-                       $new_viewer_always = 0; 
+      $new_viewer_always = 0;
+  }
+  elsif (/^-norc$/ ) {
+      $auto_rc_use = 0;
+      # N.B. This has already been obeyed.
+  }
+  elsif ( /^-output-directory=(.*)$/ ||/^-outdir=(.*)$/ ) {
+      $out_dir = $1;
   }
   elsif (/^-p$/)     { $printout_mode = 1; 
                        $preview_continuous_mode = 0; # to avoid conflicts
                        $preview_mode = 0;  
                      }
   elsif (/^-p-$/)    { $printout_mode = 0; }
-  elsif (/^-pdfdvi$/){ $pdf_mode = 3; }
-  elsif (/^-pdfps$/) { $pdf_mode = 2; }
   elsif (/^-pdf$/)   { $pdf_mode = 1; }
   elsif (/^-pdf-$/)  { $pdf_mode = 0; }
+  elsif (/^-pdfdvi$/){ $pdf_mode = 3; }
+  elsif (/^-pdflatex=(.*)$/) {
+      $pdflatex = $1;
+  }
+  elsif (/^-pdfps$/) { $pdf_mode = 2; }
   elsif (/^-print=(.*)$/) {
       $value = $1;
       if ( $value =~ /^dvi$|^ps$|^pdf$/ ) {
@@ -1317,21 +1603,44 @@
   elsif (/^-recorder-$/ ){ $recorder = 0; }
   elsif (/^-rules$/ ) { $rules_list = 1; }
   elsif (/^-norules$/ || /^-rules-$/ ) { $rules_list = 0; }
+  elsif (/^-showextraoptions$/) {
+     print "List of extra latex and pdflatex options recognized by $my_name.\n",
+           "These are passed as is to (pdf)latex.  They may not be recognized by\n",
+           "particular versions of (pdf)latex.  This list is a combination of those\n",
+           "for TeXLive and MikTeX.\n",
+           "\n",
+           "Note that in addition to the options in this list, there are several\n",
+           "options known to the (pdf)latex programs that are also recognized by\n",
+           "latexmk and trigger special behavior by latexmk.  Since these options\n",
+           "appear in the main list given by running 'latexmk --help', they do not\n",
+           "appear in the following list\n",
+           "\n";
+     foreach $option ( sort( keys %allowed_latex_options, keys %allowed_latex_options_with_arg ) ) {
+       if (exists $allowed_latex_options{$option} ) { print "   $allowed_latex_options{$option}\n"; }
+       if (exists $allowed_latex_options_with_arg{$option} ) { print "   $allowed_latex_options_with_arg{$option}\n"; }
+     }
+     exit;
+  }
   elsif (/^-silent$/ || /^-quiet$/ ){ $silent = 1; }
   elsif (/^-time$/) { $show_time = 1;}
   elsif (/^-time-$/) { $show_time = 0;}
-  elsif (/^-v$/ || /^-version$/)   { 
-      print "\n$version_details. Version $version_num\n"; 
-      exit; 
-  }
   elsif (/^-use-make$/)  { $use_make_for_missing_files = 1; }
   elsif (/^-use-make-$/)  { $use_make_for_missing_files = 0; }
+  elsif (/^-v$/ || /^-version$/)   { 
+      print "\n$version_details. Version $version_num\n";
+      exit;
+  }
   elsif (/^-verbose$/)  { $silent = 0; }
   elsif (/^-view=default$/) { $view = "default";}
   elsif (/^-view=dvi$/)     { $view = "dvi";}
   elsif (/^-view=none$/)    { $view = "none";}
   elsif (/^-view=ps$/)      { $view = "ps";}
   elsif (/^-view=pdf$/)     { $view = "pdf"; }
+  elsif (/^-xelatex$/)      { 
+      $pdflatex = "xelatex %O %S";
+      $pdf_mode = 1;
+      $dvi_mode = $postscript_mode = 0; 
+  }
   elsif (/^-e$/) {  
      if ( $#ARGV < 0 ) {
         &exit_help( "No code to execute specified after -e switch"); 
@@ -1386,6 +1695,13 @@
      $ps_filter = $ARGV[0];
      shift; 
   }
+  elsif ( ( exists( $allowed_latex_options{$_} ) )
+          || ( /^(-.+)=/ && exists( $allowed_latex_options_with_arg{$1} ) )
+        )
+  {
+      push @extra_latex_options, $original;
+      push @extra_pdflatex_options, $original;
+  }
   elsif (/^-/) {
      warn "$My_name: $_ bad option\n"; 
      $bad_options++;
@@ -1403,6 +1719,28 @@
      "**** Report bugs etc to John Collins <collins at phys.psu.edu>. ****\n"
    unless $silent;
 
+if ( ($out_dir ne '') && ($aux_dir eq '') ){
+    $aux_dir = $out_dir;
+}
+
+foreach ($out_dir, $aux_dir) {
+   # Remove aliases to cwd:
+   $_ = normalize_filename( $_ );
+   if ($_ eq '.' ) { $_ = ''; }
+}
+# Versions terminating in directory/path separator
+$out_dir1 = $out_dir;
+$aux_dir1 = $aux_dir;
+foreach ( $aux_dir1, $out_dir1 ) {
+    if ( ($_ ne '')  && ! m([\\/\:]$) ) {
+       $_ .= '/';
+    }
+}
+
+if ($bibtex_use > 1) {
+    push @generated_exts, 'bbl';
+}
+
 # For backward compatibility, convert $texfile_search to @default_files
 # Since $texfile_search is initialized to "", a nonzero value indicates
 # that an initialization file has set it.
@@ -1410,9 +1748,6 @@
     @default_files = split / /, "*.tex $texfile_search";
 }
 
-#printA "A: Command line file list:\n";
-#for ($i = 0; $i <= $#command_line_file_list; $i++ ) {  print "$i: '$command_line_file_list[$i]'\n"; }
-
 #Glob the filenames command line if the script was not invoked under a 
 #   UNIX-like environment.
 #   Cases: (1) MS/MSwin native    Glob
@@ -1431,8 +1766,6 @@
 }
 else {
     @file_list = @command_line_file_list;
-#print "A2:File list:\n";
-#for ($i = 0; $i <= $#file_list; $i++ ) {  print "$i: '$file_list[$i]'\n"; }
 }
 @file_list = uniq1( @file_list );
 
@@ -1526,8 +1859,11 @@
 &fix_cmds;
 
 # Add common options
-add_option( \$latex, $latex_default_switches );
-add_option( \$pdflatex, $pdflatex_default_switches );
+add_option( $latex_default_switches, \$latex );
+add_option( $pdflatex_default_switches, \$pdflatex );
+
+foreach (@extra_latex_options) { add_option( $_, \$latex ); }
+foreach (@extra_pdflatex_options) { add_option( $_, \$pdflatex ); }
 
 
 # If landscape mode, change dvips processor, and the previewers:
@@ -1539,23 +1875,53 @@
 }
 
 if ( $silent ) { 
-    add_option( \$latex, " $latex_silent_switch" ); 
-    add_option( \$pdflatex, " $pdflatex_silent_switch" ); 
-    add_option( \$biber, " $biber_silent_switch" ); 
-    add_option( \$bibtex, " $bibtex_silent_switch" ); 
-    add_option( \$makeindex, " $makeindex_silent_switch" ); 
-    add_option( \$dvips, " $dvips_silent_switch" ); 
+    add_option( "$latex_silent_switch", \$latex );
+    add_option( "$pdflatex_silent_switch", \$pdflatex );
+    add_option( "$biber_silent_switch", \$biber );
+    add_option( "$bibtex_silent_switch", \$bibtex );
+    add_option( "$makeindex_silent_switch", \$makeindex );
+    add_option( "$dvipdf_silent_switch", \$dvipdf );
+    add_option( "$dvips_silent_switch", \$dvips );
 }
 
 if ( $recorder ) {
-    add_option( \$latex, "-recorder" );
-    add_option( \$pdflatex, "-recorder" );
+    add_option( "-recorder", \$latex, \$pdflatex );
+}
+
+if ( $out_dir ) {
+    add_option( "-output-directory=\"$out_dir\"", \$latex, \$pdflatex );
+    if ( ! -e $out_dir ) {
+        warn "$My_name: making output directory '$out_dir'\n"
+	    if ! $silent;
+        mkdir $out_dir;
+    }
+    elsif ( ! -d $out_dir ) {
+        warn "$My_name: you requested output directory '$out_dir',\n",
+             "     but an ordinary file of the same name exists, which will\n",
+             "     probably give an error later\n";
+    }
+}
+
+if ( $aux_dir && ($aux_dir ne $out_dir) ) {
+    # N.B. If $aux_dir and $out_dir are the same, then the -output-directory
+    # option is sufficient, especially because the -aux-directory exists
+    # only in MiKTeX, not in TeXLive.
+    add_option( "-aux-directory=\"$aux_dir\"", \$latex, \$pdflatex );
+    if ( ! -e $aux_dir ) {
+        warn "$My_name: making auxiliary directory '$aux_dir'\n"
+	    if ! $silent;
+        mkdir $aux_dir;
+    }
+    elsif ( ! -d $aux_dir ) {
+        warn "$My_name: you requested aux directory '$aux_dir',\n",
+             "     but an ordinary file of the same name exists, which will\n",
+             "     probably give an error later\n";
+    }
 }
 
 if ( $jobname ne '' ) { 
     $jobstring = "--jobname=$jobname";
-    add_option( \$latex, " $jobstring" ); 
-    add_option( \$pdflatex, " $jobstring" ); 
+    add_option( "$jobstring", \$latex, \$pdflatex );
 }
 
 # Which kind of file do we preview?
@@ -1606,7 +1972,7 @@
 
 if ( $pdf_mode == 2 ) {
     # We generate pdf from ps.  Make sure we have the correct kind of ps.
-    add_option( \$dvips, " $dvips_pdf_switch" );
+    add_option( "$dvips_pdf_switch", \$dvips );
 }
 
 # Note sleep has granularity of 1 second.
@@ -1636,6 +2002,22 @@
     $generated_exts_all{$_} = 1;
 }
 
+if ($aux_dir) {
+    # Ensure $aux_dir is in TEXINPUTS search path.
+    # This is used by dvips for files generated by mpost.
+    if ( ! exists $ENV{TEXINPUTS} ) {
+	# Note the trailing ":" which ensures that the last item
+	# in the list of paths is the empty path, which actually
+	# means the default path, i.e., the following means that
+	# the TEXINPUTS search path is $aux_dir and the standard
+	# value.
+	$ENV{TEXINPUTS} = $aux_dir.$search_path_separator;
+    }
+    elsif ( $ENV{TEXINPUTS} !~ /$aux_dir$search_path_separator/ ) {
+	$ENV{TEXINPUTS} = $aux_dir.$search_path_separator.$ENV{TEXINPUTS};
+    }
+}
+
 $quell_uptodate_msgs = $silent; 
    # Whether to quell informational messages when files are uptodate
    # Will turn off in -pvc mode
@@ -1690,26 +2072,30 @@
         $root_filename = $jobname;
     }
 
+    $aux_main = "$aux_dir1$root_filename.aux";
+    $log_name = "$aux_dir1$root_filename.log";
+    $fdb_name = "$aux_dir1$root_filename.$fdb_ext";
+
     # Initialize basic dependency information:
 
     # For use under error conditions:
-    @default_includes = ($texfile_name, "$root_filename.aux");  
+    @default_includes = ($texfile_name, $aux_main);
 
-    $fdb_file = "$root_filename.$fdb_ext";
-    
-    # Initialize file and rule databases.
+    # Initialize rule database.  
+    # ?? Should I also initialize file database?
     %rule_list = ();
     &rdb_make_rule_list;
     &rdb_set_rules(\%rule_list);
 
     if ( $cleanup_mode > 0 ) {
+# ?? MAY NEED TO FIX THE FOLLOWING IF $aux_dir or $out_dir IS SET.
         my %other_generated = ();
         my @index_bibtex_generated = ();
         my @aux_files = ();
         $have_fdb = 0;
-        if ( -e $fdb_file ) {
-            print "$My_name: Examining fdb file '$fdb_file' for rules ...\n";
-            $have_fdb = ( 0 == rdb_read( $fdb_file ) );
+        if ( -e $fdb_name ) {
+            print "$My_name: Examining fdb file '$fdb_name' for rules ...\n";
+            $have_fdb = ( 0 == rdb_read( $fdb_name ) );
         }
         if ( $have_fdb ) {
             rdb_for_all(
@@ -1733,10 +2119,10 @@
             );
         }
         else {
-            # No fdb file, so do inferior job by parse_logB
-            print "$My_name: Examining log file '$root_filename.log' for generated files...\n";
+            # No fdb file, so do inferior job by parse_log
+            print "$My_name: Examining log file '$log_name' for generated files...\n";
 
-            # Variables set by parse_logB. Can I remove them
+            # Variables set by parse_log. Can I remove them
             local %generated_log = ();
 	    local %dependents = ();    # Maps files to status.  Not used here.
 	    local @bbl_files = ();     # Not used here.
@@ -1745,7 +2131,7 @@
 			 # Maps output file created and read by (pdf)latex
 			 #    to source file of conversion.
 	    local $primary_out = '';   # Actual output file (dvi or pdf). Not used here.
-            &parse_logB;
+            &parse_log;
             %other_generated = %generated_log;
 	}
 
@@ -1776,31 +2162,36 @@
                        ." (only deleted if \$cleanup_includes_generated is set): ",
                         keys %other_generated );
 	}
-        #    files used in previous versions of latexmk
-        &cleanup1( $fdb_ext, 'blg', 'ilg', 'log', 'aux.bak', 'idx.bak', 
+        &cleanup1( $aux_dir1, $fdb_ext, 'blg', 'ilg', 'log', 'aux.bak', 'idx.bak',
                    split(' ',$clean_ext), 
                    keys %generated_exts_all 
                  );
-        unlink( 'texput.log', "texput.aux", 
+        unlink_or_move( 'texput.log', "texput.aux", 
                 keys %index_bibtex_generated, 
                 keys %aux_files );
         if ($cleanup_includes_generated) {
-	    unlink( keys %other_generated );
+	    unlink_or_move( keys %other_generated );
 	}
         if ( $cleanup_includes_cusdep_generated) {
 	    &cleanup_cusdep_generated;
 	}
         if ( $cleanup_mode == 1 ) { 
-            &cleanup1( 'dvi', 'dviF', 'ps', 'psF', 'pdf',
+            &cleanup1( $out_dir1, 'dvi', 'dviF', 'ps', 'psF', 'pdf',
                        split(' ', $clean_full_ext)
                      );
         }
     }
-    if ($cleanup_fdb) { unlink $fdb_file; }
+    if ($cleanup_fdb) {
+       unlink_or_move( $fdb_name );
+       # If the fdb file exists, it will have been read, and therefore changed
+       #   rule database.  But deleting the fdb file implies we also want
+       #   a virgin rule database, so we must reset it:
+       rdb_set_rules( \%rule_list );
+    }
     if ($cleanup_only) { next FILE; }
 
 
-#??? The following are not needed if use makeB.  
+#??? The following are not needed if use rdb_make.  
 #    ?? They may be set too early?
 # Arrays and hashes for picking out accessible rules.
 # Distinguish rules for making files and others
@@ -1826,7 +2217,7 @@
     }
 
     $have_fdb = 0;
-    if ( (! -e $fdb_file) && (! -e "$root_filename.aux") ) {
+    if ( (! -e $fdb_name) && (! -e $aux_main ) ) {
         # No aux and no fdb file => set up trivial aux file 
         #    and corresponding fdb_file.  Arrange them to provoke one run 
         #    as minimum, but no more if actual aux file is trivial.
@@ -1834,8 +2225,8 @@
         &set_trivial_aux_fdb;
     }
 
-    if ( -e $fdb_file ) {
-        $rdb_errors = rdb_read( $fdb_file );
+    if ( -e $fdb_name ) {
+        $rdb_errors = rdb_read( $fdb_name );
         $have_fdb = ($rdb_errors == 0);
     }
     if (!$have_fdb) { 
@@ -1843,10 +2234,10 @@
         # previous run.  So use filetime criterion for make
         # instead of change from previous run, until we have
         # done our own make.
-	rdb_recurseA( [keys %possible_primaries],
+	rdb_recurse( [keys %possible_primaries],
 		      sub{ if ( $$Ptest_kind == 1 ) { $$Ptest_kind = 3;} }
         );
-        if ( -e "$root_filename.log" ) {
+        if ( -e $log_name ) {
 	    rdb_for_some( [keys %possible_primaries], \&rdb_set_latex_deps );
 	}
     }
@@ -1861,7 +2252,7 @@
 
     if ($go_mode) {
         # Force everything to be remade.
-	rdb_recurseA( [keys %requested_filerules], sub{$$Pout_of_date=1;}  );
+	rdb_recurse( [keys %requested_filerules], sub{$$Pout_of_date=1;}  );
     }
 
 
@@ -1873,7 +2264,7 @@
     #************************************************************
 
     if ( $preview_continuous_mode ) { 
-        &make_preview_continuousB; 
+        &make_preview_continuous; 
         # Will probably exit by ctrl/C and never arrive here.
         next FILE;
     }
@@ -1894,7 +2285,7 @@
     #Initialize failure flags now.
     $failure = 0;
     $failure_msg = '';
-    $failure = rdb_makeB( keys %requested_filerules );
+    $failure = rdb_make( keys %requested_filerules );
     if ($failure > 0) { next FILE; }
     rdb_for_some( [keys %one_time], \&rdb_run1 );
 } # end FILE
@@ -1907,7 +2298,8 @@
         if ( $failure_msg ) {
             #Remove trailing space
             $failure_msg =~ s/\s*$//;
-            warn "$My_name: Did not finish processing file:\n   $failure_msg\n";
+            warn "$My_name: Did not finish processing file '$filename':\n",
+                 "   $failure_msg\n";
             $failure = 1;
         }
     }
@@ -1945,7 +2337,8 @@
            @failed_primaries);
     }
     if ( !$force_mode ) {
-      warn "$My_name: Use the -f option to force complete processing.\n";
+      warn "$My_name: Use the -f option to force complete processing,\n",
+           " unless error was exceeding maximum runs of latex/pdflatex.\n";
     }
     exit 12;
 }
@@ -1965,6 +2358,14 @@
         # Source only
         if ( $_ && ! /%/ ) { $_ .= " %O %S"; }
     }
+    foreach ($pdf_previewer, $ps_previewer, $ps_previewer_landscape,
+             $dvi_previewer, $dvi_previewer_landscape,
+    ) {
+        # Run previewers detached
+        if ( $_ && ! /^(nostart|NONE|internal) / ) {
+            $_ = "start $_";
+        }
+    }
     foreach ($biber, $bibtex) {
         # Base only
         if ( $_ && ! /%/ ) { $_ .= " %O %B"; }
@@ -1986,10 +2387,14 @@
 #############################################################
 
 sub add_option {
-    # Call add_option( \$cmd, $opt )
-    # Add option to command
-    if ( ${$_[0]} !~ /%/ ) { &fix_cmds; }
-    ${$_[0]} =~ s/%O/$_[1] %O/;
+    # Call add_option( $opt, \$cmd ... )
+    # Add option to one or more commands
+    my $option = shift;
+    while (@_) {
+        if ( ${$_[0]} !~ /%/ ) { &fix_cmds; }
+        ${$_[0]} =~ s/%O/$option %O/;
+        shift;
+    }
 } #END add_option
 
 #############################################################
@@ -1997,17 +2402,18 @@
 sub rdb_make_rule_list {
 # Substitutions: %S = source, %D = dest, %B = this rule's base
 #                %T = texfile, %R = root = base for latex.
+#                %Y for $aux_dir1, %Z for $out_dir1
 
     # Defaults for dvi, ps, and pdf files
     # Use local, not my, so these variables can be referenced
-    local $dvi_final = "%R.dvi";
-    local $ps_final  = "%R.ps";
-    local $pdf_final = "%R.pdf";
+    local $dvi_final = "%Z%R.dvi";
+    local $ps_final  = "%Z%R.ps";
+    local $pdf_final = "%Z%R.pdf";
     if ( length($dvi_filter) > 0) {
-        $dvi_final = "%R.dviF";
+        $dvi_final = "%Z%R.dviF";
     }
     if ( length($ps_filter) > 0) {
-        $ps_final = "%R.psF";
+        $ps_final = "%Z%R.psF";
     }
 
     my $print_file = '';
@@ -2047,14 +2453,14 @@
 # This is because, especially for dvi file, the contents of the file may contain
 #    a pointer to a file to be included, not the contents of the file! 
     %rule_list = (
-        'latex'    => [ 'primary',  "$latex",     '',            "%T",        "%B.dvi",  "%R", 1, ["%R.log"] ],
-        'pdflatex' => [ 'primary',  "$pdflatex",  '',            "%T",        "%B.pdf",  "%R", 1, ["%R.log"] ],
-        'dvipdf'   => [ 'external', "$dvipdf",    'do_viewfile', $dvi_final,  "%B.pdf",  "%R", 2 ],
-        'dvips'    => [ 'external', "$dvips",     'do_viewfile', $dvi_final,  "%B.ps",   "%R", 2 ],
-        'dvifilter'=> [ 'external', $dvi_filter,  'do_viewfile', "%B.dvi",    "%B.dviF", "%R", 2 ],
-        'ps2pdf'   => [ 'external', "$ps2pdf",    'do_viewfile', $ps_final,   "%B.pdf",  "%R", 2 ],
-        'psfilter' => [ 'external', $ps_filter,   'do_viewfile', "%B.ps",     "%B.psF",  "%R", 2 ],
-        'print'    => [ 'external', "$print_cmd", 'if_source',   $print_file, "",        "",   2 ],
+        'latex'    => [ 'primary',  "$latex",     '',            "%T",        "%Z%B.dvi",  "%R",   1, ["%Y%R.log"] ],
+        'pdflatex' => [ 'primary',  "$pdflatex",  '',            "%T",        "%Z%B.pdf",  "%R",   1, ["%Y%R.log"] ],
+        'dvipdf'   => [ 'external', "$dvipdf",    'do_viewfile', $dvi_final,  "%B.pdf",    "%Z%R", 2 ],
+        'dvips'    => [ 'external', "$dvips",     'do_viewfile', $dvi_final,  "%B.ps",     "%Z%R", 2 ],
+        'dvifilter'=> [ 'external', $dvi_filter,  'do_viewfile', "%B.dvi",    "%B.dviF",   "%Z%R", 2 ],
+        'ps2pdf'   => [ 'external', "$ps2pdf",    'do_viewfile', $ps_final,   "%B.pdf",    "%Z%R", 2 ],
+        'psfilter' => [ 'external', $ps_filter,   'do_viewfile', "%B.ps",     "%B.psF",    "%Z%R", 2 ],
+        'print'    => [ 'external', "$print_cmd", 'if_source',   $print_file, "",          "",     2 ],
         'update_view' => [ 'external', $viewer_update_command, $PA_update,
                                $view_file,  "",        "",   2 ],
         'view'     => [ 'external', "$viewer",    'if_source',   $view_file,  "",        "",   2 ],
@@ -2095,6 +2501,8 @@
 	    # until run time, in case of changes.
 	    foreach ($base, $source, $dest, @$PA_extra_gen ) {
 		s/%R/$root_filename/;
+		s/%Y/$aux_dir1/;
+		s/%Z/$out_dir1/;
 	    }
 	    foreach ($source, $dest ) { 
 		s/%B/$base/;
@@ -2104,7 +2512,7 @@
     #              "    S='$source', D='$dest', B='$base' $needs_making\n";
 	    rdb_create_rule( $rule, $cmd_type, $ext_cmd, $int_cmd, $test_kind, 
 			     $source, $dest, $base,
-			     $needs_making, undef, 1, $PA_extra_gen );
+			     $needs_making, undef, undef, 1, $PA_extra_gen );
 # !! ?? Last line was
 #			     $needs_making, undef, ($test_kind==1) );
 	}
@@ -2156,20 +2564,20 @@
     # 2. Write a corresponding fdb file
     # 3. Provoke a run of (pdf)latex (actually of all primaries). 
 
-    local $aux_file = "$root_filename.aux";
-    open( aux_file, '>', $aux_file )
-        or die "Cannot write file '$aux_file'\n";
+    local *aux_file;
+    open( aux_file, '>', $aux_main )
+        or die "Cannot write file '$aux_main'\n";
     print aux_file "\\relax \n";
     close(aux_file);
 
     foreach my $rule (keys %primaries ) { 
         rdb_ensure_file( $rule, $texfile_name );
-        rdb_ensure_file( $rule, $aux_file );
+        rdb_ensure_file( $rule, $aux_main );
         rdb_one_rule(  $rule,  
                        sub{ $$Pout_of_date = 1; }
                     );
     }
-    &rdb_write( $fdb_file );
+    &rdb_write( $fdb_name );
 } #END set_trivial_aux_fdb
 
 #************************************************************
@@ -2238,12 +2646,21 @@
     my $return = 0;
     my ($base, $path, $ext) = fileparseA( $$Pdest );
     if ( &view_file_via_temporary ) {
-        my $tmpfile = tempfile1( "${root_filename}_tmp", $ext );
-        $return = &rdb_ext_cmd1( '', '', $tmpfile );
-        move( $tmpfile, $$Pdest );
+        if ( $$Pext_cmd =~ /%D/ ) {
+            my $tmpfile = tempfile1( "${root_filename}_tmp", $ext );
+            warn "$My_name: Making '$$Pdest' via temporary '$tmpfile'...\n";
+            $return = &Run_subst( undef, undef, undef, undef, $tmpfile );
+            move( $tmpfile, $$Pdest );
+        }
+        else {
+            warn "$My_name is configured to make '$$Pdest' via a temporary file\n",
+                 "    but the command template '$$Pext_cmd' does not have a slot\n",
+	    "    to set the destination file, so I won't use a temporary file\n";
+            $return = &Run_subst();
+	}
     }
     else {
-        $return = &rdb_ext_cmd;
+        $return = &Run_subst();
     }
     return $return;
 } #END do_viewfile
@@ -2290,7 +2707,7 @@
     }
     elsif ($viewer_update_method == 4) {
         if (defined $$Pext_cmd) {
-            $return = &rdb_ext_cmd;
+            $return = &Run_subst();
 	}
         else {
             warn "$My_name: viewer is supposed to be updated by running a command,\n",
@@ -2306,7 +2723,7 @@
     # Unconditionally apply rule if source file exists.
     # Assumes rule context
     if ( -e $$Psource ) {
-        return &rdb_ext_cmd;
+        return &Run_subst();
     }
     else {
 	return -1;
@@ -2397,7 +2814,7 @@
 
 #************************************************************
 
-sub make_preview_continuousB {
+sub make_preview_continuous {
     local @changed = ();
     local @disappeared = ();
     local @no_dest = ();       # Non-existent destination files
@@ -2405,7 +2822,6 @@
     local @rules_to_apply = ();
 
     local $failure = 0;
-    local $runs = 0;
     local %rules_applied = ();
     local $updated = 0;
 
@@ -2472,7 +2888,10 @@
             #   $MSWin_fudge_break.
             $SIG{BREAK} = $SIG{INT} = 'IGNORE';
         }
-        $failure = rdb_makeB( @targets );
+        if ($compiling_cmd) {
+	    Run_subst( $compiling_cmd );
+        }
+        $failure = rdb_make( @targets );
 
 ##     warn "=========Viewer PID = $$Pviewer_process; updated=$updated\n";
 
@@ -2539,13 +2958,25 @@
             $failure_msg =~ s/\s*$//;  #Remove trailing space
             warn "$My_name: $failure_msg\n",
     "    ==> You will need to change a source file before I do another run <==\n";
+            if ($failure_cmd) {
+	        Run_subst( $failure_cmd );
+            }
 	}
+        else {
+            if ($success_cmd) {
+	        Run_subst( $success_cmd );
+            }
+        }
         rdb_show_rule_errors();
         if ($show_time && ! $first_time) { show_timing(); }
         if ( $first_time || $updated || $failure ) {
             print "\n=== Watching for updated files. Use ctrl/C to stop ...\n";
         }
         $waiting = 1; if ($diagnostics) { warn "WAITING\n"; }
+# During waiting for file changes, handle ctrl/C and ctrl/break here, rather than letting
+#   system handle them by terminating script (and any script that calls it).  This allows,
+#   for example, the clean up code in the following command line to work:
+#          latexmk -pvc foo; cleanup;
         &catch_break;
         $have_break = 0;
   WAIT: while (1) {
@@ -2562,7 +2993,7 @@
            $processing_time1 = processing_time();
         # Does this do this job????
            local $new_files = 0;
-           rdb_for_some( [keys %current_primaries], sub{ $new_files += &rdb_find_new_filesB } );
+           rdb_for_some( [keys %current_primaries], sub{ $new_files += &rdb_find_new_files } );
            if ($new_files > 0) {
 	       warn "$My_name: New file(s) found.\n";
                last WAIT; 
@@ -2576,7 +3007,7 @@
      }
      $waiting = 0; if ($diagnostics) { warn "NOT       WAITING\n"; }
   } #end infinite_loop CHANGE:
-} #END sub make_preview_continuousB
+} #END sub make_preview_continuous
 
 #************************************************************
 
@@ -2585,16 +3016,37 @@
     # NEW VERSION
     # Run rc_file whose name is given in first argument
     #    Exit with code 0 on success
-    #    Exit with code 1 if file could not be read.
+    #    Exit with code 1 if file cannot be read or does not exist.
     #    Stop if there is a syntax error or other problem.
+    # PREVIOUSLY: 
+    #    Exit with code 2 if is a syntax error or other problem.
     my $rc_file = $_[0];
     my $ret_code = 0;
     warn "$My_name: Executing Perl code in file '$rc_file'...\n" 
         if  $diagnostics;
-    if ( ! -r $rc_file ) {
+    # I could use the do command of perl, but the preceeding -r test
+    # to get good diagnostics gets the wrong result under cygwin
+    # (e.g., on /cygdrive/c/latexmk/LatexMk)
+    my $RCH = new FileHandle;
+    if ( !-e $rc_file ) {
+        warn "$My_name: The rc-file '$rc_file' does not exist\n";
         return 1;
     }
-    do( $rc_file );
+    elsif ( open $RCH, "<$rc_file" ) {
+        { local $/; eval <$RCH>; }
+        close $RCH;
+    }
+    else {
+        warn "$My_name: I cannot read the rc-file '$rc_file'\n";
+        return 1;
+    }
+    # PREVIOUS VERSION
+#    if ( ! -r $rc_file ) {
+#        warn "$My_name: I cannot read the rc-file '$rc_file'\n",
+#  	     "          or at least that's what Perl (for $^O) reports\n";
+#        return 1;
+#    }
+#    do( $rc_file );
     if ( $@ ) {
         # Indent each line of possibly multiline message:
         my $message = prefix( $@, "     " );
@@ -2639,10 +3091,11 @@
 #************************************************************
 
 sub cleanup1 {
-    # Usage: cleanup1( exts_without_period, ... )
+    # Usage: cleanup1( directory, exts_without_period, ... )
+    my $dir = shift;
     foreach (@_) { 
-        (my $name = /%R/ ? $_ : "%R.$_") =~ s/%R/$root_filename/;
-        unlink("$name");
+        (my $name = /%R/ ? $_ : "%R.$_") =~ s/%R/$dir$root_filename/;
+        unlink_or_move("$name");
     }
 } #END cleanup1
 
@@ -2665,7 +3118,7 @@
        return;
     }
     if ( (-e $$Pdest) && (-e $$Psource) ) {
-        unlink $$Pdest;
+        unlink_or_move( $$Pdest );
     }
     elsif ( (-e $$Pdest) && (!-e $$Psource) ) {
         warn "$My_name: For custom dependency '$rule',\n",
@@ -2757,9 +3210,12 @@
   "$My_name $version_num: Automatic LaTeX document generation routine\n\n",
   "Usage: $my_name [latexmk_options] [filename ...]\n\n",
   "  Latexmk_options:\n",
-  "   -bibtex         - use bibtex when needed (default)\n",
-  "   -bibtex-        - never use bibtex\n",
-  "   -bibtex-cond    - use bibtex when needed, but only if the bib files exist\n",
+  "   -aux-directory=dir or -auxdir=dir \n",
+  "                 - set name of directory for auxiliary files (aux, log)\n",
+  "                 - Currently this only works with MiKTeX\n",
+  "   -bibtex       - use bibtex when needed (default)\n",
+  "   -bibtex-      - never use bibtex\n",
+  "   -bibtex-cond  - use bibtex when needed, but only if the bib files exist\n",
   "   -bm <message> - Print message across the page when converting to postscript\n",
   "   -bi <intensity> - Set contrast or intensity of banner\n",
   "   -bs <scale> - Set scale for banner\n",
@@ -2800,10 +3256,17 @@
   "   -l-    - turn off -l\n",
   "   -latex=<program> - set program used for latex.\n",
   "                      (replace '<program>' by the program name)\n",
+  "   -latexoption=<option> - add the given option to the (pdf)latex command\n",
+  "   -M     - Show list of dependent files after processing\n",
+  "   -MF file - Specifies name of file to receives list dependent files\n",
+  "   -MP    - List of dependent files includes phony target for each source file.\n",
   "   -new-viewer    - in -pvc mode, always start a new viewer\n",
   "   -new-viewer-   - in -pvc mode, start a new viewer only if needed\n",
   "   -nobibtex      - never use bibtex\n",
   "   -nodependents  - Do not show list of dependent files after processing\n",
+  "   -norc          - omit automatic reading of system, user and project rc files\n",
+  "   -output-directory=dir or -outdir=dir\n",
+  "                  - set name of directory for output files\n",
   "   -pdf   - generate pdf by pdflatex\n",
   "   -pdfdvi - generate pdf by dvipdf\n",
   "   -pdflatex=<program> - set program used for pdflatex.\n",
@@ -2824,12 +3287,17 @@
   "                on force mode, so errors do not cause $my_name to stop.)\n",
   "            (Side effect: turn off ordinary preview mode.)\n",
   "   -pvc-  - turn off -pvc\n",
+  "   -quiet    - silence progress messages from called programs\n",
   "   -r <file> - Read custom RC file\n",
+  "               (N.B. This file could override options specified earlier\n",
+  "               on the command line.)\n",
   "   -recorder - Use -recorder option for (pdf)latex\n",
   "               (to give list of input and output files)\n",
   "   -recorder- - Do not use -recorder option for (pdf)latex\n",
   "   -rules    - Show list of rules after processing\n",
   "   -rules-   - Do not show list of rules after processing\n",
+  "   -showextraoptions  - Show other allowed options that are simply passed\n",
+  "               as is to latex and pdflatex\n",
   "   -silent   - silence progress messages from called programs\n",
   "   -time     - show CPU time used\n",
   "   -time-    - don't show CPU time used\n",
@@ -2843,14 +3311,18 @@
   "   -view=none    - no viewer is used\n",
   "   -view=ps      - viewer is for ps\n",
   "   -view=pdf     - viewer is for pdf\n",
+  "   -xelatex      - use xelatex for processing files to pdf\n",
+  "\n",
   "   filename = the root filename of LaTeX document\n",
   "\n",
   "-p, -pv and -pvc are mutually exclusive\n",
   "-h, -c and -C override all other options.\n",
   "-pv and -pvc require one and only one filename specified\n",
   "All options can be introduced by '-' or '--'.  (E.g., --help or -help.)\n",
-  "Contents of RC file specified by -r overrides options specified\n",
-  "  before the -r option on the command line\n";
+  " \n",
+  "In addition, latexmk recognizes many other options that are passed to\n",
+  "latex and/or pdflatex without interpretation by latexmk.  Run latexmk\n",
+  "with the option -showextraoptions to see a list of these\n";
 
 } #END print_help
 
@@ -2902,9 +3374,14 @@
 
 sub check_biber_log {
     # Check for biber warnings:
-    # Usage: check_biber_log( base_of_biber_run[, \@biber_source )
-    # return 0: OK, 1: biber warnings, 2: biber errors, 
-    #        3: could not open .blg file.
+    # Usage: check_biber_log( base_of_biber_run, \@biber_source )
+    # return 0: OK;
+    #        1: biber warnings;
+    #        2: biber errors;
+    #        3: could not open .blg file;
+    #        4: failed to find one or more source files, except for bibfile;
+    #        5: failed to find bib file;
+    #        6: missing file, one of which is control file
     #       10: only error is missing \citation commands.
     # Side effect: add source files @biber_source
     my $base = $_[0];
@@ -2917,52 +3394,82 @@
     my $have_error = 0;
     my $missing_citations = 0;
     my $no_citations = 0;
-    my $error_count = 0;
-    my $warning_count = 0;
+    my $error_count = 0;            # From my counting of error messages
+    my $warning_count = 0;          # From my counting of warning messages
+    # The next two occur only from biber
+    my $bibers_error_count = 0;     # From biber's counting of errors
+    my $bibers_warning_count = 0;   # From biber's counting of warnings
+    my $not_found_count = 0;
+    my $control_file_missing = 0;
     while (<$log_file>) {
         if (/> WARN /) { 
             print "Biber warning: $_"; 
             $have_warning = 1;
             $warning_count ++;
         }
-        elsif (/> FATAL /) {
+        elsif (/> (FATAL|ERROR) /) {
             print "Biber error: $_"; 
-            $have_error = 1;
-            $error_count ++;
-            if ( /> FATAL - The file '[^']+' does not contain any citations!/ ) {
-                $no_citations++;
+            if ( /> (FATAL|ERROR) - Cannot find file '([^']+)'/    #'
+                 || /> (FATAL|ERROR) - Cannot find '([^']+)'/ ) {  #'
+                $not_found_count++;
+                push @$Pbiber_source, $2;
+            }
+            elsif ( /> (FATAL|ERROR) - Cannot find control file '([^']+)'/ ) {  #'
+                $not_found_count++;
+                $control_file_missing = 1;
+                push @$Pbiber_source, $2;
+            }
+            else {
+                $have_error = 1;
+                $error_count ++;
+                if ( /> (FATAL|ERROR) - The file '[^']+' does not contain any citations!/ ) { #'
+                    $no_citations++;
+	        }
             }
         }
         elsif ( /> INFO - Found .* '([^']+)'\s*$/
                 || /> INFO - Found '([^']+)'\s*$/
+                || /> INFO - Reading '([^']+)'\s*$/
+                || /> INFO - Reading (.*)$/
                 || /> INFO - Processing .* file '([^']+)' .*$/
               ) {
 	    if ( defined $Pbiber_source ) {
                 push @$Pbiber_source, $1;
 	    }
         }
+        elsif ( /> INFO - WARNINGS: ([\d]+)\s*$/ ) {
+            $bibers_warning_count = $1;
+	}
+        elsif ( /> INFO - ERRORS: ([\d]+)\s*$/ ) {
+            $bibers_error_count = $1;
+	}
     }
     close $log_file;
-    my $bibret = &find_file_list1( $Pbiber_source, $Pbiber_source,
-                                  '', \@BIBINPUTS );
+
+    my @not_found = &find_file_list1( $Pbiber_source, $Pbiber_source,
+                                      '', \@BIBINPUTS );
     @$Pbiber_source = uniqs( @$Pbiber_source );
-    if ($bibret == 0) {
-        warn "$My_name: Found biber source file(s) [@$Pbiber_source]\n" 
+    if ( ($#not_found < 0) && ($#$Pbiber_source >= 0) ) {
+        warn "$My_name: Found biber source file(s) [@$Pbiber_source]\n"
         unless $silent;
     }
+    elsif ( ($#not_found == 0) && ($not_found[0] =~ /\.bib$/) ) {
+        # Special treatment if sole missing file is bib file
+        # I don't want to treat that as an error
+        warn "$My_name: Biber did't find bib file [$not_found[0]]\n";
+	return 5;
+    }
     else {
-        warn "$My_name: Failed to find one or more biber source files ",
-             "in [@$Pbiber_source]\n";
+        show_array( "$My_name: Failed to find one or more biber source files:",
+                    @not_found );
         if ($force_mode) {
             warn "==== Force_mode is on, so I will continue.  ",
                  "But there may be problems ===\n";
         }
-        else {
-            #$failure = -1;
-            #$failure_msg = 'Failed to find one or more biber source files';
-            #warn "$My_name: Failed to find one or more biber source files\n";
-        }
-        return 3;
+        if ($control_file_missing) {
+            return 6;
+	}
+        return 4;
     }
 #    print "$My_name: #Biber errors = $error_count, warning messages = $warning_count,\n  ",
 #          "missing citation messages = $missing_citations, no_citations = $no_citations\n";
@@ -2979,12 +3486,49 @@
 
 #**************************************************
 
+sub run_bibtex {
+    my $return = 999;
+    if ( $aux_dir ) {
+        if ( $$Psource =~ /^$aux_dir1/ ) {
+            # Run bibtex in $aux_dir, fixing input search path
+            # to allow for finding files in original directory
+            my ( $base, $path, $ext ) = fileparseA( $$Psource );
+            my $cwd = good_cwd();
+            foreach ( 'BIBINPUTS', 'BSTINPUTS' ) {
+	        if ( exists $ENV{$_} ) {
+    	            $ENV{$_} = $cwd.$search_path_separator.$ENV{$_};
+	        }
+	        else {
+		    $ENV{$_} = $cwd.$search_path_separator;
+		}
+	    }
+            pushd( $path );
+            $return = &Run_subst( undef, undef, '', $base.$ext, '', $base );
+            popd();
+        }
+        else {
+            warn "$My_name: Directory in file name '$$Psource' for bibtex\n",
+                 "   but it is not the output directory '$aux_dir'\n";
+            $return = Run_subst();
+	}
+    }
+    else {
+        $return = Run_subst();
+    }
+    return $return;
+}
+
+
+#**************************************************
+
 sub check_bibtex_log {
     # Check for bibtex warnings:
     # Usage: check_bibtex_log( base_of_bibtex_run )
     # return 0: OK, 1: bibtex warnings, 2: bibtex errors, 
     #        3: could not open .blg file.
-    #       10: only error is missing \citation commands.
+    #       10: only error is missing \citation commands or a missing aux file
+    #           (which would normally be corrected after a later run of 
+    #           (pdf)latex).
 
     my $base = $_[0];
     my $log_name = "$base.blg";
@@ -2994,27 +3538,41 @@
     my $have_warning = 0;
     my $have_error = 0;
     my $missing_citations = 0;
+    my @missing_aux = ();
     my $error_count = 0;
     while (<$log_file>) {
         if (/^Warning--/) { 
             #print "Bibtex warning: $_"; 
             $have_warning = 1;
         }
+        elsif ( /^I couldn\'t open auxiliary file (.*\.aux)/ ) {
+            push @missing_aux, $1;
+	}
         elsif ( /^I found no \\citation commands---while reading file/ ) {
-            $missing_citations++; 
+            $missing_citations++;
 	}
-        elsif (/There (were|was) (\d+) error message/) { 
+        elsif (/There (were|was) (\d+) error message/) {
             $error_count = $2;
             #print "Bibtex error: count=$error_count $_"; 
             $have_error = 1;
         }
     }
     close $log_file;
-    #print "Bibtex errors = $error_count, missing citations = $missing_citations\n";
-    if ($have_error && ($error_count <= $missing_citations ) 
-        && ($missing_citations > 0) ) {
-        # If the only error is a missing citation line, that should only 
+    my $missing = $missing_citations + $#missing_aux + 1;
+
+    if ( $#missing_aux > -1 ) {
+        # Need to make the missing files.
+        warn "$My_name: One or more aux files is missing for bibtex. I'll try\n",
+             "          to get (pdf)latex to remake them.\n";
+        rdb_for_some( [keys %current_primaries], sub{ $$Pout_of_date = 1; } );
+    }
+    #print "Bibtex errors = $error_count, missing aux files and citations = $missing\n";
+    if ($have_error && ($error_count <= $missing )
+        && ($missing > 0) ) {
+        # If the only error is a missing citation line, that should only
         # count as a warning.
+        # Also a missing aux file should be innocuous; it will be created on
+        # next run of (pdf)latex.  ?? HAVE I HANDLED THAT CORRECTLY?
         # But have to deal with the problem that bibtex gives a non-zero 
         # exit code.  So leave things as they are so that the user gets
         # a better diagnostic ??????????????????????????
@@ -3029,26 +3587,25 @@
 
 #**************************************************
 
-sub clean_file_name {
-    # Convert quoted filename as found in log file to filename without quotes
-    # Allows arbitrarily embedded double-quoted substrings, includes the
-    # cases
-    # 1. `"string".ext', which arises e.g., from \jobname.bbl:
-    #    when the base filename contains spaces, \jobname has quotes.
-    #    and from \includegraphics with basename specified.
-    #    Also deals with filenames written by asymptote.sty
-    # 2. Or "string.ext" from \includegraphcs with basename and ext specified.
-    #    and from MiKTeX logfile for input files with spaces. 
-    # Doubled quotes (e.g., A""B) don't get converted.
-    # Neither do unmatched quotes.
-    my $filename = $_[0];
-    while ( $filename =~ s/^([^\"]*)\"([^\"]+)\"(.*)$/$1$2$3/ ) {}
-    return $filename;
-}
+sub normalize_force_directory {
+    #  Usage, normalize_force_directory( dir, filename )
+    #  Perform the following operations:
+    #    Clean filename
+    #    If filename contains no path component, insert dir in front
+    #    Normalize filename
+    #  Return result
+    my $default_dir = $_[0];
+    my $filename = clean_filename( $_[1] );
+    my ($base_name, $path ) = fileparse( $filename );
+    if ( $base_name eq $filename ) {
+       $filename = "$default_dir$filename";
+    }
+    return normalize_filename( $filename );
+} #END normalize force_directory
 
 # ------------------------------
 
-sub parse_logB {
+sub parse_log {
 # Scan log file for: dependent files
 #    reference_changed, bad_reference, bad_citation
 # Return value: 1 if success, 0 if no log file.
@@ -3109,7 +3666,6 @@
     $bad_reference = 0;
     $bad_citation = 0;
 
-    my $log_name = "$root_filename.log";
     my $log_file = new FileHandle;
     if ( ! open( $log_file, "<$log_name" ) ) {
         return 0;
@@ -3188,8 +3744,9 @@
 	        # First line OK
                 next LINE;
             } else {
-                warn "$My_name: Error on first line of '$log_name'.  ".
-                    "This is apparently not a TeX log file.\n";
+                warn "$My_name: Error on first line of '$log_name'.\n".
+                    "This is apparently not a TeX log file.  ",
+		    "The first line is:\n$_\n";
                 $failure = 1;
                 $failure_msg = "Log file '$log_name' appears to have wrong format.";
                 return 0;
@@ -3202,7 +3759,7 @@
                 if ( ($block_type eq 'conversion') 
                      && /^\($current_pkg\)\s+Output file: <([^>]+)>/ ) 
                 {
-		    $delegated_output = $1;
+		    $delegated_output = normalize_clean_filename($1);
                 }
 		next LINE;
 	    }
@@ -3216,20 +3773,20 @@
 	}
         # Check for changed references, bad references and bad citations:
         if (/Rerun to get/) { 
-            warn "$My_name: References changed.\n";
+            warn "$My_name: References changed.\n" if ! $silent;
             $reference_changed = 1;
         } 
 	if (/LaTeX Warning: (Reference[^\001]*undefined)./) { 
-	    warn "$My_name: $1 \n";
-	    $bad_reference = 1;
+	    warn "$My_name: $1 \n" unless $silent;
+	    $bad_reference++;
 	} 
 	if (/LaTeX Warning: (Citation[^\001]*undefined)./) {
-	    warn "$My_name: $1 \n";
-	    $bad_citation = 1;
+	    warn "$My_name: $1 \n" unless $silent;
+	    $bad_citation++;
 	}
         if (/Package natbib Warning: (Citation[^\001]*undefined)./) {
-            warn "$My_name: $1 \n";
-            $bad_citation = 1;
+            warn "$My_name: $1 \n" unless $silent;
+            $bad_citation++;
 	}
 	if ( /^Document Class: / ) {
 	    # Class sign-on line
@@ -3245,7 +3802,7 @@
 	    next LINE;
 	}
 	if ( /^Output written on\s+(.*)\s+\(\d+\s+page/ ) {
-            $primary_out = clean_file_name($1);
+            $primary_out = normalize_clean_filename($1);
 	    warn "$My_name: Log file says output to '$primary_out'\n"
 	       unless $silent;
 	    next LINE;
@@ -3259,15 +3816,18 @@
 	    next LINE;
 	}
         if ( /^\\openout\d+\s*=\s*\`([^\']+)\'\.$/ ) {
-            $generated_log{clean_file_name($1)} = 1;
+                #  When (pdf)latex is run with an -output-directory 
+                #    or an -aux_directory, the file name does not contain
+                #    the output path; fix this, after removing quotes:
+            $generated_log{normalize_force_directory( $aux_dir1, $1 )} = 1;
 	    next LINE;
 	}
         # Test for conversion produced by package:
 	if ( /^Package (\S+) Info: Source file: <([^>]+)>/ ) {
 	    # Info. produced by epstopdf (and possibly others) 
             #    about file conversion
-            $current_pkg = clean_file_name($1);
-            $delegated_source = clean_file_name($2);
+            $current_pkg = normalize_clean_filename($1);
+            $delegated_source = normalize_clean_filename($2);
             $block_type = 'conversion';
 	    next LINE;
 	}
@@ -3294,9 +3854,12 @@
    		     "  '$_'\n";
                 next LINE;
 	    }
-	    # Typically, there is trailing space, not part of filename:
+	        # Typically, there is trailing space, not part of filename:
 	    $idx_file =~ s/\s*$//;
-	    $idx_file = clean_file_name($idx_file);
+                #  When (pdf)latex is run with an -output-directory 
+                #    or an -aux_directory, the file name does not contain
+                #    the output path; fix this, after removing quotes:
+	    $idx_file = normalize_force_directory( $aux_dir1, $idx_file );
 	    my ($idx_base, $idx_path, $idx_ext) = fileparseA( $idx_file );
 	    $idx_base = $idx_path.$idx_base;
             $idx_file = $idx_base.$idx_ext;
@@ -3320,8 +3883,10 @@
 	    next LINE;
 	}
 	if ( /^No file (.*?\.bbl)./ ) {
-	    # Notice that the
-	    my $bbl_file = clean_file_name($1);
+                #  When (pdf)latex is run with an -output-directory 
+                #    or an -aux_directory, the file name does not contain
+                #    the output path; fix this, after removing quotes:
+	    my $bbl_file = normalize_force_directory( $aux_dir1, $1 );
 	    warn "$My_name: Non-existent bbl file '$bbl_file'\n $_\n";
     	    $dependents{$bbl_file} = 0;
 	    push @bbl_files, $bbl_file;
@@ -3329,16 +3894,28 @@
 	}
 	foreach my $pattern (@file_not_found) {
 	    if ( /$pattern/ ) {
-		my $file = clean_file_name($1);
+                my $file = clean_filename($1);
 		warn "$My_name: Missing input file: '$file' from line\n  '$_'\n"
 		    unless $silent;
-		$dependents{$file} = 0;
+		$dependents{normalize_filename($file)} = 0;
+		my $file1 = $file;
+                if ( $aux_dir ) {
+                      # Allow for the possibility that latex generated
+                      # a file in $aux_dir, from which the missing file can
+                      # be created by a cusdep (or other) rule that puts
+                      # the result in $out_dir.  If the announced missing file
+                      # has no path, then it would be effectively a missing
+                      # file in $aux_dir, with a path.  So give this alternate
+                      # location.
+                      my $file1 = normalize_force_directory( $aux_dir1, $file );
+		      $dependents{$file1} = 0;
+		}
 		next LINE;
 	    }
 	}
 	if ( /^File: (.+) Graphic file \(type / ) {
 	    # First line of message from includegraphics/x
-	    $dependents{clean_file_name($1)} = 1;
+	    $dependents{normalize_clean_filename($1)} = 1;
 	    next LINE;
 	}
 	# Now test for generic lines to ignore, only after special cases!
@@ -3467,6 +4044,7 @@
 	    }
 	INCLUDE_NAME:
             foreach my $include_name (@new_includes) {
+                $include_name = normalize_filename( $include_name );
 	        my ($base, $path, $ext) = fileparseB( $include_name );
                 if ( ($path eq './') || ($path eq '.\\') ) {
                     $include_name = $base.$ext;
@@ -3654,23 +4232,45 @@
         }
     }
     return 1;
-} #END parse_logB
+} #END parse_log
 
 #************************************************************
 
 sub parse_fls {
-    my ($fls_name, $Pinputs, $Poutputs ) = @_;
-    %$Pinputs = %$Poutputs = ();
+    my ($fls_name, $Pinputs, $Poutputs, $Pfirst_read_after_write ) = @_;
+    %$Pinputs = %$Poutputs = %$Pfirst_read_after_write = ();
     my $fls_file = new FileHandle;
+    # Make a note of current working directory
+    # I'll update it from the fls file later
+    # Currently I don't use this, but it would be useful to use
+    # this when testing prefix for cwd in a filename, by
+    # giving (pdf)latex's best view of the cwd.  Note that the
+    # value given by the cwd() function may be mangled, e.g., by cygwin
+    # compared with native MSWin32.
+    my $cwd = good_cwd();
     if ( ! open ($fls_file, "<$fls_name") ) {
         return 1;
     }
     foreach $_ ( <$fls_file> ) {
-        if (/^\s*INPUT\s+(.*)\s+$/) {
-	    $$Pinputs{$1} = 1;
+        # Remove trailing CR and LF. Thus we get correct behavior when an fls file
+        #  is produced by MS-Windows program (e.g., in MiKTeX) with CRLF line ends,
+        #  but is read by Unix Perl (which treats LF as line end, and preserves CRLF
+        #  in read-in lines):
+        $_ =~ s/[\n\r]*$//;
+        if (/^\s*PWD\s+(.*)$/) {
+            $cwd = $1;
+        }
+        elsif (/^\s*INPUT\s+(.*)$/) {
+            # Take precautions against aliasing of foo, ./foo and other possibilities for cwd.
+            my $file = normalize_filename( $1 );
+            if ( (exists $$Poutputs{$file}) && (! exists $$Pinputs{$file}) ) {
+                $$Pfirst_read_after_write{$file} = 1;
+            }
+	    $$Pinputs{$file} = 1;
 	}
-        elsif (/^\s*OUTPUT\s+(.*)\s+$/) {
-	    $$Poutputs{$1} = 1;
+        elsif (/^\s*OUTPUT\s+(.*)$/) {
+            # Take precautions against aliasing of foo, ./foo and other possibilities for cwd.
+	    $$Poutputs{ normalize_filename( $1 )} = 1;
 	}
     }
     close( $fls_file );
@@ -3679,6 +4279,68 @@
 
 #************************************************************
 
+sub clean_filename {
+    # Convert quoted filename as found in log file to filename without quotes
+    # Allows arbitrarily embedded double-quoted substrings, includes the
+    # cases
+    # 1. `"string".ext', which arises e.g., from \jobname.bbl:
+    #    when the base filename contains spaces, \jobname has quotes.
+    #    and from \includegraphics with basename specified.
+    #    Also deals with filenames written by asymptote.sty
+    # 2. Or "string.ext" from \includegraphcs with basename and ext specified.
+    #    and from MiKTeX logfile for input files with spaces. 
+    # Doubled quotes (e.g., A""B) don't get converted.
+    # Neither do unmatched quotes.
+    my $filename = $_[0];
+    while ( $filename =~ s/^([^\"]*)\"([^\"]+)\"(.*)$/$1$2$3/ ) {}
+    return $filename;
+}
+
+# ------------------------------
+
+sub normalize_filename {
+   # Remove various forms for cwd at start of filename.
+   # Convert to have directory separator = '/' only
+   my $file = $_[0];
+   my $file1 = $file;   # Saved original value
+   my $cwd = good_cwd();
+   # Normalize files to use / to separate directory components:
+   # (Note both / and \ are allowed under MSWin.)
+   $cwd =~ s(\\)(/)g;
+   $file =~ s(\\)(/)g;
+
+   # Remove current directory string:
+   $file =~ s(^\./)();
+   $file =~ s(^$cwd/)();
+
+   return $file;
+}
+
+# ------------------------------
+
+sub normalize_clean_filename {
+    # Remove quotes around filename --- see clean_filename --- as from log file.
+    # Then remove any string for cwd, and convert to use '/' for directory separator,
+    # (and any other standardization) done by normalize_filename.
+    return normalize_filename( clean_filename( $_[0] ));
+}
+
+#************************************************************
+
+sub OS_preferred_filename {
+   # Usage: OS_preferred_filename(name)
+   # Returns filename with directory separator '/' converted
+   # to preferred conventions for current OS.
+   # Currently implemented: only '\' for MSWin32
+   my $file = $_[0];
+   if ( $^O eq 'MSWin32' ) {
+      $file =~ s(/)(\\)g;
+    }
+   return $file;
+}
+
+#************************************************************
+
 sub parse_aux {
     #Usage: parse_aux( $aux_file, \@new_bib_files, \@new_aux_files, \@new_bst_files )
     # Parse aux_file (recursively) for bib files, and bst files.  
@@ -3712,18 +4374,18 @@
         warn "$My_name: No .bib files listed in .aux file '$aux_file' \n",
         return 2;
     }
-    my $bibret = &find_file_list1( $Pbib_files, $Pbib_files,
-                                  '.bib', \@BIBINPUTS );
+    my @not_found = &find_file_list1( $Pbib_files, $Pbib_files,
+                                      '.bib', \@BIBINPUTS );
     @$Pbib_files = uniqs( @$Pbib_files );
     &find_file_list1( $Pbst_files, $Pbst_files, '.bst' );
     @$Pbst_files = uniqs( @$Pbst_files );
-    if ($bibret == 0) {
-        warn "$My_name: Found bibliography file(s) [@$Pbib_files]\n" 
+    if ( $#not_found < 0) {
+        warn "$My_name: Found bibliography file(s) [@$Pbib_files]\n"
         unless $silent;
     }
     else {
-        warn "$My_name: Failed to find one or more bibliography files ",
-             "in [@$Pbib_files]\n";
+        show_array( "$My_name: Failed to find one or more bibliography files ",
+                    @not_found );
         if ($force_mode) {
             warn "==== Force_mode is on, so I will continue.  ",
                  "But there may be problems ===\n";
@@ -3771,7 +4433,7 @@
       }
       elsif ( /^\\\@input\{(.*)\}/ ) { 
           # \\@input{next_aux_file_name}
-	  &parse_aux1( $1 );
+	  &parse_aux1( $aux_dir1.$1 );
       }
    }
    close($aux_fh);
@@ -3789,11 +4451,12 @@
 #************************************************************
 
 sub fdb_get {
-    # Call: fdb_get(filename [, run_time])
+    # Call: fdb_get(filename [, check_time])
     # Returns an array (time, size, md5) for the current state of the
     #    named file.
-    # The optional argument run_time is the runtime of some command
-    #    associated with the use of the file --- see below.
+    # The optional argument check_time is either the run_time of some command
+    #    that may have changed the file or the last time the file was checked
+    #    for changes --- see below.
     # For non-existent file, deletes its entry in fdb_current, 
     #    and returns (0,-1,0)  
     # As an optimization, the md5 value is taken from the cache in 
@@ -3811,11 +4474,11 @@
     #    at some runtime t, the file is rewritten later by the same or another
     #    program, with timestamp t, and when the initial file also has 
     #    timestamp t.
-    # A test is applied for this situation if the run_time argument is 
+    # A test is applied for this situation if the check_time argument is
     #    supplied and is nonzero.
 
-    my ($file, $run_time) = @_;
-    if ( ! defined $run_time ) { $run_time = 0;}
+    my ($file, $check_time) = @_;
+    if ( ! defined $check_time ) { $check_time = 0;}
     my ($new_time, $new_size) = get_time_size($file);
     my @nofile =  (0,-1,0);     # What we use for initializing
 				# a new entry in fdb or flagging
@@ -3833,23 +4496,27 @@
     my $file_data = $fdb_current{$file};
     my ( $time, $size, $md5 ) = @$file_data;
 
-#warn "--------- Getting MD5: $file: (N,O,R) = $new_time, $time, $run_time\n";
-#warn "--------- $file: (OT,OS,OM) = @$file_data\n";
     if ( ($new_time != $time) || ($new_size != $size) 
-         || ( $run_time && ($run_time == $time ) )
+         || ( $check_time && ($check_time == $time ) )
        ) {
-        # Only force recalculation of md5 if time or size changed
-        # Or if the time equals run_time, so that the file may
-        #   have changed within the 1-second granularity of the time
+        # Only force recalculation of md5 if time or size changed.
+        # However, the physical file time may have changed without
+        #   affecting the value of the time coded in $time, because
+        #   times are computed with a 1-second granularity.
+        #   The only case to treat specially is where the file was created,
+        #   then used by the current rule, and then rewritten, all within
+        #   the granularity size, otherwise the value of the reported file
+        #   time changed, and we've handled it.  But we may have already
+        #   checked this at an earlier time than the current check.  So the
+        #   only dangerous case is where the file time equals a check_time,
+        #   which is either the run_time of the command or the time of a
+        #   previous check.
         # Else we assume file is really unchanged.
         $recalculate_md5 = 1;
     }
     if ($recalculate_md5) {
-#warn "--------- RECALC MD5: $rule $file: (N,O,R) = $new_time, $time, $run_time\n";
-#warn "  ------- $file: (OT,OS,OM) = @$file_data\n";
-#&traceback;
+#warn "--------- RECALC MD5: $rule $file: (N,O,R,C) \n  = $new_time, $time, $$Prun_time, $check_time\n";
         @$file_data = ( $new_time, $new_size, get_checksum_md5( $file ) );
-#warn "  ------- $file: (NT,NS,NM) = @$file_data\n";
     }
     return @$file_data;;
 } #END fdb_get
@@ -3926,7 +4593,7 @@
 	    $rule = $1;
             my $tail = $'; #'  Single quote in comment tricks the parser in
                            # emacs from misparsing an isolated single quote
-            $run_time = 0;
+            $run_time = $check_time = 0;
             $source = $dest = $base = '';
             if ( $tail =~ /^\s*(\S+)\s*$/ ) {
                 $run_time = $1;
@@ -3937,13 +4604,19 @@
                 $dest = $3;
                 $base = $4;
 	    }
+            elsif ( $tail =~ /^\s*(\S+)\s+\"([^\"]*)\"\s+\"([^\"]*)\"\s+\"([^\"]*)\"\s+(\S+)\s*$/ ) {
+                $run_time = $1;
+                $source = $2;
+                $dest = $3;
+                $base = $4;
+                $check_time = $5;
+	    }
             if ( rdb_rule_exists( $rule ) ) {
                 rdb_one_rule( $rule, 
-                              sub{ $$Ptest_kind = 1; 
+                              sub{ 
+                                   if ($$Ptest_kind == 3) { $$Ptest_kind = 1; }
                                    $$Prun_time = $run_time;
-                                   #??if ($source) { $$Psource = $source; }
-                                   #??if ($dest) { $$Pdest = $dest; }
-                                   #??if ($base) { $$Pbase = $base; }
+                                   $$Pcheck_time = $check_time;
                                  }                                      
                              );
 	    }
@@ -3965,11 +4638,12 @@
                 # If it existed on last run, it will be in later 
                 #    lines of the fdb file
                 rdb_create_rule( $rule, 'cusdep', '', $PAnew_cmd, 1, 
-                                 $source, $dest, $base, 0, $run_time, 1 );
+                                 $source, $dest, $base, 0, $run_time, $check_time, 1 );
 	    }
             elsif ( $rule =~ /^(makeindex|bibtex|biber)\s*(.*)$/ ) {
                 my $PA_extra_gen = [];
                 my $rule_generic = $1;
+                my $int_cmd = '';
                 if ( ! $source ) {
                     # If fdb_file was old-style (v. 1)
                     $source = $2;
@@ -3991,18 +4665,20 @@
 	        }
                 if ($rule =~ /^makeindex/) { $PA_extra_gen = [ "$base.ilg" ]; }
                 if ($rule =~ /^(bibtex|biber)/) { $PA_extra_gen = [ "$base.blg" ]; }
+                if ($rule =~ /^bibtex/) { $int_cmd = "run_bibtex"; }
   	        warn "$My_name: File-database '$in_name': setting rule '$rule'\n"
                    if $diagnostics;
                 my $cmd_type = 'external';
                 my $ext_cmd = ${$rule_generic};
 		warn "  Rule kind = '$rule_generic'; ext_cmd = '$ext_cmd';\n",
+                     "  int_cmd = '$int_cmd';\n",
 		     "  source = '$source'; dest = '$dest'; base = '$base';\n"
                    if $diagnostics;
                 # Set source file as non-existent.  
                 # If it existed on last run, it will be in later 
                 #    lines of the fdb file
-                rdb_create_rule( $rule, $cmd_type, $ext_cmd, '', 1, 
-                                 $source, $dest, $base, 0, $run_time, 1, $PA_extra_gen );
+                rdb_create_rule( $rule, $cmd_type, $ext_cmd, $int_cmd, 1, 
+                                 $source, $dest, $base, 0, $run_time,  $check_time, 1, $PA_extra_gen );
 	    }
             else {
   	        warn "$My_name: In file-database '$in_name' rule '$rule'\n",
@@ -4059,7 +4735,7 @@
     }
     undef $in_handle;
     # Set cus dependencies.
-    &rdb_set_dependentsA( keys %rule_db );
+    &rdb_set_dependents( keys %rule_db );
 
 #?? Check from_rules exist.
 
@@ -4112,7 +4788,7 @@
            { 
                return; 
            }
-           print $out_handle "[\"$rule\"] $$Prun_time \"$$Psource\" \"$$Pdest\" \"$$Pbase\" \n"; 
+           print $out_handle "[\"$rule\"] $$Prun_time \"$$Psource\" \"$$Pdest\" \"$$Pbase\" $$Pcheck_time\n";
            rdb_do_files(
              sub { print $out_handle "  \"$file\" $$Ptime $$Psize $$Pmd5 \"$$Pfrom_rule\"\n"; }
 	   );
@@ -4155,6 +4831,9 @@
     local %generated_log = (); # Lists generated files found in log file
     local %generated_fls = (); # Lists generated files found in fls file
     local %source_fls = ();    # Lists source files found in fls file
+    local %first_read_after_write = (); # Lists source files that are only read
+                                  # after being written (so are not true
+                                  # source files.
     local $primary_out = $$Pdest;  # output file (dvi or pdf)
     local %conversions = ();   # (pdf)latex-performed conversions.
                      # Maps output file created and read by (pdf)latex
@@ -4162,14 +4841,15 @@
     # The following are also returned, but are global, to be used by caller
     # $reference_changed, $bad_reference $bad_citation
 
-    &parse_logB;
-    my $fls_file = "$root_filename.fls";
+    &parse_log;
+    my $fls_file = "$aux_dir1$root_filename.fls";
     if ($recorder && test_gen_file($fls_file) ) {
-        parse_fls( $fls_file, \%source_fls, \%generated_fls );
+        parse_fls( $fls_file, \%source_fls, \%generated_fls, \%first_read_after_write );
         foreach (keys %source_fls) {
             $dependents{$_} = 4;
 	}
         foreach (keys %generated_fls) {
+            $_ = normalize_filename($_);
             rdb_add_generated( $_ );
             if ( exists($dependents{$_}) ) {
                $dependents{$_} = 6;
@@ -4185,7 +4865,7 @@
     #         missing input file might be correctable by a run of some
     #         other program whose running is provoked AFTER a run of
     #         (pdf)latex, we'll set a diagnostic and leave it to the
-    #         rdb_makeB to handle after all circular dependencies are
+    #         rdb_make to handle after all circular dependencies are
     #         resolved. 
     #   2.  The output file might be of a different kind than expected
     #         (i.e., dvi instead of pdf, or vv).  This could
@@ -4209,9 +4889,9 @@
             print "!!!===Creating rule '$from_rule': '$ind_file' from '$idx_file'\n"
                   if ($diagnostics);
             rdb_create_rule( $from_rule, 'external', $makeindex, '', 1, 
-                             $idx_file, $ind_file, $ind_base, 1, 0);
+                             $idx_file, $ind_file, $ind_base, 1, 0, 0 );
             print "  ===Source file '$ind_file' for '$rule'\n"
-                  if ($diagnostics > -1);
+                  if ($diagnostics);
             rdb_ensure_file( $rule, $ind_file, $from_rule );
 	}
         # Make sure the .ind file is treated as a detected source file;
@@ -4255,11 +4935,11 @@
             print "   ===Creating rule '$from_rule'\n" if ($diagnostics);
             if ( $bib_program eq 'biber' ) {
                 rdb_create_rule( $from_rule, 'external', $biber, '', 1,
-                                 "$bbl_base.bcf", $bbl_file, $bbl_base, 1, 0);
+                                 "$bbl_base.bcf", $bbl_file, $bbl_base, 1, 0, 0 );
 	     }
              else {
-                 rdb_create_rule( $from_rule, 'external', $bibtex, '', 1,
-                                  "$bbl_base.aux", $bbl_file, $bbl_base, 1, 0);
+                 rdb_create_rule( $from_rule, 'external', $bibtex, 'run_bibtex', 1,
+                                  "$bbl_base.aux", $bbl_file, $bbl_base, 1, 0, 0 );
 	       }
 	}
         local %old_sources = ();
@@ -4331,7 +5011,7 @@
         }
     }
 
-    my @more_sources = &rdb_set_dependentsA( $rule );
+    my @more_sources = &rdb_set_dependents( $rule );
     my $num_new = $#more_sources + 1;
     foreach (@more_sources) { 
 	$dependents{$_} = 4;
@@ -4342,6 +5022,9 @@
             $$Pchanged = 1; # New files can be made.  Ignore error.
         }
     }
+    foreach (keys %first_read_after_write) {
+        delete $dependents{$_};
+    }
     if ($diagnostics) {
 	if ($num_new > 0 ) {
 	    print "$num_new new source files for rule '$rule':\n";
@@ -4350,6 +5033,13 @@
 	else {
 	    print "No new source files for rule '$rule':\n";
 	}
+        my @first_read_after_write = sort keys %first_read_after_write;
+        if ($#first_read_after_write >= 0) {
+            print "The following files were only read after being written:\n";
+            foreach (@first_read_after_write) {
+                print "   '$_'\n";
+	    }
+	  }
     }
     my @files_not_needed = ();
     foreach (keys %$PHsource) { 
@@ -4383,8 +5073,8 @@
 
 #************************************************************
 
-sub rdb_find_new_filesB {
-    # Call: rdb_find_new_filesB
+sub rdb_find_new_files {
+    # Call: rdb_find_new_files
     # Assumes rule context for primary rule.
     # Deal with files which were missing and for which a method
     # of finding them has become available:
@@ -4476,30 +5166,30 @@
 	}
     }
     return $found;
-} # END rdb_find_new_filesB
+} # END rdb_find_new_files
 
 #************************************************************
 
-sub rdb_set_dependentsA {
-    # Call rdb_set_dependentsA( rules ...)
+sub rdb_set_dependents {
+    # Call rdb_set_dependents( rules ...)
     # Returns array (sorted), of new source files.
     local @new_sources = ();
     local @deletions = ();
 
 # Shouldn't recurse.  The definite rules to be examined are given.
-    rdb_for_some( [@_],  0, \&rdb_one_depA );
-# OLD    rdb_recurseA( [@_],  0, \&rdb_one_depA );
+    rdb_for_some( [@_],  0, \&rdb_one_dep );
+# OLD    rdb_recurse( [@_],  0, \&rdb_one_dep );
     foreach (@deletions) {
 	my ($rule, $file) = @$_;
         rdb_remove_files( $rule, $file );
     }
     &rdb_make_links;
     return uniqs( @new_sources );
-} #END rdb_set_dependentsA
+} #END rdb_set_dependents
 
 #************************************************************
 
-sub rdb_one_depA {
+sub rdb_one_dep {
     # Helper for finding dependencies.  One case, $rule and $file given
     # Assume file (and rule) context for DESTINATION file.
 
@@ -4508,7 +5198,7 @@
     if ( (! exists $possible_primaries{$rule}) && ($rule !~ /^cusdep/) ) {
         return;
     }
-#print "=============ONE_DEPA: '$rule' '$file'\n";
+#print "=============ONE_DEP: '$rule' '$file'\n";
     local $new_dest = $file;
     my ($base_name, $path, $toext) = fileparseA( $new_dest );
     $base_name = $path.$base_name;
@@ -4580,7 +5270,7 @@
                 local @PAnew_cmd = ( 'do_cusdep', $func_name );
                 if (! rdb_rule_exists( $from_rule ) ) {
                     rdb_create_rule( $from_rule, 'cusdep', '', \@PAnew_cmd, 3, 
-                                     $source, $new_dest, $base_name, 0);
+                                     $source, $new_dest, $base_name, 0 );
 		}
                 else {
 		    rdb_one_rule( 
@@ -4600,10 +5290,9 @@
         # Try to make the missing file
         #Set character to surround filenames in commands:
         my $q = $quote_filenames ? '"' : '';
-	if ($rule =~ /^cusdep/ ) { traceback(); }
         if ( $toext ne '' ) {
              print "$My_name: '$rule': source file '$file' doesn't exist. I'll try making it...\n";
-             &Run_msg( "$make $q$file$q" );
+             &Run_subst( "$make $q$file$q" );
              if ( -e $file ) {
                  return;
 	     }
@@ -4613,7 +5302,7 @@
                    "   I'll try making it with allowed extensions \n";
              foreach my $try_ext ( keys %$Pinput_extensions ) {
                  my $new_dest = "$file.$try_ext";
-                 &Run_msg( "$make $q$new_dest$q" );
+                 &Run_subst( "$make $q$new_dest$q" );
                  if ( -e $new_dest ) {
                      print "SUCCESS in making '$new_dest'\n";
                      # Put file in rule, without a from_rule, but
@@ -4631,7 +5320,7 @@
 	   }
 	}
     }
-} #END rdb_one_depA
+} #END rdb_one_dep
 
 #************************************************************
 
@@ -4688,13 +5377,24 @@
         delete $source{$_};
     }
     foreach my $dest (@dest) {
-       print $fh "$root_filename$dest :";
+       if ($deps_file eq '-' ) {
+          print $fh "$root_filename$dest :";
+       } else {
+          print $fh "$root_filename$dest $deps_file :";
+       }
        foreach (sort keys %source) {
            print $fh "\\\n    $_";
        }
        print $fh "\n";
     }
     print $fh "#===End dependents for $filename:\n";
+    if ($dependents_phony) {
+        print $fh "\n#===Phony rules for $filename:\n\n";
+        foreach (sort keys %source) {
+            print $fh "$_ :\n\n";
+        }
+        print $fh "#===End phony rules for $filename:\n";
+    }
 } #END deps_list
 
 #************************************************************
@@ -4726,7 +5426,7 @@
     # Call: rdb_accessible( rule, ...)
     # Returns array of rules accessible from the given rules
     local @accessible = ();
-    rdb_recurseA( [@_], sub{ push @accessible, $rule; } );
+    rdb_recurse( [@_], sub{ push @accessible, $rule; } );
     return @accessible;
 } #END rdb_accessible
 
@@ -4734,8 +5434,8 @@
 #************************************************************
 #************************************************************
 
-sub rdb_makeB {
-    # Call: rdb_makeB( target, ... )
+sub rdb_make {
+    # Call: rdb_make( target, ... )
     # Makes the targets and prerequisites.  
     # Leaves one-time rules to last.
     # Does appropriate repeated makes to resolve dependency loops
@@ -4895,7 +5595,7 @@
     local $failure = 0;        # General accumulated error flag
     local $missing_dvi_pdf = ''; # Did primary run fail to make its output file? 
     local $runs = 0;
-    local $too_many_runs = 0;
+    local $too_many_passes = 0;
     local %rules_applied = ();
     my $retry_msg = 0;         # Did I earlier say I was going to attempt 
                                # another pass after a failure?
@@ -4906,6 +5606,7 @@
         }
       PASS:
         while (1==1) {
+            # Exit condition at end of body of loop.
             $runs = 0;
             my $previous_failure = $failure;
             $failure = 0;
@@ -4916,25 +5617,20 @@
 	    if ($diagnostics) {
                 print "MakeB: doing pre_primary and primary...\n";
             }
-            rdb_for_some( [@pre_primary, $primary], \&rdb_makeB1 );
-            if ( ($runs > 0) && ! $too_many_runs ) {
-                $retry_msg = 0;
-                if ( $failure && $newrule_nofile ) { 
-                    $retry_msg = 1;
-                    print "$My_name: Error on run, but found possibility to ",
-                          "make new source files\n";
-                    next PASS;
-		}
-                elsif ( $force_mode || (! $failure) ) {
-                    next PASS;
-		}
+            # Do the primary run if it is needed. On return $runs == 0
+            #       signals that nothing was run (and hence no output
+            #       files changed), either because no input files
+            #       changed and no run was needed, or because the
+            #       number of passes through the rule exceeded the
+            #       limit.  In the second case $too_many_runs is set.
+            rdb_for_some( [@pre_primary, $primary], \&rdb_make1 );
+            if ( ($runs > 0) && ! $too_many_passes ) {
+                next PASS;
             }
-            elsif ($runs == 0) {
+            if ($runs == 0) {
                 # $failure not set on this pass, so use value from previous pass:
                 $failure = $previous_failure;
-                if ($retry_msg) {
-                    print "But in fact no new files made\n";
-		}
+                if ($failure && !$force_mode ) { last PASS; }
 	    }
             if ( $missing_dvi_pdf ) { 
                # No output from primary, after completing circular dependence
@@ -4942,15 +5638,16 @@
                $failure = 1; 
                last PASS;
             }    
-            if ($failure && !$force_mode ) { last PASS; }
 	    if ($diagnostics) {
   	        print "MakeB: doing post_primary...\n";
 	    }
-            rdb_for_some( [@post_primary], \&rdb_makeB1 );
-            if ($failure) { last PASS; }
-            if ($runs > 0) { next PASS; }
-            # Get here if nothing was run.
-            last PASS;
+            rdb_for_some( [@post_primary], \&rdb_make1 );
+            if ( ($runs == 0) || $too_many_passes ) {
+                # If $too_many_passes is set, it should also be that
+                # $runs == 0; but for safety, I also checked
+                # $too_many_passes.
+                last PASS;
+	    }
 	}
 	continue {
             # Re-evaluate rule classification and accessibility,
@@ -4962,18 +5659,11 @@
             &rdb_make_links;
 	}
     }
-    rdb_for_some( [@one_time], \&rdb_makeB1 );
-    rdb_write( $fdb_file );
+    rdb_for_some( [@one_time], \&rdb_make1 );
+    rdb_write( $fdb_name );
 
-    if (! $silent) { 
-        # Diagnose of the runs
-        if ( $#{keys %rules_applied }  > -1 ) {
-            print "$My_name: $runs runs.  Rules applied:\n";
-            foreach (sort keys %rules_applied) {
-		print "    '$_'\n";
-	    }
-	}
-	elsif ($failure && $force_mode) {
+    if (! $silent) {
+	if ($failure && $force_mode) {
             print "$My_name: Errors, in force_mode: so I tried finishing targets\n";
 	}
 	elsif ($failure) {
@@ -4986,43 +5676,54 @@
 	}
     }
     return $failure;
-} #END rdb_makeB
+} #END rdb_make
 
 #-------------------
 
 sub rdb_show_rule_errors {
-    local @messages = ();
+    local @errors = ();
+    local @warnings = ();
     rdb_for_all( 
 	       sub{
 		   if ($$Plast_message ne '') {
-		       push @messages, "$rule: $$Plast_message";
+                       if ($$Plast_result == 200) {
+   		          push @warnings, "$rule: $$Plast_message";
+		       }
+		       else {
+		          push @errors, "$rule: $$Plast_message";
+		       }
 		   }
 		   elsif ($$Plast_result == 1) {
-		       push @messages, "$rule: failed to create output file";
+		       push @errors, "$rule: failed to create output file";
 		   }
 		   elsif ($$Plast_result == 2) {
-		       push @messages, "$rule: gave an error";
+		       push @errors, "$rule: gave an error";
 		   }
 		   elsif ($$Prun_time == 0) {
-#    This can have innocuous causes.  So don't report
-#		       push @messages, "$rule: never run";
+                       #  This can have innocuous causes.  So don't report
 		   }
 	       }
 	      );
-    if ($#messages > -1) { 
+    if ($#warnings > -1) { 
+	warn "Collected warning summary (may duplicate other messages):\n";
+	foreach (@warnings){
+	    warn "  $_\n";
+	}
+    }
+    if ($#errors > -1) { 
 	warn "Collected error summary (may duplicate other messages):\n";
-	foreach (@messages){
+	foreach (@errors){
 	    warn "  $_\n";
 	}
     }
-    return $#messages+1;
+    return $#errors+1;
 }
 
 #-------------------
 
-sub rdb_makeB1 {
-    # Call: rdb_makeB1
-    # Helper routine for rdb_makeB.
+sub rdb_make1 {
+    # Call: rdb_make1
+    # Helper routine for rdb_make.
     # Carries out make at level of given rule (all data available).
     # Assumes contexts for recursion, make, and rule, and
     # assumes that source files for the rule are to be considered
@@ -5081,8 +5782,15 @@
 	    #      not run the rule, but not set an error condition.
 	    #      Any error will arise at the (pdf)latex level due to a 
 	    #      missing source file at that level.
-	    if ( ( $$Pcmd_type eq 'cusdep') && $$Psource && (! -e $$Psource) ) {
-		# No action
+	    if ( $$Psource && (! -e $$Psource)
+# OLD                && ( ( $$Pcmd_type eq 'cusdep') )
+# NEW
+                 && ( ( $$Pcmd_type ne 'primary') )
+               ) {
+                # Main source file doesn't exist, and rule is NOT primary.
+		# No action, since a run is pointless.  Primary is different:
+                # file might be found elsewhere (by kpsearch from (pdf)latex),
+                # while non-existence of main source file is a clear error.
 	    }
 	    elsif ( $$Pcmd_type eq 'delegated' ) {
 		# Delegate to destination rule
@@ -5111,9 +5819,6 @@
         &rdb_diagnose_changes( "Rule '$rule': " );
     }
 
-    $rules_applied{$rule} = 1;
-    $runs++;
-
     # We are applying the rule, so its source file state for when it
     # was last made is as of now:
     # ??IS IT CORRECT TO DO NOTHING IN CURRENT VERSION?
@@ -5127,15 +5832,17 @@
         # Getting here represents some kind of weird error.
         warn "$My_name: Maximum runs of $rule reached ",
              "without getting stable files\n";
-        warn "     Use the -f option to force complete processing.\n"
-            if (! $force_mode);
-        $too_many_runs = 1;
+        $too_many_passes = 1;
         # Treat rule as completed, else in -pvc mode get infinite reruns:
         $$Pout_of_date = 0;
         $failure = 1;
 	$failure_msg = "'$rule' needed too many passes";
         return;
     }
+
+    $rules_applied{$rule} = 1;
+    $runs++;
+
     $pass{$rule}++; 
     if ($bibtex_not_run > 0) {
         if ($bibtex_not_run == 1 ) {
@@ -5150,7 +5857,7 @@
     else {
         warn_running( "Run number $pass{$rule} of rule '$rule'" );
         if ($$Pcmd_type eq 'primary' ) { 
-            $return = &rdb_primary_run; 
+            $return = &rdb_primary_run;
         }
         else { $return = &rdb_run1; }
     }
@@ -5180,14 +5887,18 @@
             # For a primary rule, i.e., (pdf)latex, not to produce the 
             #    expected output file may not be an error condition.  
             # Diagnostics were handled in parsing the log file.
-            # Special action in main loop inrdb_makeB1
+            # Special action in main loop in rdb_make
             $missing_dvi_pdf = $$Pdest;
         }
+        elsif ($return == -2) {
+           # Missing output file was reported to be NOT an error
+           $$Pout_of_date = 0;
+	}
 	else {
             $failure = 1;
 	}
     }
-    if ($return != 0) {
+    if ( ($return != 0) && ($return != -2) ) {
         $failure = 1; 
 	$$Plast_result = 2;
         if ( !$$Plast_message ) {
@@ -5196,25 +5907,23 @@
 # !!??        $failure_msg = $$Plast_message;
         
     }
-}  #END rdb_makeB1
+}  #END rdb_make1
 
 #************************************************************
 
-sub rdb_submakeB {
-    # Call: rdb_submakeB
-    # Makes all the source files for a given rule.
-    # Assumes contexts for recursion, for make, and rule.
-    %visited = %visited_at_rule_start;
-    local $failure = 0;  # Error flag
-    my @v = keys %visited;
-#??    print "---submakeB $rule.  @v \n";
-    rdb_do_files( sub{ rdb_recurse_rule( $$Pfrom_rule, 0,0,0, \&rdb_makeB1 ) } );
-    return $failure;
-}  #END rdb_submakeB
+#??sub rdb_submake {
+#??    # Call: rdb_submake
+#??    # Makes all the source files for a given rule.
+#??    # Assumes contexts for recursion, for make, and rule.
+#??    %visited = %visited_at_rule_start;
+#??    local $failure = 0;  # Error flag
+#??    my @v = keys %visited;
+#??    rdb_do_files( sub{ rdb_recurse_rule( $$Pfrom_rule, 0,0,0, \&rdb_make1 ) } );
+#??    return $failure;
+#??}  #END rdb_submake
 
 #************************************************************
 
-
 sub rdb_classify_rules {
     # Usage: rdb_classify_rules( \%allowed_primaries, requested targets )
     # Assume the following variables are available (global or local):
@@ -5238,7 +5947,7 @@
     @post_primary = ();
     @one_time = ();
 
-    rdb_recurseA( \@requested_targets, \&rdb_classify1, 0,0, \&rdb_classify2 );
+    rdb_recurse( \@requested_targets, \&rdb_classify1, 0,0, \&rdb_classify2 );
 
     # Reverse, as tendency is to find last rules first.
     @pre_primary = reverse @pre_primary;
@@ -5327,11 +6036,13 @@
     # Assumes contexts for: rule.
     # Unconditionally apply the rule
     # Returns return code from applying the rule.
-    # Otherwise: 0 on other kind of success, -1 on error.
-
-    # Source file data, by definition, correspond to the file state just before 
-    # the latest run, and the run_time to the time just before the run:
-    &rdb_update_filesA;
+    # Otherwise: 0 on other kind of success, 
+    #            -1 on error, 
+    #            -2 when missing dest_file is to be ignored
+
+    # Source file data, by definition, correspond to the file state just
+    # before the latest run, and the run_time to the time just before the run:
+    &rdb_update_files;
     $$Prun_time = time;
     $$Pchanged = 0;       # No special changes in files
     $$Plast_result = 0;
@@ -5352,7 +6063,7 @@
         $return = &$int_cmd( @int_args ); 
     }
     elsif ($$Pext_cmd) {
-	$return = &rdb_ext_cmd;
+	$return = &Run_subst();
     }
     else {
         warn "$My_name: Either a bug OR a configuration error:\n",
@@ -5363,8 +6074,35 @@
         $$Plast_message = "Bug or configuration error; incorrect command type";
     }
     if ( $rule =~ /^biber/ ) {
-        my $retcode = check_biber_log($$Pbase);
-        if ($retcode == 3) {
+        my @biber_source = ( );
+        my $retcode = check_biber_log( $$Pbase, \@biber_source );
+        foreach my $source ( @biber_source ) {
+            print "  === Source file '$source' for '$rule'\n"
+               if ($diagnostics);
+            rdb_ensure_file( $rule, $source );
+        }
+        if ($retcode == 5) {
+        # Special treatment if sole missing file is bib file
+        # I don't want to treat that as an error
+            $return = 0;
+            $$Plast_result = 200;
+            $$Plast_message = "Could not find bib file for '$$Pbase'";
+            push @warnings, "Bib file not found for '$$Pbase'";
+        }
+        elsif ($retcode == 6) {
+           # Missing control file.  Need to remake it (if possible)
+           # Don't treat missing bbl file as error.
+           warn "$My_name: bibtex control file missing.  Since that can\n",
+                "   be recreated, I'll try to do so.\n";
+           $return = -2;
+           rdb_for_some( [keys %current_primaries], sub{ $$Pout_of_date = 1; } );
+	}
+        elsif ($retcode == 4) {
+            $$Plast_result = 2;
+            $$Plast_message = "Could not find all biber source files for '$$Pbase'";
+            push @warnings, "Not all biber source files found for '$$Pbase'";
+        }
+        elsif ($retcode == 3) {
             $$Plast_result = 2;
             $$Plast_message = "Could not open biber log file for '$$Pbase'";
             push @warnings, $$Plast_message;
@@ -5378,13 +6116,16 @@
         }
         elsif ($retcode == 10) {
             push @warnings, "Biber found no citations for '$$Pbase'";
-            # Biber doesn't generate a bbl file in this situation.  So I cannot
-            #   ignore the error the way I do with bibtex.
-            #$return = 0;
+            # Biber doesn't generate a bbl file in this situation.
+            $return = -2;
         }
     }
     if ( $rule =~ /^bibtex/ ) {
         my $retcode = check_bibtex_log($$Pbase);
+        if ( ! -e $$Psource ) {
+            $retcode = 10;
+            rdb_for_some( [keys %current_primaries], sub{ $$Pout_of_date = 1; } );
+	}
         if ($retcode == 3) {
             $$Plast_result = 2;
             $$Plast_message = "Could not open bibtex log file for '$$Pbase'";
@@ -5392,15 +6133,23 @@
         }
         elsif ($retcode == 2) {
             $$Plast_message = "Bibtex errors: See file '$$Pbase.blg'";
+            $failure = 1;
             push @warnings, $$Plast_message;
         }
         elsif ($retcode == 1) {
             push @warnings, "Bibtex warnings for '$$Pbase'";
         }
         elsif ($retcode == 10) {
-            push @warnings, "Bibtex found no citations for '$$Pbase'";
-            # But this is an innocuous error, so fix return code
-            $return = 0;
+            push @warnings, "Bibtex found no citations for '$$Pbase',\n",
+                            "    or bibtex found a missing aux file\n";
+            if (! -e $$Pdest ) {
+                warn "$My_name: Bibtex did not produce '$$Pdest'.  But that\n",
+                     "     was because of missing files, so I will continue.\n";
+                $return = -2;
+	    }
+            else {
+                $return = 0;
+	    }
         }
     }
 
@@ -5412,16 +6161,15 @@
     }
     $$Pout_of_date = $$Pout_of_date_user = 0;
 
-    if ( ($$Plast_result == 0) && ($return != 0) ) {
+    if ( ($$Plast_result == 0) && ($return != 0) && ($return != -2) ) {
         $$Plast_result = 2;
         if ($$Plast_message eq '') {
 	    $$Plast_message = "Command for '$rule' gave return code $return";
 	}
     }
-    elsif ( $$Pdest && (! -e $$Pdest) ) {
+    elsif ( $$Pdest && (! -e $$Pdest) && ($return != -2) ) {
 	$$Plast_result = 1;
     }
-
     return $return;
 }  # END rdb_run1
 
@@ -5435,7 +6183,7 @@
 
     # Source file data, by definition, correspond to the file state just before 
     # the latest run, and the run_time to the time just before the run:
-    &rdb_update_filesA;
+    &rdb_update_files;
     $$Prun_time = time;
     $$Pchanged = 0;       # No special changes in files
     $$Plast_result = 0;
@@ -5453,41 +6201,59 @@
 
 #-----------------
 
-sub rdb_ext_cmd {
-    # Call: rdb_ext_cmd
-    # Assumes rule context.  Runs external command with substitutions.
-    # Uses defaults for the substitutions.  See rdb_ext_cmd1.
-    return rdb_ext_cmd1();
-} #END rdb_ext_cmd
+sub Run_subst {
+    # Call: Run_subst( cmd, msg, options, source, dest, base )
+    # Runs command with substitutions.
+    # If an argument is omitted or undefined, it is replaced by a default:
+    #    cmd is the command to execute
+    #    msg is whether to print a message: 
+    #           0 for not, 1 according to $silent setting, 2 always
+    #    options, source, dest, base: correspond to placeholders.
+    # Substitutions:
+    #    %S=source, %D=dest, %B=base, %R=root=base for latex, %O=options, 
+    #    %T=texfile, %Y=$aux_dir1, %Z=$out_dir1
+    # This is a globally usable subroutine, and works in a rule context,
+    #    and outside.
+    # Defaults:
+    #     cmd: $PPext_cmd if defined, else '';
+    #     msg: 1
+    #     options: ''
+    #     source:  $$Psource if defined, else $texfile_name;
+    #     dest:    $$Pdest if defined, else $view_file, else '';
+    #     base:    $$Pbase if defined, else $root_filename;
 
-#-----------------
+    my ($ext_cmd, $msg, $options, $source, $dest, $base ) = @_;
 
-sub rdb_ext_cmd1 {
-    # Call: rdb_ext_cmd1( options, source, dest, base ) or rdb_ext_cmd1() or ...
-    # Assumes rule context.  Returns command with substitutions.
-    # Null arguments or unprovided arguments => use defaults.
-    # for %S=source, %D=dest, %B=base, %R=root=base for latex, %O='', %T=texfile
-    my ($options, $source, $dest, $base ) = @_;
-    # Apply defaults
+    $ext_cmd ||= ( $Pext_cmd ? $$Pext_cmd : '' );
+    $msg     =   ( defined $msg ? $msg : 1 );
     $options ||= '';
-    $source  ||= $$Psource;
-    $dest    ||= $$Pdest;
-    $base    ||= $$Pbase;
-    
-    my $ext_cmd = $$Pext_cmd;
-    
+    $source  ||= ( $Psource ? $$Psource : $texfile_name );
+    $dest    ||= ( $Pdest ? $$Pdest : ( $view_file || '' ) );
+    $base    ||= ( $Pbase ? $$Pbase : $root_filename );
+
+    if ( $ext_cmd eq '' ) {
+         return 0;
+    }
+
     #Set character to surround filenames:
     my $q = $quote_filenames ? '"' : '';
 
-    %subst = ( 
+    my %subst = ( 
        '%O' => $options,
        '%R' => $q.$root_filename.$q,
        '%B' => $q.$base.$q,
        '%T' => $q.$texfile_name.$q,
        '%S' => $q.$source.$q,
        '%D' => $q.$dest.$q,
+       '%Y' => $q.$aux_dir1.$q,
+       '%Z' => $q.$out_dir1.$q,
        '%%' => '%'         # To allow literal %B, %R, etc, by %%B.
     );
+    if ( ($^O eq "MSWin32" ) && $MSWin_back_slash ) {
+	foreach ( '%R', '%B', '%T', '%S', '%D', '%Y', '%Z' ) {
+	    $subst{$_} =~ s(/)(\\)g;
+	}
+    }
 
     my @tokens = split /(%.)/, $ext_cmd;
     foreach (@tokens) {
@@ -5495,10 +6261,12 @@
     }
     $ext_cmd = join '', @tokens;
 
-    # print "quote is '$q'; ext_cmd = '$ext_cmd'\n";
-    my ($pid, $return) = &Run_msg($ext_cmd);
+    my ($pid, $return) = 
+          ( ($msg == 0) || ( ($msg == 1) && $silent ) )
+             ? &Run($ext_cmd)
+             : &Run_msg($ext_cmd);
     return $return;
-} #END rdb_ext_cmd1
+} #END Run_subst
 
 #-----------------
 
@@ -5517,36 +6285,48 @@
     if (-e $$Pdest) { $missing_dvi_pdf = '';}
 
     ######### Analyze results of run:
-    if ( ! -e "$root_filename.log" ) {
+    if ( ! -e $log_name ) {
         $failure = 1;
         $$Plast_result = 2;
-        $$Plast_message = $failure_msg = "(Pdf)LaTeX failed to generate a log file";
+        $$Plast_message = $failure_msg 
+           = "(Pdf)LaTeX failed to generate the expected log file '$log_name'";
         return -1;
     }
 
     if ($recorder) {
         # Handle problem that some version of (pdf)latex give fls files
-        # of name latex.fls or pdflatex.fls instead of $root_filename.fls:
-        my $std_fls_file = "$root_filename.fls";
-        my $other_fls_file = "latex.fls";
+        #    of name latex.fls or pdflatex.fls instead of $root_filename.fls.
+        # Also that setting of -output-directory -aux-directory is not 
+        #    respected by (pdf)latex, at least in some versions.
+        my $std_fls_file = "$aux_dir1$root_filename.fls";
+        my @other_fls_names = ( );
         if ( $rule =~ /^pdflatex/ ) {
-            $other_fls_file = "pdflatex.fls";
+            push @other_fls_names, "pdflatex.fls";
 	}
+        else {
+            push @other_fls_names, "latex.fls";
+	}
+        if ( $aux_dir1 ne '' ) {
+           push @other_fls_names, "$root_filename.fls";
+	}
+        my $have_fls = 0;
         if ( test_gen_file($std_fls_file) ) {
-             # Good filename
+             $have_fls = 1;
 	}
-        elsif ( test_gen_file($other_fls_file) ) {
-            copy $other_fls_file, $std_fls_file;
-        }
         else {
+            foreach my $cand (@other_fls_names) {
+                if ( test_gen_file($cand) ) {
+                    copy $cand, $std_fls_file;
+                    $have_fls = 1;
+                    last;
+		}
+	    }
+        }
+        if (! $have_fls) {
             warn "$My_name: fls file doesn't appear to have been made\n";
 	}
     }
 
-
-    ####### NOT ANY MORE! Capture any changes in source file status before we
-    #         check for errors in the latex run
-
     # Find current set of source files:
     &rdb_set_latex_deps;
 
@@ -5558,28 +6338,33 @@
     #   up-to-date:
     rdb_do_files( sub { if ($$Pcorrect_after_primary) {&rdb_update1;} } );
 
-    # There may be new source files, and the run may have caused
-    # circular-dependency files to be changed.  And the regular
-    # source files may have been updated during a lengthy run of
-    # latex.  So redo the makes for sources of the current rule:
-    my $submake_return = &rdb_submakeB;
-    &rdb_clear_change_record;
-    &rdb_flag_changes_here(0);
-    if ($$Pout_of_date && !$silent) { 
-        &rdb_diagnose_changes( "Rule '$rule': " );
-    }
+#??    # There may be new source files, and the run may have caused
+#??    # circular-dependency files to be changed.  And the regular
+#??    # source files may have been updated during a lengthy run of
+#??    # latex.  So redo the makes for sources of the current rule:
+#??    my $submake_return = &rdb_submake;
+#??    &rdb_clear_change_record;
+#??    &rdb_flag_changes_here(0);
+#??    if ($$Pout_of_date && !$silent) { 
+#??        &rdb_diagnose_changes( "Rule '$rule': " );
+#??    }
+
     $updated = 1;    # Flag that some dependent file has been remade
-    # Fix the state of the files as of now: this will solve the
-    # problem of latex and pdflatex interfering with each other,
-    # at the expense of some non-optimality
-    #??  Check this is correct:
-    &rdb_update_filesA;
+
+#??    # Fix the state of the files as of now: this will solve the
+#??    # problem of latex and pdflatex interfering with each other,
+#??    # at the expense of some non-optimality
+#??    #??  Check this is correct:
+#??    &rdb_update_files;
+
     if ( $diagnostics ) {
 	print "$My_name: Rules after run: \n";
 	rdb_show();
     }
 
     $return = $return_latex;
+
+# ???? Is the following needed?
     if ($return_latex && $$Pout_of_date_user) {
        print "Error in (pdf)LaTeX, but change of user file(s), ",
              "so ignore error & provoke rerun\n"
@@ -5590,12 +6375,12 @@
     # Summarize issues that may have escaped notice:
     my @warnings = ();
     if ($bad_reference) {
-        push @warnings, "Latex could not resolve all references";
+        push @warnings, "Latex failed to resolve $bad_reference reference(s)";
     }
     if ($bad_citation) {
-        push @warnings, "Latex could not resolve all citations";
+        push @warnings, "Latex failed to resolve $bad_citation citation(s)";
     }
-    if ($#warnings > 0) {
+    if ($#warnings > -1) {
 	show_array( "$My_name: Summary of warnings:", @warnings );
     }
     return $return;
@@ -5625,6 +6410,9 @@
 
     local $ignore_run_time = $_[0];
     if ( ! defined $ignore_run_time ) { $ignore_run_time = 0; }
+
+    $$Pcheck_time = time;
+
     local $dest_mtime = 0;
     $dest_mtime = get_mtime($$Pdest) if ($$Pdest);
     rdb_do_files( \&rdb_file_change1);
@@ -5642,8 +6430,11 @@
     # Flag whether $file in $rule has changed or disappeared.
     # Set rule's make flag if there's a change.
 
-    my $run_time_argument = $ignore_run_time ? 0 : $$Prun_time;
-    my ($new_time, $new_size, $new_md5) = fdb_get($file, $run_time_argument );
+    my $check_time_argument = 0;
+    if (! $ignore_run_time ) {
+        $check_time_argument = max( $$Pcheck_time, $$Prun_time );
+    }
+    my ($new_time, $new_size, $new_md5) = fdb_get($file, $check_time_argument );
 #??    print "FC1 '$rule':$file $$Pout_of_date TK=$$Ptest_kind\n"; 
 #??    print "    OLD $$Ptime, $$Psize, $$Pmd5\n",
 #??          "    New $new_time, $new_size, $new_md5\n";
@@ -5693,7 +6484,7 @@
 
 sub rdb_new_changes {
     &rdb_clear_change_record;
-    rdb_recurseA( [@_], sub{ &rdb_flag_changes_here(1); } );
+    rdb_recurse( [@_], sub{ &rdb_flag_changes_here(1); } );
     return ($#changed >= 0) || ($#no_dest >= 0) || ($#rules_to_apply >= 0);
 } #END rdb_new_changes
 
@@ -5813,8 +6604,8 @@
 
 #************************************************************
 
-sub rdb_recurseA {
-    # Call: rdb_recurseA( rule | [ rules],
+sub rdb_recurse {
+    # Call: rdb_recurse( rule | [ rules],
     #                    \&rule_act1, \&file_act1, \&file_act2, 
     #                    \&rule_act2 )
     # The actions are pointers to subroutines, and may be null (0, or
@@ -5848,7 +6639,7 @@
 
     foreach $rule ( @heads ) { rdb_recurse_rule( $rule, @_ ); }
 
-} #END rdb_recurseA
+} #END rdb_recurse
 
 #************************************************************
 
@@ -5930,7 +6721,7 @@
     $depth++;
     # We may need to repeat actions on dependent rules, without being
     # blocked by the test on visited files.  So save %visited:
-    local %visited_at_rule_start = %visited;
+    # NOT CURRENTLY USED!!    local %visited_at_rule_start = %visited;
     # At end, the last value set for %visited wins.
     rdb_one_rule( $rule, $rule_act1, \&rdb_recurse_file, $rule_act2 );
     $depth--;
@@ -5982,7 +6773,8 @@
     local ( $PArule_data, $PHsource, $PHdest ) = @{$rule_db{$rule}};
     local ($Pcmd_type, $Pext_cmd, $PAint_cmd, $Ptest_kind, 
            $Psource, $Pdest, $Pbase,
-           $Pout_of_date, $Pout_of_date_user, $Prun_time, $Pchanged,
+           $Pout_of_date, $Pout_of_date_user, $Prun_time, $Pcheck_time,
+           $Pchanged,
            $Plast_result, $Plast_message, $PA_extra_generated )
         = Parray( $PArule_data );
 
@@ -6005,7 +6797,7 @@
     local $PAfile_data = ${$PHsource}{$file};
     local ($Ptime, $Psize, $Pmd5, $Pfrom_rule, $Pcorrect_after_primary ) 
           = Parray( $PAfile_data );
-    &$file_act if $file_act;
+    &$file_act() if $file_act;
     if ( ! rdb_rule_exists( $$Pfrom_rule ) ) {
         $$Pfrom_rule = '';
     }
@@ -6031,7 +6823,7 @@
 sub rdb_create_rule {
     # rdb_create_rule( rule, command_type, ext_cmd, int_cmd, test_kind,
     #                  source, dest, base, 
-    #                  needs_making, run_time, set_file_not_exists,
+    #                  needs_making, run_time, check_time, set_file_not_exists,
     #                  ref_to_array_of_specs_of_extra_generated_files )
     # int_cmd is either a string naming a perl subroutine or it is a
     # reference to an array containing the subroutine name and its
@@ -6041,7 +6833,7 @@
 # ==== Sets rule data ====
     my ( $rule, $cmd_type, $int_cmd, $PAext_cmd, $test_kind, 
          $source, $dest, $base, 
-         $needs_making, $run_time, $set_file_not_exists, $extra_gen ) = @_;
+         $needs_making, $run_time, $check_time, $set_file_not_exists, $extra_gen ) = @_;
     my $changed = 0;
 
     # Set defaults, and normalize parameters:
@@ -6049,7 +6841,7 @@
               $set_file_not_exists ) {
         if (! defined $_) { $_ = ''; }
     }
-    foreach ( $needs_making, $run_time, $test_kind ) {
+    foreach ( $needs_making, $run_time, $check_time, $test_kind ) {
         if (! defined $_) { $_ = 0; }
     }
     if (!defined $test_kind) {
@@ -6071,7 +6863,7 @@
     $rule_db{$rule} = 
         [  [$cmd_type, $int_cmd, $PAext_cmd, $test_kind, 
             $source, $dest, $base,
-            $needs_making, 0, $run_time, $changed,
+            $needs_making, 0, $run_time, $check_time, $changed,
             -1, '', $PA_extra_gen ],
            {},
            {}
@@ -6193,8 +6985,8 @@
 
 #************************************************************
 
-sub rdb_update_filesA {
-    # Call: fdb_updateA
+sub rdb_update_files {
+    # Call: rdb_update_files
     # Assumes rule context.  Update source files of rule to current state.
     rdb_do_files( \&rdb_update1 );
 }
@@ -6242,7 +7034,7 @@
     #   primary run.
 
     # Remove the destination file, to indicate it needs to be remade:
-    unlink $$Pdest;
+    unlink_or_move( $$Pdest );
     # Arrange that the non-existent destination file is not treated as
     #   an error.  The variable changed here is a bit misnamed.
     $$Pchanged = 1;
@@ -6293,7 +7085,7 @@
 #  Then print rest of @_, one item per line preceeded by some space
     warn "$_[0]\n";
     shift;
-    if ($#_ >= 0) {  foreach (@_){ warn "  '$_'\n";} }
+    if ($#_ >= 0) {  foreach (@_){ warn "  $_\n";} }
     else { warn "  NONE\n"; }
 }
 
@@ -6357,7 +7149,7 @@
         }
     }
     return @globbed;
-}
+} #END glob_list1
 
 #************************************************************
 # Miscellaneous
@@ -6371,8 +7163,51 @@
        $line[$i] = $prefix.$line[$i]."\n";
    }
    return join( "", @line );
-}
+} #END prefix
+
 
+#===============================
+
+sub parse_quotes {
+    # Split string into words.
+    # Words are delimited by space, except that strings
+    # quoted all stay inside a word.  E.g., 
+    #   'asdf B" df "d "jkl"'
+    # is split to ( 'asdf', 'B df d', 'jkl').
+    # An array is returned.
+    my @results = ();
+    my $item = '';
+    local $_ = shift;
+    pos($_) = 0;
+  ITEM:
+    while() {
+        /\G\s*/gc;
+        if ( /\G$/ ) {
+	    last ITEM;
+	}
+        # Now pos (and \G) is at start of item:
+      PART:
+        while () {
+  	    if (/\G([^\s\"]*)/gc) {
+	        $item .= $1;
+	    }
+            if ( /\G\"([^\"]*)\"/gc ) {
+                # Match balanced quotes
+		$item .= $1;
+		next PART;
+	    }
+            elsif ( /\G\"(.*)$/gc ) {
+                # Match unbalanced quote
+		$item .= $1;
+                warn "====Non-matching quotes in\n    '$_'\n";
+	    }
+            push @results, $item;
+            $item = '';
+            last PART;
+	}
+    }
+    return @results;
+} #END parse_quotes
 
 #************************************************************
 #************************************************************
@@ -6484,6 +7319,7 @@
     my $md5 = Digest::MD5->new;
     my $ignore_pattern = '';
 
+#&traceback;
 #warn "======= GETTING MD5: $source\n";
     if ( $source eq "" ) { 
        # STDIN:
@@ -6575,11 +7411,9 @@
     # Modified version of find_file_list that doesn't die.
     # Given output and input arrays of filenames, a file suffix, and a path, 
     # fill the output array with full filenames
-    # Return a status code:
-    # Retcode = 0 on success
-    # Retocde = 1 if at least one file was not found
-    # Usage: find_file_list1( ref_to_output_file_array, 
-    #                         ref_to_input_file_array, 
+    # Return array of not-found files.
+    # Usage: find_file_list1( ref_to_output_file_array,
+    #                         ref_to_input_file_array,
     #                         suffix,
     #                         ref_to_array_search_path
     #                       )
@@ -6588,6 +7422,7 @@
   my $ref_input  = $_[1];
   my $suffix     = $_[2];
   my $ref_search = $_[3];
+  my @not_found = ();
 
 #??  show_array( "=====find_file_list1.  Suffix: '$suffix'\n Source:",  @$ref_input );
 #??  show_array( " Bibinputs:",  @$ref_search );
@@ -6601,17 +7436,32 @@
     	push @return_list, $tmp_file;
     }
     if ( $find_retcode != 0 ) {
-        $retcode = 1;
+        push @not_found, $file.$suffix;
     }
   }
   @$ref_output = @return_list;
 #??  show_array( " Output", @$ref_output );
 #??  foreach (@$ref_output) { if ( /\/\// ) {  print " ====== double slash in  '$_'\n"; }  }
-  return $retcode;
+  return @not_found;
 } #END find_file_list1
 
 #************************************************************
 
+sub unlink_or_move {
+    if ( $del_dir eq '' ) {
+        unlink @_;
+    }
+    else {
+        foreach (@_) {
+	    if (-e $_ && ! rename $_, "$del_dir/$_" ) {
+                warn "$My_name:Cannot move '$_' to '$del_dir/$_'\n";
+	    }
+        }
+    }
+}
+
+#************************************************************
+
 sub kpsewhich {
 # Usage: kpsewhich( filespec, ...)
 # Returns array of files with paths as found by kpsewhich
@@ -6919,38 +7769,65 @@
     my $time = processing_time() - $time1;
     push @timings, "'$_[0]': time = $time\n"; 
     return ($pid, $return);
-}
+} #END Run_msg
+
+#==================
 
 sub Run {
-# Usage: Run ("program arguments ");
-#    or  Run ("start program arguments");
-#    or  Run ("NONE program arguments");
-# First form is just a call to system, and the routine returns after the 
-#    program has finished executing.  
-# Second form (with 'start') runs the program detached, as appropriate for
-#    the operating system: It runs "program arguments &" on UNIX, and 
-#    "start program arguments" on WIN95 and WINNT.  If multiple start
-#    words are at the beginning of the command, the extra ones are removed.
-# Third form (with 'NONE') does not run anything, but prints an error
-#    message.  This is provided to allow program names defined in the
-#    configuration to flag themselves as unimplemented.
-# A given command line starting with "start NONE" is equivalent to "NONE".
-# If the word "start" is duplicated at the beginning, that is equivalent to
-#    a single "start".
+# Usage: Run ("command string");
+#    or  Run ("one-or-more keywords command string");
+# Possible keywords: internal, NONE, start, nostart.
+#
+# A command string not started by keywords just gives a call to system with
+#   the specified string, I return after that has finished executing.
+# Exceptions to this behavior are triggered by keywords.
+# The general form of the string is
+#    Zero or more occurences of the start keyword,
+#    followed by at most one of the other key words (internal, nostart, NONE),
+#    followed by (a) a command string to be executed by the systerm
+#             or (b) if the command string is specified to be internal, then
+#                    it is of the form
+#
+#                       routine arguments
+#
+#                    which implies invocation of the named Perl subroutine
+#                    with the given arguments, which are obtained by splitting
+#                    the string into words, delimited by spaces, but with
+#                    allowance for double quotes.
+#
+# The meaning of the keywords is:
+#
+#    start: The command line is to be running detached, as appropriate for
+#             a previewer.  The method is appropriate for the operating system
+#             (and the keyword is inspired by the action of the start command
+#             that implements in under MSWin).
+#           HOWEVER: the start keyword is countermanded by the nostart,
+#             internal, and NONE keywords.  This allows rules that do
+#             previewing to insert a start keyword to create a presumption
+#             of detached running unless otherwise.
+#   nostart: Countermands a previous start keyword; the following command
+#             string is then to be obeyed by the system, and any necessary
+#             detaching (as of a previewer) is done by the executed command(s).
+#   internal: The following command string, of the form 'routine arguments'
+#             specifies a call to the named Perl subroutine.
+#   NONE:   This does not run anything, but causes an error message to be
+#             printed.  This is provided to allow program names defined in the
+#             configuration to flag themselves as unimplemented.
+# Note that if the word "start" is duplicated at the beginning, that is
+#   equivalent to a single "start".
+#
 # Return value is a list (pid, exitcode):
-#   If process is spawned sucessfully, and I know the PID,
+#   If a process is spawned sucessfully, and I know the PID,
 #       return (pid, 0),
 #   else if process is spawned sucessfully, but I do not know the PID,
 #       return (0, 0),
 #   else if process is run, 
 #       return (0, exitcode of process)
-#   else (I fail to run the requested process)
+#   else if I fail to run the requested process
 #       return (0, suitable return code)
 #   where return code is 1 if cmdline is null or begins with "NONE" (for
-#                      an unimplemented command)
-#                     or the return value of the system subroutine.
-
-
+#       an unimplemented command)
+#       or the return value of the Perl subroutine.
     my $cmd_line = $_[0];
     if ( $cmd_line eq '' ) {
 	traceback( "$My_name: Bug OR configuration error\n".
@@ -6966,7 +7843,16 @@
 	# already contained a "start").
         $detach = 1;
     }
-    if ( $cmd_line =~ /^NONE/ ) {
+    if ( $cmd_line =~ s/^nostart +// ) {
+        $detach = 0;
+    }
+    if ( $cmd_line =~ /^internal\s+([a-zA-Z_]\w*)\s+(.*)$/ ) {
+	my $routine = $1;
+	my @args = parse_quotes( $2 );
+	warn "$My_name: calling $routine( @args )\n";
+        return ( 0, &$routine( @args ) );
+    }
+    elsif ( $cmd_line =~ /^NONE/ ) {
         warn "$My_name: ",
              "Program not implemented for this version.  Command line:\n";
 	warn "   '$cmd_line'\n";
@@ -6981,7 +7867,7 @@
        # metacharacters to be interpreted:
        return( 0, system( $cmd_line ) );
    }
-}
+}  #END Run
 
 #************************************************************
 
@@ -7046,7 +7932,7 @@
     }
     # NEVER GET HERE.
     ##warn "Run_Detached.UNIX: F\n";
-}
+} #END Run_Detached
 
 #************************************************************
 
@@ -7098,17 +7984,61 @@
 #************************************************************
 #************************************************************
 
+#============================================
+
+sub cache_good_cwd {
+    # Set cached value of cwd to current cwd.
+    # Under cygwin, the cwd is converted to a native MSWin path so
+    # that the result can be used for input to MSWin programs as well
+    # as cygwin programs. 
+    my $cwd = cwd();
+    if ( $^O eq "cygwin" ) {
+        my $cmd = "cygpath -w \"$cwd\"";
+        my $Win_cwd = `$cmd`;
+        chomp $Win_cwd;
+        if ( $Win_cwd ) {
+            $cwd = $Win_cwd;
+	}
+        else {
+            warn "$My_name: Could not correctly run command\n",
+                 "      '$cmd'\n",
+                 "  to get MSWin version of cygwin path\n",
+                 "     '$cwd'\n",
+                 "  The result was\n",
+                 "     'Win_cwd'\n";
+	}
+    }
+    $cache{cwd} = $cwd;
+}  # END cache_good_cwd
+
+#============================================
+
+sub good_cwd {
+    # Return cwd, but under cygwin, convert to MSWin path.
+    # Use cached result
+    return $cache{cwd};
+}  # END good_cwd
+
+#============================================
+
 #   Directory stack routines
 
 sub pushd {
-    push @dir_stack, cwd();
-    if ( $#_ > -1) { chdir $_[0]; }
+    push @dir_stack, [cwd(), $cache{cwd}];
+    if ( $#_ > -1) {
+        chdir $_[0]; 
+        &cache_good_cwd;
+    }
 }
 
 #************************************************************
 
 sub popd {
-    if ($#dir_stack > -1 ) { chdir pop @dir_stack; }
+    if ($#dir_stack > -1 ) { 
+        my $Parr = pop @dir_stack;
+        chdir $$Parr[0]; 
+        $cache{cwd} = $$Parr[1];
+    }
 }
 
 #************************************************************
diff -Nru latexmk-4.24/latexmk.ps latexmk-4.35/latexmk.ps
--- latexmk-4.24/latexmk.ps	2011-05-07 22:34:25.000000000 +0000
+++ latexmk-4.35/latexmk.ps	2012-11-12 13:43:10.000000000 +0000
@@ -1,11 +1,11 @@
 %!PS-Adobe-3.0
 %%Creator: groff version 1.19.2
-%%CreationDate: Sat May  7 18:34:25 2011
+%%CreationDate: Mon Nov 12 14:43:09 2012
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%+ font Times-Italic
 %%DocumentSuppliedResources: procset grops 1.19 2
-%%Pages: 27
+%%Pages: 34
 %%PageOrder: Ascend
 %%DocumentMedia: Default 595 842 0 () ()
 %%Orientation: Portrait
@@ -260,37 +260,37 @@
 2.5(wo)-.25 G 2.5(ft)-2.5 G(he compiled document.)-2.5 E F3(Late)108 276
 Q(xmk)-.2 E F0 .53(determines which are the source \214les by e)3.03 F
 .53(xamining the log \214le.)-.15 F(\(Optionally)5.53 E 3.03(,i)-.65 G
-3.03(ta)-3.03 G .53(lso e)-3.03 F .53(xamines the)-.15 F
-(list of input and output \214les generated by the)108 288 Q F3(-r)2.501
-E(ecor)-.37 E(der)-.37 E F0 .001(option of modern v)2.501 F .001
-(ersions of)-.15 F F3(late)2.501 E(x)-.2 E F0(and)2.501 E F3(pd\215ate)
-2.501 E(x)-.2 E F0 5.001(.S)C(ee)-5.001 E .285
-(the documentation for the)108 300 R F3(-r)2.785 E(ecor)-.37 E(der)-.37
-E F0 .285(option of)2.785 F F3(late)2.785 E(xmk)-.2 E F0(belo)2.785 E
--.65(w.)-.25 G 5.285(\)W).65 G(hen)-5.285 E F3(late)2.785 E(xmk)-.2 E F0
-.284(is run, it e)2.784 F .284(xamines properties)-.15 F .71
-(of the source \214les, and if an)108 312 R 3.21(yh)-.15 G -2.25 -.2
-(av e)-3.21 H .711(been changed since the last document generation,)3.41
-F F3(late)3.211 E(xmk)-.2 E F0 .711(will run the)3.211 F -.25(va)108 324
-S .015(rious LaT).25 F .015(eX processing programs as necessary)-.7 F
-5.015(.I)-.65 G 2.515(np)-5.015 G(articular)-2.515 E 2.515(,i)-.4 G
-2.515(tw)-2.515 G .015(ill repeat the run of LaT)-2.515 F .015
-(eX \(or pd\215ate)-.7 F(x\))-.15 E 1.269(often enough to resolv)108 336
-R 3.769(ea)-.15 G 1.269
-(ll cross references; depending on the macro packages used.)-3.769 F -.4
-(Wi)6.27 G 1.27(th some macro).4 F .124
-(packages and document classes, four)108 348 R 2.624(,o)-.4 G 2.624(re)
--2.624 G -.15(ve)-2.874 G 2.624(nm).15 G .123
-(ore, runs may be needed. If necessary)-2.624 F(,)-.65 E F3(late)2.623 E
-(xmk)-.2 E F0 .123(will also run)2.623 F(bibte)108 360 Q .855(x, biber)
--.15 F 3.355(,a)-.4 G .855(nd/or mak)-3.355 F(einde)-.1 E 3.355(x. In)
--.15 F(addition,)3.356 E F3(late)3.356 E(xmk)-.2 E F0 .856
-(can be con\214gured to generate other necessary \214les.)3.356 F -.15
-(Fo)108 372 S 3.36(re).15 G .86(xample, from an updated \214gure \214le\
- it can automatically generate a \214le in encapsulated postscript or)
--3.51 F(another suitable format for reading by LaT)108 384 Q(eX.)-.7 E
-F3(Late)108 400.8 Q(xmk)-.2 E F0 .503(has tw)3.003 F 3.003(od)-.1 G(if)
--3.003 E .503(ferent pre)-.25 F(vie)-.25 E .503(wing options.)-.25 F
+3.03(ta)-3.03 G .53(lso e)-3.03 F .53(xamines the)-.15 F .981
+(list of input and output \214les generated by the)108 288 R F2(-r)3.481
+E(ecorder)-.18 E F0 .981(option of modern v)3.481 F .981(ersions of)-.15
+F F3(late)3.482 E(x)-.2 E F0(and)3.482 E F3(pd\215ate)3.482 E(x)-.2 E F0
+(.)A .181(See the documentation for the)108 300 R F2(-r)2.681 E(ecorder)
+-.18 E F0 .181(option of)2.681 F F3(late)2.681 E(xmk)-.2 E F0(belo)2.681
+E -.65(w.)-.25 G 5.181(\)W).65 G(hen)-5.181 E F3(late)2.68 E(xmk)-.2 E
+F0 .18(is run, it e)2.68 F .18(xamines prop-)-.15 F .186
+(erties of the source \214les, and if an)108 312 R 2.686(yh)-.15 G -2.25
+-.2(av e)-2.686 H .186(been changed since the last document generation,)
+2.886 F F3(late)2.686 E(xmk)-.2 E F0 .187(will run)2.687 F 1.464(the v)
+108 324 R 1.464(arious LaT)-.25 F 1.464
+(eX processing programs as necessary)-.7 F 6.464(.I)-.65 G 3.964(np)
+-6.464 G(articular)-3.964 E 3.964(,i)-.4 G 3.964(tw)-3.964 G 1.463
+(ill repeat the run of LaT)-3.964 F 1.463(eX \(or)-.7 F(pd\215ate)108
+336 Q .575(x\) often enough to resolv)-.15 F 3.075(ea)-.15 G .575
+(ll cross references; depending on the macro packages used.)-3.075 F -.4
+(Wi)5.576 G .576(th some).4 F .566
+(macro packages and document classes, four)108 348 R 3.066(,o)-.4 G
+3.066(re)-3.066 G -.15(ve)-3.316 G 3.066(nm).15 G .565
+(ore, runs may be needed. If necessary)-3.066 F(,)-.65 E F3(late)3.065 E
+(xmk)-.2 E F0(will)3.065 E .836(also run bibte)108 360 R .836(x, biber)
+-.15 F 3.336(,a)-.4 G .836(nd/or mak)-3.336 F(einde)-.1 E 3.336(x. In)
+-.15 F(addition,)3.336 E F3(late)3.336 E(xmk)-.2 E F0 .836
+(can be con\214gured to generate other neces-)3.336 F .009
+(sary \214les.)108 372 R -.15(Fo)5.009 G 2.509(re).15 G .009(xample, fr\
+om an updated \214gure \214le it can automatically generate a \214le in\
+ encapsulated post-)-2.659 F
+(script or another suitable format for reading by LaT)108 384 Q(eX.)-.7
+E F3(Late)108 400.8 Q(xmk)-.2 E F0 .503(has tw)3.003 F 3.003(od)-.1 G
+(if)-3.003 E .503(ferent pre)-.25 F(vie)-.25 E .503(wing options.)-.25 F
 .503(In the simple)5.503 F F2(-pv)3.003 E F0 .503
 (option, a dvi, postscript or pdf pre)3.003 F(vie)-.25 E(wer)-.25 E .447
 (is automatically run after generating the dvi, postscript or pdf v)108
@@ -325,2453 +325,3083 @@
 (w\) as simple as forcing a redra)-.25 E 2.5(wo)-.15 G 2.5(fi)-2.5 G
 (ts display)-2.5 E(.)-.65 E F3(Late)108 559.2 Q(xmk)-.2 E F0 .804(has t\
 he ability to print a banner in gray diagonally across each page when m\
-aking the postscript)3.304 F 2.5(\214le. It)108 571.2 R
-(can also, if needed, call an e)2.5 E
-(xternal program to do other postprocessing on the generated \214les.)
--.15 E F3(Late)108 588 Q(xmk)-.2 E F0 1.979(is highly con\214gurable, b\
-oth from the command line and in con\214guration \214les, so that it ca\
-n)4.479 F .643(accommodate a wide v)108 600 R .643
-(ariety of user needs and system con\214gurations.)-.25 F(Def)5.643 E
-.642(ault v)-.1 F .642(alues are set according to)-.25 F 2.136
-(the operating system, so)108 612 R F3(late)4.636 E(xmk)-.2 E F0 2.137
-(often w)4.637 F 2.137(orks without special con\214guration on MS-W)-.1
-F(indo)-.4 E 2.137(ws, c)-.25 F(ygwin,)-.15 E
-(Linux, OS-X, and other UNIX systems \(notably Solaris\).)108 624 Q
-3.161(Av)108 640.8 S .661(ery anno)-3.311 F .661
-(ying complication handled v)-.1 F .661(ery reliably by)-.15 F F3(Late)
-3.161 E(xmk)-.2 E F0 3.161(,i)C 3.161(st)-3.161 G .66(hat LaT)-3.161 F
-.66(eX is a multiple pass system.)-.7 F .267(On each run, LaT)108 652.8
-R .268(eX reads in information generated on a pre)-.7 F .268
-(vious run, for things lik)-.25 F 2.768(ec)-.1 G .268
-(ross referencing and)-2.768 F(inde)108 664.8 Q 3.109(xing. In)-.15 F
-.609(the simplest cases, a second run of LaT)3.109 F .608(eX suf)-.7 F
-.608(\214ces, and often the log \214le contains a message)-.25 F .012
-(about the need for another pass.)108 676.8 R(Ho)5.013 E(we)-.25 E -.15
-(ve)-.25 G .813 -.4(r, t).15 H .013(here is a wide v).4 F .013
-(ariety of add-on macro packages to LaT)-.25 F .013(eX, with)-.7 F 3.065
-(av)108 688.8 S .565(ariety of beha)-3.315 F 3.065(viors. The)-.2 F .565
-(result is to break simple-minded determinations of ho)3.065 F 3.065(wm)
--.25 G(an)-3.065 E 3.065(yr)-.15 G .565(uns are needed)-3.065 F 1.315
-(and of which programs.)108 700.8 R 1.315(In its ne)6.315 F 3.815(wv)
--.25 G(ersion,)-3.965 E F3(late)3.815 E(xmk)-.2 E F0 1.315
-(has a highly general and ef)3.815 F 1.316(\214cient solution to these)
--.25 F 2.726(issues. The)108 712.8 R .226(solution in)2.726 F -.2(vo)-.4
-G(lv).2 E .226(es retaining between runs information on the source \214\
-les, and a symptom is that)-.15 F F3(late)108 724.8 Q(xmk)-.2 E F0 2.348
-(generates an e)4.848 F 2.348(xtra \214le \(with e)-.15 F(xtension)-.15
-E F3(.fdb_late)4.849 E(xmk)-.2 E F0 4.849(,b)C 4.849(yd)-4.849 G(ef)
--4.849 E 2.349(ault\) that contains the source \214le)-.1 F 2.5(7M)
-281.835 768 S(ay 2011)-2.5 E(1)204.835 E 0 Cg EP
+aking the postscript)3.304 F 3.056(\214le. It)108 571.2 R .556
+(can also, if needed, call an e)3.056 F .556
+(xternal program to do other postprocessing on generated dvi and post-)
+-.15 F .319(script \214les.)108 583.2 R .318(\(See the options)5.319 F
+F2(-dF)2.818 E F0(and)2.818 E F2(-pF)2.818 E F0 2.818(,a)C .318
+(nd the documentation for the)-2.818 F F3($dvi_\214lter)2.818 E F0(and)
+2.818 E F3($ps_\214lter)2.818 E F0(con\214gu-)2.818 E 1.137(ration v)108
+595.2 R 3.637(ariables.\) These)-.25 F 1.137(capabilities are lefto)
+3.637 F -.15(ve)-.15 G 3.637(rf).15 G 1.137(rom older v)-3.637 F 1.137
+(ersions of)-.15 F F3(late)3.637 E(xmk)-.2 E F0 6.137(.M)C 1.137
+(ore \215e)-6.137 F 1.138(xibility can be)-.15 F .469
+(obtained in current v)108 607.2 R .468
+(ersions, since the command strings for running late)-.15 F .468
+(x, pd\215ate)-.15 F .468(x, etc can no)-.15 F 2.968(wb)-.25 G 2.968(ec)
+-2.968 G(on\214g-)-2.968 E .756(ured to run multiple commands.)108 619.2
+R .756(This also e)5.756 F .756
+(xtends the possibility of postprocessing generated \214les to pdf)-.15
+F 2.5(\214les. \214les.)108 631.2 R F3(Late)108 648 Q(xmk)-.2 E F0 1.979
+(is highly con\214gurable, both from the command line and in con\214gur\
+ation \214les, so that it can)4.48 F .642(accommodate a wide v)108 660 R
+.643(ariety of user needs and system con\214gurations.)-.25 F(Def)5.643
+E .643(ault v)-.1 F .643(alues are set according to)-.25 F 2.137
+(the operating system, so)108 672 R F3(late)4.637 E(xmk)-.2 E F0 2.137
+(often w)4.637 F 2.136(orks without special con\214guration on MS-W)-.1
+F(indo)-.4 E 2.136(ws, c)-.25 F(ygwin,)-.15 E
+(Linux, OS-X, and other UNIX systems \(notably Solaris\).)108 684 Q 3.16
+(Av)108 700.8 S .66(ery anno)-3.31 F .66(ying complication handled v)-.1
+F .66(ery reliably by)-.15 F F3(Late)3.161 E(xmk)-.2 E F0 3.161(,i)C
+3.161(st)-3.161 G .661(hat LaT)-3.161 F .661
+(eX is a multiple pass system.)-.7 F .268(On each run, LaT)108 712.8 R
+.268(eX reads in information generated on a pre)-.7 F .267
+(vious run, for things lik)-.25 F 2.767(ec)-.1 G .267
+(ross referencing and)-2.767 F(inde)108 724.8 Q 3.108(xing. In)-.15 F
+.608(the simplest cases, a second run of LaT)3.108 F .608(eX suf)-.7 F
+.609(\214ces, and often the log \214le contains a message)-.25 F(11 No)
+267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(1)190.545 E 0 Cg EP
 %%Page: 2 2
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E(information.)108 84 Q/F1 10.95/Times-Bold@0 SF(LA)
-72 112.8 Q(TEXMK OPTIONS AND ARGUMENTS ON COMMAND LINE)-1.04 E F0 .025(\
-\(All options can be introduced by single or double "-" characters, e.g\
-., "late)108 124.8 R .025(xmk -help" or "late)-.15 F .025
-(xmk --help".\))-.15 F/F2 10/Times-Bold@0 SF(\214le)108 141.6 Q F0 1.048
+(TEXMK\(1L\))-1.11 E .013(about the need for another pass.)108 84 R(Ho)
+5.013 E(we)-.25 E -.15(ve)-.25 G .813 -.4(r, t).15 H .013
+(here is a wide v).4 F .013(ariety of add-on macro packages to LaT)-.25
+F .012(eX, with)-.7 F 3.065(av)108 96 S .565(ariety of beha)-3.315 F
+3.065(viors. The)-.2 F .565
+(result is to break simple-minded determinations of ho)3.065 F 3.065(wm)
+-.25 G(an)-3.065 E 3.065(yr)-.15 G .565(uns are needed)-3.065 F 1.316
+(and of which programs.)108 108 R 1.316(In its ne)6.316 F 3.815(wv)-.25
+G(ersion,)-3.965 E/F1 10/Times-Italic@0 SF(late)3.815 E(xmk)-.2 E F0
+1.315(has a highly general and ef)3.815 F 1.315
+(\214cient solution to these)-.25 F 2.725(issues. The)108 120 R .225
+(solution in)2.725 F -.2(vo)-.4 G(lv).2 E .226(es retaining between run\
+s information on the source \214les, and a symptom is that)-.15 F F1
+(late)108 132 Q(xmk)-.2 E F0 .521(generates an e)3.021 F .521
+(xtra \214le \(with e)-.15 F(xtension)-.15 E F1(.fdb_late)3.021 E(xmk)
+-.2 E F0 3.021(,b)C 3.021(yd)-3.021 G(ef)-3.021 E .52
+(ault\) that contains the source \214le infor)-.1 F(-)-.2 E(mation.)108
+144 Q/F2 10.95/Times-Bold@0 SF(LA)72 172.8 Q
+(TEXMK OPTIONS AND ARGUMENTS ON COMMAND LINE)-1.04 E F0
+(In general the command line to in)108 184.8 Q -.2(vo)-.4 G -.1(ke).2 G
+F1(late)2.6 E(xmk)-.2 E F0(has the form)2.5 E(late)144 208.8 Q
+(xmk [options] [\214le])-.15 E(All options can be introduced by single \
+or double "-" characters, e.g., "late)108 232.8 Q(xmk -help" or "late)
+-.15 E(xmk --help".)-.15 E/F3 10/Times-Bold@0 SF(Note)108 256.8 Q F0
+3.207(:I)C 3.207(na)-3.207 G .707
+(ddition to the options in the list belo)-3.207 F -.65(w,)-.25 G F1
+(late)3.858 E(xmk)-.2 E F0 .708
+(recognizes almost all the options recognized by)3.208 F(the)108 268.8 Q
+F1(late)3.933 E(x)-.2 E F0(and)3.933 E F1(pd\215ate)3.933 E(x)-.2 E F0
+1.433(programs in one of both of their current T)3.933 F(eXLi)-.7 E
+1.732 -.15(ve a)-.25 H 1.432(nd MiKT).15 F 1.432(eX implementations.)-.7
+F .93(Some of the options for these programs also trigger special actio\
+n or beha)108 280.8 R .93(vior by)-.2 F F1(late)3.43 E(xmk)-.2 E F0 3.43
+(,i)C 3.43(nw)-3.43 G .93(hich case)-3.43 F(the)108 292.8 Q 3.888(ya)
+-.15 G 1.388(re in this list.)-3.888 F 1.388(Otherwise, the)6.388 F
+3.888(ya)-.15 G 1.388(re just passed through to a called)-3.888 F F1
+(late)3.888 E(x)-.2 E F0(or)3.887 E F1(pd\215ate)3.887 E(x)-.2 E F0
+1.387(program. Run)3.887 F F1(late)108 304.8 Q(xmk)-.2 E F0 1.146
+(with the)3.646 F F3(-sho)3.646 E(wextraoptions)-.1 E F0 1.146
+(to get a list of the options that)3.646 F F1(late)3.647 E(xmk)-.2 E F0
+1.147(accepts and that are simply)3.647 F 1.273(passed through to)108
+316.8 R F1(late)3.773 E(x)-.2 E F0(or)3.773 E F1(pd\215ate)3.773 E(x)-.2
+E F0 6.273(.S)C 1.273(ee also the e)-6.273 F 1.273(xplanation of the)
+-.15 F F3(-sho)3.772 E(wextraoptions)-.1 E F0 1.272(option for more)
+3.772 F(information.)108 328.8 Q F3(De\214nitions of options and ar)108
+352.8 Q(guments)-.1 E(\214le)108 381.6 Q F0 1.048
 (One or more \214les can be speci\214ed.)23.22 F 1.048
-(If no \214les are speci\214ed,)6.048 F/F3 10/Times-Italic@0 SF(late)
-3.548 E(xmk)-.2 E F0 1.049(will, by def)3.549 F 1.049(ault, run on all)
--.1 F .753(\214les in the current w)144 153.6 R .753
-(orking directory with a ".te)-.1 F .753(x" e)-.15 F 3.253
-(xtension. This)-.15 F(beha)3.252 E .752(vior can be changed: see)-.2 F
-1.198(the description concerning the)144 165.6 R F3(@default_\214les)
-3.698 E F0 -.25(va)3.698 G 1.199
+(If no \214les are speci\214ed,)6.048 F F1(late)3.548 E(xmk)-.2 E F0
+1.049(will, by def)3.549 F 1.049(ault, run on all)-.1 F .753
+(\214les in the current w)144 393.6 R .753(orking directory with a ".te)
+-.1 F .753(x" e)-.15 F 3.253(xtension. This)-.15 F(beha)3.252 E .752
+(vior can be changed: see)-.2 F 1.198(the description concerning the)144
+405.6 R F1(@default_\214les)3.698 E F0 -.25(va)3.698 G 1.199
 (riable in the section "List of con\214guration v).25 F(ari-)-.25 E
-(ables usable in initialization \214les".)144 177.6 Q .852
-(If a \214le is speci\214ed without an e)108 194.4 R .852
+(ables usable in initialization \214les".)144 417.6 Q .852
+(If a \214le is speci\214ed without an e)108 434.4 R .852
 (xtension, then the ".te)-.15 F .852(x" e)-.15 F .851
 (xtension is automatically added, just as LaT)-.15 F(eX)-.7 E 2.5
-(does. Thus,)108 206.4 R(if you specify:)2.5 E(late)144 230.4 Q(xmk foo)
--.15 E(then)108 254.4 Q F3(late)2.5 E(xmk)-.2 E F0
-(will operate on the \214le "foo.te)2.5 E(x".)-.15 E F2(-bibtex)108
-271.2 Q F0 .122(When the source \214le uses bbl \214les for bibliograph)
-6 F 1.422 -.65(y, r)-.05 H .122(un bibte).65 F 2.622(xo)-.15 G 2.623(rb)
--2.622 G .123(iber as needed to re)-2.623 F .123(generate the)-.15 F
-(bbl \214les.)144 283.2 Q
-(This property can also be con\214gured by setting the)144 307.2 Q F3
-($bibte)2.5 E(x_use)-.2 E F0 -.25(va)2.5 G
-(riable to 2 in a con\214guration \214le).25 E F2(-bibtex-)108 324 Q F0
-(Ne)144 336 Q -.15(ve)-.25 G 2.5(rr).15 G(un bibte)-2.5 E 2.5(xo)-.15 G
-2.5(rb)-2.5 G(iber)-2.5 E(.)-.55 E 2.94(Ac)144 360 S .44
+(does. Thus,)108 446.4 R(if you specify:)2.5 E(late)144 470.4 Q(xmk foo)
+-.15 E(then)108 494.4 Q F1(late)2.5 E(xmk)-.2 E F0
+(will operate on the \214le "foo.te)2.5 E(x".)-.15 E F3
+(-auxdir=FOO or -aux-dir)108 523.2 Q(ectory=FOO)-.18 E F0 .134
+(Sets the directory for auxiliary output \214les of \(pdf\)late)144
+547.2 R 2.634(x\()-.15 G .134(.aux, .log etc\).)-2.634 F .135
+(This achie)5.135 F -.15(ve)-.25 G 2.635(si).15 G .135(ts ef)-2.635 F
+.135(fect by)-.25 F(the)144 559.2 Q F3(-aux-dir)2.731 E(ectory)-.18 E F0
+.231(option of \(pdf\)late)2.731 F .231
+(x, which currently is only implemented on the MiKT)-.15 F .23(eX v)-.7
+F(er)-.15 E(-)-.2 E(sion of \(pdf\)late)144 571.2 Q(x.)-.15 E 8.343
+(See also the)144 595.2 R F3(-outdir)10.843 E F0(/)A F3(-output-dir)A
+(ectory)-.18 E F0 8.343(options, and the)10.843 F F1($aux_dir)10.844 E
+F0(,)A F1($out_dir)10.844 E F0 10.844(,a)C(nd)-10.844 E F1($sear)144
+607.2 Q -.15(ch)-.37 G(_path_separ).15 E(ator)-.15 E F0 1.028
+(con\214guration v)3.528 F 1.028(ariables of)-.25 F F1(late)3.528 E(xmk)
+-.2 E F0 6.028(.I)C 3.528(np)-6.028 G(articular)-3.528 E 3.528(,s)-.4 G
+1.027(ee the documentation)-3.528 F(of)144 619.2 Q F1($out_dir)2.5 E F0
+(for some complications on what directory names are suitable.)2.5 E F3
+(-bibtex)144 672 Q F0 1.652
+(When the source \214le uses bbl \214les for bibliograph)6 F 2.953 -.65
+(y, r)-.05 H 1.653(un bibte).65 F 4.153(xo)-.15 G 4.153(rb)-4.153 G
+1.653(iber as needed to)-4.153 F(re)144 684 Q(generate the bbl \214les.)
+-.15 E(This property can also be con\214gured by setting the)144 708 Q
+F1($bibte)2.5 E(x_use)-.2 E F0 -.25(va)2.5 G
+(riable to 2 in a con\214guration \214le).25 E(11 No)267.545 768 Q -.15
+(ve)-.15 G(mber 2012).15 E(2)190.545 E 0 Cg EP
+%%Page: 3 3
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF(-bibtex-)108 84 Q F0(Ne)144
+96 Q -.15(ve)-.25 G 2.5(rr).15 G(un bibte)-2.5 E 2.5(xo)-.15 G 2.5(rb)
+-2.5 G(iber)-2.5 E(.)-.55 E 2.94(Ac)144 120 S .44
 (ommon use for this option is when a document comes from an e)-2.94 F
 .44(xternal source, complete with)-.15 F .14
-(its bbl \214le\(s\), and the user does not ha)144 372 R .441 -.15(ve t)
+(its bbl \214le\(s\), and the user does not ha)144 132 R .441 -.15(ve t)
 -.2 H .141(he corresponding bib \214les a).15 F -.25(va)-.2 G 2.641
-(ilable. In).25 F .141(this situation use)2.641 F .521(of the)144 384 R
-F2(-bibtex-)3.021 E F0 .521(option will pre)3.021 F -.15(ve)-.25 G(nt)
-.15 E F3(late)3.021 E(xmk)-.2 E F0 .521(from trying to run)3.021 F F3
-(bibte)3.02 E(x)-.2 E F0(or)3.02 E F3(biber)3.02 E F0 3.02(,w)C .52
-(hich w)-3.02 F .52(ould result)-.1 F(in o)144 396 Q -.15(ve)-.15 G
-(rwriting of the bbl \214les.).15 E F2(-bibtex-cond)108 412.8 Q F0 .235
+(ilable. In).25 F .141(this situation use)2.641 F .521(of the)144 144 R
+F1(-bibtex-)3.021 E F0 .521(option will pre)3.021 F -.15(ve)-.25 G(nt)
+.15 E/F2 10/Times-Italic@0 SF(late)3.021 E(xmk)-.2 E F0 .521
+(from trying to run)3.021 F F2(bibte)3.02 E(x)-.2 E F0(or)3.02 E F2
+(biber)3.02 E F0 3.02(,w)C .52(hich w)-3.02 F .52(ould result)-.1 F
+(in o)144 156 Q -.15(ve)-.15 G(rwriting of the bbl \214les.).15 E F1
+(-bibtex-cond)108 172.8 Q F0 .235
 (When the source \214le uses bbl \214le\(s\) for the bibliograph)144
-424.8 R 1.535 -.65(y, r)-.05 H(un).65 E F3(bibte)2.735 E(x)-.2 E F0(or)
-2.735 E F3(biber)2.736 E F0 .236(as needed to re)2.736 F(gener)-.15 E(-)
--.2 E .314(ate the bbl \214les, b)144 436.8 R .313(ut only if the rele)
+184.8 R 1.535 -.65(y, r)-.05 H(un).65 E F2(bibte)2.735 E(x)-.2 E F0(or)
+2.735 E F2(biber)2.736 E F0 .236(as needed to re)2.736 F(gener)-.15 E(-)
+-.2 E .314(ate the bbl \214les, b)144 196.8 R .313(ut only if the rele)
 -.2 F -.25(va)-.25 G .313(nt bib \214le\(s\) e).25 F 2.813(xist. Thus)
 -.15 F .313(when the bib \214les are not a)2.813 F -.25(va)-.2 G
-(ilable,).25 E F3(bibte)144 448.8 Q(x)-.2 E F0(or)3.273 E F3(biber)3.273
+(ilable,).25 E F2(bibte)144 208.8 Q(x)-.2 E F0(or)3.273 E F2(biber)3.273
 E F0 .773(is not run, thereby a)3.273 F -.2(vo)-.2 G .773(iding o).2 F
 -.15(ve)-.15 G .774(rwriting of the bbl \214le\(s\).).15 F .774
-(This is the def)5.774 F .774(ault set-)-.1 F(ting.)144 460.8 Q .679
-(\(Note that it is possible for)144 484.8 R F3(late)3.179 E(xmk)-.2 E F0
+(This is the def)5.774 F .774(ault set-)-.1 F(ting.)144 220.8 Q .679
+(\(Note that it is possible for)144 244.8 R F2(late)3.179 E(xmk)-.2 E F0
 .678(to decide that the bib \214le does not e)3.179 F .678(xist, e)-.15
 F -.15(ve)-.25 G 3.178(nt).15 G .678(hough the bib)-3.178 F .564
-(\214le does e)144 496.8 R .564(xist and)-.15 F F3(bibte)3.064 E(x)-.2 E
-F0(or)3.064 E F3(biber)3.064 E F0 .564(\214nds it.)3.064 F .564
+(\214le does e)144 256.8 R .564(xist and)-.15 F F2(bibte)3.064 E(x)-.2 E
+F0(or)3.064 E F2(biber)3.064 E F0 .564(\214nds it.)3.064 F .564
 (The problem is that the bib \214le may not be in the cur)5.564 F(-)-.2
-E .248(rent directory b)144 508.8 R .247
-(ut in some search path; the places)-.2 F F3(late)2.747 E(xmk)-.2 E F0
-(and)2.747 E F3(bibte)2.747 E(x)-.2 E F0(or)2.747 E F3(biber)2.747 E F0
-.247(cause to be searched)2.747 F .72(need not be identical.)144 520.8 R
+E .248(rent directory b)144 268.8 R .247
+(ut in some search path; the places)-.2 F F2(late)2.747 E(xmk)-.2 E F0
+(and)2.747 E F2(bibte)2.747 E(x)-.2 E F0(or)2.747 E F2(biber)2.747 E F0
+.247(cause to be searched)2.747 F .72(need not be identical.)144 280.8 R
 .72(On modern installations of T)5.72 F .72
 (eX and related programs this problem should)-.7 F .958
-(not arise, since)144 532.8 R F3(late)3.458 E(xmk)-.2 E F0 .958
-(uses the)3.458 F F3(kpse)3.458 E(whic)-.15 E(h)-.15 E F0 .958
-(program to do the search, and)3.458 F F3(kpse)3.458 E(whic)-.15 E(h)
+(not arise, since)144 292.8 R F2(late)3.458 E(xmk)-.2 E F0 .958
+(uses the)3.458 F F2(kpse)3.458 E(whic)-.15 E(h)-.15 E F0 .958
+(program to do the search, and)3.458 F F2(kpse)3.458 E(whic)-.15 E(h)
 -.15 E F0 .958(should use)3.458 F 1.554(the same search path as)144
-544.8 R F3(bibte)4.054 E(x)-.2 E F0(and)4.054 E F3(biber)4.054 E F0
+304.8 R F2(bibte)4.054 E(x)-.2 E F0(and)4.054 E F2(biber)4.054 E F0
 6.554(.I)C 4.054(ft)-6.554 G 1.555(his problem arises, use the)-4.054 F
-F2(-bibtex)4.055 E F0 1.555(option when)4.055 F(in)144 556.8 Q -.2(vo)
--.4 G(king).2 E F3(late)2.5 E(xmk)-.2 E F0(.\))A F2(-bm <message>)108
-573.6 Q F0 3.052(Ab)144 585.6 S .552
+F1(-bibtex)4.055 E F0 1.555(option when)4.055 F(in)144 316.8 Q -.2(vo)
+-.4 G(king).2 E F2(late)2.5 E(xmk)-.2 E F0(.\))A F1(-bm <message>)108
+333.6 Q F0 3.052(Ab)144 345.6 S .552
 (anner message to print diagonally across each page when con)-3.052 F
 -.15(ve)-.4 G .552(rting the dvi \214le to postscript.).15 F .91
-(The message must be a single ar)144 597.6 R .911
+(The message must be a single ar)144 357.6 R .911
 (gument on the command line so be careful with quoting spaces)-.18 F
-(and such.)144 609.6 Q(Note that if the)144 633.6 Q F2(-bm)2.5 E F0
-(option is speci\214ed, the)2.5 E F2(-ps)2.5 E F0(option is assumed.)2.5
-E F2(-bi <intensity>)108 650.4 Q F0(Ho)144 662.4 Q 3.286(wd)-.25 G .786
+(and such.)144 369.6 Q(Note that if the)144 393.6 Q F1(-bm)2.5 E F0
+(option is speci\214ed, the)2.5 E F1(-ps)2.5 E F0(option is assumed.)2.5
+E F1(-bi <intensity>)108 410.4 Q F0(Ho)144 422.4 Q 3.286(wd)-.25 G .786
 (ark to print the banner message.)-3.286 F 3.286(Ad)5.786 G .786
 (ecimal number between 0 and 1.)-3.286 F 3.286(0i)5.786 G 3.285(sb)
--3.286 G .785(lack and 1 is)-3.285 F 2.5(white. The)144 674.4 R(def)2.5
+-3.286 G .785(lack and 1 is)-3.285 F 2.5(white. The)144 434.4 R(def)2.5
 E(ault is 0.95, which is OK unless your toner cartridge is getting lo)
--.1 E -.65(w.)-.25 G F2(-bs <scale>)108 691.2 Q F0 2.527(Ad)144 703.2 S
+-.1 E -.65(w.)-.25 G F1(-bs <scale>)108 451.2 Q F0 2.527(Ad)144 463.2 S
 .027(ecimal number that speci\214es ho)-2.527 F 2.527(wl)-.25 G(ar)
 -2.527 E .027(ge the banner message will be printed.)-.18 F .028
 (Experimentation is)5.028 F 1.217(necessary to get the right scale for \
-your message, as a rule of thumb the scale should be about)144 715.2 R
-.605(equal to 1100 di)144 727.2 R .606
+your message, as a rule of thumb the scale should be about)144 475.2 R
+.605(equal to 1100 di)144 487.2 R .606
 (vided by the number of characters in the message.)-.25 F .606(The def)
-5.606 F .606(ault is 220.0 which is)-.1 F 2.5(7M)281.835 768 S(ay 2011)
--2.5 E(2)204.835 E 0 Cg EP
-%%Page: 3 3
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E(just right for 5 character messages.)144 84 Q/F1 10
-/Times-Bold@0 SF(-commands)108 100.8 Q F0(List the commands used by)144
-112.8 Q/F2 10/Times-Italic@0 SF(late)2.5 E(xmk)-.2 E F0
-(for processing \214les, and then e)2.5 E(xit.)-.15 E F1(-c)108 129.6 Q
+5.606 F .606(ault is 220.0 which is)-.1 F
+(just right for 5 character messages.)144 499.2 Q F1(-commands)108 516 Q
+F0(List the commands used by)144 528 Q F2(late)2.5 E(xmk)-.2 E F0
+(for processing \214les, and then e)2.5 E(xit.)-.15 E F1(-c)108 544.8 Q
 F0 .732(Clean up \(remo)28.23 F -.15(ve)-.15 G 3.232(\)a).15 G .732
 (ll re)-3.232 F .732(generatable \214les generated by)-.15 F F2(late)
 3.232 E(x)-.2 E F0(and)3.232 E F2(bibte)3.232 E(x)-.2 E F0(or)3.232 E F2
-(biber)3.232 E F0 -.15(ex)3.232 G .732(cept dvi, post-).15 F 1.602
-(script and pdf.)144 141.6 R 1.602
-(These \214les are a combination of log \214les, aux \214les, late)6.602
-F(xmk')-.15 E 4.103(sd)-.55 G 1.603(atabase \214le of)-4.103 F .576
-(source \214le information, and those with e)144 153.6 R .575
+(biber)3.232 E F0 -.15(ex)3.232 G .732(cept dvi, post-).15 F 1.675
+(script and pdf.)144 556.8 R 1.676
+(These \214les are a combination of log \214les, aux \214les,)6.675 F F2
+(late)4.176 E(xmk)-.2 E F0 2.776 -.55('s d)D 1.676(atabase \214le of).55
+F .576(source \214le information, and those with e)144 568.8 R .575
 (xtensions speci\214ed in the)-.15 F F2(@g)3.075 E(ener)-.1 E(ated_e)
--.15 E(xts)-.2 E F0(con\214guration)3.075 E -.25(va)144 165.6 S 2.5
+-.15 E(xts)-.2 E F0(con\214guration)3.075 E -.25(va)144 580.8 S 2.5
 (riable. In).25 F(addition, \214les with e)2.5 E(xtensions by the)-.15 E
 F2($clean_e)2.5 E(xt)-.2 E F0(con\214guration v)2.5 E(ariable are remo)
 -.25 E -.15(ve)-.15 G(d.).15 E .682(This cleanup is instead of a re)144
-189.6 R .682(gular mak)-.15 F 3.182(e. See)-.1 F(the)3.182 E F1(-gg)
+604.8 R .682(gular mak)-.15 F 3.182(e. See)-.1 F(the)3.182 E F1(-gg)
 3.182 E F0 .682(option if you w)3.182 F .682(ant to do a cleanup then a)
--.1 F(mak)144 201.6 Q(e.)-.1 E(If)144 225.6 Q F2($bibte)2.5 E(x_use)-.2
+-.1 F(mak)144 616.8 Q(e.)-.1 E(If)144 640.8 Q F2($bibte)2.5 E(x_use)-.2
 E F0(is set to 0 or 1, bbl \214les are counted as non-re)2.5 E
-(generatable.)-.15 E(If)144 249.6 Q F2($cleanup_includes_cusdep_g)2.605
+(generatable.)-.15 E(If)144 664.8 Q F2($cleanup_includes_cusdep_g)2.605
 E(ener)-.1 E(ated)-.15 E F0 .105(is nonzero, re)2.605 F .104
 (generatable \214les are considered as including)-.15 F 2.37
-(those generated by custom dependencies and are also deleted.)144 261.6
-R 2.37(Otherwise these \214les are not)7.37 F(deleted.)144 273.6 Q F1
-(-C)108 290.4 Q F0 .469(Clean up \(remo)25.45 F -.15(ve)-.15 G 2.968
+(those generated by custom dependencies and are also deleted.)144 676.8
+R 2.37(Otherwise these \214les are not)7.37 F(deleted.)144 688.8 Q F1
+(-C)108 705.6 Q F0 .469(Clean up \(remo)25.45 F -.15(ve)-.15 G 2.968
 (\)a).15 G .468(ll re)-2.968 F .468(generatable \214les generated by)
 -.15 F F2(late)2.968 E(x)-.2 E F0(and)2.968 E F2(bibte)2.968 E(x)-.2 E
 F0(or)2.968 E F2(biber)2.968 E F0 5.468(.T)C .468(his is the same)-5.468
-F .527(as the)144 302.4 R F1(-c)3.027 E F0 .528(option with the additio\
+F .527(as the)144 717.6 R F1(-c)3.027 E F0 .528(option with the additio\
 n of dvi, postscript and pdf \214les, and those with e)3.027 F .528
-(xtensions in the)-.15 F F2($clean_full_e)144 314.4 Q(xt)-.2 E F0
-(con\214guration v)2.5 E(ariable.)-.25 E .682
-(This cleanup is instead of a re)144 338.4 R .682(gular mak)-.15 F 3.182
-(e. See)-.1 F(the)3.182 E F1(-gg)3.182 E F0 .682(option if you w)3.182 F
-.682(ant to do a cleanup than a)-.1 F(mak)144 350.4 Q(e.)-.1 E(If)144
-374.4 Q F2($bibte)2.5 E(x_use)-.2 E F0
+(xtensions in the)-.15 F F2($clean_full_e)144 729.6 Q(xt)-.2 E F0
+(con\214guration v)2.5 E(ariable.)-.25 E(11 No)267.545 768 Q -.15(ve)
+-.15 G(mber 2012).15 E(3)190.545 E 0 Cg EP
+%%Page: 4 4
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E .682(This cleanup is instead of a re)144 84 R .682
+(gular mak)-.15 F 3.182(e. See)-.1 F(the)3.182 E/F1 10/Times-Bold@0 SF
+(-gg)3.182 E F0 .682(option if you w)3.182 F .682
+(ant to do a cleanup than a)-.1 F(mak)144 96 Q(e.)-.1 E(If)144 120 Q/F2
+10/Times-Italic@0 SF($bibte)2.5 E(x_use)-.2 E F0
 (is set to 0 or 1, bbl \214les are counted as non-re)2.5 E(generatable.)
--.15 E(If)144 398.4 Q F2($cleanup_includes_cusdep_g)2.604 E(ener)-.1 E
+-.15 E(If)144 144 Q F2($cleanup_includes_cusdep_g)2.604 E(ener)-.1 E
 (ated)-.15 E F0 .104(is nonzero, re)2.604 F .105
 (generatable \214les are considered as including)-.15 F 2.37
-(those generated by custom dependencies and are also deleted.)144 410.4
-R 2.37(Otherwise these \214les are not)7.37 F(deleted.)144 422.4 Q F1
-(-CA)108 439.2 Q F0 2.5(\(Obsolete\). No)18.23 F 2.5(we)-.25 G(qui)-2.5
-E -.25(va)-.25 G(lent to the).25 E F1(-C)2.5 E F0 2.5(option. See)2.5 F
-(that option for details.)2.5 E F1(-CF)108 456 Q F0(Remo)19.34 E .853
+(those generated by custom dependencies and are also deleted.)144 156 R
+2.37(Otherwise these \214les are not)7.37 F(deleted.)144 168 Q F1(-CA)
+108 184.8 Q F0 2.5(\(Obsolete\). No)18.23 F 2.5(we)-.25 G(qui)-2.5 E
+-.25(va)-.25 G(lent to the).25 E F1(-C)2.5 E F0 2.5(option. See)2.5 F
+(that option for details.)2.5 E F1(-CF)108 201.6 Q F0(Remo)19.34 E .853
 -.15(ve t)-.15 H .554(he \214le containing the database of source \214l\
-e information, before doing the other actions).15 F(requested.)144 468 Q
-F1(-d)108 484.8 Q F0 .644(Set draft mode.)27.11 F .644
+e information, before doing the other actions).15 F(requested.)144 213.6
+Q F1(-d)108 230.4 Q F0 .644(Set draft mode.)27.11 F .644
 (This prints the banner message "DRAFT" across your page when con)5.644
 F -.15(ve)-.4 G .643(rting the).15 F .892(dvi \214le to postscript.)144
-496.8 R .892(Size and intensity can be modi\214ed with the)5.892 F F1
+242.4 R .892(Size and intensity can be modi\214ed with the)5.892 F F1
 (-bs)3.393 E F0(and)3.393 E F1(-bi)3.393 E F0 3.393(options. The)3.393 F
-F1(-bm)3.393 E F0(option will o)144 508.8 Q -.15(ve)-.15 G
+F1(-bm)3.393 E F0(option will o)144 254.4 Q -.15(ve)-.15 G
 (rride this option as this is really just a short w).15 E
-(ay of specifying:)-.1 E(late)180 532.8 Q(xmk -bm DRAFT)-.15 E
-(Note that if the)144 556.8 Q F1(-d)2.5 E F0(option is speci\214ed, the)
-2.5 E F1(-ps)2.5 E F0(option is assumed.)2.5 E F1(-deps)108 573.6 Q F0
+(ay of specifying:)-.1 E(late)180 278.4 Q(xmk -bm DRAFT)-.15 E
+(Note that if the)144 302.4 Q F1(-d)2.5 E F0(option is speci\214ed, the)
+2.5 E F1(-ps)2.5 E F0(option is assumed.)2.5 E F1(-deps)108 319.2 Q F0
 (Sho)13.22 E 2.533(wal)-.25 G .033
 (ist of dependent \214les after processing.)-2.533 F .033
 (This is in the form of a dependenc)5.033 F 2.532(yl)-.15 G .032
-(ist of the form)-2.532 F .989(used by the)144 585.6 R F2(mak)3.489 E(e)
+(ist of the form)-2.532 F .989(used by the)144 331.2 R F2(mak)3.489 E(e)
 -.1 E F0 .989(program, and it is therefore suitable for use in a Mak)
 3.489 F 3.49(e\214le. It)-.1 F(gi)3.49 E -.15(ve)-.25 G 3.49(sa).15 G
-3.49(no)-3.49 G -.15(ve)-3.64 G(rall).15 E(vie)144 597.6 Q 2.5(wo)-.25 G
+3.49(no)-3.49 G -.15(ve)-3.64 G(rall).15 E(vie)144 343.2 Q 2.5(wo)-.25 G
 2.5(ft)-2.5 G
 (he \214les without listing intermediate \214les, as well as)-2.5 E F2
-(late)2.5 E(xmk)-.2 E F0(can determine them.)2.5 E .988(By def)144 621.6
+(late)2.5 E(xmk)-.2 E F0(can determine them.)2.5 E .988(By def)144 367.2
 R .987(ault the list of dependent \214les is sent to stdout \(i.e., nor\
-mally to the screen unless you')-.1 F -.15(ve)-.5 G .243
-(redirected late)144 633.6 R(xmk')-.15 E 2.743(so)-.55 G 2.743
-(utput\). But)-2.743 F .243
-(you can set the \214lename where the list is sent by the)2.743 F F2
-(-deps-out=)2.744 E F0(option.)144 645.6 Q 1.174(See the section "USING)
-144 669.6 R F2(late)3.674 E(xmk)-.2 E F0(WITH)3.674 E F2(mak)3.674 E(e)
--.1 E F0 3.674("f)C 1.174(or an e)-3.674 F 1.174(xample of ho)-.15 F
-3.674(wt)-.25 G 3.673(ou)-3.674 G 1.173(se a dependenc)-3.673 F 3.673
-(yl)-.15 G(ist)-3.673 E(with)144 681.6 Q F2(mak)2.5 E(e)-.1 E F0(.)A
-1.045(Users f)144 705.6 R 1.045(amiliar with GNU)-.1 F F2(automak)3.545
-E(e)-.1 E F0(and)3.545 E F2(gcc)3.545 E F0 1.045(will \214nd that the)
-3.545 F F2(-deps)3.545 E F0 1.046(option is v)3.545 F 1.046
-(ery similar in its)-.15 F(purpose and results to the)144 717.6 Q F2(-M)
-2.5 E F0(option to)2.5 E F2(gcc)2.5 E F0(.)A 2.5(7M)281.835 768 S
-(ay 2011)-2.5 E(3)204.835 E 0 Cg EP
-%%Page: 4 4
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF(-dependents)108 84 Q F0(Equi)
-144 96 Q -.25(va)-.25 G(lent to).25 E/F2 10/Times-Italic@0 SF(-deps)2.5
-E F0(.)A F1(-deps-)108 112.8 Q F0(Do not sho)9.89 E 2.5(wal)-.25 G
+mally to the screen unless you')-.1 F -.15(ve)-.5 G(redirected)144 379.2
+Q F2(late)2.898 E(xmk)-.2 E F0 1.498 -.55('s o)D .399
+(utput\). But you can set the \214lename where the list is sent by the)
+.55 F F1(-deps-out=)2.899 E F0(option.)144 391.2 Q 1.174
+(See the section "USING)144 415.2 R F2(late)3.674 E(xmk)-.2 E F0(WITH)
+3.674 E F2(mak)3.674 E(e)-.1 E F0 3.674("f)C 1.174(or an e)-3.674 F
+1.174(xample of ho)-.15 F 3.674(wt)-.25 G 3.673(ou)-3.674 G 1.173
+(se a dependenc)-3.673 F 3.673(yl)-.15 G(ist)-3.673 E(with)144 427.2 Q
+F2(mak)2.5 E(e)-.1 E F0(.)A .979(Users f)144 451.2 R .979
+(amiliar with GNU)-.1 F F2(automak)3.479 E(e)-.1 E F0(and)3.479 E F2
+(gcc)3.479 E F0 .979(will \214nd that the)3.479 F F1(-deps)3.48 E F0 .98
+(option is v)3.48 F .98(ery similar in its)-.15 F .278
+(purpose and results to the)144 463.2 R F1(-M)2.777 E F0 .277(option to)
+2.777 F F2(gcc)2.777 E F0 5.277(.\()C .277(In f)-5.277 F(act,)-.1 E F2
+(late)2.777 E(xmk)-.2 E F0 .277(also has options)2.777 F F1(-M)2.777 E
+F0(,)A F1(-MF)2.777 E F0 2.777(,a)C(nd)-2.777 E F1(-MP)2.777 E F0
+(options that beha)144 475.2 Q .3 -.15(ve l)-.2 H(ik).15 E 2.5(et)-.1 G
+(hose of)-2.5 E F2(gcc)2.5 E F0(.\))A F1(-dependents)108 492 Q F0(Equi)
+144 504 Q -.25(va)-.25 G(lent to).25 E F1(-deps)2.5 E F0(.)A F1(-deps-)
+108 520.8 Q F0(Do not sho)9.89 E 2.5(wal)-.25 G
 (ist of dependent \214les after processing.)-2.5 E(\(This is the def)5 E
-(ault.\))-.1 E F1(-dependents-)108 129.6 Q F0(Equi)144 141.6 Q -.25(va)
--.25 G(lent to).25 E F2(-deps-)2.5 E F0(.)A F1(-deps-out=FILEN)108 158.4
+(ault.\))-.1 E F1(-dependents-)108 537.6 Q F0(Equi)144 549.6 Q -.25(va)
+-.25 G(lent to).25 E F1(-deps-)2.5 E F0(.)A F1(-deps-out=FILEN)108 566.4
 Q(AME)-.2 E F0 1.278
 (Set the \214lename to which the list of dependent \214les is written.)
-144 170.4 R 1.278(If the FILEN)6.278 F 1.278(AME ar)-.35 F 1.278
+144 578.4 R 1.278(If the FILEN)6.278 F 1.279(AME ar)-.35 F 1.279
 (gument is)-.18 F
-(omitted or set to '-', then the output is sent to stdout.)144 182.4 Q(\
+(omitted or set to "-", then the output is sent to stdout.)144 590.4 Q(\
 Use of this option also turns on the output of the list of dependent \
-\214les after processing.)144 206.4 Q F1(-dF)108 223.2 Q F0 .313
-(Dvi \214le \214ltering.)21 F .313(The ar)5.313 F .313(gument to this o\
+\214les after processing.)144 614.4 Q F1(-dF)108 631.2 Q F0 .314
+(Dvi \214le \214ltering.)21 F .314(The ar)5.314 F .313(gument to this o\
 ption is a \214lter which will generate a \214ltered dvi \214le with)
--.18 F .985(the e)144 235.2 R .985(xtension ".dviF".)-.15 F .985(All e)
+-.18 F .985(the e)144 643.2 R .985(xtension ".dviF".)-.15 F .985(All e)
 5.985 F .985(xtra processing \(e.g. con)-.15 F -.15(ve)-.4 G .985
 (rsion to postscript, pre).15 F(vie)-.25 E 2.285 -.65(w, p)-.25 H .985
 (rinting\) will).65 F(then be performed on this \214ltered dvi \214le.)
-144 247.2 Q(Example usage: T)144 271.2 Q 2.5(ou)-.8 G
+144 655.2 Q(Example usage: T)144 679.2 Q 2.5(ou)-.8 G
 (se dviselect to select only the e)-2.5 E -.15(ve)-.25 G 2.5(np).15 G
-(ages of the dvi \214le:)-2.5 E(late)180 295.2 Q(xmk -dF ')-.15 E
-(dviselect e)-.5 E -.15(ve)-.25 G(n' foo.te).15 E(x)-.15 E F1
-(-diagnostics)108 312 Q F0 .921
-(Print detailed diagnostics during a run.)144 324 R .921
-(This may help for deb)5.921 F .922(ugging problems or to understand)-.2
-F F2(late)144 336 Q(xmk)-.2 E F0 1.1 -.55('s b)D(eha).55 E(vior in dif)
--.2 E(\214cult situations.)-.25 E F1(-dvi)108 352.8 Q F0(Generate dvi v)
-19.33 E(ersion of document.)-.15 E F1(-dvi-)108 369.6 Q F0 -.45(Tu)16 G
-1.059(rn of).45 F 3.559(fg)-.25 G 1.058(eneration of dvi v)-3.559 F
-1.058(ersion of document.)-.15 F 1.058(\(This may get o)6.058 F -.15(ve)
--.15 G 1.058(rridden, if some other \214le is).15 F(made \(e.g., a .ps \
-\214le\) that is generated from the dvi \214le, or if no generated \214\
-le at all is requested.\))144 381.6 Q F1(-e <code>)108 398.4 Q F0(Ex)144
-410.4 Q 1.494
-(ecute the speci\214ed initialization code before processing.)-.15 F
-1.494(The code is)6.494 F F2 -.8(Pe)3.994 G(rl).8 E F0 1.495
-(code of the same)3.995 F 1.087(form as is used in)144 422.4 R F2(late)
-3.587 E(xmk)-.2 E F0 2.187 -.55('s i)D 1.086
+(ages of the dvi \214le:)-2.5 E(late)180 703.2 Q(xmk -dF "dviselect e)
+-.15 E -.15(ve)-.25 G(n" foo.te).15 E(x)-.15 E(11 No)267.545 768 Q -.15
+(ve)-.15 G(mber 2012).15 E(4)190.545 E 0 Cg EP
+%%Page: 5 5
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF(-diagnostics)108 84 Q F0 .922
+(Print detailed diagnostics during a run.)144 96 R .921
+(This may help for deb)5.922 F .921(ugging problems or to understand)-.2
+F/F2 10/Times-Italic@0 SF(late)144 108 Q(xmk)-.2 E F0 1.1 -.55('s b)D
+(eha).55 E(vior in dif)-.2 E(\214cult situations.)-.25 E F1(-dvi)108
+124.8 Q F0(Generate dvi v)19.33 E(ersion of document.)-.15 E F1(-dvi-)
+108 141.6 Q F0 -.45(Tu)16 G 1.058(rn of).45 F 3.558(fg)-.25 G 1.058
+(eneration of dvi v)-3.558 F 1.058(ersion of document.)-.15 F 1.058
+(\(This may get o)6.058 F -.15(ve)-.15 G 1.058
+(rridden, if some other \214le is).15 F(made \(e.g., a .ps \214le\) tha\
+t is generated from the dvi \214le, or if no generated \214le at all is\
+ requested.\))144 153.6 Q F1(-e <code>)108 170.4 Q F0(Ex)144 182.4 Q
+1.495(ecute the speci\214ed initialization code before processing.)-.15
+F 1.494(The code is)6.494 F F2 -.8(Pe)3.994 G(rl).8 E F0 1.494
+(code of the same)3.994 F 1.086(form as is used in)144 194.4 R F2(late)
+3.586 E(xmk)-.2 E F0 2.186 -.55('s i)D 1.087
 (nitialization \214les -- for more details, see the information on the)
-.55 F F1(-r)3.586 E F0 1.788(option, and the section about "Con\214gura\
-tion/initialization \(RC\) \214les".)144 434.4 R 1.789
+.55 F F1(-r)3.587 E F0 1.789(option, and the section about "Con\214gura\
+tion/initialization \(RC\) \214les".)144 206.4 R 1.788
 (The code is typically a)6.788 F
-(sequence of assignment statements separated by semicolons.)144 446.4 Q
-.605(The code is e)144 470.4 R -.15(xe)-.15 G .605(cuted when the).15 F
-F1(-e)3.105 E F0 .605(option is encountered during)3.105 F F2(late)3.104
-E(xmk)-.2 E F0 1.704 -.55('s p)D .604(arsing of its command).55 F 3.322
-(line. See)144 482.4 R(the)3.322 E F1(-r)3.322 E F0 .822(option for a w)
-3.322 F .822(ay of e)-.1 F -.15(xe)-.15 G .822
-(cuting initialization code from a \214le.).15 F .823
-(An error results in)5.823 F F2(late)144 494.4 Q(xmk)-.2 E F0 2.569
-(stopping. Multiple)2.569 F .069(instances of the)2.569 F F1(-r)2.569 E
+(sequence of assignment statements separated by semicolons.)144 218.4 Q
+.604(The code is e)144 242.4 R -.15(xe)-.15 G .604(cuted when the).15 F
+F1(-e)3.105 E F0 .605(option is encountered during)3.105 F F2(late)3.105
+E(xmk)-.2 E F0 1.705 -.55('s p)D .605(arsing of its command).55 F 3.323
+(line. See)144 254.4 R(the)3.323 E F1(-r)3.323 E F0 .822(option for a w)
+3.323 F .822(ay of e)-.1 F -.15(xe)-.15 G .822
+(cuting initialization code from a \214le.).15 F .822
+(An error results in)5.822 F F2(late)144 266.4 Q(xmk)-.2 E F0 2.568
+(stopping. Multiple)2.568 F .069(instances of the)2.568 F F1(-r)2.569 E
 F0(and)2.569 E F1(-e)2.569 E F0 .069(options can be used, and the)2.569
-F 2.568(ya)-.15 G .068(re e)-2.568 F -.15(xe)-.15 G .068(cuted in).15 F
-(the order the)144 506.4 Q 2.5(ya)-.15 G(ppear on the command line.)-2.5
+F 2.569(ya)-.15 G .069(re e)-2.569 F -.15(xe)-.15 G .069(cuted in).15 F
+(the order the)144 278.4 Q 2.5(ya)-.15 G(ppear on the command line.)-2.5
 E .178(Some care is needed to deal with proper quoting of special chara\
-cters in the code on the command)144 530.4 R 2.6(line. F)144 542.4 R .1
-(or e)-.15 F .1(xample, suppose you w)-.15 F .099(ant to set the late)
--.1 F 2.599(xc)-.15 G .099(ommand to use its -shell-escape option, then)
--2.599 F(under UNIX/LINUX you could use the line)144 554.4 Q(late)180
-578.4 Q(xmk -e '$late)-.15 E(x=q/late)-.15 E 2.5(x%)-.15 G 2.5(O-)-2.5 G
+cters in the code on the command)144 302.4 R 2.599(line. F)144 314.4 R
+.099(or e)-.15 F .099(xample, suppose you w)-.15 F .099
+(ant to set the late)-.1 F 2.599(xc)-.15 G .1
+(ommand to use its -shell-escape option, then)-2.599 F
+(under UNIX/LINUX you could use the line)144 326.4 Q(late)180 350.4 Q
+(xmk -e '$late)-.15 E(x=q/late)-.15 E 2.5(x%)-.15 G 2.5(O-)-2.5 G
 (shell-escape %S/' \214le.te)-2.5 E(x)-.15 E .275(Note that the single \
 quotes block normal UNIX/LINUX command shells from treating the charac-)
-144 602.4 R .392(ters inside the quotes as special.)144 614.4 R .391
+144 374.4 R .391(ters inside the quotes as special.)144 386.4 R .391
 (\(In this e)5.391 F .391(xample, the q/.../ construct is a)-.15 F F2
--.8(Pe)2.891 G(rl).8 E F0 .391(idiom equi)2.891 F -.25(va)-.25 G .391
-(lent to).25 F .738(using single quotes.)144 626.4 R .738(This a)5.738 F
--.2(vo)-.2 G .739
+-.8(Pe)2.891 G(rl).8 E F0 .392(idiom equi)2.892 F -.25(va)-.25 G .392
+(lent to).25 F .739(using single quotes.)144 398.4 R .739(This a)5.739 F
+-.2(vo)-.2 G .738
 (ids the complications of getting a quote character inside an already).2
-F(quoted string in a w)144 638.4 Q
+F(quoted string in a w)144 410.4 Q
 (ay that is independent of both the shell and the operating-system.\))
--.1 E .665(The abo)144 662.4 R .965 -.15(ve c)-.15 H .665
+-.1 E .664(The abo)144 434.4 R .964 -.15(ve c)-.15 H .664
 (ommand line will NO).15 F 3.165(Tw)-.4 G .665(ork under MS-W)-3.265 F
-(indo)-.4 E .664(ws with cmd.e)-.25 F .964 -.15(xe o)-.15 H 3.164(rc).15
-G .664(ommand.com or)-3.164 F(4nt.e)144 674.4 Q -.15(xe)-.15 G 5(.F).15
+(indo)-.4 E .665(ws with cmd.e)-.25 F .965 -.15(xe o)-.15 H 3.165(rc).15
+G .665(ommand.com or)-3.165 F(4nt.e)144 446.4 Q -.15(xe)-.15 G 5(.F).15
 G(or MS-W)-5.15 E(indo)-.4 E(ws with these command shells you could use)
--.25 E(late)180 698.4 Q(xmk -e "$late)-.15 E(x=q/late)-.15 E 2.5(x%)-.15
-G 2.5(O-)-2.5 G(shell-escape %S/" \214le.te)-2.5 E(x)-.15 E(or)144 722.4
-Q 2.5(7M)281.835 768 S(ay 2011)-2.5 E(4)204.835 E 0 Cg EP
-%%Page: 5 5
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E(late)180 84 Q(xmk -e "$late)-.15 E(x=')-.15 E(late)
--.1 E 2.5(x%)-.15 G 2.5(O-)-2.5 G(shell-escape %S'" \214le.te)-2.5 E(x)
--.15 E(The last tw)144 108 Q 2.5(oe)-.1 G(xamples will NO)-2.65 E 2.5
-(Tw)-.4 G(ork with UNIX/LINUX command shells.)-2.6 E/F1 10/Times-Bold@0
-SF(-f)108 124.8 Q F0 -.15(Fo)29.34 G(rce).15 E/F2 10/Times-Italic@0 SF
-(late)3.717 E(xmk)-.2 E F0 1.217
-(to continue document processing despite errors.)3.717 F(Normally)6.217
-E 3.718(,w)-.65 G(hen)-3.718 E F2(late)3.718 E(xmk)-.2 E F0(detects)
-3.718 E .574(that LaT)144 136.8 R .573
+-.25 E(late)180 470.4 Q(xmk -e "$late)-.15 E(x=q/late)-.15 E 2.5(x%)-.15
+G 2.5(O-)-2.5 G(shell-escape %S/" \214le.te)-2.5 E(x)-.15 E(or)144 494.4
+Q(late)180 518.4 Q(xmk -e "$late)-.15 E(x=')-.15 E(late)-.1 E 2.5(x%)
+-.15 G 2.5(O-)-2.5 G(shell-escape %S'" \214le.te)-2.5 E(x)-.15 E
+(The last tw)144 542.4 Q 2.5(oe)-.1 G(xamples will NO)-2.65 E 2.5(Tw)-.4
+G(ork with UNIX/LINUX command shells.)-2.6 E F1(-f)108 559.2 Q F0 -.15
+(Fo)29.34 G(rce).15 E F2(late)3.718 E(xmk)-.2 E F0 1.217
+(to continue document processing despite errors.)3.718 F(Normally)6.217
+E 3.717(,w)-.65 G(hen)-3.717 E F2(late)3.717 E(xmk)-.2 E F0(detects)
+3.717 E .573(that LaT)144 571.2 R .573
 (eX or another program has found an error which will not be resolv)-.7 F
-.573(ed by further process-)-.15 F
-(ing, no further processing is carried out.)144 148.8 Q F1(-f-)108 165.6
-Q F0 -.45(Tu)26.01 G 1.002(rn of).45 F 3.503(ft)-.25 G 1.003
+.574(ed by further process-)-.15 F
+(ing, no further processing is carried out.)144 583.2 Q F1(-f-)108 600 Q
+F0 -.45(Tu)26.01 G 1.003(rn of).45 F 3.503(ft)-.25 G 1.003
 (he forced processing-past-errors such as is set by the)-3.503 F F1(-f)
 3.503 E F0 3.503(option. This)3.503 F 1.003(could be used to)3.503 F
--.15(ove)144 177.6 S(rride a setting in a con\214guration \214le.).15 E
-F1(-g)108 194.4 Q F0 -.15(Fo)27.67 G(rce).15 E F2(late)4.05 E(xmk)-.2 E
-F0 1.55(to process document fully)4.05 F 4.05(,e)-.65 G -.15(ve)-4.3 G
-4.05(nu).15 G 1.55(nder situations where)-4.05 F F2(late)4.05 E(xmk)-.2
-E F0 -.1(wo)4.05 G 1.55(uld normally).1 F .114
-(decide that no changes in the source \214les ha)144 206.4 R .415 -.15
-(ve o)-.2 H .115(ccurred since the pre).15 F .115(vious run.)-.25 F .115
-(This option is use-)5.115 F(ful, for e)144 218.4 Q
+-.15(ove)144 612 S(rride a setting in a con\214guration \214le.).15 E F1
+(-g)108 628.8 Q F0 -.15(Fo)27.67 G(rce).15 E F2(late)4.05 E(xmk)-.2 E F0
+1.55(to process document fully)4.05 F 4.05(,e)-.65 G -.15(ve)-4.3 G 4.05
+(nu).15 G 1.55(nder situations where)-4.05 F F2(late)4.05 E(xmk)-.2 E F0
+-.1(wo)4.05 G 1.55(uld normally).1 F .115
+(decide that no changes in the source \214les ha)144 640.8 R .415 -.15
+(ve o)-.2 H .115(ccurred since the pre).15 F .114(vious run.)-.25 F .114
+(This option is use-)5.114 F(ful, for e)144 652.8 Q
 (xample, if you change some options and wish to reprocess the \214les.)
--.15 E F1(-g-)108 235.2 Q F0 -.45(Tu)24.34 G(rn of).45 E(f)-.25 E F1(-g)
-2.5 E F0(.)A F1(-gg)108 252 Q F0 .248("Super go mode" or "clean mak)
+-.15 E F1(-g-)108 669.6 Q F0 -.45(Tu)24.34 G(rn of).45 E(f)-.25 E F1(-g)
+2.5 E F0(.)A F1(-gg)108 686.4 Q F0 .248("Super go mode" or "clean mak)
 22.67 F .248(e": clean out generated \214les as if)-.1 F F1(-C)2.748 E
 F0 .248(had been gi)2.748 F -.15(ve)-.25 G .248(n, and then do a).15 F
-(re)144 264 Q(gular mak)-.15 E(e.)-.1 E F1(-h, -help)108 280.8 Q F0
-(Print help information.)144 292.8 Q F1(-l)108 309.6 Q F0 .045
+(re)144 698.4 Q(gular mak)-.15 E(e.)-.1 E(11 No)267.545 768 Q -.15(ve)
+-.15 G(mber 2012).15 E(5)190.545 E 0 Cg EP
+%%Page: 6 6
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF(-h, -help)108 84 Q F0
+(Print help information.)144 96 Q F1(-jobname=STRING)108 112.8 Q F0 .871
+(Set the basename of output \214les\(s\) to STRING, instead of the def)
+144 124.8 R .87(ault, which is the basename of)-.1 F(the speci\214ed T)
+144 136.8 Q(eX \214le.)-.7 E .426(This is lik)144 160.8 R 2.926(et)-.1 G
+.426(he same option for current implementations of the)-2.926 F/F2 10
+/Times-Italic@0 SF(late)2.926 E(x)-.2 E F0(and)2.926 E F2(pd\215ate)
+2.927 E(x)-.2 E F0 2.927(,a)C .427(nd the passing)-2.927 F
+(of this option to these programs is part of)144 172.8 Q F2(late)2.5 E
+(xmk)-.2 E F0 1.1 -.55('s i)D(mplementation of).55 E F1(-jobname)2.5 E
+F0(.)A F1(-l)108 201.6 Q F0 .046
 (Run in landscape mode, using the landscape mode for the pre)29.89 F
-(vie)-.25 E .046(wers and the dvi to postscript con-)-.25 F -.15(ve)144
-321.6 S 3.593(rters. This).15 F 1.093(option is not normally needed no)
-3.593 F -.1(wa)-.25 G 1.092(days, since current pre).1 F(vie)-.25 E
-1.092(wers normally deter)-.25 F(-)-.2 E
-(mine this information automatically)144 333.6 Q(.)-.65 E F1(-l-)108
-350.4 Q F0 -.45(Tu)26.56 G(rn of).45 E(f)-.25 E F1(-l)2.5 E F0(.)A F1
-(-new-viewer)108 367.2 Q F0 1.827(When in continuous-pre)144 379.2 R
-(vie)-.25 E 4.327(wm)-.25 G 1.827(ode, al)-4.327 F -.1(wa)-.1 G 1.827
-(ys start a ne).1 F 4.327(wv)-.25 G(ie)-4.327 E 1.827(wer to vie)-.25 F
-4.327(wt)-.25 G 1.827(he generated \214le.)-4.327 F(By)6.828 E(def)144
-391.2 Q(ault,)-.1 E F2(late)3.001 E(xmk)-.2 E F0 .501
-(will, in continuous-pre)3.001 F(vie)-.25 E 3.001(wm)-.25 G .501
-(ode, test for a pre)-3.001 F .501(viously running pre)-.25 F(vie)-.25 E
-.5(wer for the)-.25 F .542(same \214le and not start a ne)144 403.2 R
-3.042(wo)-.25 G .542(ne if a pre)-3.042 F .542(vious pre)-.25 F(vie)-.25
-E .543(wer is running.)-.25 F(Ho)5.543 E(we)-.25 E -.15(ve)-.25 G 1.343
--.4(r, i).15 H .543(ts test sometimes).4 F -.1(fa)144 415.2 S .046
+(vie)-.25 E .045(wers and the dvi to postscript con-)-.25 F -.15(ve)144
+213.6 S 3.592(rters. This).15 F 1.092(option is not normally needed no)
+3.592 F -.1(wa)-.25 G 1.093(days, since current pre).1 F(vie)-.25 E
+1.093(wers normally deter)-.25 F(-)-.2 E
+(mine this information automatically)144 225.6 Q(.)-.65 E F1(-l-)108
+242.4 Q F0 -.45(Tu)26.56 G(rn of).45 E(f)-.25 E F1(-l)2.5 E F0(.)A F1
+(-latex="COMMAND")108 259.2 Q F0 1.654
+(This sets the string specifying the command to run late)144 271.2 R
+1.653(x, and is typically used to add desired)-.15 F 2.5(options. Since)
+144 283.2 R
+(the string normally contains spaces, it should be quoted, e.g.,)2.5 E
+(late)156.5 307.2 Q 2.5(x-)-.15 G(late)-2.5 E(x="late)-.15 E 2.5(x-)-.15
+G(-shell-escape %O %S")-2.5 E(foo.te)5 E(x)-.15 E .217(The speci\214cat\
+ion of the contents of the string are the same as for the)144 331.2 R F2
+($late)2.717 E(x)-.2 E F0 .217(con\214guration v)2.717 F(ariable.)-.25 E
+.477(Depending on your operating system and the command-line shell you \
+are using, you may need to)144 343.2 R
+(change the single quotes to double quotes \(or something else\).)144
+355.2 Q 2.8 -.8(To s)144 379.2 T 1.2
+(et the command for running pd\215ate).8 F 3.7(x\()-.15 G 1.2
+(rather than the command for late)-3.7 F 1.2(x\) see the)-.15 F F1
+(-pd\215atex)3.7 E F0(option.)144 391.2 Q .002(Note that the ef)144
+415.2 R .002(fect of this option can also be achie)-.25 F -.15(ve)-.25 G
+2.502(db).15 G 2.502(yu)-2.502 G .002(sing the)-2.502 F F1(-e)2.502 E F0
+.002(option with a suitable line of)2.502 F(Perl code to set the)144
+427.2 Q F2($late)2.5 E(x)-.2 E F0 -.25(va)2.5 G 2.5(riable. See).25 F
+(the e)2.5 E(xplanation of the)-.15 E F1(-e)2.5 E F0(option.)2.5 E F1
+(-M)108 444 Q F0(Sho)23.23 E 2.5(wl)-.25 G
+(ist of dependent \214les after processing.)-2.5 E(This is equi)5 E -.25
+(va)-.25 G(lent to the).25 E F1(-deps)2.5 E F0(option.)2.5 E F1
+(-MF \214le)108 460.8 Q F0(If a list of dependents is made, the)144
+472.8 Q F1(-MF)2.5 E F0(speci\214es the \214le to write it to.)2.5 E F1
+(-MP)108 489.6 Q F0 .804(If a list of dependents is made, includes phon)
+17.12 F 3.304(yt)-.15 G(ar)-3.304 E .804(get for each source \214le.)
+-.18 F .804(If you use the depen-)5.804 F 1.189(dents list in a Mak)144
+501.6 R 1.188(e\214le, the dummy rules w)-.1 F 1.188
+(ork around errors mak)-.1 F 3.688(eg)-.1 G -2.15 -.25(iv e)-3.688 H
+3.688(si).25 G 3.688(fy)-3.688 G 1.188(ou remo)-3.688 F 1.488 -.15(ve h)
+-.15 H(eader).15 E(\214les without updating the Mak)144 513.6 Q
+(e\214le to match.)-.1 E F1(-new-viewer)108 530.4 Q F0 1.827
+(When in continuous-pre)144 542.4 R(vie)-.25 E 4.327(wm)-.25 G 1.827
+(ode, al)-4.327 F -.1(wa)-.1 G 1.827(ys start a ne).1 F 4.327(wv)-.25 G
+(ie)-4.327 E 1.827(wer to vie)-.25 F 4.327(wt)-.25 G 1.827
+(he generated \214le.)-4.327 F(By)6.828 E(def)144 554.4 Q(ault,)-.1 E F2
+(late)3.001 E(xmk)-.2 E F0 .501(will, in continuous-pre)3.001 F(vie)-.25
+E 3.001(wm)-.25 G .501(ode, test for a pre)-3.001 F .501
+(viously running pre)-.25 F(vie)-.25 E .5(wer for the)-.25 F .542
+(same \214le and not start a ne)144 566.4 R 3.042(wo)-.25 G .542
+(ne if a pre)-3.042 F .542(vious pre)-.25 F(vie)-.25 E .543
+(wer is running.)-.25 F(Ho)5.543 E(we)-.25 E -.15(ve)-.25 G 1.343 -.4
+(r, i).15 H .543(ts test sometimes).4 F -.1(fa)144 578.4 S .046
 (ils \(notably if there is an already-running pre).1 F(vie)-.25 E .046
 (wer that is vie)-.25 F .045(wing a \214le of the same name as the)-.25
-F(current \214le, b)144 427.2 Q(ut in a dif)-.2 E(ferent directory\).)
+F(current \214le, b)144 590.4 Q(ut in a dif)-.2 E(ferent directory\).)
 -.25 E(This option turns of)5 E 2.5(ft)-.25 G(he def)-2.5 E(ault beha)
--.1 E(vior)-.2 E(.)-.55 E F1(-new-viewer)108 444 Q(-)-.37 E F0 .112
-(The in)144 456 R -.15(ve)-.4 G .112(rse of the).15 F F1(-new-viewer)
+-.1 E(vior)-.2 E(.)-.55 E F1(-new-viewer)108 607.2 Q(-)-.37 E F0 .112
+(The in)144 619.2 R -.15(ve)-.4 G .112(rse of the).15 F F1(-new-viewer)
 2.612 E F0 2.613(option. It)2.612 F(puts)2.613 E F2(late)2.613 E(xmk)-.2
 E F0 .113(in its normal beha)2.613 F .113(vior that in pre)-.2 F(vie)
 -.25 E(w-con-)-.25 E(tinuous mode it checks for an already-running pre)
-144 468 Q(vie)-.25 E(wer)-.25 E(.)-.55 E F1(-nobibtex)108 484.8 Q F0(Ne)
-144 496.8 Q -.15(ve)-.25 G 2.5(rr).15 G(un bibte)-2.5 E 2.5(xo)-.15 G
-2.5(rb)-2.5 G(iber)-2.5 E(.)-.55 E 2.94(Ac)144 520.8 S .44
+144 631.2 Q(vie)-.25 E(wer)-.25 E(.)-.55 E F1(-nobibtex)108 648 Q F0(Ne)
+144 660 Q -.15(ve)-.25 G 2.5(rr).15 G(un bibte)-2.5 E 2.5(xo)-.15 G 2.5
+(rb)-2.5 G(iber)-2.5 E(.)-.55 E 2.94(Ac)144 684 S .44
 (ommon use for this option is when a document comes from an e)-2.94 F
 .44(xternal source, complete with)-.15 F .14
-(its bbl \214le\(s\), and the user does not ha)144 532.8 R .441 -.15
-(ve t)-.2 H .141(he corresponding bib \214les a).15 F -.25(va)-.2 G
-2.641(ilable. In).25 F .141(this situation use)2.641 F .069(of the)144
-544.8 R F1(-nobibtex)2.569 E F0 .069(option will pre)2.569 F -.15(ve)
--.25 G(nt).15 E F2(late)2.569 E(xmk)-.2 E F0 .069(from trying to run)
-2.569 F F2(bibte)2.569 E(x)-.2 E F0(or)2.569 E F2(biber)2.568 E F0 2.568
-(,w)C .068(hich w)-2.568 F .068(ould result)-.1 F(in o)144 556.8 Q -.15
-(ve)-.15 G(rwriting of the bbl \214les.).15 E F1(-p)108 573.6 Q F0 .703
-(Print out the document.)27.11 F .703(By def)5.703 F .703
-(ault it is the generated postscript \214le that is printed.)-.1 F .703
-(But you can)5.703 F .044(use the)144 585.6 R F1(-print=...)2.544 E F0
-.044(option to print the dvi or pdf \214les instead, and you can con\
-\214gure this in a start up)2.544 F(\214le \(by setting the)144 597.6 Q
-F2($print_type)2.5 E F0 -.25(va)2.5 G(riable\).).25 E(Ho)144 621.6 Q(we)
--.25 E -.15(ve)-.25 G 1.045 -.4(r, p).15 H .245
+(its bbl \214le\(s\), and the user does not ha)144 696 R .441 -.15(ve t)
+-.2 H .141(he corresponding bib \214les a).15 F -.25(va)-.2 G 2.641
+(ilable. In).25 F .141(this situation use)2.641 F .069(of the)144 708 R
+F1(-nobibtex)2.569 E F0 .069(option will pre)2.569 F -.15(ve)-.25 G(nt)
+.15 E F2(late)2.569 E(xmk)-.2 E F0 .069(from trying to run)2.569 F F2
+(bibte)2.569 E(x)-.2 E F0(or)2.569 E F2(biber)2.568 E F0 2.568(,w)C .068
+(hich w)-2.568 F .068(ould result)-.1 F(in o)144 720 Q -.15(ve)-.15 G
+(rwriting of the bbl \214les.).15 E(11 No)267.545 768 Q -.15(ve)-.15 G
+(mber 2012).15 E(6)190.545 E 0 Cg EP
+%%Page: 7 7
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF(-nor)108 84 Q(c)-.18 E F0
+-.45(Tu)13.41 G(rn of).45 E 2.5(ft)-.25 G
+(he automatic reading of initialization \(rc\) \214les.)-2.5 E 1.534
+(N.B. Normally the initialization \214les are read and obe)144 108 R
+1.535(yed, and then command line options are)-.15 F(obe)144 120 Q .898
+(yed in the order the)-.15 F 3.397(ya)-.15 G .897(re encountered.)-3.397
+F(Then)5.897 E F1(-nor)3.397 E(c)-.18 E F0 .897(is an e)3.397 F .897
+(xception to this rule: it is acted on)-.15 F
+(\214rst, no matter where is occurs on the command line.)144 132 Q F1
+(-outdir=FOO or -output-dir)108 160.8 Q(ectory=FOO)-.18 E F0 .599
+(Sets the directory for the output \214les of \(pdf\)late)144 184.8 R
+3.099(x. This)-.15 F(achie)3.099 E -.15(ve)-.25 G 3.1(si).15 G .6(ts ef)
+-3.1 F .6(fect by the)-.25 F F1(-output-dir)3.1 E(ec-)-.18 E(tory)144
+196.8 Q F0 .296(option of \(pdf\)late)2.796 F .296
+(x, which currently \(Dec. 2011\) is implemented on the common v)-.15 F
+.295(ersions of)-.15 F(\(pdf\)late)144 208.8 Q(x, i.e., MiKT)-.15 E
+(eX and T)-.7 E(eXLi)-.7 E -.15(ve)-.25 G 5(.I).15 G 2.5(tm)-5 G
+(ay not be present in other v)-2.5 E(ersions.)-.15 E .312(See also the)
+144 232.8 R F1(-auxdir)2.812 E F0(/)A F1(-aux-dir)A(ectory)-.18 E F0
+.312(options, and the)2.812 F/F2 10/Times-Italic@0 SF($aux_dir)2.812 E
+F0(,)A F2($out_dir)2.812 E F0 2.812(,a)C(nd)-2.812 E F2($sear)2.812 E
+-.15(ch)-.37 G(_path_sepa-).15 E -.15(ra)144 244.8 S(tor).15 E F0 .073
+(con\214guration v)2.574 F .073(ariables of)-.25 F F2(late)2.573 E(xmk)
+-.2 E F0 5.073(.I)C 2.573(np)-5.073 G(articular)-2.573 E 2.573(,s)-.4 G
+.073(ee the documentation of)-2.573 F F2($out_dir)2.573 E F0 .073
+(for some)2.573 F(complications on what directory names are suitable.)
+144 256.8 Q F1(-p)144 309.6 Q F0 .655(Print out the document.)27.11 F
+.655(By def)5.655 F .655
+(ault it is the generated postscript \214le that is printed.)-.1 F(But)
+5.656 E .325(you can use the)144 321.6 R F1(-print=...)2.825 E F0 .324(\
+option to print the dvi or pdf \214les instead, and you can con\214gure\
+ this in)2.824 F 2.5(as)144 333.6 S(tart up \214le \(by setting the)-2.5
+E F2($print_type)2.5 E F0 -.25(va)2.5 G(riable\).).25 E(Ho)144 357.6 Q
+(we)-.25 E -.15(ve)-.25 G 1.045 -.4(r, p).15 H .245
 (rinting is enabled by def).4 F .245
 (ault only under UNIX/LINUX systems, where the def)-.1 F .245
-(ault is to)-.1 F 1.207(use the lpr command.)144 633.6 R 1.207
+(ault is to)-.1 F 1.207(use the lpr command.)144 369.6 R 1.207
 (In general, the correct beha)6.207 F 1.207(vior for printing v)-.2 F
-1.206(ery much depends on your)-.15 F(system')144 645.6 Q 2.597(ss)-.55
+1.206(ery much depends on your)-.15 F(system')144 381.6 Q 2.597(ss)-.55
 G(oftw)-2.597 E 2.597(are. In)-.1 F(particular)2.597 E 2.597(,u)-.4 G
 .097(nder MS-W)-2.597 F(indo)-.4 E .097(ws you must ha)-.25 F .398 -.15
 (ve s)-.2 H .098(uitable program\(s\) a).15 F -.25(va)-.2 G(ilable,).25
-E .476(and you must ha)144 657.6 R .776 -.15(ve c)-.2 H .475
+E .476(and you must ha)144 393.6 R .776 -.15(ve c)-.2 H .475
 (on\214gured the print commands used by).15 F F2(late)2.975 E(xmk)-.2 E
 F0 5.475(.T)C .475(his can be non-tri)-5.475 F 2.975(vial. See)-.25 F
-.157(the documentation on the)144 669.6 R F2($lpr)2.657 E F0(,)A F2
+.157(the documentation on the)144 405.6 R F2($lpr)2.657 E F0(,)A F2
 ($lpr_dvi)2.657 E F0 2.657(,a)C(nd)-2.657 E F2($lpr_pdf)2.657 E F0 .157
 (con\214guration v)2.657 F .158(ariables to see ho)-.25 F 2.658(wt)-.25
 G 2.658(os)-2.658 G .158(et the)-2.658 F(commands for printing.)144
-681.6 Q(This option is incompatible with the)144 705.6 Q F1(-pv)2.5 E F0
+417.6 Q(This option is incompatible with the)144 441.6 Q F1(-pv)2.5 E F0
 (and)2.5 E F1(-pvc)2.5 E F0(options, so it turns them of)2.5 E(f.)-.25 E
-2.5(7M)281.835 768 S(ay 2011)-2.5 E(5)204.835 E 0 Cg EP
-%%Page: 6 6
+F1(-pdf)108 458.4 Q F0 .654(Generate pdf v)18.22 F .654
+(ersion of document using pd\215ate)-.15 F 3.154(x. \(See)-.15 F(the)
+3.154 E F1(-xelatex)3.154 E F0 .654(if you wish to use)3.154 F F2
+(xelate)3.153 E(x)-.2 E F0(to)3.153 E(mak)144 470.4 Q 2.5(ey)-.1 G
+(our pdf \214le\(s\).\))-2.5 E F1(-pdfdvi)108 487.2 Q F0(Generate pdf v)
+144 499.2 Q(ersion of document from the dvi \214le, by def)-.15 E
+(ault using dvipdf.)-.1 E F1(-pdfps)108 516 Q F0(Generate pdf v)8.77 E
+(ersion of document from the ps \214le, by def)-.15 E
+(ault using ps2pdf.)-.1 E F1(-pdf-)108 532.8 Q F0 -.45(Tu)14.89 G .556
+(rn of).45 F 3.056(fg)-.25 G .556(eneration of pdf v)-3.056 F .556
+(ersion of document.)-.15 F .556(\(This can be used to o)5.556 F -.15
+(ve)-.15 G .556(rride a setting in a con-).15 F(\214guration \214le.)144
+544.8 Q(It may get o)5 E -.15(ve)-.15 G(rridden if some other option re\
+quires the generation of a pdf \214le.\)).15 E F1(-pd\215atex="COMMAND")
+108 561.6 Q F0 .855
+(This sets the string specifying the command to run pd\215ate)144 573.6
+R .855(x, and is typically used to add desired)-.15 F 2.5
+(options. Since)144 585.6 R
+(the string normally contains spaces, it should be quoted, e.g.,)2.5 E
+(late)156.5 609.6 Q 2.5(x-)-.15 G(pdf -pd\215ate)-2.5 E(x="pd\215ate)
+-.15 E 2.5(x-)-.15 G(-shell-escape %O %S")-2.5 E(foo.te)5 E(x)-.15 E
+.442(The speci\214cation of the contents of the string are the same as \
+for the)144 633.6 R F2($pd\215ate)2.943 E(x)-.2 E F0 .443
+(con\214guration v)2.943 F(ari-)-.25 E 3.548(able. Depending)144 645.6 R
+1.047(on your operating system and the command-line shell you are using\
+, you may)3.548 F(need to change the single quotes to double quotes \(o\
+r something else\).)144 657.6 Q 1.683 -.8(To s)144 681.6 T .083
+(et the command for running late).8 F 2.584(x\()-.15 G .084
+(rather than the command for pd\215ate)-2.584 F .084(x\) see the)-.15 F
+F1(-latex)2.584 E F0(option.)2.584 E .002(Note that the ef)144 705.6 R
+.002(fect of this option can also be achie)-.25 F -.15(ve)-.25 G 2.502
+(db).15 G 2.502(yu)-2.502 G .002(sing the)-2.502 F F1(-e)2.502 E F0 .002
+(option with a suitable line of)2.502 F(Perl code to set the)144 717.6 Q
+F2($pd\215ate)2.5 E(x)-.2 E F0 -.25(va)2.5 G(riable. See the e).25 E
+(xplanation of the)-.15 E F1(-e)2.5 E F0(option.)2.5 E(11 No)267.545 768
+Q -.15(ve)-.15 G(mber 2012).15 E(7)190.545 E 0 Cg EP
+%%Page: 8 8
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF(-pdf)108 84 Q F0
-(Generate pdf v)18.22 E(ersion of document using pd\215ate)-.15 E(x.)
--.15 E F1(-pdfdvi)108 100.8 Q F0(Generate pdf v)144 112.8 Q
-(ersion of document from the dvi \214le, by def)-.15 E
-(ault using dvipdf.)-.1 E F1(-pdfps)108 129.6 Q F0(Generate pdf v)8.77 E
-(ersion of document from the ps \214le, by def)-.15 E
-(ault using ps2pdf.)-.1 E F1(-pdf-)108 146.4 Q F0 -.45(Tu)14.89 G .557
-(rn of).45 F 3.057(fg)-.25 G .556(eneration of pdf v)-3.057 F .556
-(ersion of document.)-.15 F .556(\(This can be used to o)5.556 F -.15
-(ve)-.15 G .556(rride a setting in a con-).15 F(\214guration \214le.)144
-158.4 Q(It may get o)5 E -.15(ve)-.15 G(rridden if some other option re\
-quires the generation of a pdf \214le.\)).15 E F1
-(-print=dvi, -print=ps, -print=pdf)108 175.2 Q F0 .844
-(De\214ne which kind of \214le is printed.)144 187.2 R .845
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF
+(-print=dvi, -print=ps, -print=pdf)108 84 Q F0 .844
+(De\214ne which kind of \214le is printed.)144 96 R .845
 (This option also ensures that the requisite \214le is made, and)5.845 F
-(turns on printing.)144 199.2 Q(The def)5 E
-(ault is to print a postscript \214le.)-.1 E F1(-ps)108 216 Q F0
+(turns on printing.)144 108 Q(The def)5 E
+(ault is to print a postscript \214le.)-.1 E F1(-ps)108 124.8 Q F0
 (Generate postscript v)23.22 E(ersion of document.)-.15 E F1(-ps-)108
-232.8 Q F0 -.45(Tu)19.89 G .474(rn of).45 F 2.974(fg)-.25 G .474
+141.6 Q F0 -.45(Tu)19.89 G .474(rn of).45 F 2.974(fg)-.25 G .474
 (eneration of postscript v)-2.974 F .474(ersion of document.)-.15 F .473
 (This can be used to o)5.474 F -.15(ve)-.15 G .473(rride a setting in a)
-.15 F .719(con\214guration \214le.)144 244.8 R .719(\(It may get o)5.719
+.15 F .719(con\214guration \214le.)144 153.6 R .719(\(It may get o)5.719
 F -.15(ve)-.15 G .719
 (rridden by some other option that requires a postscript \214le, for).15
-F -.15(ex)144 256.8 S(ample a request for printing.\)).15 E F1(-pF)108
-273.6 Q F0 .596(Postscript \214le \214ltering.)21 F .596(The ar)5.596 F
+F -.15(ex)144 165.6 S(ample a request for printing.\)).15 E F1(-pF)108
+182.4 Q F0 .596(Postscript \214le \214ltering.)21 F .596(The ar)5.596 F
 .596(gument to this option is a \214lter which will generate a \214lter\
-ed post-)-.18 F .358(script \214le with the e)144 285.6 R .358
+ed post-)-.18 F .358(script \214le with the e)144 194.4 R .358
 (xtension ".psF".)-.15 F .358(All e)5.358 F .358
 (xtra processing \(e.g. pre)-.15 F(vie)-.25 E 1.658 -.65(w, p)-.25 H
 .358(rinting\) will then be per).65 F(-)-.2 E
-(formed on this \214ltered postscript \214le.)144 297.6 Q
-(Example of usage: Use psnup to print tw)144 321.6 Q 2.5(op)-.1 G
-(ages on the one page:)-2.5 E(late)180 345.6 Q
-(xmk -ps -pF 'psnup -2' foo.te)-.15 E(x)-.15 E(or)144 369.6 Q(late)180
-393.6 Q(xmk -ps -pF "psnup -2" foo.te)-.15 E(x)-.15 E .332(Whether to u\
+(formed on this \214ltered postscript \214le.)144 206.4 Q
+(Example of usage: Use psnup to print tw)144 230.4 Q 2.5(op)-.1 G
+(ages on the one page:)-2.5 E(late)180 254.4 Q
+(xmk -ps -pF 'psnup -2' foo.te)-.15 E(x)-.15 E(or)144 278.4 Q(late)180
+302.4 Q(xmk -ps -pF "psnup -2" foo.te)-.15 E(x)-.15 E .332(Whether to u\
 se single or double quotes round the "psnup -2" will depend on your com\
-mand inter)144 417.6 R(-)-.2 E(preter)144 429.6 Q 2.5(,a)-.4 G 2.5(su)
+mand inter)144 326.4 R(-)-.2 E(preter)144 338.4 Q 2.5(,a)-.4 G 2.5(su)
 -2.5 G(sed by the particular v)-2.5 E
 (ersion of perl and the operating system on your computer)-.15 E(.)-.55
-E F1(-pv)108 446.4 Q F0 1.147(Run \214le pre)22.11 F(vie)-.25 E(wer)-.25
+E F1(-pv)108 355.2 Q F0 1.147(Run \214le pre)22.11 F(vie)-.25 E(wer)-.25
 E 6.147(.I)-.55 G 3.647(ft)-6.147 G(he)-3.647 E F1(-view)3.647 E F0
 1.147(option is used, this will select the kind of \214le to be pre)
-3.647 F(vie)-.25 E(wed)-.25 E .772(\(dvi, ps or pdf\).)144 458.4 R .771
+3.647 F(vie)-.25 E(wed)-.25 E .772(\(dvi, ps or pdf\).)144 367.2 R .771
 (Otherwise the vie)5.771 F .771(wer vie)-.25 F .771
 (ws the "highest" kind of \214le selected, by the)-.25 F F1(-dvi)3.271 E
-F0(,)A F1(-ps)3.271 E F0(,)A F1(-pdf)144 470.4 Q F0(,)A F1(-pdfps)3.035
+F0(,)A F1(-ps)3.271 E F0(,)A F1(-pdf)144 379.2 Q F0(,)A F1(-pdfps)3.035
 E F0 .535(options, in the order dvi, ps, pdf \(lo)3.035 F 3.035(wt)-.25
 G 3.035(oh)-3.035 G 3.035(igh\). If)-3.035 F .536
-(no \214le type has been selected, the)3.035 F .743(dvi pre)144 482.4 R
+(no \214le type has been selected, the)3.035 F .743(dvi pre)144 391.2 R
 (vie)-.25 E .743(wer will be used.)-.25 F .742
 (This option is incompatible with the)5.743 F F1(-p)3.242 E F0(and)3.242
-E F1(-pvc)3.242 E F0 .742(options, so it turns)3.242 F(them of)144 494.4
-Q(f.)-.25 E F1(-pv-)108 511.2 Q F0 -.45(Tu)18.78 G(rn of).45 E(f)-.25 E
-F1(-pv)2.5 E F0(.)A F1(-pvc)108 528 Q F0 .946(Run a \214le pre)17.67 F
+E F1(-pvc)3.242 E F0 .742(options, so it turns)3.242 F(them of)144 403.2
+Q(f.)-.25 E F1(-pv-)108 420 Q F0 -.45(Tu)18.78 G(rn of).45 E(f)-.25 E F1
+(-pv)2.5 E F0(.)A F1(-pvc)108 436.8 Q F0 .946(Run a \214le pre)17.67 F
 (vie)-.25 E .947
 (wer and continually update the .dvi, .ps, and/or .pdf \214les whene)
 -.25 F -.15(ve)-.25 G 3.447(rc).15 G .947(hanges are)-3.447 F .85
-(made to source \214les \(see the Description abo)144 540 R -.15(ve)-.15
-G 3.35(\). Which).15 F .85(of these \214les is generated and which is)
-3.35 F(vie)144 552 Q .451(wed is go)-.25 F -.15(ve)-.15 G .451
+(made to source \214les \(see the Description abo)144 448.8 R -.15(ve)
+-.15 G 3.35(\). Which).15 F .85
+(of these \214les is generated and which is)3.35 F(vie)144 460.8 Q .451
+(wed is go)-.25 F -.15(ve)-.15 G .451
 (rned by the other options, and is the same as for the).15 F F1(-pv)
 2.951 E F0 2.952(option. The)2.952 F(pre)2.952 E(vie)-.25 E(w-con-)-.25
-E .866(tinuous option)144 564 R F1(-pvc)3.366 E F0 .866(can only w)3.366
-F .866(ork with one \214le.)-.1 F .866
+E .866(tinuous option)144 472.8 R F1(-pvc)3.366 E F0 .866(can only w)
+3.366 F .866(ork with one \214le.)-.1 F .866
 (So in this case you will normally only specify)5.866 F .318
-(one \214lename on the command line.)144 576 R .318
+(one \214lename on the command line.)144 484.8 R .318
 (It is also incompatible with the)5.318 F F1(-p)2.818 E F0(and)2.819 E
 F1(-pv)2.819 E F0 .319(options, so it turns)2.819 F(these options of)144
-588 Q(f.)-.25 E(The)144 612 Q F1(-pvc)3.204 E F0 .704
+496.8 Q(f.)-.25 E(The)144 520.8 Q F1(-pvc)3.204 E F0 .704
 (option also turns of)3.204 F 3.204(ff)-.25 G .704(orce mode \()-3.204 F
 F1(-f)A F0 .704(\), as is normally best for continuous pre)B(vie)-.25 E
-3.203(wm)-.25 G(ode.)-3.203 E(If you really w)144 624 Q
+3.203(wm)-.25 G(ode.)-3.203 E(If you really w)144 532.8 Q
 (ant force mode, use the options in the order)-.1 E F1(-pvc -f)2.5 E F0
-(.)A -.4(Wi)144 648 S 1.148(th a good pre).4 F(vie)-.25 E 1.149
+(.)A -.4(Wi)144 556.8 S 1.148(th a good pre).4 F(vie)-.25 E 1.149
 (wer the display will be automatically updated.)-.25 F(\(Under)6.149 E
 /F2 10/Times-Italic@0 SF 1.149(some b)3.649 F 1.149(ut not all)-.2 F F0
--.15(ve)3.649 G -.2(r-).15 G .672(sions of UNIX/Linux "gv -w)144 660 R
+-.15(ve)3.649 G -.2(r-).15 G .672(sions of UNIX/Linux "gv -w)144 568.8 R
 .672(atch" does this for postscript \214les; this can be set by a con\
-\214guration)-.1 F -.25(va)144 672 S 3.006(riable. This).25 F -.1(wo)
+\214guration)-.1 F -.25(va)144 580.8 S 3.006(riable. This).25 F -.1(wo)
 3.006 G .506(uld also w).1 F .506(ork for pdf \214les e)-.1 F .506
 (xcept for an apparent b)-.15 F .506(ug in gv that causes an error)-.2 F
-(when the ne)144 684 Q(wly updated pdf \214le is read.\))-.25 E(Man)5 E
-2.5(yo)-.15 G(ther pre)-2.5 E(vie)-.25 E
-(wers will need a manual update.)-.25 E .969
-(Important note: the acroread program on MS-W)144 708 R(indo)-.4 E .968
-(ws locks the pdf \214le, and pre)-.25 F -.15(ve)-.25 G .968(nts ne).15
-F 3.468(wv)-.25 G(er)-3.618 E(-)-.2 E 1.413
-(sions being written, so it is a bad idea to use acroread to vie)144 720
-R 3.913(wp)-.25 G 1.413(df \214les in pre)-3.913 F(vie)-.25 E
-(w-continuous)-.25 E 2.5(7M)281.835 768 S(ay 2011)-2.5 E(6)204.835 E 0
-Cg EP
-%%Page: 7 7
+(when the ne)144 592.8 Q(wly updated pdf \214le is read.\))-.25 E(Man)5
+E 2.5(yo)-.15 G(ther pre)-2.5 E(vie)-.25 E
+(wers will need a manual update.)-.25 E F1 .533(Important note)144 616.8
+R F0 3.033(:t)C .532(he acroread program on MS-W)-3.033 F(indo)-.4 E
+.532(ws locks the pdf \214le, and pre)-.25 F -.15(ve)-.25 G .532(nts ne)
+.15 F 3.032(wv)-.25 G(er)-3.182 E(-)-.2 E 1.413
+(sions being written, so it is a bad idea to use acroread to vie)144
+628.8 R 3.913(wp)-.25 G 1.413(df \214les in pre)-3.913 F(vie)-.25 E
+(w-continuous)-.25 E 2.5(mode. It)144 640.8 R(is better to use a dif)2.5
+E(ferent vie)-.25 E(wer: SumatraPDF and gsvie)-.25 E 2.5(wa)-.25 G
+(re good possibilities.)-2.5 E .759(There are some other methods for ar\
+ranging an update, notably useful for man)144 664.8 R 3.258(yv)-.15 G
+.758(ersions of xdvi)-3.408 F(and xpdf.)144 676.8 Q
+(These are best set in)5 E F2(late)2.5 E(xmk)-.2 E F0 1.1 -.55('s c)D
+(on\214guration; see belo).55 E -.65(w.)-.25 G 1.14(Note that if)144
+700.8 R F2(late)3.64 E(xmk)-.2 E F0 1.14(dies or is stopped by the user)
+3.64 F 3.64(,t)-.4 G 1.14(he "fork)-3.64 F 1.14(ed" pre)-.1 F(vie)-.25 E
+1.14(wer will continue to run.)-.25 F(Successi)144 712.8 Q 1.396 -.15
+(ve i)-.25 H -1.9 -.4(nv o).15 H 1.096(cations with the).4 F F1(-pvc)
+3.596 E F0 1.096(option will not fork ne)3.596 F 3.596(wp)-.25 G(re)
+-3.596 E(vie)-.25 E 1.095(wers, b)-.25 F(ut)-.2 E F2(late)3.595 E(xmk)
+-.2 E F0 1.095(will nor)3.595 F(-)-.2 E 1.441(mally use the e)144 724.8
+R 1.441(xisting pre)-.15 F(vie)-.25 E(wer)-.25 E 6.441(.\()-.55 G 1.441
+(At least this will happen when)-6.441 F F2(late)3.942 E(xmk)-.2 E F0
+1.442(is running under an)3.942 F(11 No)267.545 768 Q -.15(ve)-.15 G
+(mber 2012).15 E(8)190.545 E 0 Cg EP
+%%Page: 9 9
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E 2.5(mode. It)144 84 R
-(is better to use a dvi or ps vie)2.5 E(wer)-.25 E 2.5(,a)-.4 G 2.5(ss)
--2.5 G(et by one of the)-2.5 E/F1 10/Times-Bold@0 SF(-view=dvi)2.5 E F0
-(and)2.5 E F1(-view=ps)2.5 E F0(options.)2.5 E .759(There are some othe\
-r methods for arranging an update, notably useful for man)144 108 R
-3.258(yv)-.15 G .758(ersions of xdvi)-3.408 F(and xpdf.)144 120 Q
-(These are best set in)5 E/F2 10/Times-Italic@0 SF(late)2.5 E(xmk)-.2 E
-F0 1.1 -.55('s c)D(on\214guration; see belo).55 E -.65(w.)-.25 G 1.14
-(Note that if)144 144 R F2(late)3.64 E(xmk)-.2 E F0 1.14
-(dies or is stopped by the user)3.64 F 3.64(,t)-.4 G 1.14(he "fork)-3.64
-F 1.14(ed" pre)-.1 F(vie)-.25 E 1.14(wer will continue to run.)-.25 F
-(Successi)144 156 Q 1.396 -.15(ve i)-.25 H -1.9 -.4(nv o).15 H 1.096
-(cations with the).4 F F1(-pvc)3.596 E F0 1.096(option will not fork ne)
-3.596 F 3.596(wp)-.25 G(re)-3.596 E(vie)-.25 E 1.095(wers, b)-.25 F(ut)
--.2 E F2(late)3.595 E(xmk)-.2 E F0 1.095(will nor)3.595 F(-)-.2 E 1.441
-(mally use the e)144 168 R 1.441(xisting pre)-.15 F(vie)-.25 E(wer)-.25
-E 6.441(.\()-.55 G 1.441(At least this will happen when)-6.441 F F2
-(late)3.942 E(xmk)-.2 E F0 1.442(is running under an)3.942 F
-(operating system where it kno)144 180 Q(ws ho)-.25 E 2.5(wt)-.25 G 2.5
-(od)-2.5 G(etermine whether an e)-2.5 E(xisting pre)-.15 E(vie)-.25 E
-(wer is running.\))-.25 E F1(-pvc-)108 196.8 Q F0 -.45(Tu)14.34 G(rn of)
-.45 E(f)-.25 E F1(-pvc)2.5 E F0(.)A F1(-quiet)108 213.6 Q F0
-(Same as -silent)11 E F1(-r <r)108 230.4 Q(c\214le>)-.18 E F0(Read the \
-speci\214ed initialization \214le \("RC \214le"\) before processing.)144
-242.4 Q .019(Be careful about the ordering: \(1\) Standard initializati\
-on \214les -- see the section belo)144 266.4 R 2.518(wo)-.25 G 2.518(n")
--2.518 G(Con\214gu-)-2.518 E 1.446
-(ration/initialization \(RC\) \214les" -- are read \214rst.)144 278.4 R
+(TEXMK\(1L\))-1.11 E(operating system where it kno)144 84 Q(ws ho)-.25 E
+2.5(wt)-.25 G 2.5(od)-2.5 G(etermine whether an e)-2.5 E(xisting pre)
+-.15 E(vie)-.25 E(wer is running.\))-.25 E/F1 10/Times-Bold@0 SF(-pvc-)
+108 100.8 Q F0 -.45(Tu)14.34 G(rn of).45 E(f)-.25 E F1(-pvc)2.5 E F0(.)A
+F1(-quiet)108 117.6 Q F0(Same as -silent)11 E F1(-r <r)108 134.4 Q
+(c\214le>)-.18 E F0(Read the speci\214ed initialization \214le \("RC \
+\214le"\) before processing.)144 146.4 Q .019(Be careful about the orde\
+ring: \(1\) Standard initialization \214les -- see the section belo)144
+170.4 R 2.518(wo)-.25 G 2.518(n")-2.518 G(Con\214gu-)-2.518 E 1.446
+(ration/initialization \(RC\) \214les" -- are read \214rst.)144 182.4 R
 1.446(\(2\) Then the options on the command line are)6.446 F .229
-(acted on in the order the)144 290.4 R 2.729(ya)-.15 G .229(re gi)-2.729
+(acted on in the order the)144 194.4 R 2.729(ya)-.15 G .229(re gi)-2.729
 F -.15(ve)-.25 G 2.729(n. Therefore).15 F .229
 (if an initialization \214le is speci\214ed by the)2.729 F F1(-r)2.728 E
-F0(option,)2.728 E .498(it is read during this second step.)144 302.4 R
+F0(option,)2.728 E .498(it is read during this second step.)144 206.4 R
 .499(Thus an initialization \214le speci\214ed with the)5.499 F F1(-r)
 2.999 E F0 .499(option can o)2.999 F -.15(ve)-.15 G -.2(r-).15 G .641
-(ride both the standard initialization \214les and)144 314.4 R F2(pr)
-3.141 E -.15(ev)-.37 G(iously).15 E F0 .641(speci\214ed options.)3.141 F
-.64(But all of these can be)5.641 F -.15(ove)144 326.4 S(rridden by).15
-E F2(later)2.5 E F0(options.)2.5 E .289
+(ride both the standard initialization \214les and)144 218.4 R/F2 10
+/Times-Italic@0 SF(pr)3.141 E -.15(ev)-.37 G(iously).15 E F0 .641
+(speci\214ed options.)3.141 F .64(But all of these can be)5.641 F -.15
+(ove)144 230.4 S(rridden by).15 E F2(later)2.5 E F0(options.)2.5 E .289
 (The contents of the RC \214le just comprise a piece of code in the)144
-350.4 R F2 -.8(Pe)2.789 G(rl).8 E F0 .289(programming language \(typi-)
-2.789 F .825(cally a sequence of assignment statements\); the)144 362.4
+254.4 R F2 -.8(Pe)2.789 G(rl).8 E F0 .289(programming language \(typi-)
+2.789 F .825(cally a sequence of assignment statements\); the)144 266.4
 R 3.324(ya)-.15 G .824(re e)-3.324 F -.15(xe)-.15 G .824(cuted when the)
 .15 F F1(-r)3.324 E F0 .824(option is encountered)3.324 F(during)144
-374.4 Q F2(late)3.05 E(xmk)-.2 E F0 1.65 -.55('s p)D .55
+278.4 Q F2(late)3.05 E(xmk)-.2 E F0 1.65 -.55('s p)D .55
 (arsing of its command line.).55 F .551(See the)5.551 F F1(-e)3.051 E F0
 .551(option for a w)3.051 F .551(ay of gi)-.1 F .551
-(ving initialization)-.25 F .005(code directly on)144 386.4 R F2(late)
+(ving initialization)-.25 F .005(code directly on)144 290.4 R F2(late)
 2.505 E(xmk)-.2 E F0 1.105 -.55('s c)D .005(ommand line.).55 F .005
 (An error results in)5.005 F F2(late)2.504 E(xmk)-.2 E F0 2.504
-(stopping. Multiple)2.504 F(instances)2.504 E .766(of the)144 398.4 R F1
+(stopping. Multiple)2.504 F(instances)2.504 E .766(of the)144 302.4 R F1
 (-r)3.266 E F0(and)3.266 E F1(-e)3.266 E F0 .766
 (options can be used, and the)3.266 F 3.266(ya)-.15 G .766(re e)-3.266 F
 -.15(xe)-.15 G .766(cuted in the order the).15 F 3.266(ya)-.15 G .766
-(ppear on the com-)-3.266 F(mand line.)144 410.4 Q F1(-r)108 427.2 Q
-(ecorder)-.18 E F0 1.128(Use the -recorder option with)144 439.2 R F2
+(ppear on the com-)-3.266 F(mand line.)144 314.4 Q F1(-r)108 331.2 Q
+(ecorder)-.18 E F0 1.128(Use the -recorder option with)144 343.2 R F2
 (late)3.628 E(x)-.2 E F0(and)3.628 E F2(pd\215ate)3.628 E(x)-.2 E F0
 6.128(.I)C 3.628(n\()-6.128 G 1.128(most\) modern v)-3.628 F 1.127
 (ersions of these programs,)-.15 F .285(this results in a \214le of e)
-144 451.2 R(xtension)-.15 E F2(.\215s)2.786 E F0 .286
+144 355.2 R(xtension)-.15 E F2(.\215s)2.786 E F0 .286
 (containing a list of the \214les that these programs ha)2.786 F .586
--.15(ve r)-.2 H .286(ead and).15 F(written.)144 463.2 Q F2(Late)5.479 E
+-.15(ve r)-.2 H .286(ead and).15 F(written.)144 367.2 Q F2(Late)5.479 E
 (xmk)-.2 E F0 .478(will then use this \214le to impro)2.979 F .778 -.15
 (ve i)-.15 H .478(ts detection of source \214les and generated \214les)
-.15 F(after a run of)144 475.2 Q F2(late)2.5 E(x)-.2 E F0(or)2.5 E F2
-(pd\215ate)2.5 E(x)-.2 E F0(.)A -.15(Fo)144 499.2 S 2.5(rf).15 G
+.15 F(after a run of)144 379.2 Q F2(late)2.5 E(x)-.2 E F0(or)2.5 E F2
+(pd\215ate)2.5 E(x)-.2 E F0(.)A -.15(Fo)144 403.2 S 2.5(rf).15 G
 (urther information, see the documentation for the)-2.5 E F2($r)2.5 E
 (ecor)-.37 E(der)-.37 E F0(con\214guration v)2.5 E(ariable.)-.25 E F1
-(-r)108 516 Q(ecorder)-.18 E(-)-.37 E F0
-(Do not use the -recorder option with)144 528 Q F2(late)2.5 E(x)-.2 E F0
-(and)2.5 E F2(pd\215ate)2.5 E(x)-.2 E F0(.)A F1(-rules)108 544.8 Q F0
+(-r)108 420 Q(ecorder)-.18 E(-)-.37 E F0
+(Do not use the -recorder option with)144 432 Q F2(late)2.5 E(x)-.2 E F0
+(and)2.5 E F2(pd\215ate)2.5 E(x)-.2 E F0(.)A F1(-rules)108 448.8 Q F0
 (Sho)11.56 E 2.5(wal)-.25 G(ist of)-2.5 E F2(latemk)2.5 E F0 1.1 -.55
 ('s r)D(ules and dependencies after processing.).55 E F1(-rules-)108
-561.6 Q F0(Do not sho)8.23 E 2.5(wal)-.25 G(ist of)-2.5 E F2(late)2.5 E
+465.6 Q F0(Do not sho)8.23 E 2.5(wal)-.25 G(ist of)-2.5 E F2(late)2.5 E
 (xmk)-.2 E F0 1.1 -.55('s r)D(ules and dependencies after processing.)
-.55 E(\(This is the def)5 E(ault.\))-.1 E F1(-silent)108 578.4 Q F0
-1.187(Run commands silently)9.89 F 3.687(,i)-.65 G 1.188
+.55 E(\(This is the def)5 E(ault.\))-.1 E F1(-sho)108 482.4 Q
+(wextraoptions)-.1 E F0(Sho)144 494.4 Q 2.698(wt)-.25 G .198
+(he list of e)-2.698 F(xtra)-.15 E F2(late)2.699 E(x)-.2 E F0(and)2.699
+E F2(pd\215ate)2.699 E(x)-.2 E F0 .199(options that)2.699 F F2(late)
+2.699 E(xmk)-.2 E F0 2.699(recognizes. These)2.699 F .199
+(are options for the)2.699 F F2(late)144 506.4 Q(x)-.2 E F0(and)2.743 E
+F2(pd\215ate)2.743 E(x)-.2 E F0(that)2.743 E F2(late)2.743 E(xmk)-.2 E
+F0 .243(recognizes, b)2.743 F .243
+(ut simply passes through to these programs when the)-.2 F(y)-.15 E .699
+(are run.)144 518.4 R .699
+(These options are \(currently\) a combination of those allo)5.699 F .7
+(wed by the T)-.25 F(eXLi)-.7 E 1 -.15(ve a)-.25 H .7(nd MiK-).15 F -.7
+(Te)144 530.4 S 2.799(Xi).7 G 2.799(mplementations. \(If)-2.799 F 2.798
+(ap)2.798 G .298(articular option is gi)-2.798 F -.15(ve)-.25 G 2.798
+(nt).15 G(o)-2.798 E F2(late)2.798 E(xmk)-.2 E F0 -.2(bu)2.798 G 2.798
+(ti).2 G 2.798(sn)-2.798 G .298(ot handled by the particu-)-2.798 F .306
+(lar implementation of)144 542.4 R F2(late)2.807 E(x)-.2 E F0(or)2.807 E
+F2(pd\215ate)2.807 E(x)-.2 E F0 .307
+(that is being used, that program will probably gi)2.807 F .607 -.15
+(ve a)-.25 H 2.807(ne).15 G(rror)-2.807 E 2.79(message.\) These)144
+554.4 R .29(options are v)2.79 F .29(ery numerous, b)-.15 F .29
+(ut are not listed in this documentation because the)-.2 F(y)-.15 E(ha)
+144 566.4 Q .3 -.15(ve n)-.2 H 2.5(oe).15 G -.25(ff)-2.5 G(ect on).25 E
+F2(late)2.5 E(xmk)-.2 E F0 1.1 -.55('s a)D(ctions.).55 E 1.201
+(There are a fe)144 590.4 R 3.701(wo)-.25 G 1.202(ptions \()-3.701 F F1
+(-includedir)A(ectory=dir)-.18 E F0(,)A F1(-initialize)3.702 E F0(,)A F1
+(-ini)3.702 E F0 3.702(\)t)C 1.202(hat are not recognized, either)-3.702
+F .392(because the)144 602.4 R 2.892(yd)-.15 G(on')-2.892 E 2.892<748c>
+-.18 G 2.892(tw)-2.892 G(ith)-2.892 E F2(late)2.892 E(xmk)-.2 E F0 1.492
+-.55('s i)D .391(ntended operations, or because the).55 F 2.891(yn)-.15
+G .391(eed special processing)-2.891 F(by)144 614.4 Q F2(late)2.5 E(xmk)
+-.2 E F0(that isn')2.5 E 2.5(ti)-.18 G
+(mplemented \(at least, not yet\).)-2.5 E .348
+(There are also options that are accepted by)144 638.4 R F2(late)2.848 E
+(x)-.2 E F0 .348(etc, b)2.848 F .348(ut instead trigger actions by)-.2 F
+F2(late)2.849 E(xmk)-.2 E F0(:)A F1(-help)2.849 E F0(,)A F1(-v)144 650.4
+Q(ersion)-.1 E F0(.)A(Finally)144 674.4 Q 2.746(,t)-.65 G .246
+(here are certain options for)-2.746 F F2(late)2.746 E(x)-.2 E F0(and)
+2.746 E F2(pd\215ate)2.746 E(x)-.2 E F0(\(e.g.,)2.746 E F1(-r)2.746 E
+(ecorder)-.18 E F0 2.745(\)t)C .245(hat trigger special actions)-2.745 F
+.381(or beha)144 686.4 R .381(vior by)-.2 F F2(late)2.881 E(xmk)-.2 E F0
+.382(itself as well as being passed in some form to the called)2.881 F
+F2(late)2.882 E(x)-.2 E F0(and)2.882 E F2(pd\215ate)2.882 E(x)-.2 E F0
+.63(program, or that af)144 698.4 R .63(fect other programs as well.)
+-.25 F .63(These options do ha)5.63 F .93 -.15(ve e)-.2 H .63
+(ntries in this documenta-).15 F 6.133(tion. These)144 710.4 R 3.633
+(options are:)6.133 F F1(-jobname=STRING)6.133 E F0(,)A F1(-aux-dir)
+6.134 E(ectory=dir)-.18 E F0(,)A F1(-output-dir)6.134 E(ectory=DIR)-.18
+E F0(,)A F1(-quiet)144 722.4 Q F0 2.5(,a)C(nd)-2.5 E F1(-r)2.5 E
+(ecorder)-.18 E F0(.)A(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15
+E(9)190.545 E 0 Cg EP
+%%Page: 10 10
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF(-silent)108 84 Q F0 1.188
+(Run commands silently)9.89 F 3.688(,i)-.65 G 1.188
 (.e., with options that reduce the amount of diagnostics generated.)
--3.687 F -.15(Fo)6.188 G(r).15 E -.15(ex)144 590.4 S
-(ample, with the def).15 E(ault settings, the command "late)-.1 E 2.5
-(x-)-.15 G(interaction=batchmode" is used for late)-2.5 E(x.)-.15 E
-(Also reduce the number of informational messages that)144 614.4 Q F2
-(late)2.5 E(xmk)-.2 E F0(generates.)2.5 E 2.935 -.8(To c)144 638.4 T
-1.335(hange the options used to mak).8 F 3.835(et)-.1 G 1.335
-(he commands run silently)-3.835 F 3.834(,y)-.65 G 1.334
-(ou need to con\214gure)-3.834 F F2(late)3.834 E(xmk)-.2 E F0 .849
-(with changed v)144 650.4 R .849(alues of its con\214guration v)-.25 F
+-3.688 F -.15(Fo)6.187 G(r).15 E -.15(ex)144 96 S(ample, with the def)
+.15 E(ault settings, the command "late)-.1 E 2.5(x-)-.15 G
+(interaction=batchmode" is used for late)-2.5 E(x.)-.15 E
+(Also reduce the number of informational messages that)144 120 Q/F2 10
+/Times-Italic@0 SF(late)2.5 E(xmk)-.2 E F0(generates.)2.5 E 2.934 -.8
+(To c)144 144 T 1.334(hange the options used to mak).8 F 3.835(et)-.1 G
+1.335(he commands run silently)-3.835 F 3.835(,y)-.65 G 1.335
+(ou need to con\214gure)-3.835 F F2(late)3.835 E(xmk)-.2 E F0 .85
+(with changed v)144 156 R .849(alues of its con\214guration v)-.25 F
 .849(ariables, the rele)-.25 F -.25(va)-.25 G .849(nt ones being).25 F
-F2($bibte)3.35 E(x_silent_switc)-.2 E(h)-.15 E F0(,)A F2
-($biber_silent_switc)144 662.4 Q(h)-.15 E F0(,)A F2($dvips_silent_switc)
-2.5 E(h)-.15 E F0(,)A F2($late)2.5 E(x_silent_switc)-.2 E(h)-.15 E F0
-2.5(,a)C(nd)-2.5 E F2($pd\215ate)2.5 E(x_silent_switc)-.2 E(h)-.15 E F0
-(.)A F1(-use-mak)108 679.2 Q(e)-.1 E F0 .47(When after a run of)144
-691.2 R F2(late)2.97 E(x)-.2 E F0(or)2.97 E F2(pd\215ate)2.97 E(x)-.2 E
-F0 2.969(,t)C .469(here are w)-2.969 F .469
+F2($bibte)3.349 E(x_silent_switc)-.2 E(h)-.15 E F0(,)A F2
+($biber_silent_switc)144 168 Q(h)-.15 E F0(,)A F2($dvipdf_silent_switc)
+3.527 E(h)-.15 E F0(,)A F2($dvips_silent_switc)3.527 E(h)-.15 E F0(,)A
+F2($late)3.528 E(x_silent_switc)-.2 E(h)-.15 E F0(,)A F2($mak)3.528 E
+(ein-)-.1 E(de)144 180 Q(x_silent_switc)-.2 E(h)-.15 E F0 2.5(,a)C(nd)
+-2.5 E F2($pd\215ate)2.5 E(x_silent_switc)-.2 E(h)-.15 E F0(.)A F1
+(-use-mak)108 196.8 Q(e)-.1 E F0 .47(When after a run of)144 208.8 R F2
+(late)2.97 E(x)-.2 E F0(or)2.97 E F2(pd\215ate)2.97 E(x)-.2 E F0 2.969
+(,t)C .469(here are w)-2.969 F .469
 (arnings about missing \214les \(e.g., as requested by)-.1 F .762
-(the LaT)144 703.2 R .762
+(the LaT)144 220.8 R .762
 (eX \\input, \\include, and \\includgraphics\),)-.7 F F2(late)3.262 E
 (xmk)-.2 E F0 .762(tries to mak)3.262 F 3.262(et)-.1 G .762
-(hem by a custom depen-)-3.262 F(denc)144 715.2 Q 1.841 -.65(y. I)-.15 H
+(hem by a custom depen-)-3.262 F(denc)144 232.8 Q 1.841 -.65(y. I)-.15 H
 3.041(fn).65 G 3.041(or)-3.041 G(ele)-3.041 E -.25(va)-.25 G .541
 (nt custom dependenc).25 F 3.041(yw)-.15 G .54
 (ith an appropriate source \214le is found, and if the -use-)-3.041 F
-(mak)144 727.2 Q 3.604(eo)-.1 G 1.104(ption is set, then)-3.604 F F2
+(mak)144 244.8 Q 3.604(eo)-.1 G 1.104(ption is set, then)-3.604 F F2
 (late)3.604 E(xmk)-.2 E F0 1.105(will try as a resort using the mak)
 3.605 F 3.605(ep)-.1 G 1.105(rogram to try to mak)-3.605 F 3.605(et)-.1
-G(he)-3.605 E 2.5(7M)281.835 768 S(ay 2011)-2.5 E(7)204.835 E 0 Cg EP
-%%Page: 8 8
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E(missing \214les.)144 84 Q .575
-(Note that the \214lename may be speci\214ed without an e)144 108 R .575
-(xtension, e.g., by \\include)-.15 F(graphics{dra)-.15 E(wing})-.15 E
-.228(in a LaT)144 120 R .228(eX \214le.)-.7 F .228(In that case,)5.228 F
-/F1 10/Times-Italic@0 SF(late)2.728 E(xmk)-.2 E F0 .228
-(will try making dra)2.728 F(wing.e)-.15 E .229(xt with e)-.15 F .229
-(xt set in turn to the possi-)-.15 F(ble e)144 132 Q
-(xtensions that are rele)-.15 E -.25(va)-.25 G(nt for).25 E F1(late)2.5
-E(x)-.2 E F0(\(or as appropriate)2.5 E F1(pd\215ate)2.5 E(x)-.2 E F0
-(\).)A(See also the documentation for the)144 156 Q F1($use_mak)2.5 E
-(e_for_missing_\214les)-.1 E F0(con\214guration v)2.5 E(ariable.)-.25 E
-/F2 10/Times-Bold@0 SF(-use-mak)108 172.8 Q(e-)-.1 E F0
-(Do not use the mak)144 184.8 Q 2.5(ep)-.1 G(rogram to try to mak)-2.5 E
-2.5(em)-.1 G(issing \214les.)-2.5 E(\(Def)5 E(ault.\))-.1 E F2(-v)108
-201.6 Q 2.5(,-)-.55 G -.1(ve)-2.5 G(rsion).1 E F0(Print v)144 213.6 Q
-(ersion number of)-.15 E F1(late)2.5 E(xmk)-.2 E F0(.)A F2(-v)108 230.4
-Q(erbose)-.1 E F0(Opposite of)144 242.4 Q F2(-silent)2.5 E F0 5(.T)C
-(his is the def)-5 E(ault setting.)-.1 E F2
-(-view=default, -view=dvi, -view=ps, -view=pdf)108 259.2 Q F0 1.105
-(Set the kind of \214le used when pre)144 271.2 R(vie)-.25 E 1.105
-(wing is requested \(e.g., by the)-.25 F F2(-pv)3.604 E F0(or)3.604 E F2
-(-pvc)3.604 E F0 3.604(switches\). The)3.604 F(def)144 283.2 Q
+G(he)-3.605 E(missing \214les.)144 256.8 Q .575
+(Note that the \214lename may be speci\214ed without an e)144 280.8 R
+.575(xtension, e.g., by \\include)-.15 F(graphics{dra)-.15 E(wing})-.15
+E .228(in a LaT)144 292.8 R .228(eX \214le.)-.7 F .228(In that case,)
+5.228 F F2(late)2.728 E(xmk)-.2 E F0 .228(will try making dra)2.728 F
+(wing.e)-.15 E .229(xt with e)-.15 F .229(xt set in turn to the possi-)
+-.15 F(ble e)144 304.8 Q(xtensions that are rele)-.15 E -.25(va)-.25 G
+(nt for).25 E F2(late)2.5 E(x)-.2 E F0(\(or as appropriate)2.5 E F2
+(pd\215ate)2.5 E(x)-.2 E F0(\).)A(See also the documentation for the)144
+328.8 Q F2($use_mak)2.5 E(e_for_missing_\214les)-.1 E F0
+(con\214guration v)2.5 E(ariable.)-.25 E F1(-use-mak)108 345.6 Q(e-)-.1
+E F0(Do not use the mak)144 357.6 Q 2.5(ep)-.1 G(rogram to try to mak)
+-2.5 E 2.5(em)-.1 G(issing \214les.)-2.5 E(\(Def)5 E(ault.\))-.1 E F1
+(-v)108 374.4 Q 2.5(,-)-.55 G -.1(ve)-2.5 G(rsion).1 E F0(Print v)144
+386.4 Q(ersion number of)-.15 E F2(late)2.5 E(xmk)-.2 E F0(.)A F1(-v)108
+403.2 Q(erbose)-.1 E F0(Opposite of)144 415.2 Q F1(-silent)2.5 E F0 5
+(.T)C(his is the def)-5 E(ault setting.)-.1 E F1
+(-view=default, -view=dvi, -view=ps, -view=pdf)108 432 Q F0 1.105
+(Set the kind of \214le used when pre)144 444 R(vie)-.25 E 1.105
+(wing is requested \(e.g., by the)-.25 F F1(-pv)3.604 E F0(or)3.604 E F1
+(-pvc)3.604 E F0 3.604(switches\). The)3.604 F(def)144 456 Q
 (ault is to vie)-.1 E 2.5(wt)-.25 G
 (he "highest" kind of requested \214le \(in the order dvi, ps, pdf\).)
--2.5 E .857(The pre)108 300 R(vie)-.25 E .857(w-continuous option)-.25 F
-F2(-pvc)3.357 E F0 .857(can only w)3.357 F .857(ork with one \214le.)-.1
-F .857(So in this case you will normally only)5.857 F
-(specify one \214lename on the command line.)108 312 Q(Options)108 328.8
-Q F2(-p)2.5 E F0(,)A F2(-pv)2.5 E F0(and)2.5 E F2(-pvc)2.5 E F0
+-2.5 E F1(-xelatex)108 472.8 Q F0 .924(Use x)144 484.8 R(elate)-.15 E
+3.424(x. That)-.15 F .924(is, use x)3.424 F(elate)-.15 E 3.424(xt)-.15 G
+3.424(op)-3.424 G .924
+(rocess the source \214le\(s\) to pdf \(in place of pd\215ate)-3.424 F
+3.425(x\). This)-.15 F(option is e)144 496.8 Q(xactly equi)-.15 E -.25
+(va)-.25 G(lent to specifying the follo).25 E(wing sequence of options:)
+-.25 E(-pd\215ate)156.5 520.8 Q(x="x)-.15 E(elate)-.15 E 2.5(x%)-.15 G
+2.5(O%)-2.5 G(S" -pdf -dvi- -ps)-2.5 E .858(The pre)108 549.6 R(vie)-.25
+E .857(w-continuous option)-.25 F F1(-pvc)3.357 E F0 .857(can only w)
+3.357 F .857(ork with one \214le.)-.1 F .857
+(So in this case you will normally only)5.857 F
+(specify one \214lename on the command line.)108 561.6 Q(Options)108
+578.4 Q F1(-p)2.5 E F0(,)A F1(-pv)2.5 E F0(and)2.5 E F1(-pvc)2.5 E F0
 (are mutually e)2.5 E(xclusi)-.15 E -.15(ve)-.25 G 5(.S).15 G 2.5(oe)-5
 G(ach of these options turns the others of)-2.5 E(f.)-.25 E/F3 10.95
-/Times-Bold@0 SF(EXAMPLES)72 357.6 Q F0(%)108 369.6 Q F2(latexmk thesis)
-2.5 E F1 2.5(#r)72.34 G(un late)-2.5 E 2.5(xe)-.2 G(nough times to r)
--2.5 E(esolve)-.37 E(cr)252 381.6 Q(oss-r)-.45 E(efer)-.37 E(ences)-.37
-E F0(%)108 405.6 Q F2(latexmk -pvc -ps thesis)2.5 E F1 2.5(#r)36.23 G
+/Times-Bold@0 SF(EXAMPLES)72 607.2 Q F0(%)108 619.2 Q F1(latexmk thesis)
+2.5 E F2 2.5(#r)72.34 G(un late)-2.5 E 2.5(xe)-.2 G(nough times to r)
+-2.5 E(esolve)-.37 E(cr)252 631.2 Q(oss-r)-.45 E(efer)-.37 E(ences)-.37
+E F0(%)108 655.2 Q F1(latexmk -pvc -ps thesis)2.5 E F2 2.5(#r)36.23 G
 (un late)-2.5 E 2.5(xe)-.2 G(nough times to r)-2.5 E(esolve)-.37 E(cr)
-252 417.6 Q(oss-r)-.45 E(efer)-.37 E(ences, mak)-.37 E 2.5(eap)-.1 G
-(ostscript)-2.5 E(\214le)252 429.6 Q 2.5(,s)-.1 G(tart a pr)-2.5 E -.15
-(ev)-.37 G(ie).15 E(wer)-.15 E 5(.T)-1.11 G(hen)-5 E(watc)252 441.6 Q
+252 667.2 Q(oss-r)-.45 E(efer)-.37 E(ences, mak)-.37 E 2.5(eap)-.1 G
+(ostscript)-2.5 E(\214le)252 679.2 Q 2.5(,s)-.1 G(tart a pr)-2.5 E -.15
+(ev)-.37 G(ie).15 E(wer)-.15 E 5(.T)-1.11 G(hen)-5 E(watc)252 691.2 Q
 2.5(hf)-.15 G(or c)-2.5 E(hang)-.15 E(es in the sour)-.1 E(ce)-.37 E
-(\214le thesis.te)252 453.6 Q 2.5(xa)-.2 G(nd any \214les it)-2.5 E 2.5
-(uses. After)252 465.6 R(any c)2.5 E(hang)-.15 E(es r)-.1 E(erun late)
--.37 E(x)-.2 E(the appr)252 477.6 Q(opriate number of times and)-.45 E
--.37(re)252 489.6 S(mak).37 E 2.5(et)-.1 G(he postscript \214le)-2.5 E 5
-(.I)-.15 G 2.5(fl)-5 G(ate)-2.5 E(x)-.2 E(encounter)252 501.6 Q 2.5(sa)
--.1 G 2.5(ne)-2.5 G(rr)-2.5 E(or)-.45 E 2.5(,l)-1.11 G(ate)-2.5 E
-(xmk will)-.2 E -.1(ke)252 513.6 S(ep running).1 E 2.5(,w)-.1 G(atc)-2.5
-E(hing for)-.15 E(sour)252 525.6 Q(ce \214le c)-.37 E(hang)-.15 E(es.)
--.1 E(%)108 549.6 Q F2(latexmk -c)2.5 E F1 2.5(#r)88.46 G(emo)-2.87 E
-(ve .aux, .lo)-.1 E .2 -.1(g, .)-.1 H(bbl, .blg).1 E 2.5(,.)-.1 G(dvi,)
--2.5 E(.pdf)252 561.6 Q 2.5(,.)-.1 G(ps & .bbl \214les)-2.5 E F3
-(CONFIGURA)72 602.4 Q(TION/INITIALIZA)-1.04 E(TION \(RC\) FILES)-1.04 E
-F1(Late)108 614.4 Q(xmk)-.2 E F0(can be customized using initialization\
- \214les, which are read at startup in the follo)2.5 E(wing order:)-.25
-E(1\) The system RC \214le, if it e)108 631.2 Q(xists.)-.15 E .627
-(On a UNIX system,)115.5 643.2 R F1(late)3.127 E(xmk)-.2 E F0 .627
-(searches for follo)3.127 F .627
-(wing places for its system RC \214le, in the follo)-.25 F .627
-(wing order)-.25 F(,)-.4 E(and reads the \214rst it \214nds:)108 655.2 Q
-("/opt/local/share/late)115.5 667.2 Q(xmk/Late)-.15 E(xMk",)-.15 E
-("/usr/local/share/late)115.5 679.2 Q(xmk/Late)-.15 E(xMk",)-.15 E
-("/usr/local/lib/late)115.5 691.2 Q(xmk/Late)-.15 E(xMk".)-.15 E
-(On a MS-WINDO)115.5 703.2 Q(WS system it looks for "C:\\late)-.35 E
-(xmk\\Late)-.15 E(xMk".)-.15 E(On a c)115.5 715.2 Q
-(ygwin system \(i.e., a MS-W)-.15 E(indo)-.4 E
-(ws system in which perl is)-.25 E(that of c)115.5 727.2 Q(ygwin\),)-.15
-E F1(late)2.5 E(xmk)-.2 E F0(reads for the \214rst it \214nds of)2.5 E
-2.5(7M)281.835 768 S(ay 2011)-2.5 E(8)204.835 E 0 Cg EP
-%%Page: 9 9
+(\214le thesis.te)252 703.2 Q 2.5(xa)-.2 G(nd any \214les it)-2.5 E 2.5
+(uses. After)252 715.2 R(any c)2.5 E(hang)-.15 E(es r)-.1 E(erun late)
+-.37 E(x)-.2 E(the appr)252 727.2 Q(opriate number of times and)-.45 E
+F0(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(10)185.545 E 0 Cg
+EP
+%%Page: 11 11
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E("/c)115.5 84 Q(ygdri)-.15 E -.15(ve)-.25 G(/c/late)
-.15 E(xmk/Late)-.15 E(xMk",)-.15 E("/opt/local/share/late)115.5 96 Q
-(xmk/Late)-.15 E(xMk",)-.15 E("/usr/local/share/late)115.5 108 Q
-(xmk/Late)-.15 E(xMk",)-.15 E("/usr/local/lib/late)115.5 120 Q(xmk/Late)
--.15 E(xMk".)-.15 E .038(2\) The user')108 136.8 R 2.538(sR)-.55 G 2.538
-<438c>-2.538 G .038(le, "$HOME/.late)-2.538 F .038(xmkrc", if it e)-.15
-F 2.538(xists. Here)-.15 F .038($HOME is the v)2.538 F .039
-(alue of the en)-.25 F .039(vironment v)-.4 F(ari-)-.25 E .046
-(able HOME.)108 148.8 R .046
-(On UNIX and clones \(including LINUX\), this v)5.046 F .045
-(ariable is set by the system; on MS-W)-.25 F(indo)-.4 E(ws,)-.25 E
-(the user may choose to set it.)108 160.8 Q .286
-(3\) The RC \214le in the current w)108 177.6 R .286(orking directory)
--.1 F 5.286(.T)-.65 G .286(his \214le can be named either "late)-5.286 F
-.286(xmkrc" or ".late)-.15 F(xmkrc",)-.15 E
-(and the \214rst of these to be found is used, if an)108 189.6 Q -.65
-(y.)-.15 G(4\) An)108 206.4 Q 2.5(yR)-.15 G 2.5<438c>-2.5 G
-(le\(s\) speci\214ed on the command line with the)-2.5 E/F1 10
-/Times-Bold@0 SF(-r)2.5 E F0(option.)2.5 E .132
-(Each RC \214le is a sequence of)108 223.2 R/F2 10/Times-Italic@0 SF -.8
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Italic@0 SF -.37(re)252 84 S(mak).37 E
+2.5(et)-.1 G(he postscript \214le)-2.5 E 5(.I)-.15 G 2.5(fl)-5 G(ate)
+-2.5 E(x)-.2 E(encounter)252 96 Q 2.5(sa)-.1 G 2.5(ne)-2.5 G(rr)-2.5 E
+(or)-.45 E 2.5(,l)-1.11 G(ate)-2.5 E(xmk will)-.2 E -.1(ke)252 108 S
+(ep running).1 E 2.5(,w)-.1 G(atc)-2.5 E(hing for)-.15 E(sour)252 120 Q
+(ce \214le c)-.37 E(hang)-.15 E(es.)-.1 E(%)108 144 Q/F2 10/Times-Bold@0
+SF(latexmk -c)2.5 E F1 2.5(#r)88.46 G(emo)-2.87 E(ve .aux, .lo)-.1 E .2
+-.1(g, .)-.1 H(bbl, .blg).1 E 2.5(,.)-.1 G(dvi,)-2.5 E(.pdf)252 156 Q
+2.5(,.)-.1 G(ps & .bbl \214les)-2.5 E/F3 10.95/Times-Bold@0 SF
+(CONFIGURA)72 196.8 Q(TION/INITIALIZA)-1.04 E(TION \(RC\) FILES)-1.04 E
+F1(Late)108 208.8 Q(xmk)-.2 E F0(can be customized using initialization\
+ \214les, which are read at startup in the follo)2.5 E(wing order:)-.25
+E(1\) The system RC \214le, if it e)108 225.6 Q(xists.)-.15 E .627
+(On a UNIX system,)115.5 237.6 R F1(late)3.127 E(xmk)-.2 E F0 .627
+(searches for follo)3.127 F .627
+(wing places for its system RC \214le, in the follo)-.25 F .628
+(wing order)-.25 F(,)-.4 E(and reads the \214rst it \214nds:)108 249.6 Q
+("/opt/local/share/late)115.5 261.6 Q(xmk/Late)-.15 E(xMk",)-.15 E
+("/usr/local/share/late)115.5 273.6 Q(xmk/Late)-.15 E(xMk",)-.15 E
+("/usr/local/lib/late)115.5 285.6 Q(xmk/Late)-.15 E(xMk".)-.15 E
+(On a MS-WINDO)115.5 297.6 Q(WS system it looks for "C:\\late)-.35 E
+(xmk\\Late)-.15 E(xMk".)-.15 E .627(On a c)115.5 309.6 R .626
+(ygwin system \(i.e., a MS-W)-.15 F(indo)-.4 E .626
+(ws system in which perl is that of c)-.25 F(ygwin\),)-.15 E F1(late)
+3.126 E(xmk)-.2 E F0 .626(reads for the)3.126 F(\214rst it \214nds of)
+108 321.6 Q("/c)115.5 333.6 Q(ygdri)-.15 E -.15(ve)-.25 G(/c/late).15 E
+(xmk/Late)-.15 E(xMk",)-.15 E("/opt/local/share/late)115.5 345.6 Q
+(xmk/Late)-.15 E(xMk",)-.15 E("/usr/local/share/late)115.5 357.6 Q
+(xmk/Late)-.15 E(xMk",)-.15 E("/usr/local/lib/late)115.5 369.6 Q
+(xmk/Late)-.15 E(xMk".)-.15 E 2.192(2\) The user')108 386.4 R 4.692(sR)
+-.55 G 4.692<438c>-4.692 G 2.192(le, "$HOME/.late)-4.692 F 2.193
+(xmkrc", if it e)-.15 F 4.693(xists. Here)-.15 F 2.193
+($HOME is the user')4.693 F 4.693(sh)-.55 G 2.193(ome directory)-4.693 F
+(.)-.65 E([)108 398.4 Q F1(Late)A(xmk)-.2 E F0 1.821
+(determines the user')4.321 F 4.321(sh)-.55 G 1.821
+(ome directory as follo)-4.321 F 4.321(ws: It)-.25 F 1.821(is the v)
+4.321 F 1.82(alue of the en)-.25 F 1.82(vironment v)-.4 F(ariable)-.25 E
+1.114(HOME, if this v)108 410.4 R 1.114(ariable e)-.25 F 1.115
+(xists, which normally is the case on UNIX-lik)-.15 F 3.615(es)-.1 G
+1.115(ystems \(including LINUX and)-3.615 F 2.55(OS-X\). Otherwise)108
+422.4 R .05(the en)2.55 F .05(vironment v)-.4 F .05(ariable USERPR)-.25
+F .049(OFILE is used, if it e)-.4 F .049
+(xists, which normally is the case)-.15 F(on MS-W)108 434.4 Q(indo)-.4 E
+(ws systems. Otherwise a blank string is used instead of $HOME.])-.25 E
+.286(3\) The RC \214le in the current w)108 451.2 R .286
+(orking directory)-.1 F 5.286(.T)-.65 G .286
+(his \214le can be named either "late)-5.286 F .286(xmkrc" or ".late)
+-.15 F(xmkrc",)-.15 E
+(and the \214rst of these to be found is used, if an)108 463.2 Q -.65
+(y.)-.15 G(4\) An)108 480 Q 2.5(yR)-.15 G 2.5<438c>-2.5 G
+(le\(s\) speci\214ed on the command line with the)-2.5 E F2(-r)2.5 E F0
+(option.)2.5 E .132(Each RC \214le is a sequence of)108 496.8 R F1 -.8
 (Pe)2.632 G(rl).8 E F0 2.632(commands. Naturally)2.632 F 2.632(,a)-.65 G
 .131(user can use this in creati)-.001 F .431 -.15(ve w)-.25 H 2.631
 (ays. But).05 F .131(for most)2.631 F .037
 (purposes, one simply uses a sequence of assignment statements that o)
-108 235.2 R -.15(ve)-.15 G .038(rride some of the b).15 F .038
-(uilt-in settings of)-.2 F F2(Late)108 247.2 Q(xmk)-.2 E F0 5.036(.S)C
+108 508.8 R -.15(ve)-.15 G .038(rride some of the b).15 F .038
+(uilt-in settings of)-.2 F F1(Late)108 520.8 Q(xmk)-.2 E F0 5.036(.S)C
 (traightforw)-5.036 E .036(ard cases can be handled without kno)-.1 F
-.035(wledge of the)-.25 F F2 -.8(Pe)2.535 G(rl).8 E F0 .035
+.035(wledge of the)-.25 F F1 -.8(Pe)2.535 G(rl).8 E F0 .035
 (language by using the e)2.535 F(xam-)-.15 E
-(ples in this document as templates.)108 259.2 Q
+(ples in this document as templates.)108 532.8 Q
 (Comment lines are introduced by the "#" character)5 E(.)-.55 E .555
-(Note that command line options are obe)108 283.2 R .556
+(Note that command line options are obe)108 556.8 R .556
 (yed in the order in which the)-.15 F 3.056(ya)-.15 G .556
 (re written; thus an)-3.056 F 3.056(yR)-.15 G 3.056<438c>-3.056 G .556
-(le speci-)-3.056 F .698(\214ed on the command line with the)108 295.2 R
-F1(-r)3.197 E F0 .697(option can o)3.197 F -.15(ve)-.15 G .697
+(le speci-)-3.056 F .698(\214ed on the command line with the)108 568.8 R
+F2(-r)3.197 E F0 .697(option can o)3.197 F -.15(ve)-.15 G .697
 (rride pre).15 F .697(vious options b)-.25 F .697(ut can be itself o)-.2
 F -.15(ve)-.15 G .697(rridden by).15 F .174
-(later options on the command line.)108 307.2 R .174(There is also the)
-5.174 F F1(-e)2.674 E F0 .174(option, which allo)2.674 F .174
-(ws initialization code to be speci-)-.25 F(\214ed in)108 319.2 Q F2
-(late)2.5 E(xmk)-.2 E F0 1.1 -.55('s c)D(ommand line.).55 E/F3 10.95
-/Times-Bold@0 SF(HO)72 348 Q 2.738(WT)-.548 G 2.738(OS)-2.935 G(ET V)
--2.738 E(ARIABLES IN INITIALIZA)-1.478 E(TION FILES)-1.04 E F0 .474
-(The important v)108 360 R .474(ariables that can be con\214gured are d\
-escribed in the section "List of con\214guration v)-.25 F(ariables)-.25
-E(usable in initialization \214les".)108 372 Q
-(Syntax for setting these v)5 E(ariables is of the follo)-.25 E
-(wing forms:)-.25 E($bibte)252 388.8 Q 2.5(x=')-.15 G(bibte)-2.5 E 2.5
+(later options on the command line.)108 580.8 R .174(There is also the)
+5.174 F F2(-e)2.674 E F0 .174(option, which allo)2.674 F .174
+(ws initialization code to be speci-)-.25 F(\214ed in)108 592.8 Q F1
+(late)2.5 E(xmk)-.2 E F0 1.1 -.55('s c)D(ommand line.).55 E F1 -1.05(Fo)
+111.724 616.8 S 3.724(rp)1.05 G 1.224(ossible e)-3.724 F 1.223
+(xamples of code for in an RC \214le)-.2 F 3.723(,s)-.1 G 1.223
+(ee the dir)-3.723 F 1.223(ectory e)-.37 F(xample_r)-.2 E 1.223
+(c\214les in the distrib)-.37 F 1.223(ution of)-.2 F(late)108 628.8 Q
+(xmk \(e)-.2 E(.g)-.15 E(., at http://ctan.tug)-.15 E(.or)-.15 E(g/te)
+-.37 E(x-ar)-.2 E -.15(ch)-.37 G(ive/support/late).15 E(xmk/e)-.2 E
+(xample_r)-.2 E(c\214les\).)-.37 E F3(HO)72 657.6 Q 2.738(WT)-.548 G
+2.738(OS)-2.935 G(ET V)-2.738 E(ARIABLES IN INITIALIZA)-1.478 E
+(TION FILES)-1.04 E F0 .474(The important v)108 669.6 R .474(ariables t\
+hat can be con\214gured are described in the section "List of con\214gu\
+ration v)-.25 F(ariables)-.25 E(usable in initialization \214les".)108
+681.6 Q(Syntax for setting these v)5 E(ariables is of the follo)-.25 E
+(wing forms:)-.25 E($bibte)252 698.4 Q 2.5(x=')-.15 G(bibte)-2.5 E 2.5
 (x%)-.15 G 2.5(O%)-2.5 G(B';)-2.5 E(for the setting of a string v)108
-405.6 Q(ariable,)-.25 E($pre)252 422.4 Q(vie)-.25 E(w_mode = 1;)-.25 E
-(for the setting of a numeric v)108 439.2 Q(ariable, and)-.25 E(@def)252
-456 Q(ault_\214les = \('paper', 'paper1'\);)-.1 E
-(for the setting of an array of strings.)108 472.8 Q
-(It is possible to append an item to an array v)5 E(ariable as follo)
--.25 E(ws:)-.25 E(push @def)252 496.8 Q(ault_\214les, 'paper2';)-.1 E
-.067(Note that simple "scalar" v)108 520.8 R .067(ariables ha)-.25 F
-.367 -.15(ve n)-.2 H .067(ames that be).15 F .067
-(gin with a $ character and array v)-.15 F .067(ariables ha)-.25 F .368
--.15(ve n)-.2 H(ames).15 E(that be)108 532.8 Q(gin with a @ character)
--.15 E 2.5(.E)-.55 G(ach statement ends with a semicolon.)-2.5 E .674
-(Strings should be enclosed in single quotes.)108 556.8 R(\(Y)5.674 E
-.674(ou could use double quotes, as in man)-1.1 F 3.173(yp)-.15 G .673
-(rogramming lan-)-3.173 F 2.725(guages. But)108 568.8 R .225(then the)
-2.725 F F2 -.8(Pe)2.725 G(rl).8 E F0 .225(programming language brings i\
-nto play some special rules for interpolating v)2.725 F(ari-)-.25 E
-(ables into strings.)108 580.8 Q(People not \215uent in)5 E F2 -.8(Pe)
-2.5 G(rl).8 E F0(will w)2.5 E(ant to a)-.1 E -.2(vo)-.2 G
-(id these complications.\)).2 E -1.1(Yo)108 604.8 S 2.888(uc)1.1 G .388
-(an do much more complicated things, b)-2.888 F .388
-(ut for this you will need to consult a manual for the)-.2 F F2 -.8(Pe)
-2.888 G(rl).8 E F0(pro-)2.888 E(gramming language.)108 616.8 Q F3(FORMA)
-72 669.6 Q 2.738(TO)-1.04 G 2.738(FC)-2.738 G(OMMAND SPECIFICA)-2.738 E
-(TIONS)-1.04 E F0 .046(Some of the v)108 681.6 R .046
-(ariables set the commands that)-.25 F F2(late)2.547 E(xmk)-.2 E F0 .047
-(uses for carrying out its w)2.547 F .047(ork, for e)-.1 F .047
-(xample to generate)-.15 F 2.83(ad)108 693.6 S .33(vi \214le from a te)
--2.83 F 2.83<788c>-.15 G .33(le or to vie)-2.83 F 2.83(wa)-.25 G .329
-(postscript \214le.)-.001 F .329
-(This section describes some important features of ho)5.329 F(w)-.25 E
-(the commands are speci\214ed.)108 705.6 Q F1(Placeholders)108 729.6 Q
-F0 6.854(:S)C 1.854(upposed you w)-6.854 F(anted)-.1 E F2(late)4.354 E
-(xmk)-.2 E F0 1.855(to use the command elate)4.354 F 4.355(xi)-.15 G
-4.355(np)-4.355 G 1.855(lace of the re)-4.355 F 1.855(gular late)-.15 F
-(x)-.15 E 2.5(7M)281.835 768 S(ay 2011)-2.5 E(9)204.835 E 0 Cg EP
-%%Page: 10 10
+715.2 Q(ariable,)-.25 E(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15
+E(11)185.545 E 0 Cg EP
+%%Page: 12 12
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E .449(command, and suppose moreo)108 84 R -.15(ve)
--.15 G 2.949(rt).15 G .449(hat you w)-2.949 F .449(anted to gi)-.1 F
-.749 -.15(ve i)-.25 H 2.949(tt).15 G .449(he option "--shell-escape".)
--2.949 F -1.1(Yo)5.448 G 2.948(uc)1.1 G .448(ould do this)-2.948 F
-(by the follo)108 96 Q(wing setting:)-.25 E($late)120.5 112.8 Q 2.5(x=')
--.15 G(elate)-2.5 E 2.5(x-)-.15 G(-shell-escape %O %S';)-2.5 E .626
-(The tw)108 129.6 R 3.126(oi)-.1 G .626
-(tems starting with the % character are placeholders.)-3.126 F .626
-(These are substituted by appropriate v)5.626 F(alues)-.25 E .403
-(before the command is run.)108 141.6 R .403
-(Thus %S will be replaced by the source \214le that elate)5.403 F 2.902
-(xw)-.15 G .402(ill be applied to, and)-2.902 F .682
-(%O will be replaced by an)108 153.6 R 3.182(yo)-.15 G .682(ptions that)
--3.182 F/F1 10/Times-Italic@0 SF(late)3.183 E(xmk)-.2 E F0 .683
-(has decided to use for this command.)3.183 F .683(\(E.g., if you used)
-5.683 F(the -silent option it w)108 165.6 Q
-(ould replace %O by "-interaction=batchmode".\))-.1 E(The a)108 189.6 Q
--.25(va)-.2 G(ilable placeholders are:).25 E/F2 10/Times-Bold@0 SF(%B)
-108 206.4 Q F0 .793(base of \214lename for current command.)19.33 F .792
+(TEXMK\(1L\))-1.11 E($pre)252 84 Q(vie)-.25 E(w_mode = 1;)-.25 E
+(for the setting of a numeric v)108 100.8 Q(ariable, and)-.25 E(@def)252
+117.6 Q(ault_\214les = \('paper', 'paper1'\);)-.1 E
+(for the setting of an array of strings.)108 134.4 Q
+(It is possible to append an item to an array v)5 E(ariable as follo)
+-.25 E(ws:)-.25 E(push @def)252 158.4 Q(ault_\214les, 'paper2';)-.1 E
+.067(Note that simple "scalar" v)108 182.4 R .067(ariables ha)-.25 F
+.367 -.15(ve n)-.2 H .067(ames that be).15 F .067
+(gin with a $ character and array v)-.15 F .067(ariables ha)-.25 F .367
+-.15(ve n)-.2 H(ames).15 E(that be)108 194.4 Q(gin with a @ character)
+-.15 E 2.5(.E)-.55 G(ach statement ends with a semicolon.)-2.5 E .673
+(Strings should be enclosed in single quotes.)108 218.4 R(\(Y)5.674 E
+.674(ou could use double quotes, as in man)-1.1 F 3.174(yp)-.15 G .674
+(rogramming lan-)-3.174 F 2.726(guages. But)108 230.4 R .226(then the)
+2.726 F/F1 10/Times-Italic@0 SF -.8(Pe)2.726 G(rl).8 E F0 .225(programm\
+ing language brings into play some special rules for interpolating v)
+2.726 F(ari-)-.25 E(ables into strings.)108 242.4 Q
+(People not \215uent in)5 E F1 -.8(Pe)2.5 G(rl).8 E F0(will w)2.5 E
+(ant to a)-.1 E -.2(vo)-.2 G(id these complications.\)).2 E -1.1(Yo)108
+266.4 S 2.888(uc)1.1 G .388(an do much more complicated things, b)-2.888
+F .388(ut for this you will need to consult a manual for the)-.2 F F1
+-.8(Pe)2.888 G(rl).8 E F0(pro-)2.888 E(gramming language.)108 278.4 Q/F2
+10.95/Times-Bold@0 SF(FORMA)72 331.2 Q 2.738(TO)-1.04 G 2.738(FC)-2.738
+G(OMMAND SPECIFICA)-2.738 E(TIONS)-1.04 E F0 .047(Some of the v)108
+343.2 R .047(ariables set the commands that)-.25 F F1(late)2.547 E(xmk)
+-.2 E F0 .047(uses for carrying out its w)2.547 F .046(ork, for e)-.1 F
+.046(xample to generate)-.15 F 2.829(ad)108 355.2 S .329
+(vi \214le from a te)-2.829 F 2.829<788c>-.15 G .329(le or to vie)-2.829
+F -5.328 2.829(wa p)-.25 H .33(ostscript \214le.)-2.829 F .33
+(This section describes some important features of ho)5.33 F(w)-.25 E
+(the commands are speci\214ed.)108 367.2 Q/F3 10/Times-Bold@0 SF
+(Placeholders)108 391.2 Q F0 5.299(:S)C .299(upposed you w)-5.299 F
+(anted)-.1 E F1(late)2.798 E(xmk)-.2 E F0 .298(to use the command elate)
+2.798 F 2.798(xi)-.15 G 2.798(np)-2.798 G .298(lace of the re)-2.798 F
+.298(gular late)-.15 F 2.798(xc)-.15 G(om-)-2.798 E .7
+(mand, and suppose moreo)108 403.2 R -.15(ve)-.15 G 3.2(rt).15 G .7
+(hat you w)-3.2 F .7(anted to gi)-.1 F 1 -.15(ve i)-.25 H 3.2(tt).15 G
+.7(he option "--shell-escape".)-3.2 F -1.1(Yo)5.7 G 3.2(uc)1.1 G .7
+(ould do this by)-3.2 F(the follo)108 415.2 Q(wing setting:)-.25 E
+($late)120.5 432 Q 2.5(x=')-.15 G(elate)-2.5 E 2.5(x-)-.15 G
+(-shell-escape %O %S';)-2.5 E .626(The tw)108 448.8 R 3.126(oi)-.1 G
+.626(tems starting with the % character are placeholders.)-3.126 F .626
+(These are substituted by appropriate v)5.626 F(alues)-.25 E .402
+(before the command is run.)108 460.8 R .402
+(Thus %S will be replaced by the source \214le that elate)5.402 F 2.903
+(xw)-.15 G .403(ill be applied to, and)-2.903 F .683
+(%O will be replaced by an)108 472.8 R 3.183(yo)-.15 G .683(ptions that)
+-3.183 F F1(late)3.183 E(xmk)-.2 E F0 .683
+(has decided to use for this command.)3.183 F .682(\(E.g., if you used)
+5.682 F(the -silent option it w)108 484.8 Q
+(ould replace %O by "-interaction=batchmode".\))-.1 E(The a)108 508.8 Q
+-.25(va)-.2 G(ilable placeholders are:).25 E F3(%B)108 525.6 Q F0 .792
+(base of \214lename for current command.)19.33 F .793
 (E.g., if a postscript \214le document.ps is being made from)5.793 F
-(the dvi \214le document.dvi, then the basename is document.)144 218.4 Q
-F2(%D)108 235.2 Q F0
+(the dvi \214le document.dvi, then the basename is document.)144 537.6 Q
+F3(%D)108 554.4 Q F0
 (destination \214le \(e.g., the name of the postscript \214le when con)
-18.78 E -.15(ve)-.4 G(rting a dvi \214le to postscript\).).15 E F2(%O)
-108 252 Q F0(options)18.22 E F2(%R)108 268.8 Q F0(root \214lename.)18.78
+18.78 E -.15(ve)-.4 G(rting a dvi \214le to postscript\).).15 E F3(%O)
+108 571.2 Q F0(options)18.22 E F3(%R)108 588 Q F0(root \214lename.)18.78
 E(This is the base name for the main te)5 E 2.5<788c>-.15 G(le.)-2.5 E
-F2(%S)108 285.6 Q F0
+F3(%S)108 604.8 Q F0
 (source \214le \(e.g., the name of the dvi \214le when con)20.44 E -.15
-(ve)-.4 G(rting a dvi \214le to ps\).).15 E F2(%T)108 302.4 Q F0
-(The name of the primary te)19.33 E 2.5<788c>-.15 G(le.)-2.5 E .349(If \
-for some reason you need a literal % character in your string not subje\
-ct to the abo)108 319.2 R .649 -.15(ve r)-.15 H .349
-(ules, use a pair of).15 F 1.01(these characters.)108 331.2 R 1.009
+(ve)-.4 G(rting a dvi \214le to ps\).).15 E F3(%T)108 621.6 Q F0
+(The name of the primary te)19.33 E 2.5<788c>-.15 G(le.)-2.5 E F3(%Y)108
+638.4 Q F0 .337(Name of directory for auxiliary output \214les \(see th\
+e con\214guration v)18.78 F(ariable)-.25 E F1($aux_dir)2.837 E F0 2.837
+(\). A)B(directory)2.836 E .08
+(separation character \('/'\) is appended if)144 650.4 R F1($aux_dir)
+2.58 E F0 .081(is non-empty and does not end in a suitable char)2.581 F
+(-)-.2 E(acter)144 662.4 Q 2.891(,w)-.4 G .391
+(ith suitable characters being those appropriate to UNIX and MS-W)-2.891
+F(indo)-.4 E .39(ws, i.e., ':', '/' and)-.25 F('\\'.)144 674.4 Q F3(%Z)
+108 691.2 Q F0 .038
+(Name of directory for output \214les \(see the con\214guration v)19.33
+F(ariable)-.25 E F1($out_dir)2.538 E F0 2.538(\). A)B .038
+(directory separation)2.538 F .492(character \('/'\) is appended if)144
+703.2 R F1($out_dir)2.992 E F0 .492
+(is non-empty and does not end in a suitable character)2.992 F 2.991(,w)
+-.4 G(ith)-2.991 E
+(suitable characters being those appropriate to UNIX and MS-W)144 715.2
+Q(indo)-.4 E(ws, i.e., ':', '/' and '\\'.)-.25 E(11 No)267.545 768 Q
+-.15(ve)-.15 G(mber 2012).15 E(12)185.545 E 0 Cg EP
+%%Page: 13 13
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E .349(If for some reason you need a literal % chara\
+cter in your string not subject to the abo)108 84 R .649 -.15(ve r)-.15
+H .349(ules, use a pair of).15 F 1.01(these characters.)108 96 R 1.009
 (Thus with the command speci\214cation $ps_pre)6.01 F(vie)-.25 E 1.009
 (wer = ')-.25 F(late)-.1 E 3.509(x-)-.15 G 1.009
 (ad=%%S\214le.ad %S', the)-3.509 F .204
-(%%S will become %S when the command is e)108 343.2 R -.15(xe)-.15 G
-.204(cuted, b).15 F .205
+(%%S will become %S when the command is e)108 108 R -.15(xe)-.15 G .204
+(cuted, b).15 F .205
 (ut the %S will be replaced by the source \214lename,)-.2 F
-(which in this case w)108 355.2 Q
+(which in this case w)108 120 Q
 (ould be the name of a postscript \214le to be vie)-.1 E(wed.)-.25 E
 .099(Appropriate quoting will be applied to the \214lename substitution\
-s, so you mustn')108 372 R 2.598(ts)-.18 G .098(upply them yourself e)
--2.598 F -.15(ve)-.25 G(n).15 E .15(if you the names of your ha)108 384
-R .45 -.15(ve s)-.2 H .15(paces in them.).15 F .15(\(But if your T)5.15
-F .15(eX \214lenames ha)-.7 F .45 -.15(ve s)-.2 H .15(paces in them, be)
-.15 F -.1(wa)-.25 G .15(re that).1 F(man)108 396 Q 2.653(yv)-.15 G .152
-(ersions of the T)-2.803 F .152
+s, so you mustn')108 136.8 R 2.598(ts)-.18 G .098(upply them yourself e)
+-2.598 F -.15(ve)-.25 G(n).15 E .066(if the names of your \214les ha)108
+148.8 R .366 -.15(ve s)-.2 H .066(paces in them.).15 F .067
+(\(But if your T)5.066 F .067(eX \214lenames ha)-.7 F .367 -.15(ve s)-.2
+H .067(paces in them, be).15 F -.1(wa)-.25 G .067(re that).1 F(man)108
+160.8 Q 2.653(yv)-.15 G .152(ersions of the T)-2.803 F .152
 (eX program cannot correctly handle \214lenames containing spaces.\))-.7
 F .152(In case late)5.152 F(xmk')-.15 E(s)-.55 E .666
-(quoting does not w)108 408 R .667
+(quoting does not w)108 172.8 R .667
 (ork correctly on your system, you can turn it of)-.1 F 3.167(f-)-.25 G
 3.167(-s)-3.167 G .667(ee the documentation for the v)-3.167 F(ari-)-.25
-E(able)108 420 Q F1($quote_\214lenames)2.5 E F0(.)A .195
+E(able)108 184.8 Q/F1 10/Times-Italic@0 SF($quote_\214lenames)2.5 E F0
+(.)A .195
 (The distinction between %B and %R needs a bit of care, since the)108
-436.8 R 2.694(ya)-.15 G .194(re often the same, b)-2.694 F .194
+201.6 R 2.694(ya)-.15 G .194(re often the same, b)-2.694 F .194
 (ut not al)-.2 F -.1(wa)-.1 G 2.694(ys. F).1 F(or)-.15 E -.15(ex)108
-448.8 S .437(ample on a simple document, the basename of a bibte).15 F
+213.6 S .437(ample on a simple document, the basename of a bibte).15 F
 2.937(xr)-.15 G .437(un is the same as for the te)-2.937 F 2.937
 (x\214le. But)-.15 F .438(in a docu-)2.938 F 2.031(ment with se)108
-460.8 R -.15(ve)-.25 G 2.031(ral bibliographies, the bibliograph).15 F
+225.6 R -.15(ve)-.25 G 2.031(ral bibliographies, the bibliograph).15 F
 4.531<798c>-.05 G 2.031(les will ha)-4.531 F 2.331 -.15(ve a v)-.2 H
 2.03(ariety of names.)-.1 F 2.03(Since bibte)7.03 F 4.53(xi)-.15 G(s)
--4.53 E(in)108 472.8 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G
+-4.53 E(in)108 237.6 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G
 (ith the basename of the bibliograph)-2.5 E 2.5<798c>-.05 G
 (le, the setting for the bibte)-2.5 E 2.5(xc)-.15 G
-(ommand should therefore be)-2.5 E($bibte)120.5 489.6 Q 2.5(x=')-.15 G
-(bibte)-2.5 E 2.5(x%)-.15 G 2.5(O%)-2.5 G(B';)-2.5 E(Generally)108 506.4
+(ommand should therefore be)-2.5 E($bibte)120.5 254.4 Q 2.5(x=')-.15 G
+(bibte)-2.5 E 2.5(x%)-.15 G 2.5(O%)-2.5 G(B';)-2.5 E(Generally)108 271.2
 Q 3.132(,y)-.65 G .633(ou should use %B rather than %R.)-3.132 F .633
 (Similarly for most purposes, the name %T of the primary)5.633 F(te)108
-518.4 Q(x\214le is not a useful placeholder)-.15 E(.)-.55 E .117
-(See the def)108 542.4 R .117(ault v)-.1 F .117
+283.2 Q(x\214le is not a useful placeholder)-.15 E(.)-.55 E .117
+(See the def)108 307.2 R .117(ault v)-.1 F .117
 (alues in the section "List of con\214guration v)-.25 F .116
 (ariables usable in initialization \214les" for what is)-.25 F
-(normally the most appropriate usage.)108 554.4 Q 1.13
-(If you omit to supply an)108 578.4 R 3.63(yp)-.15 G 1.13
+(normally the most appropriate usage.)108 319.2 Q 1.13
+(If you omit to supply an)108 343.2 R 3.63(yp)-.15 G 1.13
 (laceholders whate)-3.63 F -.15(ve)-.25 G 3.63(ri).15 G 3.63(nt)-3.63 G
 1.13(he speci\214cation of a command,)-3.63 F F1(late)3.63 E(xmk)-.2 E
 F0 1.13(will supply)3.63 F .636
-(what its author thinks are appropriate def)108 590.4 R 3.136
+(what its author thinks are appropriate def)108 355.2 R 3.136
 (aults. This)-.1 F(gi)3.136 E -.15(ve)-.25 G 3.136(sc).15 G .635
 (ompatibility with con\214guration \214les for pre)-3.136 F(vi-)-.25 E
-(ous v)108 602.4 Q(ersions of)-.15 E F1(late)2.5 E(xmk)-.2 E F0 2.5(,w)C
-(hich didn')-2.5 E 2.5(tu)-.18 G(se placeholders.)-2.5 E F2 .893
-("Detaching" a command)108 626.4 R F0 3.393(:N)C .893(ormally when)
--3.393 F F1(late)3.394 E(xmk)-.2 E F0 .894(runs a command, it w)3.394 F
-.894(aits for the command to run to)-.1 F 4.09(completion. This)108
-638.4 R 1.59(is appropriate for commands lik)4.09 F 4.09(el)-.1 G(ate)
--4.09 E 1.59(x, of course.)-.15 F 1.59(But for pre)6.59 F(vie)-.25 E
-1.59(wers, the command)-.25 F .694
-(should normally run detached, so that)108 650.4 R F1(late)3.194 E(xmk)
+(ous v)108 367.2 Q(ersions of)-.15 E F1(late)2.5 E(xmk)-.2 E F0 2.5(,w)C
+(hich didn')-2.5 E 2.5(tu)-.18 G(se placeholders.)-2.5 E/F2 10
+/Times-Bold@0 SF .893("Detaching" a command)108 391.2 R F0 3.393(:N)C
+.893(ormally when)-3.393 F F1(late)3.394 E(xmk)-.2 E F0 .894
+(runs a command, it w)3.394 F .894(aits for the command to run to)-.1 F
+4.09(completion. This)108 403.2 R 1.59(is appropriate for commands lik)
+4.09 F 4.09(el)-.1 G(ate)-4.09 E 1.59(x, of course.)-.15 F 1.59
+(But for pre)6.59 F(vie)-.25 E 1.59(wers, the command)-.25 F .694
+(should normally run detached, so that)108 415.2 R F1(late)3.194 E(xmk)
 -.2 E F0 .694(gets the pre)3.194 F(vie)-.25 E .694
 (wer running and then returns to its ne)-.25 F .695(xt task)-.15 F .143
-(\(or e)108 662.4 R .143(xits if there is nothing else to do\).)-.15 F
+(\(or e)108 427.2 R .143(xits if there is nothing else to do\).)-.15 F
 1.743 -.8(To a)5.143 H(chie).8 E .443 -.15(ve t)-.25 H .143(his ef).15 F
 .143(fect of detaching a command, you need to precede)-.25 F
-(the command name with "start ", as in)108 674.4 Q($dvi_pre)120.5 691.2
-Q(vie)-.25 E(wer = ')-.25 E(start xdvi %O %S';)-.55 E
-(This will be translated to whate)108 708 Q -.15(ve)-.25 G 2.5(ri).15 G
-2.5(sa)-2.5 G(ppropriate for your operating system.)-2.5 E 2.5(7M)
-281.835 768 S(ay 2011)-2.5 E(10)199.835 E 0 Cg EP
-%%Page: 11 11
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E .802(Notes: \(1\) In some circumstances,)108 84 R
-/F1 10/Times-Italic@0 SF(late)3.302 E(x)-.2 E F0 .802(will al)3.302 F
--.1(wa)-.1 G .802(ys run a command detached.).1 F .803
-(This is the case for a pre-)5.802 F(vie)108 96 Q 1.331(wer in pre)-.25
-F(vie)-.25 E 3.831(wc)-.25 G 1.331(ontinuous mode, since otherwise pre)
--3.831 F(vie)-.25 E 1.331(wing continuously mak)-.25 F 1.331
-(es no sense.)-.1 F 1.33(\(2\) This)6.33 F .244
-(precludes the possibility of running a command named start.)108 108 R
-.245(\(3\) If the w)5.244 F .245(ord start occurs more than once at)-.1
-F .62(the be)108 120 R .62(ginning of the command string, that is equi)
--.15 F -.25(va)-.25 G .62(lent to ha).25 F .62(ving just one.)-.2 F .62
-(\(4\) Under c)5.62 F .62(ygwin, some com-)-.15 F .99
-(plications happen, since c)108 132 R .991
+(the command name with "start ", as in)108 439.2 Q($dvi_pre)120.5 456 Q
+(vie)-.25 E(wer = ')-.25 E(start xdvi %O %S';)-.55 E
+(This will be translated to whate)108 472.8 Q -.15(ve)-.25 G 2.5(ri).15
+G 2.5(sa)-2.5 G(ppropriate for your operating system.)-2.5 E .802
+(Notes: \(1\) In some circumstances,)108 496.8 R F1(late)3.302 E(x)-.2 E
+F0 .802(will al)3.302 F -.1(wa)-.1 G .802(ys run a command detached.).1
+F .803(This is the case for a pre-)5.802 F(vie)108 508.8 Q 1.331
+(wer in pre)-.25 F(vie)-.25 E 3.831(wc)-.25 G 1.331
+(ontinuous mode, since otherwise pre)-3.831 F(vie)-.25 E 1.331
+(wing continuously mak)-.25 F 1.331(es no sense.)-.1 F 1.33(\(2\) This)
+6.33 F .244(precludes the possibility of running a command named start.)
+108 520.8 R .245(\(3\) If the w)5.244 F .245
+(ord start occurs more than once at)-.1 F .62(the be)108 532.8 R .62
+(ginning of the command string, that is equi)-.15 F -.25(va)-.25 G .62
+(lent to ha).25 F .62(ving just one.)-.2 F .62(\(4\) Under c)5.62 F .62
+(ygwin, some com-)-.15 F .99(plications happen, since c)108 544.8 R .991
 (ygwin amounts to a complicated mer)-.15 F .991(ging of UNIX and MS-W)
 -.18 F(indo)-.4 E 3.491(ws. See)-.25 F(the)3.491 E(source code for ho)
-108 144 Q 2.5(wI)-.25 G -1.65 -.5('v e)-2.5 H(handled the problem.)3 E
-/F2 10/Times-Bold@0 SF 1.5(Command names containing spaces)108 168 R F0
-4(:U)C 1.5(nder MS-W)-4 F(indo)-.4 E 1.5
+108 556.8 Q 2.5(wI)-.25 G -1.65 -.5('v e)-2.5 H(handled the problem.)3 E
+F2 1.5(Command names containing spaces)108 580.8 R F0 4(:U)C 1.5
+(nder MS-W)-4 F(indo)-.4 E 1.5
 (ws it is common that the name of a command)-.25 F .701
-(includes spaces, since softw)108 180 R .701
+(includes spaces, since softw)108 592.8 R .701
 (are is often installed in a subdirectory of "C:\\Program Files".)-.1 F
 .702(Such command)5.702 F
-(names should be enclosed in double quotes, as in)108 192 Q
-($lpr_pdf = '"c:/Program Files/Ghostgum/gsvie)120.5 208.8 Q(w/gsvie)-.25
-E(w32.e)-.25 E -.15(xe)-.15 G 2.5("/).15 G 2.5(p%)-2.5 G(S';)-2.5 E .184
-(\(Note about the abo)108 225.6 R .484 -.15(ve ex)-.15 H .184(ample: F)
+(names should be enclosed in double quotes, as in)108 604.8 Q
+($lpr_pdf = '"c:/Program Files/Ghostgum/gsvie)120.5 621.6 Q(w/gsvie)-.25
+E(w32.e)-.25 E -.15(xe)-.15 G 2.5("/).15 G 2.5(p%)-2.5 G(S';)-2.5 E
+($pdf_pre)120.5 633.6 Q(vie)-.25 E(wer = ')-.25 E
+(start "c:/Program Files/SumatraPDF/SumatraPDF)-.55 E(.e)-.8 E -.15(xe)
+-.15 G 2.5("%).15 G 2.5(O%)-2.5 G(S';)-2.5 E($pdf_pre)120.5 645.6 Q(vie)
+-.25 E(wer = ')-.25 E
+(start "c:/Program Files/SumatraPDF \(x86\)/SumatraPDF)-.55 E(.e)-.8 E
+-.15(xe)-.15 G 2.5("%).15 G 2.5(O%)-2.5 G(S';)-2.5 E .184
+(\(Note about the abo)108 674.4 R .484 -.15(ve ex)-.15 H .184(ample: F)
 .15 F(orw)-.15 E .184(ard slashes are equi)-.1 F -.25(va)-.25 G .183
 (lent to backslashes in \214lenames under MS-W).25 F(in-)-.4 E(do)108
-237.6 Q .016(ws, pro)-.25 F .016
+686.4 Q .016(ws, pro)-.25 F .016
 (vided that the \214lename is inside double quotes.)-.15 F .017
 (It is easier to use forw)5.017 F .017(ard slashes in e)-.1 F .017
-(xamples lik)-.15 F(e)-.1 E .944(the one abo)108 249.6 R -.15(ve)-.15 G
+(xamples lik)-.15 F(e)-.1 E .944(the one abo)108 698.4 R -.15(ve)-.15 G
 3.444(,s).15 G .944(ince then one does not ha)-3.444 F 1.244 -.15(ve t)
 -.2 H 3.444(ow).15 G .943(orry about the rules for dealing with forw)
 -3.544 F .943(ard slashes in)-.1 F(strings in the Perl language.\))108
-261.6 Q F2 2.735(Using MS-W)108 285.6 R(indo)-.18 E 2.735
+710.4 Q(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(13)185.545 E
+0 Cg EP
+%%Page: 14 14
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF .93
+(Command names under Cygwin)108 84 R F0 3.43(:I)C 3.43(fl)-3.43 G(ate)
+-3.43 E .93(xmk is e)-.15 F -.15(xe)-.15 G .93(cuted by Cygwin').15 F
+3.43(sp)-.55 G(erl,)-3.43 E/F2 10/Times-Italic@0 SF .93
+(be particularly certain that)5.93 F 1.397(pathnames in commands have)
+108 96 R F1 -.25(fo)3.897 G(rward).25 E F2(slashes)3.897 E F0 1.396
+(not the usual backslashes for the separator of pathname)3.897 F 4.067
+(components. See)108 108 R 1.568(the abo)4.067 F 1.868 -.15(ve ex)-.15 H
+4.068(amples. Backslashes).15 F 1.568
+(often get misinterpreted by the Unix shell used by)4.068 F(Cygwin')108
+120 Q 3.145(sP)-.55 G .645(erl to e)-3.145 F -.15(xe)-.15 G .645(cute e)
+.15 F .645(xternal commands.)-.15 F -.15(Fo)5.645 G(rw).15 E .645
+(ard slashes don')-.1 F 3.145(ts)-.18 G(uf)-3.145 E .645
+(fer from this problem, and \(when)-.25 F(quoted, as abo)108 132 Q -.15
+(ve)-.15 G 2.5(\)a).15 G(re equally acceptable to MS-W)-2.5 E(indo)-.4 E
+(ws.)-.25 E F1 2.735(Using MS-W)108 156 R(indo)-.18 E 2.735
 (ws \214le associations)-.1 F F0 5.235(:Au)C 2.735
 (seful trick under modern v)-5.235 F 2.735(ersions of MS-W)-.15 F(indo)
--.4 E 2.735(ws \(e.g.,)-.25 F -.4(Wi)108 297.6 S
+-.4 E 2.735(ws \(e.g.,)-.25 F -.4(Wi)108 168 S
 (nXP\) is to use just the command ').4 E(start' by itself:)-.55 E
-($dvi_pre)120.5 314.4 Q(vie)-.25 E(wer = ')-.25 E(start %S';)-.55 E .57
-(Under recent v)108 331.2 R .57(ersions of MS-W)-.15 F(indo)-.4 E .569
+($dvi_pre)120.5 184.8 Q(vie)-.25 E(wer = ')-.25 E(start %S';)-.55 E .57
+(Under recent v)108 201.6 R .57(ersions of MS-W)-.15 F(indo)-.4 E .569
 (ws, this will cause to be run whate)-.25 F -.15(ve)-.25 G 3.069(rp).15
-G .569(rogram the system has associ-)-3.069 F(ated with dvi \214les.)108
-343.2 Q(\(The same applies for a postscript vie)5 E(wer and a pdf vie)
--.25 E(wer)-.25 E(.\))-.55 E F2(Not using a certain command)108 367.2 Q
-F0 2.5(:I)C 2.5(fac)-2.5 G
+G .569(rogram the system has associ-)-3.069 F .516
+(ated with dvi \214les.)108 213.6 R .516
+(\(The same applies for a postscript vie)5.516 F .517(wer and a pdf vie)
+-.25 F(wer)-.25 E 3.017(.\) But)-.55 F .517(note that this trick is)
+3.017 F 2.122(not al)108 225.6 R -.1(wa)-.1 G 2.122
+(ys suitable for the pdf pre).1 F(viwer)-.25 E 4.622(,i)-.4 G 4.622(fy)
+-4.622 G 2.122(our system has acroread for the def)-4.622 F 2.121
+(ault pdf vie)-.1 F(wer)-.25 E 7.121(.A)-.55 G(s)-7.121 E -.15(ex)108
+237.6 S 1.584(plained else).15 F 1.584(where, acroread under MS-W)-.25 F
+(indo)-.4 E 1.585(ws does not w)-.25 F 1.585(ork well with)-.1 F F2
+(late)4.085 E(x)-.2 E F0(and)4.085 E F2(late)4.085 E(xmk)-.2 E F0 4.085
+(,b)C(ecause)-4.085 E(acroread locks the pdf \214le.)108 249.6 Q F1
+(Not using a certain command)108 273.6 Q F0 2.5(:I)C 2.5(fac)-2.5 G
 (ommand is not to be run, the command name NONE is used, as in)-2.5 E
-2.5($lpr =)120.5 384 R('NONE lpr';)2.5 E .93
-(This typically is used when an appropriate command does not e)108 400.8
+2.5($lpr =)120.5 290.4 R('NONE lpr';)2.5 E .93
+(This typically is used when an appropriate command does not e)108 307.2
 R .93(xist on your system.)-.15 F .93(The string after the)5.93 F
-("NONE" is ef)108 412.8 Q(fecti)-.25 E -.15(ve)-.25 G(ly a comment.).15
-E F2 .21(Options to commands)108 436.8 R F0 2.71(:S)C .21(etting the na\
+("NONE" is ef)108 319.2 Q(fecti)-.25 E -.15(ve)-.25 G(ly a comment.).15
+E F1 .21(Options to commands)108 343.2 R F0 2.71(:S)C .21(etting the na\
 me of a command can be used not only for changing the name of the)-2.71
-F .452(command called, b)108 448.8 R .452
+F .453(command called, b)108 355.2 R .453
 (ut also to add options to command.)-.2 F .452(Suppose you w)5.452 F
-(ant)-.1 E F1(late)2.953 E(xmk)-.2 E F0 .453(to use late)2.953 F 2.953
-(xw)-.15 G .453(ith source)-2.953 F(specials enabled.)108 460.8 Q
+(ant)-.1 E F2(late)2.952 E(xmk)-.2 E F0 .452(to use late)2.952 F 2.952
+(xw)-.15 G .452(ith source)-2.952 F(specials enabled.)108 367.2 Q
 (Then you might use the follo)5 E
-(wing line in an initialization \214le:)-.25 E($late)120.5 477.6 Q 2.5
-(x=')-.15 G(late)-2.6 E 2.5(x-)-.15 G(-src-specials %O %S';)-2.5 E F2
-(Adv)108 506.4 Q .338(anced tricks)-.1 F F0 2.838(:N)C .337
+(wing line in an initialization \214le:)-.25 E($late)120.5 384 Q 2.5
+(x=')-.15 G(late)-2.6 E 2.5(x-)-.15 G(-src-specials %O %S';)-2.5 E F1
+.092(Running a subr)108 412.8 R .092(outine instead of an exter)-.18 F
+.093(nal command)-.15 F F0 2.593(:U)C .093
+(se a speci\214cation starting with "internal", as in)-2.593 F($late)
+120.5 429.6 Q 2.5(x=')-.15 G(internal mylate)-2.5 E 2.5(x%)-.15 G 2.5
+(O%)-2.5 G(S';)-2.5 E(sub mylate)120.5 441.6 Q 2.5(x{)-.15 G(my @ar)
+130.5 453.6 Q(gs = @_;)-.18 E 2.5(#P)130.5 465.6 S
+(ossible preprocessing here)-2.5 E(return system ')130.5 477.6 Q(late)
+-.1 E(x', @ar)-.15 E(gs;)-.18 E(})120.5 489.6 Q F1(Adv)108 518.4 Q .338
+(anced tricks)-.1 F F0 2.838(:N)C .337
 (ormally one speci\214es a single command for the commands in)-2.838 F
--.2(vo)-.4 G -.1(ke).2 G 2.837(db).1 G(y)-2.837 E F1(late)2.837 E(xmk)
--.2 E F0 5.337(.N)C(atu-)-5.337 E(rally)108 518.4 Q 3.23(,i)-.65 G 3.23
+-.2(vo)-.4 G -.1(ke).2 G 2.837(db).1 G(y)-2.837 E F2(late)2.837 E(xmk)
+-.2 E F0 5.337(.N)C(atu-)-5.337 E(rally)108 530.4 Q 3.23(,i)-.65 G 3.23
 (ft)-3.23 G .731(here is some complicated additional processing you nee\
 d to do in your special situation, you can)-3.23 F .545(write a script \
-\(or batch \214le\) to do the processing, and then con\214gure)108 530.4
-R F1(late)3.044 E(xmk)-.2 E F0 .544(to use your script in place of)3.044
-F(the standard program.)108 542.4 Q .636
-(It is also possible to con\214gure)108 566.4 R F1(late)3.136 E(xmk)-.2
+\(or batch \214le\) to do the processing, and then con\214gure)108 542.4
+R F2(late)3.044 E(xmk)-.2 E F0 .544(to use your script in place of)3.044
+F(the standard program.)108 554.4 Q .636
+(It is also possible to con\214gure)108 578.4 R F2(late)3.136 E(xmk)-.2
 E F0 .636(to run multiple commands.)3.136 F -.15(Fo)5.636 G 3.136(re).15
 G .637(xample, if when running pd\215ate)-3.286 F(x)-.15 E .544
-(to generate a pdf \214le from a te)108 578.4 R 3.044<788c>-.15 G .544
+(to generate a pdf \214le from a te)108 590.4 R 3.044<788c>-.15 G .544
 (le you need to run another program after pd\215ate)-3.044 F 3.044(xt)
 -.15 G 3.044(op)-3.044 G .544(erform some e)-3.044 F(xtra)-.15 E
-(processing, you could do something lik)108 590.4 Q(e:)-.1 E($pd\215ate)
-120.5 614.4 Q 2.5(x=')-.15 G(pd\215ate)-2.5 E 2.5(x-)-.15 G
-(-shell-escape %O %S; pst2pdf_for_late)-2.5 E(xmk %B';)-.15 E .696
-(This de\214nition assumes you are using a UNIX-lik)108 638.4 R 3.196
-(es)-.1 G .696(ystem, so that the tw)-3.196 F 3.196(oc)-.1 G .696
-(ommands to be run are sepa-)-3.196 F
-(rated by the semicolon in the middle of the string.)108 650.4 Q/F3
-10.95/Times-Bold@0 SF(LIST OF CONFIGURA)72 691.2 Q(TION V)-1.04 E
-(ARIABLES USABLE IN INITIALIZA)-1.478 E(TION FILES)-1.04 E F0(Def)108
-703.2 Q(ault v)-.1 E(alues are indicated in brack)-.25 E(ets.)-.1 E 2.5
-(7M)281.835 768 S(ay 2011)-2.5 E(11)199.835 E 0 Cg EP
-%%Page: 12 12
+(processing, you could do something lik)108 602.4 Q(e:)-.1 E($pd\215ate)
+120.5 626.4 Q 2.5(x=')-.15 G(pd\215ate)-2.5 E 2.5(x-)-.15 G
+(-shell-escape %O %S; pst2pdf_for_late)-2.5 E(xmk %B';)-.15 E .845
+(This de\214nition assumes you are using a UNIX-lik)108 650.4 R 3.346
+(es)-.1 G .846(ystem \(which includes Linux and OS-X\), so that the)
+-3.346 F(tw)108 662.4 Q 2.5(oc)-.1 G(ommands to be run are separated by\
+ the semicolon in the middle of the string.)-2.5 E
+(If you are using MS-W)108 686.4 Q(indo)-.4 E(ws, you w)-.25 E
+(ould replace the abo)-.1 E .3 -.15(ve l)-.15 H(ine by).15 E($pd\215ate)
+115.5 710.4 Q 2.5(x=')-.15 G(cmd /c pd\215ate)-2.5 E 2.5(x-)-.15 G
+(-shell-escape %O %S')-2.5 E 2.5(.')145.5 722.4 S(&& pst2pdf_for_late)
+-2.5 E(xmk %B';)-.15 E(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15
+E(14)185.545 E 0 Cg EP
+%%Page: 15 15
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF
-($always_view_\214le_via_temporary [0])108 84 Q F0 .724(Whether ps and \
-pdf \214les are initially to be made in a temporary directory and then \
-mo)144 96 R -.15(ve)-.15 G 3.223(dt).15 G 3.223(ot)-3.223 G(he)-3.223 E
-.331(\214nal location.)144 108 R .331(\(This applies to dvips, dvipdf, \
-and ps2pdf operations, and the \214ltering operators on)5.331 F
-(dvi and ps \214les.)144 120 Q(It does not apply to pd\215ate)5 E
+(TEXMK\(1L\))-1.11 E .031
+(Here, the UNIX command separator ; is replaced by &&.)108 84 R .031
+(In addition, there is a problem that some v)5.031 F(ersions)-.15 E(of)
+108 96 Q/F1 10/Times-Italic@0 SF -.8(Pe)2.619 G(rl).8 E F0 .119(on MS-W)
+2.619 F(indo)-.4 E .119(ws do not obe)-.25 F 2.619(yt)-.15 G .119
+(he command separator; this problem is o)-2.619 F -.15(ve)-.15 G .12
+(rcome by e).15 F .12(xplicitly in)-.15 F -.2(vo)-.4 G(k-).2 E
+(ing the MS-W)108 108 Q(indo)-.4 E(ws command-line processor)-.25 E F1
+(cmd.e)2.5 E(xe)-.2 E F0(.)A/F2 10.95/Times-Bold@0 SF(LIST OF CONFIGURA)
+72 136.8 Q(TION V)-1.04 E(ARIABLES USABLE IN INITIALIZA)-1.478 E
+(TION FILES)-1.04 E F0(Def)108 148.8 Q(ault v)-.1 E
+(alues are indicated in brack)-.25 E(ets.)-.1 E/F3 10/Times-Bold@0 SF
+($always_view_\214le_via_temporary [0])108 165.6 Q F0 .724(Whether ps a\
+nd pdf \214les are initially to be made in a temporary directory and th\
+en mo)144 177.6 R -.15(ve)-.15 G 3.223(dt).15 G 3.223(ot)-3.223 G(he)
+-3.223 E .331(\214nal location.)144 189.6 R .331(\(This applies to dvip\
+s, dvipdf, and ps2pdf operations, and the \214ltering operators on)5.331
+F(dvi and ps \214les.)144 201.6 Q(It does not apply to pd\215ate)5 E
 (x, unfortunately)-.15 E(.\))-.65 E .413
-(This use of a temporary \214le solv)144 144 R .412
+(This use of a temporary \214le solv)144 225.6 R .412
 (es a problem that the making of these \214les can occup)-.15 F 2.912
-(yas)-.1 G(ubstan-)-2.912 E .377(tial time.)144 156 R .377(If a vie)
+(yas)-.1 G(ubstan-)-2.912 E .377(tial time.)144 237.6 R .377(If a vie)
 5.377 F .377(wer sees that the \214le has changed, it reads the ne)-.25
 F 2.877<778c>-.25 G .377(le, and this can cause ha)-2.877 F -.2(vo)-.2 G
 (c).2 E(if the program writing the \214le has not yet \214nished its w)
-144 168 Q(ork.)-.1 E .774(See the)144 192 R/F2 10/Times-Italic@0 SF
-($pvc_vie)3.274 E(w_\214le_via_tempor)-.15 E(ary)-.15 E F0 -.25(va)3.274
-G .774(riable for a setting that applies only if pre).25 F(vie)-.25 E
-(w-continu-)-.25 E .552(ous mode \(-pvc option\) is used.)144 204 R(See)
-5.552 E F2($tmpdir)3.052 E F0 .553
+144 249.6 Q(ork.)-.1 E .774(See the)144 273.6 R F1($pvc_vie)3.274 E
+(w_\214le_via_tempor)-.15 E(ary)-.15 E F0 -.25(va)3.274 G .774
+(riable for a setting that applies only if pre).25 F(vie)-.25 E
+(w-continu-)-.25 E .552(ous mode \(-pvc option\) is used.)144 285.6 R
+(See)5.552 E F1($tmpdir)3.052 E F0 .553
 (for the setting of the directory where the temporary)3.052 F
-(\214le is created.)144 216 Q F1($banner [0])108 244.8 Q F0 .918
+(\214le is created.)144 297.6 Q F3($auto_r)108 326.4 Q(c_use [1])-.18 E
+F0 .829(Whether to automatically read the standard initialization \(rc\
+\) \214les, which are the system RC \214le,)144 338.4 R .212(the user')
+144 350.4 R 2.712(sR)-.55 G 2.712<438c>-2.712 G .212
+(le, and the RC \214le in the current directory)-2.712 F 5.212(.T)-.65 G
+.212(he command line option)-5.212 F F3(-nor)2.713 E(c)-.18 E F0 .213
+(can be)2.713 F 2.337(used to turn this setting of)144 362.4 R 4.837
+(f. Each)-.25 F 2.337(RC \214le could also turn this setting of)4.837 F
+2.336(f, i.e., it could set)-.25 F F1($auto_r)144 374.4 Q(c_use)-.37 E
+F0(to zero to pre)2.5 E -.15(ve)-.25 G
+(nt automatic reading of the later RC \214les.).15 E 1.611(This v)144
+398.4 R 1.611(ariable does not af)-.25 F 1.611
+(fect the reading of RC \214les speci\214ed on the command line by the)
+-.25 F F3(-r)4.112 E F0(option.)144 410.4 Q F3($aux_dir [""])108 439.2 Q
+F0 .138(The directory in which auxiliary \214les \(aux, log, etc\) are \
+to be written by a run of \(pdf\)late)144 451.2 R 2.637(x. If)-.15 F
+(this)2.637 E -.25(va)144 463.2 S .867(riable is not set, b).25 F(ut)-.2
+E F1($out_dir)3.368 E F0 .868(is set, then)3.368 F F1($aux_dir)3.368 E
+F0 .868(is set to)3.368 F F1($out_dir)3.368 E F0 3.368(,w)C .868
+(hich is the directory to)-3.368 F
+(which general output \214les are to be written.)144 475.2 Q F3 2.82
+(Important note)144 499.2 R F0 7.82(:T)C 2.82(he ef)-7.82 F 2.819
+(fect of)-.25 F F1($aux_dir)5.319 E F0 5.319(,i)C 5.319(fd)-5.319 G(if)
+-5.319 E 2.819(ferent from)-.25 F F1($out_dir)5.319 E F0 5.319(,i)C
+5.319(sa)-5.319 G(chie)-5.319 E -.15(ve)-.25 G 5.319(db).15 G 5.319(yg)
+-5.319 G -.25(iv)-5.319 G(ing).25 E(\(pdf\)late)144 511.2 Q 3.236(xt)
+-.15 G(he)-3.236 E F3(-aux-dir)3.236 E(ectory)-.18 E F0 5.736(.C)C .736
+(urrently \(Dec. 2011\) this only w)-5.736 F .736(orks on the MiKT)-.1 F
+.737(eX v)-.7 F .737(ersion of)-.15 F(\(pdf\)late)144 523.2 Q(x.)-.15 E
+.433(See also the documentation of)144 547.2 R F1($out_dir)2.932 E F0
+.432(for some complications on what directory names are suit-)2.932 F
+(able.)144 559.2 Q F3($banner [0])108 588 Q F0 .918
 (If nonzero, the banner message is printed across each page when con)144
-256.8 R -.15(ve)-.4 G .918(rting the dvi \214le to post-).15 F 3.6
-(script. W)144 268.8 R 1.101(ithout modifying the v)-.4 F(ariable)-.25 E
-F2($banner_messa)3.601 E -.1(ge)-.1 G F0 3.601(,t).1 G 1.101
+600 R -.15(ve)-.4 G .918(rting the dvi \214le to post-).15 F 3.601
+(script. W)144 612 R 1.101(ithout modifying the v)-.4 F(ariable)-.25 E
+F1($banner_messa)3.601 E -.1(ge)-.1 G F0 3.601(,t).1 G 1.101
 (his is equi)-3.601 F -.25(va)-.25 G 1.101(lent to specifying the).25 F
-F1(-d)3.601 E F0(option.)144 280.8 Q 2.117(Note that if)144 304.8 R F1
-($banner)4.617 E F0 2.117(is nonzero, the)4.617 F F1($postscript_mode)
-4.616 E F0 2.116(is assumed and the postscript \214le is)4.616 F(al)144
-316.8 Q -.1(wa)-.1 G(ys generated, e).1 E -.15(ve)-.25 G 2.5(ni).15 G
-2.5(fi)-2.5 G 2.5(ti)-2.5 G 2.5(sn)-2.5 G -.25(ew)-2.5 G
-(er than the dvi \214le.).25 E F1($banner_intensity [0.95])108 333.6 Q
-F0(Equi)144 345.6 Q -.25(va)-.25 G .608(lent to the).25 F F1(-bi)3.108 E
+F3(-d)3.6 E F0(option.)144 624 Q 2.116(Note that if)144 648 R F3
+($banner)4.616 E F0 2.116(is nonzero, the)4.616 F F3($postscript_mode)
+4.616 E F0 2.117(is assumed and the postscript \214le is)4.616 F(al)144
+660 Q -.1(wa)-.1 G(ys generated, e).1 E -.15(ve)-.25 G 2.5(ni).15 G 2.5
+(fi)-2.5 G 2.5(ti)-2.5 G 2.5(sn)-2.5 G -.25(ew)-2.5 G
+(er than the dvi \214le.).25 E F3($banner_intensity [0.95])108 676.8 Q
+F0(Equi)144 688.8 Q -.25(va)-.25 G .609(lent to the).25 F F3(-bi)3.109 E
 F0 .608
 (option, this is a decimal number between 0 and 1 that speci\214es ho)
-3.108 F 3.109(wd)-.25 G .609(ark to)-3.109 F .99
-(print the banner message. 0 is black, 1 is white.)144 357.6 R .99
+3.109 F 3.108(wd)-.25 G .608(ark to)-3.108 F .99
+(print the banner message. 0 is black, 1 is white.)144 700.8 R .99
 (The def)5.99 F .99(ault is just right if your toner cartridge)-.1 F
-(isn')144 369.6 Q 2.5(tr)-.18 G(unning too lo)-2.5 E -.65(w.)-.25 G F1
-($banner_message ["DRAFT"])108 386.4 Q F0 .795
-(The banner message to print across each page when con)144 398.4 R -.15
-(ve)-.4 G .795(rting the dvi \214le to postscript.).15 F .795(This is)
-5.795 F(equi)144 410.4 Q -.25(va)-.25 G(lent to the).25 E F1(-bm)2.5 E
-F0(option.)2.5 E F1($banner_scale [220.0])108 427.2 Q F0 2.528(Ad)144
-439.2 S .027(ecimal number that speci\214es ho)-2.528 F 2.527(wl)-.25 G
-(ar)-2.527 E .027(ge the banner message will be printed.)-.18 F .027
-(Experimentation is)5.027 F 1.217(necessary to get the right scale for \
-your message, as a rule of thumb the scale should be about)144 451.2 R
-.511(equal to 1100 di)144 463.2 R .511
-(vided by the number of characters in the message.)-.25 F .51(The Def)
-5.51 F .51(ault is just right for 5)-.1 F(character messages.)144 475.2
-Q(This is equi)5 E -.25(va)-.25 G(lent to the).25 E F1(-bs)2.5 E F0
-(option.)2.5 E F1(@BIBINPUTS)108 492 Q F0 .046(This is an array v)144
-504 R .046(ariable, no)-.25 F 2.546(wm)-.25 G .047
-(ostly obsolete, that speci\214es directories where)-2.546 F F2(late)
-2.547 E(xmk)-.2 E F0 .047(should look)2.547 F .303(for .bib \214les.)144
-516 R .303(By def)5.303 F .303(ault it is set from the BIBINPUTS en)-.1
-F .302(vironment v)-.4 F .302(ariable of the operating sys-)-.25 F 2.588
-(tem. If)144 528 R .088(that en)2.588 F .088(vironment v)-.4 F .089(ari\
-able is not set, a single element list consisting of the current direct\
-ory)-.25 F .22(is set.)144 540 R .219(The format of the directory names\
- depends on your operating system, of course.)5.22 F(Examples)5.219 E
-(for setting this v)144 552 Q(ariable are:)-.25 E
-(@BIBINPUTS = \( ".", "C:\\bib\214les" \);)164 576 Q
-(@BIBINPUTS = \( ".", "\\\\serv)164 588 Q(er\\bib\214les" \);)-.15 E
-(@BIBINPUTS = \( ".", "C:/bib\214les" \);)164 600 Q
-(@BIBINPUTS = \( ".", "//serv)164 612 Q(er/bib\214les" \);)-.15 E
-(@BIBINPUTS = \( ".", "/usr/local/te)164 624 Q(xmf/bibte)-.15 E
-(x/bib" \);)-.15 E .975(Note that under MS W)144 648 R(indo)-.4 E .975
-(ws, either a forw)-.25 F .975(ard slash "/" or a backw)-.1 F .975
-(ard slash "\\" can be used to)-.1 F .118
-(separate pathname components, so the \214rst tw)144 660 R 2.618(oa)-.1
-G .118(nd the second tw)-2.618 F 2.618(oe)-.1 G .118(xamples are equi)
--2.768 F -.25(va)-.25 G 2.617(lent. Each).25 F(backw)144 672 Q
-(ard slash should be doubled to a)-.1 E -.2(vo)-.2 G
-(id running afoul of).2 E F2 -.8(Pe)2.5 G(rl).8 E F0 1.1 -.55('s r)D
-(ules for writing strings.).55 E F2 .362(Important note:)108 688.8 R F0
-.362(This v)2.862 F .362(ariable is no)-.25 F 2.862(wm)-.25 G .362
-(ostly obsolete in the current v)-2.862 F .362(ersion of)-.15 F F2(late)
-2.862 E(xmk)-.2 E F0 2.862(,s)C .363(ince it has a better)-2.862 F .887
-(method of searching for \214les using the kpse)108 700.8 R .887
-(which command.)-.25 F(Ho)5.887 E(we)-.25 E -.15(ve)-.25 G 1.687 -.4
-(r, i).15 H 3.387(fy).4 G .887(our system is an unusual one)-3.387 F
-(without the kpse)108 712.8 Q(which command, you may need to set the v)
--.25 E(ariable)-.25 E F2(@BIBINPUTS)2.5 E F0(.)A 2.5(7M)281.835 768 S
-(ay 2011)-2.5 E(12)199.835 E 0 Cg EP
-%%Page: 13 13
+(isn')144 712.8 Q 2.5(tr)-.18 G(unning too lo)-2.5 E -.65(w.)-.25 G
+(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(15)185.545 E 0 Cg EP
+%%Page: 16 16
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF($biber ["biber %O %S"])108 84
-Q F0(The biber processing program.)144 96 Q F1
-($biber_silent_switch ["--onlylog"])108 112.8 Q(Switch\(es\))144 124.8 Q
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF($banner_message ["DRAFT"])108
+84 Q F0 .795(The banner message to print across each page when con)144
+96 R -.15(ve)-.4 G .795(rting the dvi \214le to postscript.).15 F .795
+(This is)5.795 F(equi)144 108 Q -.25(va)-.25 G(lent to the).25 E F1(-bm)
+2.5 E F0(option.)2.5 E F1($banner_scale [220.0])108 124.8 Q F0 2.527(Ad)
+144 136.8 S .027(ecimal number that speci\214es ho)-2.527 F 2.527(wl)
+-.25 G(ar)-2.527 E .027(ge the banner message will be printed.)-.18 F
+.028(Experimentation is)5.028 F 1.217(necessary to get the right scale \
+for your message, as a rule of thumb the scale should be about)144 148.8
+R .51(equal to 1100 di)144 160.8 R .51
+(vided by the number of characters in the message.)-.25 F .511(The Def)
+5.511 F .511(ault is just right for 5)-.1 F(character messages.)144
+172.8 Q(This is equi)5 E -.25(va)-.25 G(lent to the).25 E F1(-bs)2.5 E
+F0(option.)2.5 E F1(@BIBINPUTS)108 189.6 Q F0 .047(This is an array v)
+144 201.6 R .047(ariable, no)-.25 F 2.547(wm)-.25 G .046
+(ostly obsolete, that speci\214es directories where)-2.547 F/F2 10
+/Times-Italic@0 SF(late)2.546 E(xmk)-.2 E F0 .046(should look)2.546 F
+.302(for .bib \214les.)144 213.6 R .302(By def)5.302 F .302
+(ault it is set from the BIBINPUTS en)-.1 F .303(vironment v)-.4 F .303
+(ariable of the operating sys-)-.25 F 2.589(tem. If)144 225.6 R .089
+(that en)2.589 F .089(vironment v)-.4 F .089(ariable is not set, a sing\
+le element list consisting of the current directory)-.25 F .219(is set.)
+144 237.6 R .219(The format of the directory names depends on your oper\
+ating system, of course.)5.219 F(Examples)5.22 E(for setting this v)144
+249.6 Q(ariable are:)-.25 E(@BIBINPUTS = \( ".", "C:\\bib\214les" \);)
+164 273.6 Q(@BIBINPUTS = \( ".", "\\\\serv)164 285.6 Q
+(er\\bib\214les" \);)-.15 E(@BIBINPUTS = \( ".", "C:/bib\214les" \);)164
+297.6 Q(@BIBINPUTS = \( ".", "//serv)164 309.6 Q(er/bib\214les" \);)-.15
+E(@BIBINPUTS = \( ".", "/usr/local/te)164 321.6 Q(xmf/bibte)-.15 E
+(x/bib" \);)-.15 E .975(Note that under MS W)144 345.6 R(indo)-.4 E .975
+(ws, either a forw)-.25 F .975(ard slash "/" or a backw)-.1 F .975
+(ard slash "\\" can be used to)-.1 F .118
+(separate pathname components, so the \214rst tw)144 357.6 R 2.618(oa)
+-.1 G .118(nd the second tw)-2.618 F 2.618(oe)-.1 G .118
+(xamples are equi)-2.768 F -.25(va)-.25 G 2.618(lent. Each).25 F(backw)
+144 369.6 Q(ard slash should be doubled to a)-.1 E -.2(vo)-.2 G
+(id running afoul of).2 E F2 -.8(Pe)2.5 G(rl).8 E F0 1.1 -.55('s r)D
+(ules for writing strings.).55 E F2 .171(Important note:)144 393.6 R F0
+.171(This v)2.671 F .171(ariable is no)-.25 F 2.671(wm)-.25 G .171
+(ostly obsolete in the current v)-2.671 F .17(ersion of)-.15 F F2(late)
+2.67 E(xmk)-.2 E F0 2.67(,s)C .17(ince it has)-2.67 F 3.064(ab)144 405.6
+S .564(etter method of searching for \214les using the kpse)-3.064 F
+.565(which command.)-.25 F(Ho)5.565 E(we)-.25 E -.15(ve)-.25 G 1.365 -.4
+(r, i).15 H 3.065(fy).4 G .565(our system is)-3.065 F .247
+(an unusual one without the kpse)144 417.6 R .247
+(which command, you may need to set the v)-.25 F(ariable)-.25 E F2
+(@BIBINPUTS)2.747 E F0(.)A F1($biber ["biber %O %S"])108 434.4 Q F0
+(The biber processing program.)144 446.4 Q F1
+($biber_silent_switch ["--onlylog"])108 463.2 Q(Switch\(es\))144 475.2 Q
 F0(for the biber processing program when silent mode is on.)2.5 E F1
-($bibtex ["bibtex %O %S"])108 141.6 Q F0(The BibT)144 153.6 Q
+($bibtex ["bibtex %O %S"])108 492 Q F0(The BibT)144 504 Q
 (eX processing program.)-.7 E F1($bibtex_silent_switch ["-terse"])108
-170.4 Q(Switch\(es\))144 182.4 Q F0(for the BibT)2.5 E
+520.8 Q(Switch\(es\))144 532.8 Q F0(for the BibT)2.5 E
 (eX processing program when silent mode is on.)-.7 E F1($bibtex_use [1])
-108 199.2 Q F0 .314(Under what conditions to run BibT)144 211.2 R .314
-(eX or biber)-.7 F 5.314(.W)-.55 G(hen)-5.314 E/F2 10/Times-Italic@0 SF
-(late)2.814 E(xmk)-.2 E F0(disco)2.814 E -.15(ve)-.15 G .315
-(rs from the log \214le that one).15 F .281(\(or more\) BibT)144 223.2 R
-(eX/biber)-.7 E .281
+108 549.6 Q F0 .314(Under what conditions to run BibT)144 561.6 R .314
+(eX or biber)-.7 F 5.314(.W)-.55 G(hen)-5.314 E F2(late)2.814 E(xmk)-.2
+E F0(disco)2.814 E -.15(ve)-.15 G .315(rs from the log \214le that one)
+.15 F .281(\(or more\) BibT)144 573.6 R(eX/biber)-.7 E .281
 (-generated bibliographies are used, it can run BibT)-.2 F .28
 (eX or biber whene)-.7 F -.15(ve)-.25 G 2.78(ri).15 G(t)-2.78 E
-(appears necessary to re)144 235.2 Q(generate the bbl \214le\(s\) from \
+(appears necessary to re)144 585.6 Q(generate the bbl \214le\(s\) from \
 their source bib database \214le\(s\).)-.15 E .325
-(But sometimes, the bib \214le\(s\) are not a)144 259.2 R -.25(va)-.2 G
+(But sometimes, the bib \214le\(s\) are not a)144 609.6 R -.25(va)-.2 G
 .326(ilable \(e.g., for a document obtained from an e).25 F .326
-(xternal ar)-.15 F(-)-.2 E(chi)144 271.2 Q -.15(ve)-.25 G .742(\), b).15
+(xternal ar)-.15 F(-)-.2 E(chi)144 621.6 Q -.15(ve)-.25 G .742(\), b).15
 F .742(ut the bbl \214les are pro)-.2 F 3.242(vided. In)-.15 F .742
 (that case use of BibT)3.242 F .741
-(eX or biber will result in incorrect)-.7 F -.15(ove)144 283.2 S .502
+(eX or biber will result in incorrect)-.7 F -.15(ove)144 633.6 S .502
 (rwriting of the precious bbl \214les.).15 F .502(The v)5.502 F(ariable)
 -.25 E F2($bibte)3.002 E(x_use)-.2 E F0 .503
 (controls whether this happens.)3.002 F(Its)5.503 E 1.283(possible v)144
-295.2 R 1.283(alues are: 0: ne)-.25 F -.15(ve)-.25 G 3.783(ru).15 G
+645.6 R 1.283(alues are: 0: ne)-.25 F -.15(ve)-.25 G 3.783(ru).15 G
 1.283(se BibT)-3.783 F 1.283(eX or biber)-.7 F 6.283(.1)-.55 G 3.783(:o)
 -6.283 G 1.283(nly use BibT)-3.783 F 1.282
-(eX or biber if the bib \214les)-.7 F -.15(ex)144 307.2 S 2.591(ist. 2:)
+(eX or biber if the bib \214les)-.7 F -.15(ex)144 657.6 S 2.591(ist. 2:)
 .15 F .092(run BibT)2.591 F .092(eX or biber whene)-.7 F -.15(ve)-.25 G
 2.592(ri).15 G 2.592(ta)-2.592 G .092
 (ppears necessary to update the bbl \214les, without testing)-2.592 F
-(for the e)144 319.2 Q(xistence of the bib \214les.)-.15 E F1
-($cleanup_includes_cusdep_generated [0])108 336 Q F0 1.515(If nonzero, \
-speci\214es that cleanup also deletes \214les that are generated by cus\
-tom dependencies.)144 348 R .352
-(\(When doing a clean up, e.g., by use of the)144 360 R F2(-C)2.852 E F0
-.353(option, custom dependencies are those listed in the)2.852 F F2
-(.fdb_late)144 372 Q(xmk)-.2 E F0(\214le from a pre)2.5 E(vious run.\))
--.25 E F1($cleanup_includes_generated [0])108 388.8 Q F0 .641(If nonzer\
-o, speci\214es that cleanup also deletes \214les that are detected in l\
-og \214le as being generated)144 400.8 R .829
-(\(see the \\openout lines in the log \214le\).)144 412.8 R .829
+(for the e)144 669.6 Q(xistence of the bib \214les.)-.15 E F1
+($cleanup_includes_cusdep_generated [0])108 686.4 Q F0 1.515(If nonzero\
+, speci\214es that cleanup also deletes \214les that are generated by c\
+ustom dependencies.)144 698.4 R .321
+(\(When doing a clean up, e.g., by use of the)144 710.4 R F1(-C)2.822 E
+F0 .322(option, custom dependencies are those listed in the)2.822 F F2
+(.fdb_late)144 722.4 Q(xmk)-.2 E F0(\214le from a pre)2.5 E
+(vious run.\))-.25 E(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E
+(16)185.545 E 0 Cg EP
+%%Page: 17 17
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF
+($cleanup_includes_generated [0])108 84 Q F0 .641(If nonzero, speci\214\
+es that cleanup also deletes \214les that are detected in log \214le as\
+ being generated)144 96 R .829
+(\(see the \\openout lines in the log \214le\).)144 108 R .829
 (It will also include \214les made from these \214rst generation)5.829 F
-(generated \214les.)144 424.8 Q F1($cleanup_mode [0])108 441.6 Q F0
-1.184(If nonzero, speci\214es cleanup mode: 1 for full cleanup, 2 for c\
-leanup e)144 453.6 R 1.184(xcept for dvi, ps and pdf)-.15 F .678
-(\214les, 3 for cleanup e)144 465.6 R .679
+(generated \214les.)144 120 Q F1($cleanup_mode [0])108 136.8 Q F0 1.184
+(If nonzero, speci\214es cleanup mode: 1 for full cleanup, 2 for cleanu\
+p e)144 148.8 R 1.184(xcept for dvi, ps and pdf)-.15 F .678
+(\214les, 3 for cleanup e)144 160.8 R .679
 (xcept for dep and aux \214les.)-.15 F .679(\(There is also e)5.679 F
-.679(xtra cleaning as speci\214ed by the)-.15 F F2($clean_e)144 477.6 Q
-(xt)-.2 E F0(,)A F2($clean_full_e)2.5 E(xt)-.2 E F0(and)2.5 E F2(@g)2.5
-E(ener)-.1 E(ated_e)-.15 E(xts)-.2 E F0 -.25(va)2.5 G(riables.\)).25 E
-.173(This v)108 494.4 R .173(ariable is equi)-.25 F -.25(va)-.25 G .173
-(lent to specifying one of the).25 F F1(-c)2.673 E F0(or)2.673 E F1(-C)
-2.673 E F0 2.673(options. But)2.673 F .173
-(there should be no need to set this)2.673 F -.25(va)108 506.4 S
-(riable from an RC \214le.).25 E F1($clean_ext [""])108 523.2 Q F0 1.434
-(Extra e)144 535.2 R 1.434(xtensions of \214les for)-.15 F F2(late)3.934
-E(xmk)-.2 E F0 1.434(to remo)3.934 F 1.734 -.15(ve w)-.15 H 1.434
+.679(xtra cleaning as speci\214ed by the)-.15 F/F2 10/Times-Italic@0 SF
+($clean_e)144 172.8 Q(xt)-.2 E F0(,)A F2($clean_full_e)2.5 E(xt)-.2 E F0
+(and)2.5 E F2(@g)2.5 E(ener)-.1 E(ated_e)-.15 E(xts)-.2 E F0 -.25(va)2.5
+G(riables.\)).25 E .471(This v)144 196.8 R .471(ariable is equi)-.25 F
+-.25(va)-.25 G .471(lent to specifying one of the).25 F F1(-c)2.971 E F0
+(or)2.971 E F1(-C)2.97 E F0 2.97(options. But)2.97 F .47
+(there should be no need)2.97 F(to set this v)144 208.8 Q
+(ariable from an RC \214le.)-.25 E F1($clean_ext [""])108 225.6 Q F0
+1.434(Extra e)144 237.6 R 1.434(xtensions of \214les for)-.15 F F2(late)
+3.934 E(xmk)-.2 E F0 1.434(to remo)3.934 F 1.734 -.15(ve w)-.15 H 1.434
 (hen an).15 F 3.934(yo)-.15 G 3.934(ft)-3.934 G 1.434
 (he clean-up options \()-3.934 F F1(-c)A F0(or)3.934 E F1(-C)3.935 E F0
-3.935(\)i)C(s)-3.935 E 2.5(selected. The)144 547.2 R -.25(va)2.5 G
+3.935(\)i)C(s)-3.935 E 2.5(selected. The)144 249.6 R -.25(va)2.5 G
 (lue of this v).25 E(ariable is a string containing the e)-.25 E
 (xtensions separated by spaces.)-.15 E .407(It is also possible to spec\
 ify a more general pattern of \214le to be deleted, by using the place \
-holder)144 571.2 R(%R, as in commands.)144 583.2 Q(Thus setting)5 E
-($clean_e)151.5 607.2 Q(xt = "out %R-blx.bib";)-.15 E .419(in an initia\
+holder)144 273.6 R(%R, as in commands.)144 285.6 Q(Thus setting)5 E
+($clean_e)151.5 309.6 Q(xt = "out %R-blx.bib";)-.15 E .419(in an initia\
 lization \214le will imply that when a clean-up operation is speci\214e\
-d, not only is the stan-)144 631.2 R .772
-(dard set of \214les deleted, b)144 643.2 R .772
+d, not only is the stan-)144 333.6 R .772
+(dard set of \214les deleted, b)144 345.6 R .772
 (ut also \214les of the form FOO.out and FOO-blx.bib, where FOO stands)
 -.2 F(for the basename of the \214le being processed \(as in FOO.te)144
-655.2 Q(x\).)-.15 E F1($clean_full_ext [""])108 684 Q F0 .671(Extra e)
-144 696 R .672(xtensions of \214les for)-.15 F F2(late)3.172 E(xmk)-.2 E
-F0 .672(to remo)3.172 F .972 -.15(ve w)-.15 H .672(hen the).15 F F1(-C)
-3.172 E F0 .672(option is selected, i.e., e)3.172 F .672(xtensions of)
--.15 F(\214les to remo)144 708 Q .3 -.15(ve w)-.15 H
-(hen the .dvi, etc \214les are to be cleaned-up.).15 E 2.5(7M)281.835
-768 S(ay 2011)-2.5 E(13)199.835 E 0 Cg EP
-%%Page: 14 14
+357.6 Q(x\).)-.15 E F1($clean_full_ext [""])108 386.4 Q F0 .671(Extra e)
+144 398.4 R .672(xtensions of \214les for)-.15 F F2(late)3.172 E(xmk)-.2
+E F0 .672(to remo)3.172 F .972 -.15(ve w)-.15 H .672(hen the).15 F F1
+(-C)3.172 E F0 .672(option is selected, i.e., e)3.172 F .672
+(xtensions of)-.15 F(\214les to remo)144 410.4 Q .3 -.15(ve w)-.15 H
+(hen the .dvi, etc \214les are to be cleaned-up.).15 E
+(More general patterns are allo)144 434.4 Q(wed, as for)-.25 E F2
+($clean_e)2.5 E(xt)-.2 E F0(.)A F1
+($compiling_cmd [unde\214ned], $failur)108 463.2 Q
+(e_cmd [unde\214ned], $success_cmd [unde\214ned])-.18 E F0 .617(These v)
+144 487.2 R .617(ariables specify commands that are e)-.25 F -.15(xe)
+-.15 G .617(cuted at certain points of compilations during pre-).15 F
+(vie)144 499.2 Q 1.2(w-continuous mode.)-.25 F 1.201(One moti)6.2 F -.25
+(va)-.25 G 1.201(tion for their e).25 F 1.201(xistance is to allo)-.15 F
+3.701(wc)-.25 G(on)-3.701 E -.15(ve)-.4 G 1.201(nient visual indica-).15
+F .037(tions of compilation status e)144 511.2 R -.15(ve)-.25 G 2.537
+(nw).15 G .037(hen the windo)-2.537 F 2.537(wr)-.25 G(ecei)-2.537 E .036
+(ving the screen output of the compilation is)-.25 F(hidden.)144 523.2 Q
+.677(The commands are e)144 547.2 R -.15(xe)-.15 G .678
+(cuted at the follo).15 F .678
+(wing points: $compiling_cmd at the start of compilation,)-.25 F .042
+($success_cmd at the end of a successful compilation, and $f)144 559.2 R
+.042(ailure_cmd at the end of an unsuccess-)-.1 F 1.086
+(ful compilation.)144 571.2 R 1.086(If an)6.086 F 3.586(yo)-.15 G 3.586
+(fa)-3.586 G(bo)-3.586 E 1.387 -.15(ve v)-.15 H 1.087
+(ariables is unde\214ned \(the def)-.1 F 1.087
+(ault situation\) or blank, then the)-.1 F
+(corresponding command is not e)144 583.2 Q -.15(xe)-.15 G(cuted.).15 E
+(An e)144 607.2 Q(xample of a typical setting of these v)-.15 E
+(ariables is as follo)-.25 E(ws)-.25 E
+($compiling_cmd = "xdotool search --name \\"%D\\" set_windo)154 631.2 Q
+2.5(w-)-.25 G(-name \\"%D compiling\\"";)-2.5 E 5($success_cmd =)154
+643.2 R("xdotool search --name \\"%D\\" set_windo)2.5 E 2.5(w-)-.25 G
+(-name \\"%D OK\\"";)-2.5 E($f)154 655.2 Q 5(ailure_cmd =)-.1 F
+("xdotool search --name \\"%D\\" set_windo)2.5 E 2.5(w-)-.25 G
+(-name \\"%D F)-2.5 E(AILURE\\"";)-.74 E .406
+(These assume that the program)144 679.2 R F2(xdotool)2.906 E F0 .406
+(is installed, that the pre)2.906 F(vie)-.25 E .406(wer is using an X-W)
+-.25 F(indo)-.4 E 2.906(ws)-.25 G(ys-)-2.906 E .507(tem for display)144
+691.2 R 3.007(,a)-.65 G .507(nd that the title of the windo)-3.007 F
+3.007(wc)-.25 G .508
+(ontains the name of the displayed \214le, as it nor)-3.007 F(-)-.2 E
+.093(mally does.)144 703.2 R .093(When the commands are e)5.093 F -.15
+(xe)-.15 G .092
+(cuted, the placeholder string %D is replaced by the name).15 F .605
+(of the destination \214le, which is the pre)144 715.2 R(vie)-.25 E .605
+(wed \214le.)-.25 F .605(The abo)5.605 F .906 -.15(ve c)-.15 H .606
+(ommands result in an appropriate).15 F
+(string being appended to the \214lename in the windo)144 727.2 Q 2.5
+(wt)-.25 G(itle: " compiling", " OK", or " F)-2.5 E(AILURE".)-.74 E
+(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(17)185.545 E 0 Cg EP
+%%Page: 18 18
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF(@cus_dep_list [\(\)])108 84 Q
-F0(Custom dependenc)144 96 Q 2.5(yl)-.15 G
-(ist -- see section on "Custom Dependencies".)-2.5 E F1
-(@default_\214les [\("*.tex"\)])108 112.8 Q F0(Def)144 124.8 Q
-(ault list of \214les to be processed.)-.1 E(Normally)144 148.8 Q 2.842
-(,i)-.65 G 2.842(fn)-2.842 G 2.842<6f8c>-2.842 G .341
-(lenames are speci\214ed on the command line,)-2.842 F/F2 10
-/Times-Italic@0 SF(late)2.841 E(xmk)-.2 E F0 .341(processes all te)2.841
-F 2.841<788c>-.15 G .341(les speci-)-2.841 F .99(\214ed in the)144 160.8
+(TEXMK\(1L\))-1.11 E .107
+(Other placeholders that can be used are %S, %T)144 84 R 2.606(,a)-.74 G
+.106(nd %R, with %S and %T normally being identi-)-2.606 F .655(cal. Th\
+ese can be useful for a command changing the title of the edit windo)144
+96 R 1.956 -.65(w. T)-.25 H .656(he visual indica-).65 F .034
+(tion in a windo)144 108 R 2.533(wt)-.25 G .033
+(itle can useful, since the user does not ha)-2.533 F .333 -.15(ve t)-.2
+H 2.533(ok).15 G .033(eep shifting attention to the \(pos-)-2.633 F
+(sibly hidden\) compilation windo)144 120 Q 2.5(wt)-.25 G 2.5(ok)-2.5 G
+(no)-2.5 E 2.5(wt)-.25 G(he status of the compilation.)-2.5 E/F1 10
+/Times-Bold@0 SF(@cus_dep_list [\(\)])108 148.8 Q F0(Custom dependenc)
+144 160.8 Q 2.5(yl)-.15 G(ist -- see section on "Custom Dependencies".)
+-2.5 E F1(@default_\214les [\("*.tex"\)])108 189.6 Q F0(Def)144 201.6 Q
+(ault list of \214les to be processed.)-.1 E(Normally)144 225.6 Q 2.841
+(,i)-.65 G 2.841(fn)-2.841 G 2.841<6f8c>-2.841 G .341
+(lenames are speci\214ed on the command line,)-2.841 F/F2 10
+/Times-Italic@0 SF(late)2.841 E(xmk)-.2 E F0 .342(processes all te)2.842
+F 2.842<788c>-.15 G .342(les speci-)-2.842 F .99(\214ed in the)144 237.6
 R F2(@default_\214les)3.49 E F0 -.25(va)3.49 G .99(riable, which by def)
 .25 F .99(ault is set to all te)-.1 F 3.49<788c>-.15 G .99(les \("*.te)
--3.49 F .99(x"\) in the current)-.15 F(directory)144 172.8 Q 6.04(.T)
--.65 G 1.04(his is a con)-6.04 F -.15(ve)-.4 G 1.04(nience: just run).15
-F F2(late)3.539 E(xmk)-.2 E F0 1.039
+-3.49 F .99(x"\) in the current)-.15 F(directory)144 249.6 Q 6.039(.T)
+-.65 G 1.039(his is a con)-6.039 F -.15(ve)-.4 G 1.039(nience: just run)
+.15 F F2(late)3.539 E(xmk)-.2 E F0 1.04
 (and it will process an appropriate set of \214les.)3.539 F 2.207
-(But sometimes you w)144 184.8 R 2.207
+(But sometimes you w)144 261.6 R 2.207
 (ant only some of these \214les to be processed.)-.1 F 2.207
-(In this case you set the)7.207 F F2(@default_\214les)144 196.8 Q F0
-.691(in an initialization \214le \(e.g., the \214le "late)3.191 F .691
-(xmkrc" in the current directory\).)-.15 F .69(Then if)5.69 F .497(no \
-\214les are speci\214ed on the command line then the \214les you specif\
-y by setting)144 208.8 R F2(@default_\214les)2.997 E F0(are)2.997 E
-(processed.)144 220.8 Q(Three e)144 244.8 Q(xamples:)-.15 E(@def)156.5
-268.8 Q(ault_\214les = \("paper_current"\);)-.1 E(@def)156.5 292.8 Q
+(In this case you set the)7.207 F F2(@default_\214les)144 273.6 Q F0
+.691(in an initialization \214le \(e.g., the \214le "late)3.19 F .691
+(xmkrc" in the current directory\).)-.15 F .691(Then if)5.691 F .497(no\
+ \214les are speci\214ed on the command line then the \214les you speci\
+fy by setting)144 285.6 R F2(@default_\214les)2.996 E F0(are)2.996 E
+(processed.)144 297.6 Q(Three e)144 321.6 Q(xamples:)-.15 E(@def)156.5
+345.6 Q(ault_\214les = \("paper_current"\);)-.1 E(@def)156.5 369.6 Q
 (ault_\214les = \("paper1", "paper2.te)-.1 E(x"\);)-.15 E(@def)156.5
-316.8 Q(ault_\214les = \("*.te)-.1 E(x", "*.dtx"\);)-.15 E 1.336
-(Note that more than \214le may be gi)144 340.8 R -.15(ve)-.25 G 1.336
+393.6 Q(ault_\214les = \("*.te)-.1 E(x", "*.dtx"\);)-.15 E 1.336
+(Note that more than \214le may be gi)144 417.6 R -.15(ve)-.25 G 1.336
 (n, and that the def).15 F 1.336(ault e)-.1 F 1.336(xtension is ".te)
--.15 F 3.836(x". W)-.15 F 1.335(ild cards are)-.4 F(allo)144 352.8 Q
-3.148(wed. The)-.25 F .648(parentheses are because)3.148 F F2
-(@default_\214les)3.148 E F0 .649(is an array v)3.148 F .649
+-.15 F 3.836(x". W)-.15 F 1.336(ild cards are)-.4 F(allo)144 429.6 Q
+3.149(wed. The)-.25 F .649(parentheses are because)3.149 F F2
+(@default_\214les)3.149 E F0 .649(is an array v)3.149 F .648
 (ariable, i.e., a sequence of \214le-)-.25 F
-(name speci\214cations is possible.)144 364.8 Q F1($dependents_list [0])
-108 381.6 Q F0
+(name speci\214cations is possible.)144 441.6 Q F1
+($dependents_phony [0])108 458.4 Q F0 .78
+(If a list of dependencies is output, this v)144 470.4 R .78
+(ariable determines whether to include a phon)-.25 F 3.28(yt)-.15 G(ar)
+-3.28 E .78(get for)-.18 F .173(each source \214le.)144 482.4 R .173
+(If you use the dependents list in a Mak)5.173 F .173
+(e\214le, the dummy rules w)-.1 F .173(ork around errors)-.1 F(mak)144
+494.4 Q 2.5(eg)-.1 G -2.15 -.25(iv e)-2.5 H 2.5(si).25 G 2.5(fy)-2.5 G
+(ou remo)-2.5 E .3 -.15(ve h)-.15 H
+(eader \214les without updating the Mak).15 E(e\214le to match.)-.1 E F1
+($dependents_list [0])108 511.2 Q F0
 (Whether to display a list\(s\) of dependencies at the end of a run.)144
-393.6 Q F1($dvi_\214lter [empty])108 410.4 Q F0 .547
-(The dvi \214le \214lter to be run on the ne)144 422.4 R .547
+523.2 Q F1($dvi_\214lter [empty])108 540 Q F0 .547
+(The dvi \214le \214lter to be run on the ne)144 552 R .547
 (wly produced dvi \214le before other processing.)-.25 F(Equi)5.547 E
--.25(va)-.25 G .547(lent to).25 F(specifying the)144 434.4 Q F1(-dF)2.5
-E F0(option.)2.5 E F1($dvi_mode [See belo)108 451.2 Q 2.5(wf)-.1 G
-(or default])-2.75 E F0(If nonzero, generate a dvi v)144 463.2 Q
+-.25(va)-.25 G .548(lent to).25 F(specifying the)144 564 Q F1(-dF)2.5 E
+F0(option.)2.5 E F1($dvi_mode [See belo)108 580.8 Q 2.5(wf)-.1 G
+(or default])-2.75 E F0(If nonzero, generate a dvi v)144 592.8 Q
 (ersion of the document.)-.15 E(Equi)5 E -.25(va)-.25 G(lent to the).25
-E F1(-dvi)2.5 E F0(option.)2.5 E .184(The v)108 480 R .184
-(ariable $dvi_mode def)-.25 F .184(aults to 0, b)-.1 F .184(ut if no e)
--.2 F .185
-(xplicit requests are made for other types of \214le \(postscript,)-.15
-F .476(pdf\), then $dvi_mode will be set to 1.)108 492 R .476(In additi\
-on, if a request for a \214le for which a .dvi \214le is a prerequi-)
-5.476 F(site, then $dvi_mode will be set to 1.)108 504 Q F1($dvi_pr)108
-520.8 Q -.15(ev)-.18 G(iewer ["start xdvi %O %S" under UNIX]).15 E F0
-.935(The command to in)144 532.8 R -.2(vo)-.4 G 1.136 -.1(ke a d).2 H
-(vi-pre).1 E(vie)-.25 E(wer)-.25 E 5.936(.[)-.55 G(Def)-5.936 E .936
-(ault is "start" under MS-WINDO)-.1 F .936(WS; under more)-.35 F .855
-(recent v)144 544.8 R .855(ersions of W)-.15 F(indo)-.4 E .855
-(ws, this will cause to be run whate)-.25 F -.15(ve)-.25 G 3.354(rc).15
-G .854(ommand the system has associ-)-3.354 F(ated with .dvi \214les.])
-144 556.8 Q F1($dvi_pr)108 573.6 Q -.15(ev)-.18 G
+E F1(-dvi)2.5 E F0(option.)2.5 E .856(The v)144 616.8 R .856
+(ariable $dvi_mode def)-.25 F .856(aults to 0, b)-.1 F .855(ut if no e)
+-.2 F .855(xplicit requests are made for other types of \214le)-.15 F
+.844(\(postscript, pdf\), then $dvi_mode will be set to 1.)144 628.8 R
+.845(In addition, if a request for a \214le for which a)5.845 F
+(.dvi \214le is a prerequisite, then $dvi_mode will be set to 1.)144
+640.8 Q F1($dvi_pr)108 657.6 Q -.15(ev)-.18 G
+(iewer ["start xdvi %O %S" under UNIX]).15 E F0 .936(The command to in)
+144 669.6 R -.2(vo)-.4 G 1.136 -.1(ke a d).2 H(vi-pre).1 E(vie)-.25 E
+(wer)-.25 E 5.936(.[)-.55 G(Def)-5.936 E .936
+(ault is "start" under MS-WINDO)-.1 F .935(WS; under more)-.35 F .854
+(recent v)144 681.6 R .854(ersions of W)-.15 F(indo)-.4 E .855
+(ws, this will cause to be run whate)-.25 F -.15(ve)-.25 G 3.355(rc).15
+G .855(ommand the system has associ-)-3.355 F(ated with .dvi \214les.])
+144 693.6 Q F1 2.203(Important note)144 717.6 R F0 4.703(:N)C 2.202
+(ormally you will w)-4.703 F 2.202(ant to ha)-.1 F 2.502 -.15(ve a p)-.2
+H(re).15 E(vie)-.25 E 2.202(wer run detached, so that)-.25 F F2(late)
+4.702 E(xmk)-.2 E F0(doesn')144 729.6 Q 3.51(tw)-.18 G 1.01
+(ait for the pre)-3.61 F(vie)-.25 E 1.011
+(wer to terminate before continuing its w)-.25 F 3.511(ork. So)-.1 F
+1.011(normally you should)3.511 F(11 No)267.545 768 Q -.15(ve)-.15 G
+(mber 2012).15 E(18)185.545 E 0 Cg EP
+%%Page: 19 19
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E .619
+(pre\214x the command by "start ", which \215ags to)144 84 R/F1 10
+/Times-Italic@0 SF(late)3.119 E(xmk)-.2 E F0 .619
+(that it should do the detaching of the pre-)3.119 F(vie)144 96 Q .621
+(wer itself \(by whate)-.25 F -.15(ve)-.25 G 3.121(rm).15 G .622
+(ethod is appropriate to the operating system\).)-3.121 F .622
+(But sometimes letting)5.622 F F1(late)144 108 Q(xmk)-.2 E F0 .163
+(do the detaching is not appropriate \(for a v)2.663 F .162
+(ariety of non-tri)-.25 F .162(vial reasons\), so you should put)-.25 F
+(the "start " bit in yourself, whene)144 120 Q -.15(ve)-.25 G 2.5(ri).15
+G 2.5(ti)-2.5 G 2.5(sn)-2.5 G(eeded.)-2.5 E/F2 10/Times-Bold@0 SF
+($dvi_pr)108 148.8 Q -.15(ev)-.18 G
 (iewer_landscape ["start xdvi %O %S"]).15 E F0 .816(The command to in)
-144 585.6 R -.2(vo)-.4 G 1.016 -.1(ke a d).2 H(vi-pre).1 E(vie)-.25 E
+144 160.8 R -.2(vo)-.4 G 1.016 -.1(ke a d).2 H(vi-pre).1 E(vie)-.25 E
 .816(wer in landscape mode.)-.25 F([Def)5.816 E .816
-(ault is "start" under MS-WIN-)-.1 F(DO)144 597.6 Q .434
+(ault is "start" under MS-WIN-)-.1 F(DO)144 172.8 Q .434
 (WS; under more recent v)-.35 F .434(ersions of W)-.15 F(indo)-.4 E .434
 (ws, this will cause to be run whate)-.25 F -.15(ve)-.25 G 2.934(rc).15
 G .434(ommand the)-2.934 F(system has associated with .dvi \214les.])144
-609.6 Q F1($dvipdf ["dvipdf %O %S %D"])108 626.4 Q F0 .586
-(Command to con)144 638.4 R -.15(ve)-.4 G .586(rt dvi to pdf \214le.).15
+184.8 Q F2($dvipdf ["dvipdf %O %S %D"])108 201.6 Q F0 .586
+(Command to con)144 213.6 R -.15(ve)-.4 G .586(rt dvi to pdf \214le.).15
 F 3.086(Ac)5.586 G .586
 (ommon recon\214guration is to use the dvipdfm command,)-3.086 F
-(which needs its ar)144 650.4 Q(guments in a dif)-.18 E(ferent order:)
--.25 E($dvipdf = "dvipdfm %O -o %D %S";)156.5 674.4 Q -1.2(WA)144 698.4
+(which needs its ar)144 225.6 Q(guments in a dif)-.18 E(ferent order:)
+-.25 E($dvipdf = "dvipdfm %O -o %D %S";)156.5 249.6 Q -1.2(WA)144 273.6
 S .307(RNING: The def)1.2 F .306(ault dvipdf script generates pdf \214l\
 es with bitmapped fonts, which do not look)-.1 F .359(good when vie)144
-710.4 R .359(wed by acroread.)-.25 F .359
+285.6 R .359(wed by acroread.)-.25 F .359
 (That script should be modi\214ed to gi)5.359 F .66 -.15(ve d)-.25 H .36
 (vips the options "-P pdf").15 F
-(to ensure that type 1 fonts are used in the pdf \214le.)144 722.4 Q 2.5
-(7M)281.835 768 S(ay 2011)-2.5 E(14)199.835 E 0 Cg EP
-%%Page: 15 15
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF($dvips ["dvips %O -o %D %S"])
-108 84 Q F0 .78(The program to used as a \214lter to con)144 96 R -.15
-(ve)-.4 G .78(rt a .dvi \214le to a .ps \214le.).15 F .78
+(to ensure that type 1 fonts are used in the pdf \214le.)144 297.6 Q F2
+($dvipdf_silent_switch ["-q"])108 314.4 Q F0
+(Switch\(es\) for dvipdf program when silent mode is on.)144 326.4 Q
+.967(N.B. The standard dvipdf program runs silently)144 350.4 R 3.467
+(,s)-.65 G 3.467(oa)-3.467 G .967(dding the silent switch has no ef)
+-3.467 F .966(fect, b)-.25 F .966(ut is)-.2 F 1.035(actually innocuous.)
+144 362.4 R 1.035(But if an alternati)6.035 F 1.335 -.15(ve p)-.25 H
+1.035(rogram is used, e.g., dvipdfmx, then the silent switch).15 F
+(has an ef)144 374.4 Q 2.5(fect. The)-.25 F(def)2.5 E
+(ault setting is correct for dvipdfm and dvipdfmx.)-.1 E F2
+($dvips ["dvips %O -o %D %S"])108 391.2 Q F0 .78
+(The program to used as a \214lter to con)144 403.2 R -.15(ve)-.4 G .78
+(rt a .dvi \214le to a .ps \214le.).15 F .78
 (If pdf is going to be generated)5.78 F .679(from pdf, then the v)144
-108 R .679(alue of the $dvips_pdf_switch -- see belo)-.25 F 3.18(w-)-.25
-G 3.18(-w)-3.18 G .68(ill be included in the options)-3.18 F
-(substituted for "%O".)144 120 Q F1
-($dvips_landscape ["dvips -tlandscape %O -o %D %S"])108 136.8 Q F0
-(The program to used as a \214lter to con)144 148.8 Q -.15(ve)-.4 G
-(rt a .dvi \214le to a .ps \214le in landscape mode.).15 E F1
-($dvips_pdf_switch ["-P pdf"])108 165.6 Q F0(Switch\(es\) for dvips pro\
-gram when pdf \214le is to be generated from ps \214le.)144 177.6 Q F1
-($dvips_silent_switch ["-q"])108 194.4 Q F0
-(Switch\(es\) for dvips program when silent mode is on.)144 206.4 Q F1
-($dvi_update_command [""])108 223.2 Q F0 .78(When the dvi pre)144 235.2
+415.2 R .679(alue of the $dvips_pdf_switch -- see belo)-.25 F 3.18(w-)
+-.25 G 3.18(-w)-3.18 G .68(ill be included in the options)-3.18 F
+(substituted for "%O".)144 427.2 Q F2
+($dvips_landscape ["dvips -tlandscape %O -o %D %S"])108 444 Q F0
+(The program to used as a \214lter to con)144 456 Q -.15(ve)-.4 G
+(rt a .dvi \214le to a .ps \214le in landscape mode.).15 E F2
+($dvips_pdf_switch ["-P pdf"])108 472.8 Q F0(Switch\(es\) for dvips pro\
+gram when pdf \214le is to be generated from ps \214le.)144 484.8 Q F2
+($dvips_silent_switch ["-q"])108 501.6 Q F0
+(Switch\(es\) for dvips program when silent mode is on.)144 513.6 Q F2
+($dvi_update_command [""])108 530.4 Q F0 .78(When the dvi pre)144 542.4
 R(vie)-.25 E .78(wer is set to be updated by running a command, this is\
- the command that is)-.25 F 4.022(run. See)144 247.2 R 1.522
-(the information for the v)4.022 F(ariable)-.25 E/F2 10/Times-Italic@0
-SF($dvi_update_method)4.023 E F0 1.523(for further information, and see)
-4.023 F .9(information on the v)144 259.2 R(ariable)-.25 E F2
-($pdf_update_method)3.4 E F0 .899(for an e)3.399 F .899
-(xample for the analogous case of a pdf)-.15 F(pre)144 271.2 Q(vie)-.25
-E(wer)-.25 E(.)-.55 E F1($dvi_update_method [2 under UNIX, 1 under MS-W)
-108 288 Q(indo)-.18 E(ws])-.1 E F0(Ho)144 300 Q 4.036(wt)-.25 G 1.536
-(he dvi vie)-4.036 F 1.537
+ the command that is)-.25 F 4.022(run. See)144 554.4 R 1.522
+(the information for the v)4.022 F(ariable)-.25 E F1($dvi_update_method)
+4.023 E F0 1.523(for further information, and see)4.023 F .9
+(information on the v)144 566.4 R(ariable)-.25 E F1($pdf_update_method)
+3.4 E F0 .899(for an e)3.399 F .899
+(xample for the analogous case of a pdf)-.15 F(pre)144 578.4 Q(vie)-.25
+E(wer)-.25 E(.)-.55 E F2($dvi_update_method [2 under UNIX, 1 under MS-W)
+108 595.2 Q(indo)-.18 E(ws])-.1 E F0(Ho)144 607.2 Q 4.036(wt)-.25 G
+1.536(he dvi vie)-4.036 F 1.537
 (wer updates its display when the dvi \214le has changed.)-.25 F 1.537
-(The v)6.537 F 1.537(alues here apply)-.25 F(equally to the)144 312 Q F2
-($pdf_update_method)2.5 E F0(and to the)2.5 E F2($ps_update_method)2.5 E
-F0 -.25(va)2.5 G(riables.).25 E 2.5(0=)154 324 S 2.5(>u)-2.5 G
-(pdate is automatic,)-2.5 E 1.102(1=> manual update by user)154 336 R
+(The v)6.537 F 1.537(alues here apply)-.25 F(equally to the)144 619.2 Q
+F1($pdf_update_method)2.5 E F0(and to the)2.5 E F1($ps_update_method)2.5
+E F0 -.25(va)2.5 G(riables.).25 E 2.5(0=)154 631.2 S 2.5(>u)-2.5 G
+(pdate is automatic,)-2.5 E 1.102(1=> manual update by user)154 643.2 R
 3.601(,w)-.4 G 1.101(hich may only mean a mouse click on the vie)-3.601
 F(wer')-.25 E 3.601(sw)-.55 G(indo)-3.601 E 3.601(wo)-.25 G(r)-3.601 E
-(may mean a more serious action.)144 348 Q 3.418(2=)154 360 S 3.418(>S)
--3.418 G .918(end the signal, whose number is in the v)-3.418 F(ariable)
--.25 E F2($dvi_update_signal)3.419 E F0 5.919(.T)C .919(he def)-5.919 F
-.919(ault v)-.1 F(alue)-.25 E(under UNIX is suitable for xdvi.)144 372 Q
-3.295(3=)154 384 S 3.295(>V)-3.295 G(ie)-3.895 E .795(wer cannot do an \
-update, because it locks the \214le. \(As with acroread under MS-W)-.25
-F(in-)-.4 E(do)144 396 Q(ws.\))-.25 E 6.63(4=)154 408 S 6.63(>r)-6.63 G
-4.13(un a command to do the update.)-6.63 F 4.131
-(The command is speci\214ed by the v)9.131 F(ariable)-.25 E F2
-($dvi_update_command)144 420 Q F0(.)A(See information on the v)144 444 Q
-(ariable)-.25 E F2($pdf_update_method)2.5 E F0(for an e)2.5 E
-(xample of updating by command.)-.15 E F1
+(may mean a more serious action.)144 655.2 Q 3.418(2=)154 667.2 S 3.418
+(>S)-3.418 G .918(end the signal, whose number is in the v)-3.418 F
+(ariable)-.25 E F1($dvi_update_signal)3.419 E F0 5.919(.T)C .919(he def)
+-5.919 F .919(ault v)-.1 F(alue)-.25 E(under UNIX is suitable for xdvi.)
+144 679.2 Q 3.295(3=)154 691.2 S 3.295(>V)-3.295 G(ie)-3.895 E .795(wer\
+ cannot do an update, because it locks the \214le. \(As with acroread u\
+nder MS-W)-.25 F(in-)-.4 E(do)144 703.2 Q(ws.\))-.25 E 6.63(4=)154 715.2
+S 6.63(>r)-6.63 G 4.13(un a command to do the update.)-6.63 F 4.131
+(The command is speci\214ed by the v)9.131 F(ariable)-.25 E F1
+($dvi_update_command)144 727.2 Q F0(.)A(11 No)267.545 768 Q -.15(ve)-.15
+G(mber 2012).15 E(19)185.545 E 0 Cg EP
+%%Page: 20 20
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E(See information on the v)144 84 Q(ariable)-.25 E/F1
+10/Times-Italic@0 SF($pdf_update_method)2.5 E F0(for an e)2.5 E
+(xample of updating by command.)-.15 E/F2 10/Times-Bold@0 SF
 ($dvi_update_signal [Under UNIX: SIGUSR1, which is a system-dependent v)
-108 460.8 Q(alue])-.1 E F0 .049
-(The number of the signal that is sent to the dvi vie)144 472.8 R .048
+108 100.8 Q(alue])-.1 E F0 .049
+(The number of the signal that is sent to the dvi vie)144 112.8 R .048
 (wer when it is updated by sending a signal -- see)-.25 F .449
-(the information on the v)144 484.8 R(ariable)-.25 E F2
+(the information on the v)144 124.8 R(ariable)-.25 E F1
 ($dvi_update_method)2.949 E F0 5.449(.T)C .449(he def)-5.449 F .449
 (ault v)-.1 F .45(alue is the one appropriate for)-.25 F
-(xdvi on a UNIX system.)144 496.8 Q F1($fdb_ext ["fdb_latexmk"])108
-513.6 Q F0 .707(The e)144 525.6 R .707(xtension of the \214le which)-.15
-F F2(late)3.207 E(xmk)-.2 E F0 .706
+(xdvi on a UNIX system.)144 136.8 Q F2($failur)108 153.6 Q
+(e_cmd [unde\214ned])-.18 E F0
+(See the documentation for $compiling_cmd.)144 165.6 Q F2
+($fdb_ext ["fdb_latexmk"])108 182.4 Q F0 .707(The e)144 194.4 R .707
+(xtension of the \214le which)-.15 F F1(late)3.207 E(xmk)-.2 E F0 .706
 (generates to contain a database of information on source)3.207 F 2.5
-(\214les. Y)144 537.6 R(ou will not normally need to change this.)-1.1 E
-F1($f)108 554.4 Q(or)-.25 E(ce_mode [0])-.18 E F0 1.052
-(If nonzero, continue processing past minor)144 566.4 R F2(late)3.553 E
+(\214les. Y)144 206.4 R(ou will not normally need to change this.)-1.1 E
+F2($f)108 223.2 Q(or)-.25 E(ce_mode [0])-.18 E F0 1.052
+(If nonzero, continue processing past minor)144 235.2 R F1(late)3.553 E
 (x)-.2 E F0 1.053(errors including unrecognized cross references.)3.553
-F(Equi)144 578.4 Q -.25(va)-.25 G(lent to specifying the).25 E F1(-f)2.5
-E F0(option.)2.5 E F1(@generated_exts [\( aux , b)108 595.2 Q
+F(Equi)144 247.2 Q -.25(va)-.25 G(lent to specifying the).25 E F2(-f)2.5
+E F0(option.)2.5 E F2(@generated_exts [\( aux , b)108 264 Q
 (bl , idx , ind , lof , lot , out , toc , $fdb_ext \)])-.1 E F0 .448
-(This contains a list of e)144 607.2 R .447
+(This contains a list of e)144 276 R .447
 (xtensions for \214les that are generated during a LaT)-.15 F .447
-(eX run and that are read)-.7 F(in by LaT)144 619.2 Q
+(eX run and that are read)-.7 F(in by LaT)144 288 Q
 (eX in later runs, either directly or indirectly)-.7 E(.)-.65 E .451
-(This list has tw)144 643.2 R 2.951(ou)-.1 G .451(ses: \(a\) to set the\
- kinds of \214le to be deleted in a cleanup operation \(with the)-2.951
-F F1(-c)2.952 E F0(,)A F1(-C)144 655.2 Q F0(,)A F1(-CA)3.586 E F0(,)A F1
-(-g)3.586 E F0(and)3.586 E F1(-gg)3.586 E F0 1.086(options\), and \(b\)\
- in the determination of whether a rerun of \(pdf\)LaT)3.586 F 1.085
-(eX is)-.7 F(needed after a run that gi)144 667.2 Q -.15(ve)-.25 G 2.5
-(sa).15 G 2.5(ne)-2.5 G(rror)-2.5 E(.)-.55 E(\(Normally)144 691.2 Q
-2.698(,ac)-.65 G .198(hange of a source \214le during a run should pro)
--2.698 F -.2(vo)-.15 G .398 -.1(ke a r).2 H 2.699(erun. This).1 F .199
-(includes a \214le gen-)2.699 F .13(erated by LaT)144 703.2 R .13
+(This list has tw)144 312 R 2.951(ou)-.1 G .451(ses: \(a\) to set the k\
+inds of \214le to be deleted in a cleanup operation \(with the)-2.951 F
+F2(-c)2.952 E F0(,)A F2(-C)144 324 Q F0(,)A F2(-CA)3.586 E F0(,)A F2(-g)
+3.586 E F0(and)3.586 E F2(-gg)3.586 E F0 1.086(options\), and \(b\) in \
+the determination of whether a rerun of \(pdf\)LaT)3.586 F 1.085(eX is)
+-.7 F(needed after a run that gi)144 336 Q -.15(ve)-.25 G 2.5(sa).15 G
+2.5(ne)-2.5 G(rror)-2.5 E(.)-.55 E(\(Normally)144 360 Q 2.698(,ac)-.65 G
+.198(hange of a source \214le during a run should pro)-2.698 F -.2(vo)
+-.15 G .398 -.1(ke a r).2 H 2.699(erun. This).1 F .199
+(includes a \214le gen-)2.699 F .13(erated by LaT)144 372 R .13
 (eX, e.g., an aux \214le, that is read in on subsequent runs.)-.7 F .13
-(But after a run that results in)5.13 F .739(an error)144 715.2 R 3.239
+(But after a run that results in)5.13 F .739(an error)144 384 R 3.239
 (,an)-.4 G 1.239 -.25(ew r)-3.239 H .739
 (un should occur until the user has made a change in the \214les.).25 F
-.739(But the user may)5.739 F(ha)144 727.2 Q .94 -.15(ve c)-.2 H .64
+.739(But the user may)5.739 F(ha)144 396 Q .94 -.15(ve c)-.2 H .64
 (orrected an error in a source .te).15 F 3.139<788c>-.15 G .639
-(le during the run.)-3.139 F(So)5.639 E F2(late)3.139 E(xmk)-.2 E F0
-.639(needs to distinguish user)3.139 F(-)-.2 E 2.5(7M)281.835 768 S
-(ay 2011)-2.5 E(15)199.835 E 0 Cg EP
-%%Page: 16 16
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E 2.042(generated and automatically generated \214le\
-s; it determines the automatically generated \214les as)144 84 R
-(those with e)144 96 Q(xtensions in the list in @generated_e)-.15 E
-(xts.\))-.15 E 2.534(Ac)144 120 S(on)-2.534 E -.15(ve)-.4 G .034
-(nient w).15 F .034(ay to add an e)-.1 F .033(xtra e)-.15 F .033
+(le during the run.)-3.139 F(So)5.639 E F1(late)3.139 E(xmk)-.2 E F0
+.639(needs to distinguish user)3.139 F(-)-.2 E 2.042(generated and auto\
+matically generated \214les; it determines the automatically generated \
+\214les as)144 408 R(those with e)144 420 Q
+(xtensions in the list in @generated_e)-.15 E(xts.\))-.15 E 2.534(Ac)144
+444 S(on)-2.534 E -.15(ve)-.4 G .034(nient w).15 F .034(ay to add an e)
+-.1 F .033(xtra e)-.15 F .033
 (xtension to the list, without losing the already de\214ned ones is to)
--.15 F(use a push command in the line in an RC \214le.)144 132 Q(E.g.,)5
-E(push @generated_e)184 156 Q(xts, "end";)-.15 E .278(adds the e)144 180
+-.15 F(use a push command in the line in an RC \214le.)144 456 Q(E.g.,)5
+E(push @generated_e)184 480 Q(xts, "end";)-.15 E .278(adds the e)144 504
 R .278(xtension "end" to the list of prede\214ned generated e)-.15 F
 2.778(xtensions. \(This)-.15 F -.15(ex)2.778 G .278(tension is used by)
-.15 F(the Re)144 192 Q(vT)-.25 E(eX package, for e)-.7 E(xample.\))-.15
-E/F1 10/Times-Bold@0 SF($go_mode [0])108 208.8 Q F0
-(If nonzero, process \214les re)144 220.8 Q -.05(ga)-.15 G
-(rdless of timestamps, and is then equi).05 E -.25(va)-.25 G
-(lent to the).25 E F1(-g)2.5 E F0(option.)2.5 E F1(%hash_calc_ignor)108
-237.6 Q(e_patter)-.18 E(n)-.15 E(!!!This v)144 249.6 Q(ariable is f)-.1
-E(or experts only!!!)-.25 E F0 .036(The general rule)144 273.6 R/F2 10
-/Times-Italic@0 SF(late)2.536 E(xmk)-.2 E F0 .036
+.15 F(the Re)144 516 Q(vT)-.25 E(eX package, for e)-.7 E(xample.\))-.15
+E F2($go_mode [0])108 532.8 Q F0(If nonzero, process \214les re)144
+544.8 Q -.05(ga)-.15 G(rdless of timestamps, and is then equi).05 E -.25
+(va)-.25 G(lent to the).25 E F2(-g)2.5 E F0(option.)2.5 E F2
+(%hash_calc_ignor)108 561.6 Q(e_patter)-.18 E(n)-.15 E(!!!This v)144
+573.6 Q(ariable is f)-.1 E(or experts only!!!)-.25 E F0 .036
+(The general rule)144 597.6 R F1(late)2.536 E(xmk)-.2 E F0 .036
 (uses for determining when an e)2.536 F .036
 (xtra run of some program is needed is that)-.15 F 1.615
-(one of the source \214les has changed.)144 285.6 R 1.615
+(one of the source \214les has changed.)144 609.6 R 1.615
 (But consider for e)6.615 F 1.615(xample a late)-.15 F 4.115(xp)-.15 G
 1.615(ackage that causes an)-4.115 F .18(encapsulated postscript \214le\
  \(an "eps" \214le\) to be made that is to be read in on the ne)144
-297.6 R .18(xt run.)-.15 F .18(The \214le)5.18 F .227
-(contains a comment line gi)144 309.6 R .228
+621.6 R .18(xt run.)-.15 F .18(The \214le)5.18 F .227
+(contains a comment line gi)144 633.6 R .228
 (ving its creation date and time.)-.25 F .228(On the ne)5.228 F .228
-(xt run the time changes,)-.15 F F2(late)2.728 E(x)-.2 E F0 .644
+(xt run the time changes,)-.15 F F1(late)2.728 E(x)-.2 E F0 .644
 (sees that the eps \214le has changed, and therefore reruns late)144
-321.6 R 3.143(x. This)-.15 F .643(causes an in\214nite loop, that is)
-3.143 F .809(only terminated becaues)144 333.6 R F2(late)3.309 E(xmk)-.2
+645.6 R 3.143(x. This)-.15 F .643(causes an in\214nite loop, that is)
+3.143 F .809(only terminated becaues)144 657.6 R F1(late)3.309 E(xmk)-.2
 E F0 .809(has a limit on the number of runs to guard ag)3.309 F .81
-(ainst pathological)-.05 F(situations.)144 345.6 Q .138
-(But the changing line has no real ef)144 369.6 R .137
+(ainst pathological)-.05 F(situations.)144 669.6 Q .138
+(But the changing line has no real ef)144 693.6 R .137
 (fect, since it is a comment.)-.25 F -1.1(Yo)5.137 G 2.637(uc)1.1 G .137
-(an instruct)-2.637 F F2(late)2.637 E(x)-.2 E F0 .137(to ignore the)
-2.637 F(of)144 381.6 Q(fending line as follo)-.25 E(ws:)-.25 E
-($hash_calc_ignore_pattern{'eps'} = '^%%CreationDate: ';)151.5 405.6 Q
-.59(This creates a rule for \214les with e)144 429.6 R(xtension)-.15 E
-F2(.eps)3.09 E F0 .59(about lines to ignore.)3.09 F .59
-(The left-hand side is a)5.59 F F2 -.8(Pe)3.09 G(rl).8 E F0 .313
-(idiom for setting an item in a hash.)144 441.6 R .312
-(Note that the \214le e)5.312 F .312
+(an instruct)-2.637 F F1(late)2.637 E(x)-.2 E F0 .137(to ignore the)
+2.637 F(of)144 705.6 Q(fending line as follo)-.25 E(ws:)-.25 E
+($hash_calc_ignore_pattern{'eps'} = '^%%CreationDate: ';)151.5 729.6 Q
+(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(20)185.545 E 0 Cg EP
+%%Page: 21 21
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E .59(This creates a rule for \214les with e)144 84 R
+(xtension)-.15 E/F1 10/Times-Italic@0 SF(.eps)3.09 E F0 .59
+(about lines to ignore.)3.09 F .59(The left-hand side is a)5.59 F F1 -.8
+(Pe)3.09 G(rl).8 E F0 .313(idiom for setting an item in a hash.)144 96 R
+.312(Note that the \214le e)5.312 F .312
 (xtension is speci\214ed without a period.)-.15 F(The)5.312 E -.25(va)
-144 453.6 S .511
-(lue, on the right-hand side, is a string containing a re).25 F .512
-(gular e)-.15 F 3.012(xpresssion. \(See)-.15 F .512(documentation on)
-3.012 F F2 -.8(Pe)144 465.6 S(rl).8 E F0 .636(for ho)3.136 F 3.136(wt)
--.25 G(he)-3.136 E 3.136(ya)-.15 G .635
+144 108 S .511(lue, on the right-hand side, is a string containing a re)
+.25 F .512(gular e)-.15 F 3.012(xpresssion. \(See)-.15 F .512
+(documentation on)3.012 F F1 -.8(Pe)144 120 S(rl).8 E F0 .636(for ho)
+3.136 F 3.136(wt)-.25 G(he)-3.136 E 3.136(ya)-.15 G .635
 (re to be speci\214ed in general.\))-3.136 F .635(This particular re)
 5.635 F .635(gular e)-.15 F .635(xpression speci\214es that)-.15 F .285
-(lines be)144 477.6 R .285(ginning with "%%CreationDate: " are to be ig\
-nored in deciding whether a \214le of the gi)-.15 F -.15(ve)-.25 G(n).15
-E -.15(ex)144 489.6 S(tension).15 E F2(.eps)2.5 E F0(has changed.)2.5 E
-.195(There is only one re)144 513.6 R .195(gular e)-.15 F .195
-(xpression a)-.15 F -.25(va)-.2 G .194(ilable for each e).25 F 2.694
-(xtension. If)-.15 F .194(you need more one pattern to)2.694 F 1.368(sp\
-ecify lines to ignore, then you need to combine the patterns into a sin\
-gle re)144 525.6 R 1.368(gular e)-.15 F(xpression.)-.15 E .067
-(The simplest method is separate the dif)144 537.6 R .066
+(lines be)144 132 R .285(ginning with "%%CreationDate: " are to be igno\
+red in deciding whether a \214le of the gi)-.15 F -.15(ve)-.25 G(n).15 E
+-.15(ex)144 144 S(tension).15 E F1(.eps)2.5 E F0(has changed.)2.5 E .195
+(There is only one re)144 168 R .195(gular e)-.15 F .195(xpression a)
+-.15 F -.25(va)-.2 G .194(ilable for each e).25 F 2.694(xtension. If)
+-.15 F .194(you need more one pattern to)2.694 F 1.368(specify lines to\
+ ignore, then you need to combine the patterns into a single re)144 180
+R 1.368(gular e)-.15 F(xpression.)-.15 E .067
+(The simplest method is separate the dif)144 192 R .066
 (ferent simple patterns by a v)-.25 F .066
 (ertical bar character \(indicating)-.15 F("alternation" in the jar)144
-549.6 Q(gon of re)-.18 E(gular e)-.15 E 2.5(xpressions\). F)-.15 F(or e)
+204 Q(gon of re)-.18 E(gular e)-.15 E 2.5(xpressions\). F)-.15 F(or e)
 -.15 E(xample,)-.15 E
-($hash_calc_ignore_pattern{'eps'} = '^%%CreationDate: |^%%T)151.5 573.6
-Q(itle: ';)-.35 E
-(causes lines starting with either "^%%CreationDate: " or "^%%T)144
-597.6 Q(itle: " to be ignored.)-.35 E .487
+($hash_calc_ignore_pattern{'eps'} = '^%%CreationDate: |^%%T)151.5 228 Q
+(itle: ';)-.35 E
+(causes lines starting with either "^%%CreationDate: " or "^%%T)144 252
+Q(itle: " to be ignored.)-.35 E .487
 (It may happen that a pattern to be ignored is speci\214ed in, for e)144
-621.6 R .488(xample, in a system or user initial-)-.15 F .302
-(ization \214le, and you wish to remo)144 633.6 R .602 -.15(ve t)-.15 H
+276 R .488(xample, in a system or user initial-)-.15 F .302
+(ization \214le, and you wish to remo)144 288 R .602 -.15(ve t)-.15 H
 .302(his in a \214le read later).15 F 5.301(.T)-.55 G 2.801(od)-6.101 G
 2.801(ot)-2.801 G .301(his, you use perl')-2.801 F 2.801(sd)-.55 G .301
-(elete func-)-2.801 F(tion, e.g.,)144 645.6 Q
-(delete $hash_calc_ignore_pattern{'eps'};)154 669.6 Q F1
-($kpsewhich ["kpsewhich %S"])108 698.4 Q F0 .637(The program called to \
-locate a source \214le when the name alone is not suf)144 710.4 R 3.138
-(\214cient. Most)-.25 F(\214lenames)3.138 E 1.474(used by)144 722.4 R F2
-(late)3.973 E(xmk)-.2 E F0(ha)3.973 E 1.773 -.15(ve s)-.2 H(uf).15 E
+(elete func-)-2.801 F(tion, e.g.,)144 300 Q
+(delete $hash_calc_ignore_pattern{'eps'};)154 324 Q/F2 10/Times-Bold@0
+SF($kpsewhich ["kpsewhich %S"])108 352.8 Q F0 .637(The program called t\
+o locate a source \214le when the name alone is not suf)144 364.8 R
+3.138(\214cient. Most)-.25 F(\214lenames)3.138 E 1.474(used by)144 376.8
+R F1(late)3.973 E(xmk)-.2 E F0(ha)3.973 E 1.773 -.15(ve s)-.2 H(uf).15 E
 1.473(\214cient path information to be found directly)-.25 F 6.473(.B)
--.65 G 1.473(ut sometimes, notably)-6.473 F 2.5(7M)281.835 768 S
-(ay 2011)-2.5 E(16)199.835 E 0 Cg EP
-%%Page: 17 17
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E .353
-(when .bib \214les are found from the log \214le of a bibte)144 84 R
+-.65 G 1.473(ut sometimes, notably)-6.473 F .353
+(when .bib \214les are found from the log \214le of a bibte)144 388.8 R
 2.854(xo)-.15 G 2.854(rb)-2.854 G .354
 (iber run, the name of the \214le, b)-2.854 F .354(ut not its)-.2 F
-(path is kno)144 96 Q 2.5(wn. The)-.25 F(program speci\214ed by $kpse)
-2.5 E(which is used to \214nd it.)-.25 E .42(See also the)144 120 R/F1
-10/Times-Italic@0 SF(@BIBINPUTS)2.92 E F0 -.25(va)2.92 G .42
+(path is kno)144 400.8 Q 2.5(wn. The)-.25 F
+(program speci\214ed by $kpse)2.5 E(which is used to \214nd it.)-.25 E
+.42(See also the)144 424.8 R F1(@BIBINPUTS)2.92 E F0 -.25(va)2.92 G .42
 (riable for another w).25 F .419(ay that)-.1 F F1(late)2.919 E(xmk)-.2 E
 F0 .419(also uses to try to locate \214les; it)2.919 F
-(applies only in the case of .bib \214les.)144 132 Q/F2 10/Times-Bold@0
-SF($landscape_mode [0])108 148.8 Q F0 .086
+(applies only in the case of .bib \214les.)144 436.8 Q F2
+($landscape_mode [0])108 453.6 Q F0 .086
 (If nonzero, run in landscape mode, using the landscape mode pre)144
-160.8 R(vie)-.25 E .087(wers and dvi to postscript con-)-.25 F -.15(ve)
-144 172.8 S 2.5(rters. Equi).15 F -.25(va)-.25 G(lent to the).25 E F2
+465.6 R(vie)-.25 E .087(wers and dvi to postscript con-)-.25 F -.15(ve)
+144 477.6 S 2.5(rters. Equi).15 F -.25(va)-.25 G(lent to the).25 E F2
 (-l)2.5 E F0 2.5(option. Normally)2.5 F(not needed with current pre)2.5
-E(vie)-.25 E(wers.)-.25 E F2($latex ["latex %O %S"])108 189.6 Q F0 .728
-(The LaT)144 201.6 R .728(eX processing program.)-.7 F .727
+E(vie)-.25 E(wers.)-.25 E F2($latex ["latex %O %S"])108 494.4 Q F0 .728
+(The LaT)144 506.4 R .728(eX processing program.)-.7 F .727
 (Note that as with other programs, you can use this v)5.728 F .727
 (ariable not)-.25 F(just to change the name of the program used, b)144
-213.6 Q(ut also specify options to the program.)-.2 E(E.g.,)5 E($late)
-288 237.6 Q 2.5(x=")-.15 G(late)-2.5 E 2.5(x-)-.15 G(-src-specials";)
--2.5 E F2(%latex_input_extensions)108 254.4 Q F0 .664(This v)144 266.4 R
+518.4 Q(ut also specify options to the program.)-.2 E(E.g.,)5 E($late)
+288 542.4 Q 2.5(x=")-.15 G(late)-2.5 E 2.5(x-)-.15 G(-src-specials";)
+-2.5 E F2(%latex_input_extensions)108 559.2 Q F0 .664(This v)144 571.2 R
 .664(ariable speci\214es the e)-.25 F .664(xtensions tried by late)-.15
 F .664(xmk when it \214nds that a LaT)-.15 F .665(eX run resulted in)-.7
 F .845(an error that a \214le has not been found, and the \214le is gi)
-144 278.4 R -.15(ve)-.25 G 3.344(nw).15 G .844(ithout an e)-3.344 F
+144 583.2 R -.15(ve)-.25 G 3.344(nw).15 G .844(ithout an e)-3.344 F
 3.344(xtension. This)-.15 F(typically)3.344 E 1.256(happens when LaT)144
-290.4 R 1.256(eX commands of the form \\input{\214le} or \\include)-.7 F
-1.257(graphics{\214gure}, when the)-.15 F(rele)144 302.4 Q -.25(va)-.25
+595.2 R 1.256(eX commands of the form \\input{\214le} or \\include)-.7 F
+1.257(graphics{\214gure}, when the)-.15 F(rele)144 607.2 Q -.25(va)-.25
 G(nt source \214le does not e).25 E(xist.)-.15 E 2.487
-(In this situation, late)144 326.4 R 2.486
+(In this situation, late)144 631.2 R 2.486
 (xmk searches for custom dependencies to mak)-.15 F 4.986(et)-.1 G 2.486
 (he missing \214le\(s\), b)-4.986 F(ut)-.2 E .305(restricts it to the e)
-144 338.4 R .306(xtensions speci\214ed by the v)-.15 F .306
+144 643.2 R .306(xtensions speci\214ed by the v)-.15 F .306
 (ariable %late)-.25 F(x_input_e)-.15 E 2.806(xtensions. The)-.15 F(def)
-2.806 E .306(ault e)-.1 F(xten-)-.15 E(sions are ')144 350.4 Q(te)-.18 E
-(x' and 'eps'.)-.15 E(\(F)144 374.4 Q 1.011(or Perl e)-.15 F 1.011
+2.806 E .306(ault e)-.1 F(xten-)-.15 E(sions are ')144 655.2 Q(te)-.18 E
+(x' and 'eps'.)-.15 E(\(F)144 679.2 Q 1.011(or Perl e)-.15 F 1.011
 (xperts: %late)-.15 F(x_input_e)-.15 E 1.011
 (xtensions is a hash whose k)-.15 F -.15(ey)-.1 G 3.511(sa).15 G 1.011
 (re the e)-3.511 F 3.51(xtensions. The)-.15 F -.25(va)3.51 G(lues).25 E
-2.647(are irrele)144 386.4 R -.25(va)-.25 G 5.147(nt.\) T).25 F 2.847
+2.647(are irrele)144 691.2 R -.25(va)-.25 G 5.147(nt.\) T).25 F 2.847
 -.1(wo s)-.8 H 2.647(ubroutines are pro).1 F 2.648
 (vided for manipulating this and the related v)-.15 F(ariable)-.25 E
-(%pd\215ate)144 398.4 Q(x_input_e)-.15 E 1.293(xtensions, add_input_e)
+(%pd\215ate)144 703.2 Q(x_input_e)-.15 E 1.293(xtensions, add_input_e)
 -.15 F 1.293(xt and remo)-.15 F -.15(ve)-.15 G(_input_e).15 E 3.793
 (xt. The)-.15 F 3.793(ya)-.15 G 1.293(re used as in the fol-)-3.793 F
-(lo)144 410.4 Q(wing e)-.25 E
-(xamples are possible lines in an initialization \214le:)-.15 E(remo)154
-434.4 Q -.15(ve)-.15 G(_input_e).15 E(xt\( ')-.15 E(late)-.1 E(x', ')
--.15 E(te)-.18 E(x' \);)-.15 E(remo)144 458.4 Q -.15(ve)-.15 G 2.5(st)
-.15 G(he e)-2.5 E(xtension ')-.15 E(te)-.18 E(x' from late)-.15 E
-(x_input_e)-.15 E(xtensions)-.15 E(add_input_e)154 482.4 Q(xt\( ')-.15 E
-(late)-.1 E(x', 'asdf)-.15 E 2.5('\)).55 G(;)-2.5 E .622(add the e)144
-506.4 R .622(xtension 'asdf to late)-.15 F(x_input_e)-.15 E 3.122
-(xtensions. \(Naturally)-.15 F .623(with such an e)3.123 F .623
-(xtension, you should)-.15 F(ha)144 518.4 Q .985 -.15(ve m)-.2 H .685
+(lo)144 715.2 Q(wing e)-.25 E
+(xamples are possible lines in an initialization \214le:)-.15 E(11 No)
+267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(21)185.545 E 0 Cg EP
+%%Page: 22 22
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E(remo)154 84 Q -.15(ve)-.15 G(_input_e).15 E(xt\( ')
+-.15 E(late)-.1 E(x', ')-.15 E(te)-.18 E(x' \);)-.15 E(remo)144 108 Q
+-.15(ve)-.15 G 2.5(st).15 G(he e)-2.5 E(xtension ')-.15 E(te)-.18 E
+(x' from late)-.15 E(x_input_e)-.15 E(xtensions)-.15 E(add_input_e)154
+132 Q(xt\( ')-.15 E(late)-.1 E(x', 'asdf)-.15 E 2.5('\)).55 G(;)-2.5 E
+.622(add the e)144 156 R .622(xtension 'asdf to late)-.15 F(x_input_e)
+-.15 E 3.122(xtensions. \(Naturally)-.15 F .623(with such an e)3.123 F
+.623(xtension, you should)-.15 F(ha)144 168 Q .985 -.15(ve m)-.2 H .685
 (ade an appropriate custom dependenc).15 F 3.185(yf)-.15 G .685(or late)
 -3.185 F .685(xmk, and should also ha)-.15 F .985 -.15(ve d)-.2 H .685
-(one the appro-).15 F .155(priate programming in the LaT)144 530.4 R
-.155(eX source \214le to enable the \214le to be read.)-.7 F .155
-(The standard e)5.155 F(xtensions)-.15 E(are handled by LaT)144 542.4 Q
-(eX and its graphics/graphicx packages.)-.7 E F2
-($latex_silent_switch ["-interaction=batchmode"])108 571.2 Q F0
-(Switch\(es\) for the LaT)144 583.2 Q
+(one the appro-).15 F .155(priate programming in the LaT)144 180 R .155
+(eX source \214le to enable the \214le to be read.)-.7 F .155
+(The standard e)5.155 F(xtensions)-.15 E(are handled by LaT)144 192 Q
+(eX and its graphics/graphicx packages.)-.7 E/F1 10/Times-Bold@0 SF
+($latex_silent_switch ["-interaction=batchmode"])108 220.8 Q F0
+(Switch\(es\) for the LaT)144 232.8 Q
 (eX processing program when silent mode is on.)-.7 E 1.204
-(If you use MikT)144 607.2 R 1.204(eX, you may prefer the results if yo\
+(If you use MikT)144 256.8 R 1.204(eX, you may prefer the results if yo\
 u con\214gure the options to include -c-style-)-.7 F
-(errors, e.g., by the follo)144 619.2 Q
-(wing line in an initialization \214le)-.25 E($late)149 643.2 Q
-(x_silent_switch = "-interaction=batchmode -c-style-errors";)-.15 E F2
-($lpr ["lpr %O %S" under UNIX/LINUX, "NONE lpr" under MS-WINDO)108 672 Q
-(WS])-.5 E F0(The command to print postscript \214les.)144 684 Q .729
-(Under MS-W)144 708 R(indo)-.4 E .729(ws \(unlik)-.25 F 3.229(eU)-.1 G
+(errors, e.g., by the follo)144 268.8 Q
+(wing line in an initialization \214le)-.25 E($late)149 292.8 Q
+(x_silent_switch = "-interaction=batchmode -c-style-errors";)-.15 E F1
+($lpr ["lpr %O %S" under UNIX/LINUX, "NONE lpr" under MS-WINDO)108 321.6
+Q(WS])-.5 E F0(The command to print postscript \214les.)144 333.6 Q .729
+(Under MS-W)144 357.6 R(indo)-.4 E .729(ws \(unlik)-.25 F 3.229(eU)-.1 G
 .729(NIX/LINUX\), there is no standard program for printing \214les.)
--3.229 F(But)5.73 E .328(there are w)144 720 R .328(ays you can do it.)
--.1 F -.15(Fo)5.328 G 2.827(re).15 G .327(xample, if you ha)-2.977 F
-.627 -.15(ve g)-.2 H(svie).15 E 2.827(wi)-.25 G .327
-(nstalled, you could use it with the)-2.827 F 2.5(7M)281.835 768 S
-(ay 2011)-2.5 E(17)199.835 E 0 Cg EP
-%%Page: 18 18
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E(option "/p":)144 84 Q
-($lpr = '"c:/Program Files/Ghostgum/gsvie)154 108 Q(w/gsvie)-.25 E
-(w32.e)-.25 E -.15(xe)-.15 G 2.5("/).15 G(p';)-2.5 E .44(If gsvie)144
-132 R 2.94(wi)-.25 G 2.94(si)-2.94 G .44(nstalled in a dif)-2.94 F .441
-(ferent directory)-.25 F 2.941(,y)-.65 G .441(ou will need to mak)-2.941
-F 2.941(et)-.1 G .441(he appropriate change.)-2.941 F(Note)5.441 E .384
-(the combination of single and double quotes around the name.)144 144 R
-.384(The single quotes specify that this)5.384 F 1.4
-(is a string to be assigned to the con\214guration v)144 156 R(ariable)
--.25 E/F1 10/Times-Italic@0 SF($lpr)3.9 E F0 6.4(.T)C 1.4
+-3.229 F(But)5.73 E .328(there are w)144 369.6 R .328
+(ays you can do it.)-.1 F -.15(Fo)5.328 G 2.827(re).15 G .327
+(xample, if you ha)-2.977 F .627 -.15(ve g)-.2 H(svie).15 E 2.827(wi)
+-.25 G .327(nstalled, you could use it with the)-2.827 F(option "/p":)
+144 381.6 Q($lpr = '"c:/Program Files/Ghostgum/gsvie)154 405.6 Q
+(w/gsvie)-.25 E(w32.e)-.25 E -.15(xe)-.15 G 2.5("/).15 G(p';)-2.5 E .44
+(If gsvie)144 429.6 R 2.94(wi)-.25 G 2.94(si)-2.94 G .44
+(nstalled in a dif)-2.94 F .441(ferent directory)-.25 F 2.941(,y)-.65 G
+.441(ou will need to mak)-2.941 F 2.941(et)-.1 G .441
+(he appropriate change.)-2.941 F(Note)5.441 E .384
+(the combination of single and double quotes around the name.)144 441.6
+R .384(The single quotes specify that this)5.384 F 1.4
+(is a string to be assigned to the con\214guration v)144 453.6 R
+(ariable)-.25 E/F2 10/Times-Italic@0 SF($lpr)3.9 E F0 6.4(.T)C 1.4
 (he double quotes are part of the)-6.4 F .951
-(string passed to the operating system to get the command obe)144 168 R
-.95(yed; this is necessary because one)-.15 F .11
+(string passed to the operating system to get the command obe)144 465.6
+R .95(yed; this is necessary because one)-.15 F .11
 (part of the command name \("Program Files"\) contains a space which w)
-144 180 R .11(ould otherwise be misinter)-.1 F(-)-.2 E(preted.)144 192 Q
-/F2 10/Times-Bold@0 SF($lpr_dvi ["NONE lpr_dvi"])108 208.8 Q F0
-(The printing program to print dvi \214les.)144 220.8 Q F2
-($lpr_pdf ["NONE lpr_pdf"])108 237.6 Q F0
-(The printing program to print pdf \214les.)144 249.6 Q(Under MS-W)144
-273.6 Q(indo)-.4 E(ws you could set this to use gsvie)-.25 E 1.3 -.65
+144 477.6 R .11(ould otherwise be misinter)-.1 F(-)-.2 E(preted.)144
+489.6 Q F1($lpr_dvi ["NONE lpr_dvi"])108 506.4 Q F0
+(The printing program to print dvi \214les.)144 518.4 Q F1
+($lpr_pdf ["NONE lpr_pdf"])108 535.2 Q F0
+(The printing program to print pdf \214les.)144 547.2 Q(Under MS-W)144
+571.2 Q(indo)-.4 E(ws you could set this to use gsvie)-.25 E 1.3 -.65
 (w, i)-.25 H 2.5(fi).65 G 2.5(ti)-2.5 G 2.5(si)-2.5 G(nstalled, e.g.,)
--2.5 E($lpr = '"c:/Program Files/Ghostgum/gsvie)154 297.6 Q(w/gsvie)-.25
+-2.5 E($lpr = '"c:/Program Files/Ghostgum/gsvie)154 595.2 Q(w/gsvie)-.25
 E(w32.e)-.25 E -.15(xe)-.15 G 2.5("/).15 G(p';)-2.5 E .441(If gsvie)144
-321.6 R 2.941(wi)-.25 G 2.941(si)-2.941 G .441(nstalled in a dif)-2.941
+619.2 R 2.941(wi)-.25 G 2.941(si)-2.941 G .441(nstalled in a dif)-2.941
 F .441(ferent directory)-.25 F 2.941(,y)-.65 G .441(ou will need to mak)
 -2.941 F 2.94(et)-.1 G .44(he appropriate change.)-2.94 F(Note)5.44 E
 1.683(the double quotes around the name: this is necessary because one \
-part of the command name)144 333.6 R
-(\("Program Files"\) contains a space which w)144 345.6 Q
-(ould otherwise be misinterpreted.)-.1 E F2($mak)108 374.4 Q 2.5(e[)-.1
-G("mak)-2.5 E(e"])-.1 E F0(The mak)144 386.4 Q 2.5(ep)-.1 G
-(rocessing program.)-2.5 E F2($mak)108 415.2 Q(eindex ["mak)-.1 E
-(eindex %O -o %D %S"])-.1 E F0(The inde)144 427.2 Q 2.5(xp)-.15 G
-(rocessing program.)-2.5 E F2($max_r)108 444 Q(epeat [5])-.18 E F0 .628
-(The maximum number of times)144 456 R F1(late)3.127 E(xmk)-.2 E F0 .627
-(will run late)3.127 F(x/pd\215ate)-.15 E 3.127(xb)-.15 G .627
+part of the command name)144 631.2 R
+(\("Program Files"\) contains a space which w)144 643.2 Q
+(ould otherwise be misinterpreted.)-.1 E F1($mak)108 672 Q 2.5(e[)-.1 G
+("mak)-2.5 E(e"])-.1 E F0(The mak)144 684 Q 2.5(ep)-.1 G
+(rocessing program.)-2.5 E(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012)
+.15 E(22)185.545 E 0 Cg EP
+%%Page: 23 23
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF($mak)108 84 Q(eindex ["mak)
+-.1 E(eindex %O -o %D %S"])-.1 E F0(The inde)144 96 Q 2.5(xp)-.15 G
+(rocessing program.)-2.5 E F1($mak)108 112.8 Q
+(eindex_silent_switch ["-q"])-.1 E(Switch\(es\))144 124.8 Q F0
+(for the inde)2.5 E 2.5(xp)-.15 G
+(rocessing program when silent mode is on.)-2.5 E F1($max_r)108 141.6 Q
+(epeat [5])-.18 E F0 .628(The maximum number of times)144 153.6 R/F2 10
+/Times-Italic@0 SF(late)3.127 E(xmk)-.2 E F0 .627(will run late)3.127 F
+(x/pd\215ate)-.15 E 3.127(xb)-.15 G .627
 (efore deciding that there may be)-3.127 F .808(an in\214nite loop and \
-that it needs to bail out, rather than rerunning late)144 468 R
+that it needs to bail out, rather than rerunning late)144 165.6 R
 (x/pd\215ate)-.15 E 3.308(xa)-.15 G -.05(ga)-3.308 G .809(in to resolv)
-.05 F(e)-.15 E(cross-references, etc.)144 480 Q(The def)5 E(ault v)-.1 E
-(alue co)-.25 E -.15(ve)-.15 G(rs all normal cases.).15 E .413
-(\(Note that the "etc" co)144 504 R -.15(ve)-.15 G .413
+.05 F(e)-.15 E(cross-references, etc.)144 177.6 Q(The def)5 E(ault v)-.1
+E(alue co)-.25 E -.15(ve)-.15 G(rs all normal cases.).15 E .413
+(\(Note that the "etc" co)144 201.6 R -.15(ve)-.15 G .413
 (rs a lot of cases where one run of late).15 F(x/pd\215ate)-.15 E 2.913
 (xg)-.15 G .412(enerates \214les to be read)-2.913 F
-(in on a later run.\))144 516 Q F2($new_viewer_always [0])108 532.8 Q F0
-.908(This v)144 544.8 R .908(ariable applies to)-.25 F F1(late)3.408 E
-(xmk)-.2 E F2(only)3.408 E F0 .908(in continuous-pre)3.408 F(vie)-.25 E
-3.408(wm)-.25 G 3.409(ode. If)-3.408 F F1($ne)3.409 E(w_vie)-.15 E
-(wer_always)-.15 E F0 .909(is 0,)3.409 F F1(late)144 556.8 Q(xmk)-.2 E
-F0 .511(will check for a pre)3.011 F .511(viously running pre)-.25 F
-(vie)-.25 E .51(wer on the same \214le, and if one is running will)-.25
-F .658(not start a ne)144 568.8 R 3.158(wo)-.25 G 3.158(ne. If)-3.158 F
-F1($ne)3.158 E(w_vie)-.15 E(wer_always)-.15 E F0 .658
-(is non-zero, this check will be skipped, and)3.158 F F1(late)3.158 E
-(xmk)-.2 E F0(will beha)144 580.8 Q .3 -.15(ve a)-.2 H 2.5(si).15 G 2.5
-(fn)-2.5 G 2.5(ov)-2.5 G(ie)-2.5 E(wer is running.)-.25 E F2
-($pdf_mode [0])108 597.6 Q F0 .695(If zero, do NO)144 609.6 R 3.195(Tg)
--.4 G .695(enerate a pdf v)-3.195 F .695(ersion of the document.)-.15 F
-.694(If equal to 1, generate a pdf v)5.695 F .694(ersion of)-.15 F .013
-(the document using pd\215ate)144 621.6 R 2.514(x. If)-.15 F .014
+(in on a later run.\))144 213.6 Q F1($MSW)108 230.4 Q(in_back_slash [1])
+-.18 E F0 1.36(This con\214guration v)144 242.4 R 1.361
+(ariable only has an ef)-.25 F 1.361(fect when)-.25 F F2(late)3.861 E
+(xmk)-.2 E F0 1.361(is running under MS-W)3.861 F(indo)-.4 E 3.861
+(ws. It)-.25 F .016(determines whether)144 254.4 R 2.516(,w)-.4 G .016
+(hen a command is e)-2.516 F -.15(xe)-.15 G .016(cuted under MS-W).15 F
+(indo)-.4 E .016(ws, there should be substituted)-.25 F .72("\\" for th\
+e separator character between components of a directory name.)144 266.4
+R(Internally)5.72 E(,)-.65 E F2(late)3.22 E(xmk)-.2 E F0(uses)3.22 E
+("/" for the directory separator character)144 278.4 Q 2.5(,w)-.4 G
+(hich is the character used by Unix-lik)-2.5 E 2.5(es)-.1 G(ystems.)-2.5
+E -.15(Fo)144 302.4 S 2.849(rm).15 G(an)-2.849 E 2.849(yp)-.15 G .349
+(rograms under MS-W)-2.849 F(indo)-.4 E .348
+(ws, both "\\" and "/" are acceptable as the directory separator)-.25 F
+(character)144 314.4 Q 6.836(.B)-.55 G 1.836
+(ut some programs only accept "\\".)-6.836 F 1.836(So for safety)6.836 F
+F2(late)4.337 E(xmk)-.2 E F0(mak)4.337 E 1.837(es a translation, by)-.1
+F(def)144 326.4 Q 2.995(ault. It)-.1 F .495(is concei)2.995 F -.25(va)
+-.25 G .495(ble that under certain situations this is undesirable, so t\
+he con\214guration can).25 F .179(be changed.)144 338.4 R .179
+(\(A possible e)5.179 F .179(xample might be when some of the softw)-.15
+F .18(are is implemented using Cyg-)-.1 F(win, which pro)144 350.4 Q
+(vides an Unix-lik)-.15 E 2.5(ee)-.1 G -.4(nv)-2.5 G
+(ironment inside MS-W).4 E(indo)-.4 E(ws.\))-.25 E F1
+($new_viewer_always [0])108 379.2 Q F0 .909(This v)144 391.2 R .909
+(ariable applies to)-.25 F F2(late)3.409 E(xmk)-.2 E F1(only)3.408 E F0
+.908(in continuous-pre)3.408 F(vie)-.25 E 3.408(wm)-.25 G 3.408(ode. If)
+-3.408 F F2($ne)3.408 E(w_vie)-.15 E(wer_always)-.15 E F0 .908(is 0,)
+3.408 F F2(late)144 403.2 Q(xmk)-.2 E F0 .51(will check for a pre)3.01 F
+.51(viously running pre)-.25 F(vie)-.25 E .511
+(wer on the same \214le, and if one is running will)-.25 F .658
+(not start a ne)144 415.2 R 3.158(wo)-.25 G 3.158(ne. If)-3.158 F F2
+($ne)3.158 E(w_vie)-.15 E(wer_always)-.15 E F0 .658
+(is non-zero, this check will be skipped, and)3.158 F F2(late)3.158 E
+(xmk)-.2 E F0(will beha)144 427.2 Q .3 -.15(ve a)-.2 H 2.5(si).15 G 2.5
+(fn)-2.5 G 2.5(ov)-2.5 G(ie)-2.5 E(wer is running.)-.25 E F1
+($out_dir [""])108 456 Q F0 .668(The directory in which output \214les \
+are to be written by a run of \(pdf\)late)144 468 R 3.169(x. See)-.15 F
+.669(also the v)3.169 F(ariable)-.25 E F2($aux_dir)144 480 Q F0(.)A .393
+(The ef)144 504 R .392(fect of this v)-.25 F .392
+(ariable \(when non-blank\) is achie)-.25 F -.15(ve)-.25 G 2.892(db).15
+G 2.892(yu)-2.892 G .392(sing the)-2.892 F F1(-output-dir)2.892 E
+(ectory)-.18 E F0 .392(option of)2.892 F(\(pdf\)late)144 516 Q 2.637
+(x. This)-.15 F -.15(ex)2.637 G .138
+(ists in the usual current \(Dec. 2011\) implementations of T).15 F .138
+(eX, i.e., MiKT)-.7 F .138(eX and)-.7 F -.7(Te)144 528 S(XLi).7 E -.15
+(ve)-.25 G 2.5(.B).15 G(ut it may not be present in other v)-2.5 E
+(ersions.)-.15 E(Commonly)144 552 Q 3.205(,t)-.65 G .704(he directory s\
+peci\214ed for output \214les is a subdirectory of the current w)-3.205
+F .704(orking direc-)-.1 F(tory)144 564 Q 5.921(.H)-.65 G -.25(ow)-5.921
+G -2.15 -.25(ev e).25 H 1.721 -.4(r, i).25 H 3.421(fy).4 G .921
+(ou specify some other directory)-3.421 F 3.421(,e)-.65 G .922
+(.g., "/tmp/foo" or "../output", be a)-3.421 F -.1(wa)-.15 G .922
+(re that).1 F 1.392(this could cause problems, e.g., with)144 576 R F2
+(mak)3.892 E(einde)-.1 E(x)-.2 E F0(or)3.892 E F2(bibte)3.892 E(x)-.2 E
+F0 6.392(.T)C 1.392(his is because modern v)-6.392 F 1.392(ersions of)
+-.15 F .248(these programs, by def)144 588 R .248
+(ault, will refuse to w)-.1 F .248(ork when the)-.1 F 2.748<798c>-.15 G
+.248(nd that the)-2.748 F 2.749(ya)-.15 G .249(re ask)-2.749 F .249
+(ed to write to a \214le)-.1 F .02
+(in a directory that appears not to be the current w)144 600 R .02
+(orking directory or one of its subdirectories.)-.1 F(This)5.02 E .675
+(is part of security measures by the whole T)144 612 R .675
+(eX system that try to pre)-.7 F -.15(ve)-.25 G .676
+(nt malicious or errant T).15 F(eX)-.7 E .496
+(documents from incorrectly messing with a user')144 624 R 2.995<738c>
+-.55 G 2.995(les. If)-2.995 F(for)2.995 E F2($out_dir)2.995 E F0(or)
+2.995 E F2($aux_dir)2.995 E F0 .495(you really do)2.995 F .483(need to \
+specify an absolute pathname \(e.g., "/tmp/foo"\) or a path \(e.g., "..\
+/output"\) that includes a)144 636 R(higher)144 648 Q(-le)-.2 E -.15(ve)
+-.25 G 2.538(ld).15 G(irectory)-2.538 E 2.538(,t)-.65 G .038
+(hen you need to disable the security measures \(and assume an)-2.538 F
+2.537(yr)-.15 G 2.537(isks\). This)-2.537 F 1.172
+(can be done by temporarily setting the operating system')144 660 R
+3.673(se)-.55 G -.4(nv)-3.673 G 1.173(ironment v).4 F 1.173
+(ariable openout_an)-.25 F 3.673(yt)-.15 G(o)-3.673 E
+("a" \(as in "all"\), to o)144 672 Q -.15(ve)-.15 G(rride the def).15 E
+(ault "paranoid" setting.)-.1 E F1($pdf_mode [0])108 700.8 Q F0 .695
+(If zero, do NO)144 712.8 R 3.195(Tg)-.4 G .695(enerate a pdf v)-3.195 F
+.695(ersion of the document.)-.15 F .694
+(If equal to 1, generate a pdf v)5.695 F .694(ersion of)-.15 F .013
+(the document using pd\215ate)144 724.8 R 2.514(x. If)-.15 F .014
 (equal to 2, generate a pdf v)2.514 F .014
-(ersion of the document from the ps \214le,)-.15 F .642
-(by using the command speci\214ed by the)144 633.6 R F1($ps2pdf)3.142 E
-F0 -.25(va)3.142 G 3.142(riable. If).25 F .642
-(equal to 3, generate a pdf v)3.142 F .641(ersion of)-.15 F(the documen\
-t from the dvi \214le, by using the command speci\214ed by the)144 645.6
-Q F1($dvipdf)2.5 E F0 -.25(va)2.5 G(riable.).25 E(Equi)144 669.6 Q -.25
-(va)-.25 G(lent to the).25 E F2(-pdf-)2.5 E F0(,)A F2(-pdf)2.5 E F0(,)A
-F2(-pdfdvi)2.5 E F0(,)A F2(-pdfps)2.5 E F0(options.)2.5 E F2
-($pd\215atex ["pd\215atex %O %S"])108 686.4 Q F0(The LaT)144 698.4 Q
-(eX processing program in the v)-.7 E(ersion that mak)-.15 E
-(es a pdf \214le instead of a dvi \214le.)-.1 E 2.5(7M)281.835 768 S
-(ay 2011)-2.5 E(18)199.835 E 0 Cg EP
-%%Page: 19 19
+(ersion of the document from the ps \214le,)-.15 F(11 No)267.545 768 Q
+-.15(ve)-.15 G(mber 2012).15 E(23)185.545 E 0 Cg EP
+%%Page: 24 24
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF(%pd\215atex_input_extensions)
-108 84 Q F0 .505(This v)144 96 R .505(ariable speci\214es the e)-.25 F
-.505(xtensions tried by late)-.15 F .505
-(xmk when it \214nds that a pdfLaT)-.15 F .506(eX run resulted)-.7 F
-.259(in an error that a \214le has not been found, and the \214le is gi)
-144 108 R -.15(ve)-.25 G 2.759(nw).15 G .259(ithout an e)-2.759 F 2.759
-(xtension. This)-.15 F(typically)2.758 E 1.256(happens when LaT)144 120
-R 1.256(eX commands of the form \\input{\214le} or \\include)-.7 F 1.257
-(graphics{\214gure}, when the)-.15 F(rele)144 132 Q -.25(va)-.25 G
-(nt source \214le does not e).25 E(xist.)-.15 E 2.487
-(In this situation, late)144 156 R 2.486
-(xmk searches for custom dependencies to mak)-.15 F 4.986(et)-.1 G 2.486
-(he missing \214le\(s\), b)-4.986 F(ut)-.2 E 1.657
-(restricts it to the e)144 168 R 1.657(xtensions speci\214ed by the v)
--.15 F 1.658(ariable %pd\215ate)-.25 F(x_input_e)-.15 E 4.158
-(xtensions. The)-.15 F(def)4.158 E(ault)-.1 E -.15(ex)144 180 S
+(TEXMK\(1L\))-1.11 E .642(by using the command speci\214ed by the)144 84
+R/F1 10/Times-Italic@0 SF($ps2pdf)3.142 E F0 -.25(va)3.142 G 3.142
+(riable. If).25 F .642(equal to 3, generate a pdf v)3.142 F .641
+(ersion of)-.15 F(the document from the dvi \214le, by using the comman\
+d speci\214ed by the)144 96 Q F1($dvipdf)2.5 E F0 -.25(va)2.5 G(riable.)
+.25 E(Equi)144 120 Q -.25(va)-.25 G(lent to the).25 E/F2 10/Times-Bold@0
+SF(-pdf-)2.5 E F0(,)A F2(-pdf)2.5 E F0(,)A F2(-pdfdvi)2.5 E F0(,)A F2
+(-pdfps)2.5 E F0(options.)2.5 E F2($pd\215atex ["pd\215atex %O %S"])108
+148.8 Q F0(The LaT)144 160.8 Q(eX processing program in the v)-.7 E
+(ersion that mak)-.15 E(es a pdf \214le instead of a dvi \214le.)-.1 E
+.099(An e)144 184.8 R .099(xample of the use of this v)-.15 F .099
+(ariable is to arrange for)-.25 F F1(xelate)2.6 E(x)-.2 E F0 .1
+(to be used instead of)2.6 F F1(pd\215ate)2.6 E(x)-.2 E F0 2.6(,w)C(hen)
+-2.6 E(you could set)144 196.8 Q($pd\215ate)156.5 220.8 Q 2.5(x=")-.15 G
+-.15(xe)-2.5 G(late).15 E 2.5(x%)-.15 G 2.5(O%)-2.5 G(S";)-2.5 E .52
+(Note that)144 244.8 R F1(xelate)3.02 E(x)-.2 E F0 .52(only produces .p\
+df \214les \(and not .dvi\), so to use it you will also need to turn on)
+3.02 F .827(production of .pdf \214les, and to turn of)144 256.8 R 3.328
+(ft)-.25 G .828
+(he production of .dvi \(and .ps\) \214les, either by command)-3.328 F
+(line options or by the follo)144 268.8 Q
+(wing settings in an initialization \214le)-.25 E
+($pdf_mode = 1; $postscript_mode = $dvi_mode = 0;)154 292.8 Q F2
+(%pd\215atex_input_extensions)108 333.6 Q F0 .506(This v)144 345.6 R
+.506(ariable speci\214es the e)-.25 F .505(xtensions tried by late)-.15
+F .505(xmk when it \214nds that a pdfLaT)-.15 F .505(eX run resulted)-.7
+F .259
+(in an error that a \214le has not been found, and the \214le is gi)144
+357.6 R -.15(ve)-.25 G 2.759(nw).15 G .259(ithout an e)-2.759 F 2.759
+(xtension. This)-.15 F(typically)2.759 E 1.257(happens when LaT)144
+369.6 R 1.256(eX commands of the form \\input{\214le} or \\include)-.7 F
+1.256(graphics{\214gure}, when the)-.15 F(rele)144 381.6 Q -.25(va)-.25
+G(nt source \214le does not e).25 E(xist.)-.15 E 2.486
+(In this situation, late)144 405.6 R 2.486
+(xmk searches for custom dependencies to mak)-.15 F 4.986(et)-.1 G 2.487
+(he missing \214le\(s\), b)-4.986 F(ut)-.2 E 1.658
+(restricts it to the e)144 417.6 R 1.657(xtensions speci\214ed by the v)
+-.15 F 1.657(ariable %pd\215ate)-.25 F(x_input_e)-.15 E 4.157
+(xtensions. The)-.15 F(def)4.157 E(ault)-.1 E -.15(ex)144 429.6 S
 (tensions are ').15 E(te)-.18 E(x', 'pdf)-.15 E(', 'jpg, and 'png'.).55
-E(\(F)144 204 Q .028(or Perl e)-.15 F .028(xperts: %pd\215ate)-.15 F
+E(\(F)144 453.6 Q .027(or Perl e)-.15 F .027(xperts: %pd\215ate)-.15 F
 (x_input_e)-.15 E .028(xtensions is a hash whose k)-.15 F -.15(ey)-.1 G
-2.528(sa).15 G .027(re the e)-2.528 F 2.527(xtensions. The)-.15 F -.25
-(va)2.527 G(lues).25 E 2.647(are irrele)144 216 R -.25(va)-.25 G 5.147
-(nt.\) T).25 F 2.847 -.1(wo s)-.8 H 2.647(ubroutines are pro).1 F 2.648
+2.528(sa).15 G .028(re the e)-2.528 F 2.528(xtensions. The)-.15 F -.25
+(va)2.528 G(lues).25 E 2.648(are irrele)144 465.6 R -.25(va)-.25 G 5.148
+(nt.\) T).25 F 2.848 -.1(wo s)-.8 H 2.648(ubroutines are pro).1 F 2.647
 (vided for manipulating this and the related v)-.15 F(ariable)-.25 E
-(%late)144 228 Q(x_input_e)-.15 E .151(xtensions, add_input_e)-.15 F
+(%late)144 477.6 Q(x_input_e)-.15 E .151(xtensions, add_input_e)-.15 F
 .151(xt and remo)-.15 F -.15(ve)-.15 G(_input_e).15 E 2.651(xt. The)-.15
 F 2.651(ya)-.15 G .151(re used as in the follo)-2.651 F(wing)-.25 E -.15
-(ex)144 240 S(amples are possible lines in an initialization \214le:).15
-E(remo)154 264 Q -.15(ve)-.15 G(_input_e).15 E(xt\( 'pd\215ate)-.15 E
-(x', ')-.15 E(te)-.18 E(x' \);)-.15 E(remo)144 288 Q -.15(ve)-.15 G 2.5
-(st).15 G(he e)-2.5 E(xtension ')-.15 E(te)-.18 E(x' from pd\215ate)-.15
-E(x_input_e)-.15 E(xtensions)-.15 E(add_input_e)154 312 Q
-(xt\( 'pd\215ate)-.15 E(x', 'asdf)-.15 E 2.5('\)).55 G(;)-2.5 E 2.169
-(add the e)144 336 R 2.169(xtension 'asdf to pd\215ate)-.15 F(x_input_e)
--.15 E 4.669(xtensions. \(Naturally)-.15 F 2.169(with such an e)4.669 F
-2.17(xtension, you)-.15 F .645(should ha)144 348 R .945 -.15(ve m)-.2 H
-.645(ade an appropriate custom dependenc).15 F 3.144(yf)-.15 G .644
-(or late)-3.144 F .644(xmk, and should also ha)-.15 F .944 -.15(ve d)-.2
-H .644(one the).15 F 1.618(appropriate programming in the LaT)144 360 R
-1.619(eX source \214le to enable the \214le to be read.)-.7 F 1.619
-(The standard)6.619 F -.15(ex)144 372 S
+(ex)144 489.6 S(amples are possible lines in an initialization \214le:)
+.15 E(remo)154 513.6 Q -.15(ve)-.15 G(_input_e).15 E(xt\( 'pd\215ate)
+-.15 E(x', ')-.15 E(te)-.18 E(x' \);)-.15 E(remo)144 537.6 Q -.15(ve)
+-.15 G 2.5(st).15 G(he e)-2.5 E(xtension ')-.15 E(te)-.18 E
+(x' from pd\215ate)-.15 E(x_input_e)-.15 E(xtensions)-.15 E(add_input_e)
+154 561.6 Q(xt\( 'pd\215ate)-.15 E(x', 'asdf)-.15 E 2.5('\)).55 G(;)-2.5
+E 2.17(add the e)144 585.6 R 2.169(xtension 'asdf to pd\215ate)-.15 F
+(x_input_e)-.15 E 4.669(xtensions. \(Naturally)-.15 F 2.169
+(with such an e)4.669 F 2.169(xtension, you)-.15 F .644(should ha)144
+597.6 R .944 -.15(ve m)-.2 H .644(ade an appropriate custom dependenc)
+.15 F 3.144(yf)-.15 G .644(or late)-3.144 F .644
+(xmk, and should also ha)-.15 F .945 -.15(ve d)-.2 H .645(one the).15 F
+1.619(appropriate programming in the LaT)144 609.6 R 1.619
+(eX source \214le to enable the \214le to be read.)-.7 F 1.618
+(The standard)6.618 F -.15(ex)144 621.6 S
 (tensions are handled by pd\215ate).15 E 2.5(xa)-.15 G
-(nd its graphics/graphicx packages.\))-2.5 E F1
-($pd\215atex_silent_switch ["-interaction=batchmode"])108 400.8 Q F0
-(Switch\(es\) for the pd\215ate)144 412.8 Q 2.5(xp)-.15 G
-(rogram \(speci\214ed in the v)-2.5 E(ariable)-.25 E/F2 10
-/Times-Italic@0 SF($pd\215ate)2.5 E(x)-.2 E F0(when silent mode is on.)
-2.5 E 1.204(If you use MikT)144 436.8 R 1.204(eX, you may prefer the re\
-sults if you con\214gure the options to include -c-style-)-.7 F
-(errors, e.g., by the follo)144 448.8 Q
-(wing line in an initialization \214le)-.25 E($late)149 472.8 Q
-(x_silent_switch = "-interaction=batchmode -c-style-errors";)-.15 E F1
-($pdf_pr)108 501.6 Q -.15(ev)-.18 G(iewer ["start acr).15 E(or)-.18 E
-(ead %O %S"])-.18 E F0 .03(The command to in)144 513.6 R -.2(vo)-.4 G
-.231 -.1(ke a p).2 H(df-pre).1 E(vie)-.25 E(wer)-.25 E 5.031(.[)-.55 G
-(Def)-5.031 E .031(ault is changed to "start" on MS-WINDO)-.1 F .031
-(WS; under)-.35 F 1.336(more recent v)144 525.6 R 1.336(ersions of W)
--.15 F(indo)-.4 E 1.336(ws, this will cause to be run whate)-.25 F -.15
-(ve)-.25 G 3.836(rc).15 G 1.336(ommand the system has)-3.836 F
-(associated with .pdf \214les.])144 537.6 Q F1 -1.2(WA)144 561.6 S
-(RNING)1.2 E F0 2.964(:P)C .464(otential problem under MS-W)-2.964 F
-(indo)-.4 E .465(ws: if acroread is used as the pdf pre)-.25 F(vie)-.25
-E(wer)-.25 E 2.965(,a)-.4 G(nd)-2.965 E .342(it is actually vie)144
-573.6 R .342(wing a pdf \214le, the pdf \214le cannot be updated.)-.25 F
-.341(Thus mak)5.341 F .341(es acroread a bad choice)-.1 F 1.417(of pre)
-144 585.6 R(vie)-.25 E 1.417(wer if you use)-.25 F F2(late)3.917 E(xmk)
--.2 E F0 2.517 -.55('s p)D(re).55 E 1.417
-(vious-continuous mode \(option)-.25 F F1(-pvc)3.918 E F0 3.918(\)u)C
-1.418(nder MS-windo)-3.918 F(ws.)-.25 E
-(This problem does not occur if ghostvie)144 597.6 Q 1.3 -.65(w, g)-.25
-H 2.5(vo).65 G 2.5(rg)-2.5 G(svie)-2.5 E 2.5(wi)-.25 G 2.5(su)-2.5 G
-(sed to vie)-2.5 E 2.5(wp)-.25 G(df \214les.)-2.5 E F1
-($pdf_update_command [""])108 614.4 Q F0 .75(When the pdf pre)144 626.4
-R(vie)-.25 E .749(wer is set to be updated by running a command, this i\
-s the command that is)-.25 F 2.5(run. See)144 638.4 R
-(the information for the v)2.5 E(ariable)-.25 E F2($pdf_update_method)
-2.5 E F0(.)A F1($pdf_update_method [1 under UNIX, 3 under MS-W)108 655.2
-Q(indo)-.18 E(ws])-.1 E F0(Ho)144 667.2 Q 2.951(wt)-.25 G .451
-(he pdf vie)-2.951 F .451(wer updates its display when the pdf \214le h\
-as changed. See the information on the)-.25 F -.25(va)144 679.2 S
-(riable).25 E F2($dvi_update_method)3.258 E F0 .758(for the codes.)3.258
-F .757(\(Note that information needs be changed slightly so)5.758 F .447
-(that for the v)144 691.2 R .447(alue 4, to run a command to do the upd\
+(nd its graphics/graphicx packages.\))-2.5 E F2
+($pd\215atex_silent_switch ["-interaction=batchmode"])108 650.4 Q F0
+(Switch\(es\) for the pd\215ate)144 662.4 Q 2.5(xp)-.15 G
+(rogram \(speci\214ed in the v)-2.5 E(ariable)-.25 E F1($pd\215ate)2.5 E
+(x)-.2 E F0(when silent mode is on.)2.5 E 1.203(If you use MikT)144
+686.4 R 1.204(eX, you may prefer the results if you con\214gure the opt\
+ions to include -c-style-)-.7 F(errors, e.g., by the follo)144 698.4 Q
+(wing line in an initialization \214le)-.25 E($late)149 722.4 Q
+(x_silent_switch = "-interaction=batchmode -c-style-errors";)-.15 E
+(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(24)185.545 E 0 Cg EP
+%%Page: 25 25
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF($pdf_pr)108 84 Q -.15(ev)-.18
+G(iewer ["start acr).15 E(or)-.18 E(ead %O %S"])-.18 E F0
+(The command to in)144 96 Q -.2(vo)-.4 G .2 -.1(ke a p).2 H(df-pre).1 E
+(vie)-.25 E(wer)-.25 E(.)-.55 E 1.283(On MS-WINDO)144 120 R 1.283
+(WS, the def)-.35 F 1.283
+(ault is changed to "cmd /c start """; under more recent v)-.1 F 1.282
+(ersions of)-.15 F -.4(Wi)144 132 S(ndo).4 E .843
+(ws, this will cause to be run whate)-.25 F -.15(ve)-.25 G 3.343(rc).15
+G .844(ommand the system has associated with .pdf \214les.)-3.343 F .359
+(But this may be undesirable if this association is to)144 144 R/F2 10
+/Times-Italic@0 SF(acr)2.858 E(or)-.45 E(ead)-.37 E F0 .358
+(-- see the notes in the e)2.858 F .358(xplanation of)-.15 F(the)144 156
+Q F1(-pvc)2.5 E F0(option.])2.5 E .447(On OS-X the def)144 180 R .448(a\
+ult is changed to "open %S", which results in OS-X starting up \(and de\
+taching\))-.1 F .472(the vie)144 192 R .472
+(wer associated with the \214le.)-.25 F .471(By def)5.471 F .471
+(ault, for pdf \214les this association is to OS-X')-.1 F 2.971(sp)-.55
+G(re)-2.971 E(vie)-.25 E -.65(w,)-.25 G(which is quite satisf)144 204 Q
+(actory)-.1 E(.)-.65 E F1 -1.2(WA)144 228 S(RNING)1.2 E F0 5.088(:P)C
+.088(roblem under MS-W)-5.088 F(indo)-.4 E .088
+(ws: if acroread is used as the pdf pre)-.25 F(vie)-.25 E(wer)-.25 E
+2.588(,a)-.4 G .088(nd it is actu-)-2.588 F .59(ally vie)144 240 R .59
+(wing a pdf \214le, the pdf \214le cannot be updated.)-.25 F .589
+(Thus mak)5.589 F .589(es acroread a bad choice of pre-)-.1 F(vie)144
+252 Q 1.469(wer if you use)-.25 F F2(late)3.969 E(xmk)-.2 E F0 2.569
+-.55('s p)D(re).55 E 1.469(vious-continuous mode \(option)-.25 F F1
+(-pvc)3.969 E F0 3.969(\)u)C 1.469(nder MS-windo)-3.969 F 3.97(ws. This)
+-.25 F(problem does not occur if, for e)144 264 Q
+(xample, SumatraPDF or gsvie)-.15 E 2.5(wi)-.25 G 2.5(su)-2.5 G
+(sed to vie)-2.5 E 2.5(wp)-.25 G(df \214les.)-2.5 E F1 2.203
+(Important note)144 288 R F0 4.703(:N)C 2.202(ormally you will w)-4.703
+F 2.202(ant to ha)-.1 F 2.502 -.15(ve a p)-.2 H(re).15 E(vie)-.25 E
+2.202(wer run detached, so that)-.25 F F2(late)4.702 E(xmk)-.2 E F0
+(doesn')144 300 Q 3.51(tw)-.18 G 1.01(ait for the pre)-3.61 F(vie)-.25 E
+1.011(wer to terminate before continuing its w)-.25 F 3.511(ork. So)-.1
+F 1.011(normally you should)3.511 F .619
+(pre\214x the command by "start ", which \215ags to)144 312 R F2(late)
+3.119 E(xmk)-.2 E F0 .619(that it should do the detaching of the pre-)
+3.119 F(vie)144 324 Q .621(wer itself \(by whate)-.25 F -.15(ve)-.25 G
+3.121(rm).15 G .622(ethod is appropriate to the operating system\).)
+-3.121 F .622(But sometimes letting)5.622 F F2(late)144 336 Q(xmk)-.2 E
+F0 .163(do the detaching is not appropriate \(for a v)2.663 F .162
+(ariety of non-tri)-.25 F .162(vial reasons\), so you should put)-.25 F
+(the "start " bit in yourself, whene)144 348 Q -.15(ve)-.25 G 2.5(ri).15
+G 2.5(ti)-2.5 G 2.5(sn)-2.5 G(eeded.)-2.5 E F1($pdf_update_command [""])
+108 376.8 Q F0 .749(When the pdf pre)144 388.8 R(vie)-.25 E .75(wer is \
+set to be updated by running a command, this is the command that is)-.25
+F 2.5(run. See)144 400.8 R(the information for the v)2.5 E(ariable)-.25
+E F2($pdf_update_method)2.5 E F0(.)A F1
+($pdf_update_method [1 under UNIX, 3 under MS-W)108 417.6 Q(indo)-.18 E
+(ws])-.1 E F0(Ho)144 429.6 Q 2.952(wt)-.25 G .452(he pdf vie)-2.952 F
+.451(wer updates its display when the pdf \214le has changed. See the i\
+nformation on the)-.25 F -.25(va)144 441.6 S(riable).25 E F2
+($dvi_update_method)3.257 E F0 .757(for the codes.)3.257 F .758
+(\(Note that information needs be changed slightly so)5.757 F .448
+(that for the v)144 453.6 R .447(alue 4, to run a command to do the upd\
 ate, the command is speci\214ed by the v)-.25 F(ariable)-.25 E F2
-($pdf_update_command)144 703.2 Q F0 2.957(,a)C .457(nd for the v)-2.957
+($pdf_update_command)144 465.6 Q F0 2.956(,a)C .456(nd for the v)-2.956
 F .457
 (alue 2, to specify update by signal, the signal is speci\214ed by)-.25
-F F2($pdf_update_signal)144 715.2 Q F0(.\))A 2.5(7M)281.835 768 S
-(ay 2011)-2.5 E(19)199.835 E 0 Cg EP
-%%Page: 20 20
+F F2($pdf_update_signal)144 477.6 Q F0(.\))A .819
+(Note that acroread under MS-W)144 501.6 R(indo)-.4 E .819(ws \(b)-.25 F
+.819(ut not UNIX\) locks the pdf \214le, so the def)-.2 F .818(ault v)
+-.1 F .818(alue is)-.25 F(then 3.)144 513.6 Q .928
+(Arranging to use a command to get a pre)144 537.6 R(vie)-.25 E .929
+(wer e)-.25 F .929(xplicitly updated requires three v)-.15 F .929
+(ariables to be)-.25 F 2.5(set. F)144 549.6 R(or e)-.15 E(xample:)-.15 E
+($pdf_pre)154 573.6 Q(vie)-.25 E(wer = "start xpdf -remote %R %O %S";)
+-.25 E($pdf_update_method = 4;)154 585.6 Q
+($pdf_update_command = "xpdf -remote %R -reload";)154 597.6 Q 1.062(The\
+ \214rst setting arranges for the xpdf program to be used in its "remot\
+e serv)144 621.6 R 1.061(er mode", with the)-.15 F(serv)144 633.6 Q .155
+(er name speci\214ed as the rootname of the T)-.15 F .156(eX \214le.)-.7
+F .156(The second setting arranges for updating to)5.156 F(be done in r\
+esponse to a command, and the third setting sets the update command.)144
+645.6 Q F1($pdf_update_signal [Under UNIX: SIGHUP)108 674.4 Q 2.5(,w)
+-.92 G(hich is a system-dependent v)-2.5 E(alue])-.1 E F0 .023
+(The number of the signal that is sent to the pdf vie)144 686.4 R .022
+(wer when it is updated by sending a signal -- see)-.25 F .406
+(the information on the v)144 698.4 R(ariable)-.25 E F2
+($pdf_update_method)2.906 E F0 5.406(.T)C .406(he def)-5.406 F .406
+(ault v)-.1 F .406(alue is the one appropriate for)-.25 F
+(gv on a UNIX system.)144 710.4 Q(11 No)267.545 768 Q -.15(ve)-.15 G
+(mber 2012).15 E(25)185.545 E 0 Cg EP
+%%Page: 26 26
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E .818(Note that acroread under MS-W)144 84 R(indo)
--.4 E .819(ws \(b)-.25 F .819
-(ut not UNIX\) locks the pdf \214le, so the def)-.2 F .819(ault v)-.1 F
-.819(alue is)-.25 F(then 3.)144 96 Q .929
-(Arranging to use a command to get a pre)144 120 R(vie)-.25 E .929
-(wer e)-.25 F .928(xplicitly updated requires three v)-.15 F .928
-(ariables to be)-.25 F 2.5(set. F)144 132 R(or e)-.15 E(xample:)-.15 E
-($pdf_pre)154 156 Q(vie)-.25 E(wer = "start xpdf -remote %R %O %S";)-.25
-E($pdf_update_method = 4;)154 168 Q
-($pdf_update_command = "xpdf -remote %R -reload";)154 180 Q 1.062(The \
-\214rst setting arranges for the xpdf program to be used in its "remote\
- serv)144 204 R 1.062(er mode", with the)-.15 F(serv)144 216 Q .156
-(er name speci\214ed as the rootname of the T)-.15 F .156(eX \214le.)-.7
-F .155(The second setting arranges for updating to)5.156 F(be done in r\
-esponse to a command, and the third setting sets the update command.)144
-228 Q/F1 10/Times-Bold@0 SF($pdf_update_signal [Under UNIX: SIGHUP)108
-256.8 Q 2.5(,w)-.92 G(hich is a system-dependent v)-2.5 E(alue])-.1 E F0
-.022(The number of the signal that is sent to the pdf vie)144 268.8 R
-.023(wer when it is updated by sending a signal -- see)-.25 F .407
-(the information on the v)144 280.8 R(ariable)-.25 E/F2 10
-/Times-Italic@0 SF($pdf_update_method)2.906 E F0 5.406(.T)C .406(he def)
--5.406 F .406(ault v)-.1 F .406(alue is the one appropriate for)-.25 F
-(gv on a UNIX system.)144 292.8 Q F1
-($pid_position[1 under UNIX, -1 under MS-W)108 309.6 Q(indo)-.18 E(ws])
--.1 E F0 .018(The v)144 321.6 R(ariable)-.25 E F2($pid_position)2.518 E
-F0 .018(is used to specify which w)2.518 F .018
-(ord in lines of the output from)-.1 F F2($pscmd)2.519 E F0(corre-)2.519
-E .825(sponds to the process ID.)144 333.6 R .825(The \214rst w)5.825 F
-.825(ord in the line is numbered 0.)-.1 F .824(The def)5.825 F .824
-(ault v)-.1 F .824(alue of 1 \(2nd)-.25 F -.1(wo)144 345.6 S .219
-(rd in line\) is correct for Solaris 2.6 and Linux.).1 F .22
-(Setting the v)5.219 F .22(ariable to -1 is used to indicate that)-.25 F
-F2($pscmd)144 357.6 Q F0(is not to be used.)2.5 E F1
-($postscript_mode [0])108 374.4 Q F0
-(If nonzero, generate a postscript v)144 386.4 Q
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF
+($pid_position[1 under UNIX, -1 under MS-W)108 84 Q(indo)-.18 E(ws])-.1
+E F0 .019(The v)144 96 R(ariable)-.25 E/F2 10/Times-Italic@0 SF
+($pid_position)2.519 E F0 .018(is used to specify which w)2.518 F .018
+(ord in lines of the output from)-.1 F F2($pscmd)2.518 E F0(corre-)2.518
+E .824(sponds to the process ID.)144 108 R .825(The \214rst w)5.824 F
+.825(ord in the line is numbered 0.)-.1 F .825(The def)5.825 F .825
+(ault v)-.1 F .825(alue of 1 \(2nd)-.25 F -.1(wo)144 120 S .22
+(rd in line\) is correct for Solaris 2.6 and Linux.).1 F .219
+(Setting the v)5.219 F .219(ariable to -1 is used to indicate that)-.25
+F F2($pscmd)144 132 Q F0(is not to be used.)2.5 E F1
+($postscript_mode [0])108 148.8 Q F0
+(If nonzero, generate a postscript v)144 160.8 Q
 (ersion of the document.)-.15 E(Equi)5 E -.25(va)-.25 G(lent to the).25
-E F1(-ps)2.5 E F0(option.)2.5 E(If some other request is made for which\
- a postscript \214le is needed, then $postscript_mode will be set to 1.)
-108 403.2 Q F1($pr)108 420 Q -.15(ev)-.18 G(iew_continuous_mode [0]).15
-E F0 .637(If nonzero, run a pre)144 432 R(vie)-.25 E .637(wer to vie)
--.25 F 3.137(wt)-.25 G .637(he document, and continue running)-3.137 F
-F2(late)3.137 E(xmk)-.2 E F0 .637(to k)3.137 F .636(eep .dvi up-)-.1 F
-2.933(to-date. Equi)144 444 R -.25(va)-.25 G .433(lent to the).25 F F1
-(-pvc)2.933 E F0 2.933(option. Which)2.933 F(pre)2.933 E(vie)-.25 E .434
+E F1(-ps)2.5 E F0(option.)2.5 E .465(If some other request is made for \
+which a postscript \214le is needed, then $postscript_mode will be)144
+184.8 R(set to 1.)144 196.8 Q F1($pr)108 213.6 Q -.15(ev)-.18 G
+(iew_continuous_mode [0]).15 E F0 .637(If nonzero, run a pre)144 225.6 R
+(vie)-.25 E .637(wer to vie)-.25 F 3.137(wt)-.25 G .637
+(he document, and continue running)-3.137 F F2(late)3.137 E(xmk)-.2 E F0
+.637(to k)3.137 F .636(eep .dvi up-)-.1 F 2.933(to-date. Equi)144 237.6
+R -.25(va)-.25 G .433(lent to the).25 F F1(-pvc)2.933 E F0 2.933
+(option. Which)2.933 F(pre)2.933 E(vie)-.25 E .434
 (wer is run depends on the other settings, see)-.25 F
-(the command line options)144 456 Q F1(-view=)2.5 E F0 2.5(,a)C
+(the command line options)144 249.6 Q F1(-view=)2.5 E F0 2.5(,a)C
 (nd the v)-2.5 E(ariable)-.25 E F2($vie)2.5 E(w)-.15 E F0(.)A F1($pr)108
-472.8 Q -.15(ev)-.18 G(iew_mode [0]).15 E F0 .913(If nonzero, run a pre)
-144 484.8 R(vie)-.25 E .913(wer to pre)-.25 F(vie)-.25 E 3.413(wt)-.25 G
+266.4 Q -.15(ev)-.18 G(iew_mode [0]).15 E F0 .913(If nonzero, run a pre)
+144 278.4 R(vie)-.25 E .913(wer to pre)-.25 F(vie)-.25 E 3.413(wt)-.25 G
 .913(he document.)-3.413 F(Equi)5.913 E -.25(va)-.25 G .913(lent to the)
 .25 F F1(-pv)3.412 E F0 3.412(option. Which)3.412 F(pre-)3.412 E(vie)144
-496.8 Q .123
+290.4 Q .123
 (wer is run depends on the other settings, see the command line options)
 -.25 F F1(-view=)2.623 E F0 2.623(,a)C .124(nd the v)-2.623 F(ariable)
--.25 E F2($vie)144 508.8 Q(w)-.15 E F0(.)A F1($printout_mode [0])108
-525.6 Q F0 .043(If nonzero, print the document using)144 537.6 R F2(lpr)
+-.25 E F2($vie)144 302.4 Q(w)-.15 E F0(.)A F1($printout_mode [0])108
+319.2 Q F0 .043(If nonzero, print the document using)144 331.2 R F2(lpr)
 2.543 E F0 5.043(.E)C(qui)-5.043 E -.25(va)-.25 G .043(lent to the).25 F
 F1(-p)2.543 E F0 2.543(option. This)2.543 F .043(is recommended)2.543 F
 F1(not)2.543 E F0(to)2.543 E
-(be set from an RC \214le, otherwise you could w)144 549.6 Q
-(aste lots of paper)-.1 E(.)-.55 E F1($print_type = ["ps"])108 566.4 Q
-F0 -.8(Ty)144 578.4 S(pe of \214le to printout: possibilities are "dvi"\
-, "none", "pdf", or "ps".).8 E F1($pscmd)108 595.2 Q F0 .666
+(be set from an RC \214le, otherwise you could w)144 343.2 Q
+(aste lots of paper)-.1 E(.)-.55 E F1($print_type = ["ps"])108 360 Q F0
+-.8(Ty)144 372 S(pe of \214le to printout: possibilities are "dvi", "no\
+ne", "pdf", or "ps".).8 E F1($pscmd)108 388.8 Q F0 .666
 (Command used to get all the processes currently run by the user)144
-607.2 R 5.667(.T)-.55 G .667(he -pvc option uses the com-)-5.667 F .631
-(mand speci\214ed by the v)144 619.2 R(ariable)-.25 E F2($pscmd)3.131 E
+400.8 R 5.667(.T)-.55 G .667(he -pvc option uses the com-)-5.667 F .631
+(mand speci\214ed by the v)144 412.8 R(ariable)-.25 E F2($pscmd)3.131 E
 F0 .631(to determine if there is an already running pre)3.131 F(vie)-.25
 E(wer)-.25 E 3.13(,a)-.4 G(nd)-3.13 E
-(to \214nd the process ID \(needed if)144 631.2 Q F2(late)2.5 E(xmk)-.2
+(to \214nd the process ID \(needed if)144 424.8 Q F2(late)2.5 E(xmk)-.2
 E F0(needs to signal the pre)2.5 E(vie)-.25 E
 (wer about \214le changes\).)-.25 E 2.218(Each line of the output of th\
-is command is assumed to correspond to one process.)144 655.2 R 2.219
-(See the)7.219 F F2($pid_position)144 667.2 Q F0 -.25(va)2.5 G
+is command is assumed to correspond to one process.)144 448.8 R 2.219
+(See the)7.219 F F2($pid_position)144 460.8 Q F0 -.25(va)2.5 G
 (riable for ho).25 E 2.5(wt)-.25 G(he process number is determined.)-2.5
-E .013(The def)144 691.2 R .013(ault for)-.1 F F2(pscmd)2.513 E F0 .013
+E .013(The def)144 484.8 R .013(ault for)-.1 F F2(pscmd)2.513 E F0 .013
 (is "NONE" under MS-W)2.513 F(indo)-.4 E .013(ws and c)-.25 F .012
 (ygwin \(i.e., the command is not used\),)-.15 F 2.006("ps --width 200 \
 -f -u $ENV{USER}" under linux, "ps -ww -u $ENV{USER}" under darwin)144
-703.2 R .807(\(Macintosh OS-X\), and "ps -f -u $ENV{USER}" under other \
-operating systems \(including other)144 715.2 R<8d61>144 727.2 Q -.2(vo)
+496.8 R .807(\(Macintosh OS-X\), and "ps -f -u $ENV{USER}" under other \
+operating systems \(including other)144 508.8 R<8d61>144 520.8 Q -.2(vo)
 -.2 G(rs of UNIX\).).2 E
 (In these speci\214cations "$ENV{USER}" is substituted by the username.)
-5 E 2.5(7M)281.835 768 S(ay 2011)-2.5 E(20)199.835 E 0 Cg EP
-%%Page: 21 21
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF($ps2pdf ["ps2pdf %O %S %D"])
-108 84 Q F0(Command to con)144 96 Q -.15(ve)-.4 G(rt ps to pdf \214le.)
-.15 E F1($ps_\214lter [empty])108 112.8 Q F0 1.012
-(The postscript \214le \214lter to be run on the ne)144 124.8 R 1.013
+5 E F1($ps2pdf ["ps2pdf %O %S %D"])108 537.6 Q F0(Command to con)144
+549.6 Q -.15(ve)-.4 G(rt ps to pdf \214le.).15 E F1
+($ps_\214lter [empty])108 566.4 Q F0 1.012
+(The postscript \214le \214lter to be run on the ne)144 578.4 R 1.013
 (wly produced postscript \214le before other processing.)-.25 F(Equi)144
-136.8 Q -.25(va)-.25 G(lent to specifying the).25 E F1(-pF)2.5 E F0
-(option.)2.5 E F1($ps_pr)108 153.6 Q -.15(ev)-.18 G
-(iewer ["start gv %O %S", b).15 E(ut "start %O %S" under MS-WINDO)-.2 E
-(WS])-.5 E F0 .473(The command to in)144 165.6 R -.2(vo)-.4 G .673 -.1
+590.4 Q -.25(va)-.25 G(lent to specifying the).25 E F1(-pF)2.5 E F0
+(option.)2.5 E F1($ps_pr)108 607.2 Q -.15(ev)-.18 G
+(iewer ["start gv %O %S", b).15 E(ut start %O %S under MS-WINDO)-.2 E
+(WS])-.5 E F0 .473(The command to in)144 619.2 R -.2(vo)-.4 G .673 -.1
 (ke a p).2 H(s-pre).1 E(vie)-.25 E(wer)-.25 E 5.473(.\()-.55 G .473
 (The def)-5.473 F .473(ault under MS-WINDO)-.1 F .473
-(WS will cause to be run)-.35 F(whate)144 177.6 Q -.15(ve)-.25 G 2.5(rc)
+(WS will cause to be run)-.35 F(whate)144 631.2 Q -.15(ve)-.25 G 2.5(rc)
 .15 G(ommand the system has associated with .ps \214les.\))-2.5 E .478
-(Note that gv could be used with the -w)144 201.6 R .478
+(Note that gv could be used with the -w)144 655.2 R .478
 (atch option updates its display whene)-.1 F -.15(ve)-.25 G 2.978(rt).15
 G .479(he postscript \214le)-2.978 F 1.255(changes, whereas ghostvie)144
-213.6 R 3.754(wd)-.25 G 1.254(oes not.)-3.754 F(Ho)6.254 E(we)-.25 E
+667.2 R 3.754(wd)-.25 G 1.254(oes not.)-3.754 F(Ho)6.254 E(we)-.25 E
 -.15(ve)-.25 G 2.054 -.4(r, d).15 H(if).4 E 1.254(ferent v)-.25 F 1.254
 (ersions of gv ha)-.15 F 1.554 -.15(ve s)-.2 H 1.254(lightly dif).15 F
-(ferent)-.25 E -.1(wa)144 225.6 S(ys of writing this option.).1 E -1.1
+(ferent)-.25 E -.1(wa)144 679.2 S(ys of writing this option.).1 E -1.1
 (Yo)5 G 2.5(uc)1.1 G(an con\214gure this v)-2.5 E
-(ariable apppropriately)-.25 E(.)-.65 E F1 -1.2(WA)144 249.6 S(RNING)1.2
+(ariable apppropriately)-.25 E(.)-.65 E F1 -1.2(WA)144 703.2 S(RNING)1.2
 E F0 4.633(:L)C 2.133(inux systems may ha)-4.633 F 2.433 -.15(ve i)-.2 H
 2.133(nstalled one \(or more\) v).15 F 2.133(ersions of gv under dif)
--.15 F(ferent)-.25 E(names, e.g., ggv)144 261.6 Q 2.5(,k)-.65 G
+-.15 F(ferent)-.25 E(names, e.g., ggv)144 715.2 Q 2.5(,k)-.65 G
 (ghostvie)-2.5 E 1.3 -.65(w, e)-.25 H(tc, b).65 E
-(ut perhaps not one called gv)-.2 E(.)-.65 E F1($ps_pr)108 278.4 Q -.15
+(ut perhaps not one called gv)-.2 E(.)-.65 E(11 No)267.545 768 Q -.15
+(ve)-.15 G(mber 2012).15 E(26)185.545 E 0 Cg EP
+%%Page: 27 27
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF 2.203(Important note)144 84 R
+F0 4.703(:N)C 2.202(ormally you will w)-4.703 F 2.202(ant to ha)-.1 F
+2.502 -.15(ve a p)-.2 H(re).15 E(vie)-.25 E 2.202
+(wer run detached, so that)-.25 F/F2 10/Times-Italic@0 SF(late)4.702 E
+(xmk)-.2 E F0(doesn')144 96 Q 3.51(tw)-.18 G 1.01(ait for the pre)-3.61
+F(vie)-.25 E 1.011(wer to terminate before continuing its w)-.25 F 3.511
+(ork. So)-.1 F 1.011(normally you should)3.511 F .619
+(pre\214x the command by "start ", which \215ags to)144 108 R F2(late)
+3.119 E(xmk)-.2 E F0 .619(that it should do the detaching of the pre-)
+3.119 F(vie)144 120 Q .621(wer itself \(by whate)-.25 F -.15(ve)-.25 G
+3.121(rm).15 G .622(ethod is appropriate to the operating system\).)
+-3.121 F .622(But sometimes letting)5.622 F F2(late)144 132 Q(xmk)-.2 E
+F0 .163(do the detaching is not appropriate \(for a v)2.663 F .162
+(ariety of non-tri)-.25 F .162(vial reasons\), so you should put)-.25 F
+(the "start " bit in yourself, whene)144 144 Q -.15(ve)-.25 G 2.5(ri).15
+G 2.5(ti)-2.5 G 2.5(sn)-2.5 G(eeded.)-2.5 E F1($ps_pr)108 172.8 Q -.15
 (ev)-.18 G(iewer_landscape ["start gv -swap %O %S", b).15 E
-(ut "start %O %S" under MS-WINDO)-.2 E(WS])-.5 E F0(The command to in)
-144 290.4 Q -.2(vo)-.4 G .2 -.1(ke a p).2 H(s-pre).1 E(vie)-.25 E
-(wer in landscape mode.)-.25 E F1($ps_update_command [""])108 307.2 Q F0
-.913(When the postscript pre)144 319.2 R(vie)-.25 E .912
+(ut start %O %S under MS-WINDO)-.2 E(WS])-.5 E F0(The command to in)144
+184.8 Q -.2(vo)-.4 G .2 -.1(ke a p).2 H(s-pre).1 E(vie)-.25 E
+(wer in landscape mode.)-.25 E F1($ps_update_command [""])108 201.6 Q F0
+.912(When the postscript pre)144 213.6 R(vie)-.25 E .913
 (wer is set to be updated by running a command, this is the command)-.25
-F(that is run.)144 331.2 Q(See the information for the v)5 E(ariable)
--.25 E/F2 10/Times-Italic@0 SF($ps_update_method)2.5 E F0(.)A F1
-($ps_update_method [0 under UNIX, 1 under MS-W)108 348 Q(indo)-.18 E
-(ws])-.1 E F0(Ho)144 360 Q 2.579(wt)-.25 G .079(he postscript vie)-2.579
+F(that is run.)144 225.6 Q(See the information for the v)5 E(ariable)
+-.25 E F2($ps_update_method)2.5 E F0(.)A F1
+($ps_update_method [0 under UNIX, 1 under MS-W)108 242.4 Q(indo)-.18 E
+(ws])-.1 E F0(Ho)144 254.4 Q 2.58(wt)-.25 G .08(he postscript vie)-2.58
 F .079(wer updates its display when the ps \214le has changed. See the \
-information on)-.25 F .48(the v)144 372 R(ariable)-.25 E F2
+information on)-.25 F .48(the v)144 266.4 R(ariable)-.25 E F2
 ($dvi_update_method)2.98 E F0 .48(for the codes.)2.98 F .48
 (\(Note that information needs be changed slightly)5.48 F .522
-(so that for the v)144 384 R .522(alue 4, to run a command to do the up\
-date, the command is speci\214ed by the v)-.25 F(ari-)-.25 E(able)144
-396 Q F2($ps_update_command)2.772 E F0 2.772(,a)C .272(nd for the v)
+(so that for the v)144 278.4 R .522(alue 4, to run a command to do the \
+update, the command is speci\214ed by the v)-.25 F(ari-)-.25 E(able)144
+290.4 Q F2($ps_update_command)2.772 E F0 2.772(,a)C .272(nd for the v)
 -2.772 F .272
 (alue 2, to specify update by signal, the signal is speci\214ed)-.25 F
-(by)144 408 Q F2($ps_update_signal)2.5 E F0(.\))A F1
-($ps_update_signal [Under UNIX: SIGHUP)108 436.8 Q 2.5(,w)-.92 G
-(hich is a system-dependent v)-2.5 E(alue])-.1 E F0 .022
-(The number of the signal that is sent to the pdf vie)144 448.8 R .023
+(by)144 302.4 Q F2($ps_update_signal)2.5 E F0(.\))A F1
+($ps_update_signal [Under UNIX: SIGHUP)108 331.2 Q 2.5(,w)-.92 G
+(hich is a system-dependent v)-2.5 E(alue])-.1 E F0 .023
+(The number of the signal that is sent to the pdf vie)144 343.2 R .022
 (wer when it is updated by sending a signal -- see)-.25 F F2
-($ps_update_method)144 460.8 Q F0 5(.T)C(he def)-5 E(ault v)-.1 E
+($ps_update_method)144 355.2 Q F0 5(.T)C(he def)-5 E(ault v)-.1 E
 (alue is the one appropriate for gv on a UNIX system.)-.25 E F1
-($pvc_view_\214le_via_temporary [1])108 489.6 Q F0 .783(The same as)144
-501.6 R F2($always_vie)3.283 E(w_\214le_via_tempor)-.15 E(ary)-.15 E F0
+($pvc_view_\214le_via_temporary [1])108 384 Q F0 .783(The same as)144
+396 R F2($always_vie)3.283 E(w_\214le_via_tempor)-.15 E(ary)-.15 E F0
 3.283(,e)C .783(xcept that it only applies in pre)-3.433 F(vie)-.25 E
-(w-continuous)-.25 E(mode \(-pvc option\).)144 513.6 Q F1
-($quote_\214lenames [1])108 542.4 Q F0 .946(This speci\214es whether su\
+(w-continuous)-.25 E(mode \(-pvc option\).)144 408 Q F1
+($quote_\214lenames [1])108 436.8 Q F0 .946(This speci\214es whether su\
 bstitutions for placeholders in command speci\214cations \(as in)144
-554.4 R F2($pd\215ate)3.447 E(x)-.2 E F0(\))A .031
-(are surrounded by double quotes.)144 566.4 R .031(If this v)5.031 F
-.031(ariable is 1 \(or an)-.25 F 2.53(yo)-.15 G .03(ther v)-2.53 F .03
-(alue Perl re)-.25 F -.05(ga)-.15 G .03(rds as true\), then).05 F
-(quoting is done.)144 578.4 Q(Otherwise quoting is omitted.)5 E .178
-(The quoting method used by late)108 595.2 R .178(xmk is tested to w)
--.15 F .178(ork correctly under UNIX systems \(including Linux and)-.1 F
-.55(Mac OS-X\) and under MS-W)108 607.2 R(indo)-.4 E 3.05(ws. It)-.25 F
-(allo)3.05 E .55
-(ws the use of \214lenames containing special characters, notably)-.25 F
-2.988(spaces. \(But)108 619.2 R .488(note that man)2.988 F 2.989(yv)-.15
-G .489(ersions of LaT)-3.139 F .489(eX and PdfLaT)-.7 F .489
-(eX cannot correctly deal with T)-.7 F .489(eX \214les whose)-.7 F 1.548
-(names contain spaces.)108 631.2 R(Late)6.548 E(xmk')-.15 E 4.048(sq)
--.55 G 1.548
-(uoting only ensures that such \214lenames are correctly treated by the)
--4.048 F(operating system in passing ar)108 643.2 Q
-(guments to programs.\))-.18 E F1($r)108 660 Q(ecorder [0])-.18 E F0
-1.186(Whether to use the)144 672 R F2(-r)3.686 E(ecor)-.37 E(der)-.37 E
-F0 1.186(option to)3.686 F F2(late)3.686 E(x)-.2 E F0(and)3.686 E F2
-(pd\215ate)3.686 E(x)-.2 E F0 3.686(.U)C 1.186
-(se of this option results in a \214le of)-3.686 F -.15(ex)144 684 S
-(tension).15 E F2(.\215s)2.766 E F0 .266
-(containing a list of the \214les that these programs ha)2.766 F .565
--.15(ve r)-.2 H .265(ead and written.).15 F F2(Late)5.265 E(xmk)-.2 E F0
-(will)2.765 E .564(then use this \214le to impro)144 696 R .865 -.15
+448.8 R F2($pd\215ate)3.446 E(x)-.2 E F0(\))A .03
+(are surrounded by double quotes.)144 460.8 R .03(If this v)5.03 F .031
+(ariable is 1 \(or an)-.25 F 2.531(yo)-.15 G .031(ther v)-2.531 F .031
+(alue Perl re)-.25 F -.05(ga)-.15 G .031(rds as true\), then).05 F
+(quoting is done.)144 472.8 Q(Otherwise quoting is omitted.)5 E .727
+(The quoting method used by late)144 496.8 R .727(xmk is tested to w)
+-.15 F .727(ork correctly under UNIX systems \(including)-.1 F .457
+(Linux and Mac OS-X\) and under MS-W)144 508.8 R(indo)-.4 E 2.957
+(ws. It)-.25 F(allo)2.957 E .457
+(ws the use of \214lenames containing special)-.25 F .002
+(characters, notably spaces.)144 520.8 R .002(\(But note that man)5.002
+F 2.502(yv)-.15 G .001(ersions of LaT)-2.652 F .001(eX and PdfLaT)-.7 F
+.001(eX cannot correctly)-.7 F .81(deal with T)144 532.8 R .81
+(eX \214les whose names contain spaces.)-.7 F(Late)5.81 E(xmk')-.15 E
+3.31(sq)-.55 G .81(uoting only ensures that such \214le-)-3.31 F
+(names are correctly treated by the operating system in passing ar)144
+544.8 Q(guments to programs.\))-.18 E F1($r)108 561.6 Q(ecorder [0])-.18
+E F0 1.033(Whether to use the)144 573.6 R F1(-r)3.533 E(ecorder)-.18 E
+F0 1.032(option to)3.532 F F2(late)3.532 E(x)-.2 E F0(and)3.532 E F2
+(pd\215ate)3.532 E(x)-.2 E F0 3.532(.U)C 1.032
+(se of this option results in a \214le of)-3.532 F -.15(ex)144 585.6 S
+(tension).15 E F2(.\215s)2.765 E F0 .266
+(containing a list of the \214les that these programs ha)2.765 F .566
+-.15(ve r)-.2 H .266(ead and written.).15 F F2(Late)5.266 E(xmk)-.2 E F0
+(will)2.766 E .565(then use this \214le to impro)144 597.6 R .865 -.15
 (ve i)-.15 H .565
 (ts detection of source \214les and generated \214les after a run of).15
-F F2(late)3.065 E(x)-.2 E F0(or)3.065 E F2(pd\215ate)144 708 Q(x)-.2 E
-F0(.)A 2.5(7M)281.835 768 S(ay 2011)-2.5 E(21)199.835 E 0 Cg EP
-%%Page: 22 22
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E .91
+F F2(late)3.064 E(x)-.2 E F0(or)3.064 E F2(pd\215ate)144 609.6 Q(x)-.2 E
+F0(.)A .909
 (It is generally recommended to use this option \(or to con\214gure the)
-144 84 R/F1 10/Times-Italic@0 SF($r)3.409 E(ecor)-.37 E(der)-.37 E F0
--.25(va)3.409 G .909(riable to be on.\)).25 F .379(But it only w)144 96
-R .379(orks if)-.1 F F1(\(pdf\)late)2.879 E(x)-.2 E F0 .38
+144 633.6 R F2($r)3.41 E(ecor)-.37 E(der)-.37 E F0 -.25(va)3.41 G .91
+(riable to be on.\)).25 F .38(But it only w)144 645.6 R .38(orks if)-.1
+F F2(\(pdf\)late)2.88 E(x)-.2 E F0 .379
 (supports the -recorder option, which is true for most current imple-)
-2.879 F(mentations)144 108 Q F1 .023
-(Note about the name of the .\215s \214le:)144 132 R F0 .023
-(Most implementations of)2.523 F F1(\(pdf\)late)2.523 E(x)-.2 E F0 .023
-(produce an .\215s \214le with the)2.523 F 2.021
-(same basename as the main document')144 144 R 4.521(sL)-.55 G(aT)-4.521
-E 2.021(eX, e.g., for Document.te)-.7 F 2.022
-(x, the .\215s \214le is Docu-)-.15 F 4.939(ment.\215s. Ho)144 156 R(we)
--.25 E -.15(ve)-.25 G 3.239 -.4(r, s).15 H 2.438(ome implementations in\
-stead produce \214les named for the program, i.e.,).4 F(late)144 168 Q
-.131(x.\215s or pd\215ate)-.15 F 2.632(x.\215s. In)-.15 F .132
-(this second case,)2.632 F F1(late)2.632 E(xmk)-.2 E F0 .132
+2.88 F(mentations)144 657.6 Q F2 .023
+(Note about the name of the .\215s \214le:)144 681.6 R F0 .023
+(Most implementations of)2.523 F F2(\(pdf\)late)2.523 E(x)-.2 E F0 .023
+(produce an .\215s \214le with the)2.523 F 2.022
+(same basename as the main document')144 693.6 R 4.522(sL)-.55 G(aT)
+-4.522 E 2.021(eX, e.g., for Document.te)-.7 F 2.021
+(x, the .\215s \214le is Docu-)-.15 F 4.938(ment.\215s. Ho)144 705.6 R
+(we)-.25 E -.15(ve)-.25 G 3.238 -.4(r, s).15 H 2.438(ome implementation\
+s instead produce \214les named for the program, i.e.,).4 F(late)144
+717.6 Q .132(x.\215s or pd\215ate)-.15 F 2.632(x.\215s. In)-.15 F .132
+(this second case,)2.632 F F2(late)2.632 E(xmk)-.2 E F0 .132
 (copies the late)2.632 F .132(x.\215s or pd\215ate)-.15 F .132
-(x.\215s to a \214le with)-.15 F(the basename of the main LaT)144 180 Q
-(eX document, e.g., Document.\215s.)-.7 E/F2 10/Times-Bold@0 SF
-($sleep_time [2])108 196.8 Q F0 1.053(The time to sleep \(in seconds\) \
-between checking for source \214le changes when running with the)144
-208.8 R F2(-pvc)144 220.8 Q F0 3.915(option. This)3.915 F 1.415
-(is subject to a minimum of one second delay)3.915 F 3.915(,e)-.65 G
-1.416(xcept that zero delay is also)-4.065 F(allo)144 232.8 Q(wed.)-.25
-E 3.102(Av)144 256.8 S .602(alue of e)-3.352 F .602(xactly 0 gi)-.15 F
--.15(ve)-.25 G 3.102(sn).15 G 3.102(od)-3.102 G(elay)-3.102 E 3.102(,a)
--.65 G .601(nd typically results in 100% CPU usage, which may not be)
--3.102 F(desirable.)144 268.8 Q F2($tex\214le_sear)108 285.6 Q(ch [""])
--.18 E F0(This is an obsolete v)144 297.6 Q(ariable, replaced by the)
--.25 E F1(@default_\214les)2.5 E F0 -.25(va)2.5 G(riable.).25 E -.15(Fo)
-144 321.6 S 3.366(rb).15 G(ackw)-3.366 E .866(ard compatibility)-.1 F
-3.366(,i)-.65 G 3.366(fy)-3.366 G .866(ou choose to set)-3.366 F F1($te)
-3.366 E(x\214le_sear)-.2 E -.15(ch)-.37 G F0 3.367(,i).15 G 3.367(ti)
--3.367 G 3.367(sas)-3.367 G .867(tring of space-separated)-3.367 F .301
-(\214lenames, and then)144 333.6 R F1(late)2.801 E(xmk)-.2 E F0
-(replaces)2.801 E F1(@default_\214les)2.801 E F0 .301
-(with the \214lenames in)2.801 F F1($te)2.801 E(x\214le_sear)-.2 E -.15
-(ch)-.37 G F0 .3(to which)2.95 F(is added "*.te)144 345.6 Q(x".)-.15 E
-F2($tmpdir [See belo)108 362.4 Q 2.5(wf)-.1 G(or default])-2.75 E F0
-(Directory to store temporary \214les that)144 374.4 Q F1(late)2.5 E
-(xmk)-.2 E F0(may generate while running.)2.5 E 1.16(The def)144 398.4 R
-1.16(ault under MSW)-.1 F(indo)-.4 E 1.16(ws \(including c)-.25 F 1.161
-(ygwin\), is to set)-.15 F F1($tmpdir)3.661 E F0 1.161(to the v)3.661 F
-1.161(alue of the \214rst of)-.25 F(whiche)144 410.4 Q -.15(ve)-.25 G
-2.717(ro).15 G 2.717(ft)-2.717 G .216(he system en)-2.717 F .216
+(x.\215s to a \214le with)-.15 F(the basename of the main LaT)144 729.6
+Q(eX document, e.g., Document.\215s.)-.7 E(11 No)267.545 768 Q -.15(ve)
+-.15 G(mber 2012).15 E(27)185.545 E 0 Cg EP
+%%Page: 28 28
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF($sear)108 84 Q
+(ch_path_separator [See belo)-.18 E 2.5(wf)-.1 G(or default])-2.75 E F0
+2.505(The character separating paths in the en)144 96 R 2.505
+(vironment v)-.4 F 2.505(ariables TEXINPUTS, BIBINPUTS, and)-.25 F 4.647
+(BSTINPUTS. This)144 108 R -.25(va)4.647 G 2.147
+(riable is mainly used by).25 F/F2 10/Times-Italic@0 SF(late)4.646 E
+(xmk)-.2 E F0 2.146(when the)4.646 F F1(-outdir)4.646 E F0(,)A F1
+(-output-dir)4.646 E(ectory)-.18 E F0(,)A F1(-auxdir)144 120 Q F0 4.495
+(,a)C(nd/or)-4.495 E F1(-aux-dir)4.495 E(ectory)-.18 E F0 1.996
+(options are used.)4.496 F 1.996(In that case)6.996 F F2(late)4.496 E
+(xmk)-.2 E F0 1.996(needs to communicate)4.496 F
+(appropriately modi\214ed search paths to $)144 132 Q F2(bibte)A(x)-.2 E
+F0(,)A F2(dvipdf)2.5 E F0(,)A F2(dvips)2.5 E F0 2.5(,a)C(nd)-2.5 E F2
+(\(pdf\)late)2.5 E(x)-.2 E F0(.)A .439([Comment to technically sa)144
+156 R .439(vvy readers:)-.2 F F2(\(pdf\)late)2.938 E(x)-.2 E F0(doesn')
+2.938 E 2.938(ta)-.18 G .438(ctually need the modi\214ed search path,)
+-2.938 F .48(because it corrects it internally)144 168 R 5.48(.B)-.65 G
+.48(ut, surprisingly)-5.48 F(,)-.65 E F2(dvipdf)2.98 E F0(and)2.98 E F2
+(dvips)2.98 E F0 .48(do, because sometimes graph-)2.98 F
+(ics \214les get generated in the output or aux directories.])144 180 Q
+1.004(The def)144 204 R 1.003(ault under MSW)-.1 F 1.003
+(in and Cygwin is ';' and under UNIX-lik)-.4 F 3.503(eo)-.1 G 1.003
+(perating systems \(including)-3.503 F .412(Linux and OS-X\) is ':'.)144
+216 R .412(Normally the def)5.412 F .412(aults gi)-.1 F .712 -.15(ve c)
+-.25 H .412(orrect beha).15 F(vior)-.2 E 5.412(.B)-.55 G .412
+(ut there can be dif)-5.412 F(\214culties)-.25 E .799
+(if your operating system is of one kind, b)144 228 R .798
+(ut some of your softw)-.2 F .798(are is running under an emulator)-.1 F
+.44(for the other kind of operating system; in that case you')144 240 R
+.441(ll need to \214nd out what is needed, and set)-.1 F F2($sear)144
+252 Q -.15(ch)-.37 G(_path_separ).15 E(ator)-.15 E F0 -.15(ex)2.906 G
+(plicitly).15 E 5.406(.\()-.65 G .405
+(The same goes, of course, for unusual operating systems that)-5.406 F
+(are not in the MSW)144 264 Q(in, Linux, OS-X, Unix collection.\))-.4 E
+F1($sleep_time [2])108 292.8 Q F0 1.053(The time to sleep \(in seconds\
+\) between checking for source \214le changes when running with the)144
+304.8 R F1(-pvc)144 316.8 Q F0 3.916(option. This)3.916 F 1.415
+(is subject to a minimum of one second delay)3.916 F 3.915(,e)-.65 G
+1.415(xcept that zero delay is also)-4.065 F(allo)144 328.8 Q(wed.)-.25
+E 3.101(Av)144 352.8 S .601(alue of e)-3.351 F .601(xactly 0 gi)-.15 F
+-.15(ve)-.25 G 3.101(sn).15 G 3.102(od)-3.101 G(elay)-3.102 E 3.102(,a)
+-.65 G .602(nd typically results in 100% CPU usage, which may not be)
+-3.102 F(desirable.)144 364.8 Q F1($tex\214le_sear)108 381.6 Q(ch [""])
+-.18 E F0(This is an obsolete v)144 393.6 Q(ariable, replaced by the)
+-.25 E F2(@default_\214les)2.5 E F0 -.25(va)2.5 G(riable.).25 E -.15(Fo)
+144 417.6 S 3.367(rb).15 G(ackw)-3.367 E .867(ard compatibility)-.1 F
+3.367(,i)-.65 G 3.367(fy)-3.367 G .867(ou choose to set)-3.367 F F2($te)
+3.366 E(x\214le_sear)-.2 E -.15(ch)-.37 G F0 3.366(,i).15 G 3.366(ti)
+-3.366 G 3.366(sas)-3.366 G .866(tring of space-separated)-3.366 F .3
+(\214lenames, and then)144 429.6 R F2(late)2.801 E(xmk)-.2 E F0
+(replaces)2.801 E F2(@default_\214les)2.801 E F0 .301
+(with the \214lenames in)2.801 F F2($te)2.801 E(x\214le_sear)-.2 E -.15
+(ch)-.37 G F0 .301(to which)2.951 F(is added "*.te)144 441.6 Q(x".)-.15
+E F1($success_cmd [unde\214ned])108 470.4 Q F0
+(See the documentation for $compiling_cmd.)144 482.4 Q F1
+($tmpdir [See belo)108 511.2 Q 2.5(wf)-.1 G(or default])-2.75 E F0
+(Directory to store temporary \214les that)144 523.2 Q F2(late)2.5 E
+(xmk)-.2 E F0(may generate while running.)2.5 E 1.161(The def)144 547.2
+R 1.161(ault under MSW)-.1 F(indo)-.4 E 1.161(ws \(including c)-.25 F
+1.161(ygwin\), is to set)-.15 F F2($tmpdir)3.661 E F0 1.16(to the v)
+3.661 F 1.16(alue of the \214rst of)-.25 F(whiche)144 559.2 Q -.15(ve)
+-.25 G 2.716(ro).15 G 2.716(ft)-2.716 G .216(he system en)-2.716 F .216
 (vironment v)-.4 F .216(ariables TMPDIR or TEMP e)-.25 F .216
-(xists, otherwise to the current)-.15 F(directory)144 422.4 Q 7.164(.U)
--.65 G 2.164(nder other operating systems \(e)-7.164 F 2.165
-(xpected to be UNIX/Linux, including OS-X\), the)-.15 F(def)144 434.4 Q
+(xists, otherwise to the current)-.15 F(directory)144 571.2 Q 7.165(.U)
+-.65 G 2.165(nder other operating systems \(e)-7.165 F 2.164
+(xpected to be UNIX/Linux, including OS-X\), the)-.15 F(def)144 583.2 Q
 (ault is the v)-.1 E(alue of the system en)-.25 E(vironment v)-.4 E
-(ariable TMPDIR if it e)-.25 E(xists, otherwise "/tmp".)-.15 E F2
-($use_mak)108 451.2 Q(e_f)-.1 E(or_missing_\214les [0])-.25 E F0 .376
-(Whether to use)144 463.2 R F1(mak)2.876 E(e)-.1 E F0 .376
-(to try and mak)2.876 F 2.876<658c>-.1 G .376
-(les that are missing after a run of)-2.876 F F1(late)2.876 E(x)-.2 E F0
-(or)2.876 E F1(pd\215ate)2.876 E(x)-.2 E F0 2.876(,a)C .376(nd for)
--2.876 F 1.112(which a custom dependenc)144 475.2 R 3.612(yh)-.15 G
-1.113(as not been found.)-3.612 F 1.113
-(This is generally useful only when)6.113 F F1(late)3.613 E(xmk)-.2 E F0
-(is)3.613 E(used as part of a bigger project which is b)144 487.2 Q
-(uilt by using the)-.2 E F1(mak)2.5 E(e)-.1 E F0(program.)2.5 E .032
+(ariable TMPDIR if it e)-.25 E(xists, otherwise "/tmp".)-.15 E F1
+($use_mak)108 600 Q(e_f)-.1 E(or_missing_\214les [0])-.25 E F0 .376
+(Whether to use)144 612 R F2(mak)2.876 E(e)-.1 E F0 .376(to try and mak)
+2.876 F 2.876<658c>-.1 G .376(les that are missing after a run of)-2.876
+F F2(late)2.876 E(x)-.2 E F0(or)2.876 E F2(pd\215ate)2.876 E(x)-.2 E F0
+2.876(,a)C .376(nd for)-2.876 F 1.113(which a custom dependenc)144 624 R
+3.613(yh)-.15 G 1.113(as not been found.)-3.613 F 1.112
+(This is generally useful only when)6.113 F F2(late)3.612 E(xmk)-.2 E F0
+(is)3.612 E(used as part of a bigger project which is b)144 636 Q
+(uilt by using the)-.2 E F2(mak)2.5 E(e)-.1 E F0(program.)2.5 E .032
 (Note that once a missing \214le has been made, no further calls to)144
-511.2 R F1(mak)2.532 E(e)-.1 E F0 .032(will be made on a subsequent)
-2.532 F .47(run of)144 523.2 R F1(late)2.97 E(xmk)-.2 E F0 .47
-(to update the \214le.)2.97 F .471
-(Handling this problem is the job of a suitably de\214ned Mak)5.47 F
-(e\214le.)-.1 E .096(See the section "USING)144 535.2 R F1(late)2.596 E
-(xmk)-.2 E F0(WITH)2.596 E F1(mak)2.595 E(e)-.1 E F0 2.595("f)C .095
+660 R F2(mak)2.532 E(e)-.1 E F0 .032(will be made on a subsequent)2.532
+F .471(run of)144 672 R F2(late)2.971 E(xmk)-.2 E F0 .471
+(to update the \214le.)2.971 F .47
+(Handling this problem is the job of a suitably de\214ned Mak)5.471 F
+(e\214le.)-.1 E .095(See the section "USING)144 684 R F2(late)2.595 E
+(xmk)-.2 E F0(WITH)2.595 E F2(mak)2.595 E(e)-.1 E F0 2.595("f)C .095
 (or ho)-2.595 F 2.595(wt)-.25 G 2.595(od)-2.595 G 2.595(ot)-2.595 G
-2.595(his. The)-2.595 F .095(intent of calling)2.595 F F1(mak)2.595 E(e)
--.1 E F0(from)2.595 E F1(late)144 547.2 Q(xmk)-.2 E F0
-(is merely to detect dependencies.)2.5 E F2($view ["default"])108 564 Q
-F0 1.1(Which kind of \214le is to be pre)144 576 R(vie)-.25 E 1.101
-(wed if a pre)-.25 F(vie)-.25 E 1.101(wer is used.)-.25 F 1.101
-(The possible v)6.101 F 1.101(alues are "def)-.25 F(ault",)-.1 E .248
-("dvi", "ps", "pdf".)144 588 R .248(The v)5.248 F .248(alue of "def)-.25
-F .247
-(ault" means that the "highest" of the kinds of \214le generated is)-.1
-F(to be used \(among dvi, ps and pdf\).)144 600 Q/F3 10.95/Times-Bold@0
-SF(CUST)72 628.8 Q(OM DEPENDENCIES)-.197 E F0 .307(In an)108 640.8 R
-2.807(yR)-.15 G 2.807<438c>-2.807 G .307
-(le a set of custom dependencies can be set up to con)-2.807 F -.15(ve)
--.4 G .308(rt a \214le with one e).15 F .308(xtension to a \214le with)
--.15 F(another)108 652.8 Q 5.15(.A)-.55 G 2.65(ne)-5.15 G .15
-(xample use of this w)-2.8 F .15(ould be to allo)-.1 F(w)-.25 E F1(late)
-2.65 E(xmk)-.2 E F0 .15(to con)2.65 F -.15(ve)-.4 G .15(rt a).15 F F1
-(.\214g)2.65 E F0 .15(\214le to)2.65 F F1(.eps)2.65 E F0 .15
-(to be included in the)2.65 F F1(.te)108 664.8 Q(x)-.2 E F0(\214le.)2.5
-E .892(The old method of con\214guring)108 688.8 R F1(late)3.392 E(xmk)
--.2 E F0 -.1(wa)3.392 G 3.392(st).1 G 3.392(od)-3.392 G .892
-(irectly manipulate the)-3.392 F F2(@cus_dep_list)3.392 E F0 .893
-(array that contains)3.392 F .012
-(information de\214ning the custom dependencies.)108 700.8 R .011
-(This method still w)5.012 F 2.511(orks. But)-.1 F(no)2.511 E 2.511(wt)
--.25 G .011(here are subroutines that)-2.511 F(allo)108 712.8 Q 2.5(wc)
--.25 G(on)-2.5 E -.15(ve)-.4 G
-(nient manipulations of the custom dependenc).15 E 2.5(yl)-.15 G 2.5
-(ist. These)-2.5 F(are)2.5 E 2.5(7M)281.835 768 S(ay 2011)-2.5 E(22)
-199.835 E 0 Cg EP
-%%Page: 23 23
+2.595(his. The)-2.595 F .096(intent of calling)2.596 F F2(mak)2.596 E(e)
+-.1 E F0(from)2.596 E F2(late)144 696 Q(xmk)-.2 E F0
+(is merely to detect dependencies.)2.5 E(11 No)267.545 768 Q -.15(ve)
+-.15 G(mber 2012).15 E(28)185.545 E 0 Cg EP
+%%Page: 29 29
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E(add_cus_dep\( frome)118 84 Q(xtension, toe)-.15 E
-(xtension, must, subroutine \))-.15 E(remo)118 96 Q -.15(ve)-.15 G
-(_cus_dep\( frome).15 E(xtension, toe)-.15 E(xtension \))-.15 E(sho)118
-108 Q(w_cus_dep\(\))-.25 E(The custom dependenc)108 132 Q 2.5(yi)-.15 G
-2.5(sal)-2.5 G(ist of rules, each of which is speci\214ed as follo)-2.5
-E(w:)-.25 E/F1 10/Times-Bold@0 SF(fr)108 148.8 Q(om extension:)-.18 E F0
-(The e)144 160.8 Q(xtension of the \214le we are con)-.15 E -.15(ve)-.4
-G(rting from \(e.g. "\214g"\).).15 E
-(It is speci\214ed without a period.)5 E F1(to extension:)108 177.6 Q F0
-(The e)144 189.6 Q(xtension of the \214le we are con)-.15 E -.15(ve)-.4
-G(rting to \(e.g. "eps"\).).15 E(It is speci\214ed without a period.)5 E
-F1(must:)108 206.4 Q F0 .501
+(TEXMK\(1L\))-1.11 E/F1 10/Times-Bold@0 SF($view ["default"])108 84 Q F0
+1.101(Which kind of \214le is to be pre)144 96 R(vie)-.25 E 1.101
+(wed if a pre)-.25 F(vie)-.25 E 1.1(wer is used.)-.25 F 1.1
+(The possible v)6.1 F 1.1(alues are "def)-.25 F(ault",)-.1 E .247
+("dvi", "ps", "pdf".)144 108 R .247(The v)5.247 F .247(alue of "def)-.25
+F .248
+(ault" means that the "highest" of the kinds of \214le generated is)-.1
+F(to be used \(among dvi, ps and pdf\).)144 120 Q/F2 10.95/Times-Bold@0
+SF(CUST)72 148.8 Q(OM DEPENDENCIES)-.197 E F0 .308(In an)108 160.8 R
+2.808(yR)-.15 G 2.808<438c>-2.808 G .308
+(le a set of custom dependencies can be set up to con)-2.808 F -.15(ve)
+-.4 G .307(rt a \214le with one e).15 F .307(xtension to a \214le with)
+-.15 F(another)108 172.8 Q 5.15(.A)-.55 G 2.65(ne)-5.15 G .15
+(xample use of this w)-2.8 F .15(ould be to allo)-.1 F(w)-.25 E/F3 10
+/Times-Italic@0 SF(late)2.65 E(xmk)-.2 E F0 .15(to con)2.65 F -.15(ve)
+-.4 G .15(rt a).15 F F3(.\214g)2.65 E F0 .15(\214le to)2.65 F F3(.eps)
+2.65 E F0 .15(to be included in the)2.65 F F3(.te)108 184.8 Q(x)-.2 E F0
+(\214le.)2.5 E .893(The old method of con\214guring)108 208.8 R F3(late)
+3.392 E(xmk)-.2 E F0 -.1(wa)3.392 G 3.392(st).1 G 3.392(od)-3.392 G .892
+(irectly manipulate the)-3.392 F F1(@cus_dep_list)3.392 E F0 .892
+(array that contains)3.392 F .011
+(information de\214ning the custom dependencies.)108 220.8 R .011
+(This method still w)5.011 F 2.512(orks. But)-.1 F(no)2.512 E 2.512(wt)
+-.25 G .012(here are subroutines that)-2.512 F(allo)108 232.8 Q 2.5(wc)
+-.25 G(on)-2.5 E -.15(ve)-.4 G
+(nient manipulations of the custom dependenc).15 E 2.5(yl)-.15 G 2.5
+(ist. These)-2.5 F(are)2.5 E(add_cus_dep\( frome)118 256.8 Q
+(xtension, toe)-.15 E(xtension, must, subroutine \))-.15 E(remo)118
+268.8 Q -.15(ve)-.15 G(_cus_dep\( frome).15 E(xtension, toe)-.15 E
+(xtension \))-.15 E(sho)118 280.8 Q(w_cus_dep\(\))-.25 E
+(The custom dependenc)108 304.8 Q 2.5(yi)-.15 G 2.5(sal)-2.5 G
+(ist of rules, each of which is speci\214ed as follo)-2.5 E(w:)-.25 E F1
+(fr)108 321.6 Q(om extension:)-.18 E F0(The e)144 333.6 Q
+(xtension of the \214le we are con)-.15 E -.15(ve)-.4 G
+(rting from \(e.g. "\214g"\).).15 E(It is speci\214ed without a period.)
+5 E F1(to extension:)108 350.4 Q F0(The e)144 362.4 Q
+(xtension of the \214le we are con)-.15 E -.15(ve)-.4 G
+(rting to \(e.g. "eps"\).).15 E(It is speci\214ed without a period.)5 E
+F1(must:)108 379.2 Q F0 .502
 (If non-zero, the \214le from which we are con)11.56 F -.15(ve)-.4 G
 (rting).15 E F1(must)3.002 E F0 -.15(ex)3.002 G .502(ist, if it doesn')
-.15 F 3.002(te)-.18 G(xist)-3.152 E/F2 10/Times-Italic@0 SF(late)3.002 E
-(xmk)-.2 E F0 .502(will gi)3.002 F -.15(ve)-.25 G .34
-(an error message and e)144 218.4 R .34(xit unless the)-.15 F F1(-f)2.84
-E F0 .34(option is speci\214ed.)2.84 F(If)5.339 E F2(must)2.839 E F0
-.339(is zero and the \214le we are con-)2.839 F -.15(ve)144 230.4 S
+.15 F 3.001(te)-.18 G(xist)-3.151 E F3(late)3.001 E(xmk)-.2 E F0 .501
+(will gi)3.001 F -.15(ve)-.25 G .339(an error message and e)144 391.2 R
+.339(xit unless the)-.15 F F1(-f)2.839 E F0 .339(option is speci\214ed.)
+2.839 F(If)5.34 E F3(must)2.84 E F0 .34
+(is zero and the \214le we are con-)2.84 F -.15(ve)144 403.2 S
 (rting from doesn').15 E 2.5(te)-.18 G(xist, then no action is tak)-2.65
-E(en.)-.1 E F1(function:)108 247.2 Q F0 .228
-(The name of the subroutine that)144 259.2 R F2(late)2.729 E(xmk)-.2 E
-F0 .229(should call to perform the \214le con)2.729 F -.15(ve)-.4 G
-2.729(rsion. The).15 F .229(\214rst ar)2.729 F(gu-)-.18 E .013
-(ment to the subroutine is the base name of the \214le to be con)144
-271.2 R -.15(ve)-.4 G .013(rted without an).15 F 2.512(ye)-.15 G 2.512
-(xtension. The)-2.662 F(sub-)2.512 E .295
-(routines are declared in the syntax of)144 283.2 R F2 -.8(Pe)2.795 G
-(rl).8 E F0 5.295(.T)C .295(he function should return 0 if it w)-5.295 F
-.295(as successful and a)-.1 F(nonzero number if it f)144 295.2 Q
-(ailed.)-.1 E .624(It is in)108 312 R -.2(vo)-.4 G -.1(ke).2 G 3.124(dw)
-.1 G(hene)-3.124 E -.15(ve)-.25 G(r).15 E F2(late)3.123 E(xmk)-.2 E F0
-.623(detects that a run of late)3.123 F(x/pd\215ate)-.15 E 3.123(xn)-.15
-G .623(eeds to read a \214le, lik)-3.123 F 3.123(eag)-.1 G .623
-(raphics \214le,)-3.123 F .522(whose e)108 324 R .522
+E(en.)-.1 E F1(function:)108 420 Q F0 .229
+(The name of the subroutine that)144 432 R F3(late)2.729 E(xmk)-.2 E F0
+.229(should call to perform the \214le con)2.729 F -.15(ve)-.4 G 2.728
+(rsion. The).15 F .228(\214rst ar)2.728 F(gu-)-.18 E .013
+(ment to the subroutine is the base name of the \214le to be con)144 444
+R -.15(ve)-.4 G .013(rted without an).15 F 2.513(ye)-.15 G 2.513
+(xtension. The)-2.663 F(sub-)2.513 E .295
+(routines are declared in the syntax of)144 456 R F3 -.8(Pe)2.795 G(rl)
+.8 E F0 5.295(.T)C .295(he function should return 0 if it w)-5.295 F
+.295(as successful and a)-.1 F(nonzero number if it f)144 468 Q(ailed.)
+-.1 E .623(It is in)108 484.8 R -.2(vo)-.4 G -.1(ke).2 G 3.123(dw).1 G
+(hene)-3.123 E -.15(ve)-.25 G(r).15 E F3(late)3.123 E(xmk)-.2 E F0 .623
+(detects that a run of late)3.123 F(x/pd\215ate)-.15 E 3.123(xn)-.15 G
+.623(eeds to read a \214le, lik)-3.123 F 3.124(eag)-.1 G .624
+(raphics \214le,)-3.124 F .523(whose e)108 496.8 R .523
 (xtension is the to-e)-.15 F .523(xtension of a custom dependenc)-.15 F
-4.323 -.65(y. T)-.15 H(hen).65 E F2(late)3.023 E(xmk)-.2 E F0 -.15(ex)
-3.023 G .523(amines whether a \214le e).15 F(xists)-.15 E 1.373
-(with the same name, b)108 336 R 1.372(ut with the corresponding from-e)
--.2 F 1.372(xtension, as speci\214ed in the custom-dependenc)-.15 F(y)
--.15 E 2.588(rule. If)108 348 R .089(it does, then whene)2.588 F -.15
-(ve)-.25 G 2.589(rt).15 G .089
-(he destination \214le \(the one with the to-e)-2.589 F .089
-(xtension\) is out-of-date with respect)-.15 F
-(to the corresponding source \214le.)108 360 Q 1.871 -.8(To m)108 384 T
-(ak).8 E 2.771(et)-.1 G .271(he ne)-2.771 F 2.771(wd)-.25 G .271
-(estination \214le, the)-2.771 F F2 -.8(Pe)2.771 G(rl).8 E F0 .27
-(subroutine speci\214ed in the rule is in)2.771 F -.2(vo)-.4 G -.1(ke).2
-G .27(d, with an ar).1 F .27(gument that)-.18 F .659
-(is the base name of the \214les in question.)108 396 R .66
-(Simple cases just in)5.659 F -.2(vo)-.4 G(lv).2 E 3.16(eas)-.15 G .66
-(ubroutine in)-3.16 F -.2(vo)-.4 G .66(king an e).2 F .66(xternal pro-)
--.15 F .213(gram; this can be done by follo)108 408 R .212
-(wing the templates belo)-.25 F 1.512 -.65(w, e)-.25 H -.15(ve).4 G
-2.712(nb).15 G 2.712(yt)-2.712 G .212(hose without kno)-2.712 F .212
-(wledge of the)-.25 F F2 -.8(Pe)2.712 G(rl).8 E F0(pro-)2.712 E
-(gramming language.)108 420 Q(Of course, e)5 E
+4.323 -.65(y. T)-.15 H(hen).65 E F3(late)3.023 E(xmk)-.2 E F0 -.15(ex)
+3.022 G .522(amines whether a \214le e).15 F(xists)-.15 E 1.372
+(with the same name, b)108 508.8 R 1.372
+(ut with the corresponding from-e)-.2 F 1.373
+(xtension, as speci\214ed in the custom-dependenc)-.15 F(y)-.15 E 2.589
+(rule. If)108 520.8 R .089(it does, then whene)2.589 F -.15(ve)-.25 G
+2.589(rt).15 G .089(he destination \214le \(the one with the to-e)-2.589
+F .088(xtension\) is out-of-date with respect)-.15 F
+(to the corresponding source \214le.)108 532.8 Q 1.87 -.8(To m)108 556.8
+T(ak).8 E 2.77(et)-.1 G .27(he ne)-2.77 F 2.77(wd)-.25 G .27
+(estination \214le, the)-2.77 F F3 -.8(Pe)2.77 G(rl).8 E F0 .271
+(subroutine speci\214ed in the rule is in)2.77 F -.2(vo)-.4 G -.1(ke).2
+G .271(d, with an ar).1 F .271(gument that)-.18 F .66
+(is the base name of the \214les in question.)108 568.8 R .659
+(Simple cases just in)5.659 F -.2(vo)-.4 G(lv).2 E 3.159(eas)-.15 G .659
+(ubroutine in)-3.159 F -.2(vo)-.4 G .659(king an e).2 F .659
+(xternal pro-)-.15 F .212(gram; this can be done by follo)108 580.8 R
+.212(wing the templates belo)-.25 F 1.512 -.65(w, e)-.25 H -.15(ve).4 G
+2.712(nb).15 G 2.712(yt)-2.712 G .212(hose without kno)-2.712 F .213
+(wledge of the)-.25 F F3 -.8(Pe)2.713 G(rl).8 E F0(pro-)2.713 E
+(gramming language.)108 592.8 Q(Of course, e)5 E
 (xperts could do something much more elaborate.)-.15 E 1.326
-(One other item in each custom-dependenc)108 444 R 3.826(yr)-.15 G 1.326
-(ule labelled "must" abo)-3.826 F 1.626 -.15(ve s)-.15 H 1.326
+(One other item in each custom-dependenc)108 616.8 R 3.826(yr)-.15 G
+1.326(ule labelled "must" abo)-3.826 F 1.626 -.15(ve s)-.15 H 1.326
 (peci\214es ho).15 F 3.826(wt)-.25 G 1.326(he rule should be)-3.826 F
-(applied when the source \214le f)108 456 Q(ails to e)-.1 E(xist.)-.15 E
-2.5(As)108 480 S(imple and typical e)-2.5 E
+(applied when the source \214le f)108 628.8 Q(ails to e)-.1 E(xist.)-.15
+E 2.5(As)108 652.8 S(imple and typical e)-2.5 E
 (xample of code in an initialization rc\214le is)-.15 E
-(add_cus_dep\( '\214g', 'eps', 0, '\214g2eps' \);)118 504 Q
-(sub \214g2eps {)118 516 Q(system\("\214g2de)128 528 Q 2.5(v-)-.25 G
-(Leps $_[0].\214g $_[0].eps"\);)-2.5 E(})118 540 Q .25
-(The \214rst line adds a custom dependenc)108 564 R 2.75(yt)-.15 G .25
-(hat con)-2.75 F -.15(ve)-.4 G .25(rts a \214le with e).15 F .25
-(xtension "\214g", as created by the x\214g pro-)-.15 F .324
-(gram, to an encapsulated postscript \214le, with e)108 576 R .325
-(xtension "eps".)-.15 F .325
-(The remaining lines de\214ne a subroutine that)5.325 F .203
-(carries out the con)108 588 R -.15(ve)-.4 G 2.703(rsion. If).15 F 2.703
+(add_cus_dep\( '\214g', 'eps', 0, '\214g2eps' \);)118 676.8 Q
+(sub \214g2eps {)118 688.8 Q(system\( "\214g2de)128 700.8 Q 2.5(v-)-.25
+G(Leps)-2.5 E(})118 712.8 Q(11 No)267.545 768 Q -.15(ve)-.15 G
+(mber 2012).15 E(29)185.545 E 0 Cg EP
+%%Page: 30 30
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E .25(The \214rst line adds a custom dependenc)108 84
+R 2.75(yt)-.15 G .25(hat con)-2.75 F -.15(ve)-.4 G .25
+(rts a \214le with e).15 F .25
+(xtension "\214g", as created by the x\214g pro-)-.15 F .325
+(gram, to an encapsulated postscript \214le, with e)108 96 R .325
+(xtension "eps".)-.15 F .324
+(The remaining lines de\214ne a subroutine that)5.325 F .202
+(carries out the con)108 108 R -.15(ve)-.4 G 2.702(rsion. If).15 F 2.703
 (ar)2.703 G .203(ule for con)-2.703 F -.15(ve)-.4 G .203
-(rting "\214g" to "eps" \214les already e).15 F .202
+(rting "\214g" to "eps" \214les already e).15 F .203
 (xists \(e.g., from a pre)-.15 F(viously)-.25 E
-(read-in initialization \214le\), the)108 600 Q F2(late)2.5 E(xmk)-.2 E
-F0(will delete this rule before making the ne)2.5 E 2.5(wo)-.25 G(ne.)
--2.5 E(Suppose)108 624 Q F2(late)4.08 E(xmk)-.2 E F0 1.58
-(is using this rule to con)4.08 F -.15(ve)-.4 G 1.581
-(rt a \214le "\214gure.\214g" to "\214gure.eps".).15 F 1.581
-(Then it will in)6.581 F -.2(vo)-.4 G 1.781 -.1(ke t).2 H(he).1 E 1.263
-(\214g2eps subroutine de\214ned in the abo)108 636 R 1.563 -.15(ve c)
+(read-in initialization \214le\), the)108 120 Q/F1 10/Times-Italic@0 SF
+(late)2.5 E(xmk)-.2 E F0(will delete this rule before making the ne)2.5
+E 2.5(wo)-.25 G(ne.)-2.5 E(Suppose)108 144 Q F1(late)4.081 E(xmk)-.2 E
+F0 1.581(is using this rule to con)4.081 F -.15(ve)-.4 G 1.581
+(rt a \214le "\214gure.\214g" to "\214gure.eps".).15 F 1.58
+(Then it will in)6.58 F -.2(vo)-.4 G 1.78 -.1(ke t).2 H(he).1 E 1.263
+(\214g2eps subroutine de\214ned in the abo)108 156 R 1.563 -.15(ve c)
 -.15 H 1.263(ode with a single ar).15 F 1.263
 (gument "\214gure", which is the basename of)-.18 F .877
-(each of the \214les \(possibly with a path component\).)108 648 R .877
-(This ar)5.877 F .877(gument is referred to by)-.18 F F2 -.8(Pe)3.377 G
-(rl).8 E F0 .877(as $_[0].)3.377 F .877(In the)5.877 F -.15(ex)108 660 S
+(each of the \214les \(possibly with a path component\).)108 168 R .877
+(This ar)5.877 F .877(gument is referred to by)-.18 F F1 -.8(Pe)3.377 G
+(rl).8 E F0 .876(as $_[0].)3.377 F .876(In the)5.876 F -.15(ex)108 180 S
 .66(ample abo).15 F -.15(ve)-.15 G 3.16(,t).15 G .66
-(he subroutine uses the)-3.16 F F2 -.8(Pe)3.16 G(rl).8 E F0 .66
+(he subroutine uses the)-3.16 F F1 -.8(Pe)3.16 G(rl).8 E F0 .66
 (command system to in)3.16 F -.2(vo)-.4 G .86 -.1(ke t).2 H .66
-(he program \214g2de).1 F 4.46 -.65(v. T)-.25 H .66(he double).65 F .364
-(quotes around the string are a)108 672 R F2 -.8(Pe)2.864 G(rl).8 E F0
-.365(idiom that signify that each string of the form of a v)2.864 F .365
+(he program \214g2de).1 F 4.46 -.65(v. T)-.25 H .66(he double).65 F .365
+(quotes around the string are a)108 192 R F1 -.8(Pe)2.865 G(rl).8 E F0
+.364(idiom that signify that each string of the form of a v)2.865 F .364
 (ariable name, $_[0])-.25 F(in this case, is to be substituted by its v)
-108 684 Q(alue.)-.25 E 1.327(If the return v)108 708 R 1.327
-(alue of the subroutine is non-zero, then)-.25 F F2(late)3.826 E(xmk)-.2
-E F0 1.326(will assume an error occurred during the)3.826 F -.15(exe)108
-720 S .458(cution of the subroutine.).15 F .458(In the abo)5.458 F .758
+108 204 Q(alue.)-.25 E 1.326(If the return v)108 228 R 1.326
+(alue of the subroutine is non-zero, then)-.25 F F1(late)3.827 E(xmk)-.2
+E F0 1.327(will assume an error occurred during the)3.827 F -.15(exe)108
+240 S .459(cution of the subroutine.).15 F .458(In the abo)5.459 F .758
 -.15(ve ex)-.15 H .458(ample, no e).15 F .458(xplicit return v)-.15 F
-.458(alue is gi)-.25 F -.15(ve)-.25 G .459(n, and instead the return).15
-F 2.5(7M)281.835 768 S(ay 2011)-2.5 E(23)199.835 E 0 Cg EP
-%%Page: 24 24
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E -.25(va)108 84 S .253(lue is the v).25 F .253
+.458(alue is gi)-.25 F -.15(ve)-.25 G .458(n, and instead the return).15
+F -.25(va)108 252 S .252(lue is the v).25 F .253
 (alue returned by the last \(and only\) statement, i.e., the in)-.25 F
--.2(vo)-.4 G .252(cation of system, which returns the).2 F -.25(va)108
-96 S(lue 0 on success.).25 E 1.017
-(If you use \214lenames with spaces in them, and if your LaT)108 120 R
-1.017(eX system and all other rele)-.7 F -.25(va)-.25 G 1.018(nt softw)
-.25 F 1.018(are cor)-.1 F(-)-.2 E .087(rectly handle such \214lenames, \
-then you could put single quotes around \214lenames in the command line\
- that is)108 132 R -.15(exe)108 144 S(cuted:).15 E
-(add_cus_dep\( '\214g', 'eps', 0, '\214g2eps' \);)118 168 Q
-(sub \214g2eps {)118 180 Q(system\("\214g2de)128 192 Q 2.5(v-)-.25 G
-(Lps '$_[0].\214g' '$_[0].eps'"\);)-2.5 E(})118 204 Q .62
-(This causes the in)108 228 R -.2(vo)-.4 G .62(cation of the).2 F/F1 10
-/Times-Italic@0 SF(\214g2de)3.12 E(v)-.15 E F0 .621(program to ha)3.121
-F .921 -.15(ve q)-.2 H .621(uoted \214lenames; it should therefore w).15
-F .621(ork with)-.1 F .156(\214lenames containing spaces.)108 240 R/F2
-10/Times-Bold@0 SF(Ho)5.156 E(we)-.1 E -.1(ve)-.15 G 1.996 -.92(r, n).1
-H .156(ot all softwar).92 F 2.655(ed)-.18 G .155(eals corr)-2.655 F .155
-(ectly with \214lenames that contain spa-)-.18 F 4.002(ces. Mor)108 252
-R(eo)-.18 E -.1(ve)-.1 G 3.342 -.92(r, t).1 H 1.502(he rules, if any).92
-F 4.002(,f)-.55 G 1.502(or quoting \214lenames v)-4.252 F 1.503
-(ary between operating systems, command)-.1 F(shells and indi)108 264 Q
-(vidual pieces of softwar)-.1 E(e, so this code may not always w)-.18 E
-(ork.)-.1 E F0 .516(If you use pd\215ate)108 288 R 3.016(xi)-.15 G .516
-(nstead of late)-3.016 F .515(x, then you will probably prefer to con)
--.15 F -.15(ve)-.4 G .515(rt your graphics \214les to pdf for).15 F(-)
--.2 E(mat, in which case you w)108 300 Q(ould replace the abo)-.1 E .3
--.15(ve c)-.15 H(ode in an initialization \214le by).15 E
+-.2(vo)-.4 G .253(cation of system, which returns the).2 F -.25(va)108
+264 S(lue 0 on success.).25 E .516(If you use pd\215ate)108 288 R 3.016
+(xi)-.15 G .516(nstead of late)-3.016 F .515
+(x, then you will probably prefer to con)-.15 F -.15(ve)-.4 G .515
+(rt your graphics \214les to pdf for).15 F(-)-.2 E
+(mat, in which case you w)108 300 Q(ould replace the abo)-.1 E .3 -.15
+(ve c)-.15 H(ode in an initialization \214le by).15 E
 (add_cus_dep\( '\214g', 'pdf, 0, '\214g2pdf)118 324 Q 2.5('\)).55 G(;)
--2.5 E(sub \214g2pdf {)118 336 Q(system\("\214g2de)128 348 Q 2.5(v-)-.25
-G(Lpdf $_[0].\214g $_[0].pdf"\);)-2.5 E(})118 360 Q .01(If you ha)108
-384 R .31 -.15(ve s)-.2 H .011(ome general custom dependencies de\214ne\
-d in the system or user initialization \214le, you may \214nd).15 F
-1.437(that for a particular project the)108 396 R 3.937(ya)-.15 G 1.437
-(re undesirable.)-3.937 F 1.436(So you might w)6.437 F 1.436
+-2.5 E(sub \214g2pdf {)118 336 Q(system\( "\214g2de)128 348 Q 2.5(v-)
+-.25 G(Lpdf)-2.5 E(})118 360 Q/F2 10/Times-Bold@0 SF .812(Note 1:)108
+384 R F0 .812(In the command lines gi)3.312 F -.15(ve)-.25 G 3.312(ni)
+.15 G 3.312(nt)-3.312 G .812(he system commands in the abo)-3.312 F
+1.113 -.15(ve ex)-.15 H .813(amples, double quotes ha).15 F -.15(ve)-.2
+G 1.21(been inserted around the \214le names \(implemented by ' of the \
+program ag)108 396 R 1.21(ainst special characters in \214le-)-.05 F
+2.642(names. V)108 408 R .142(ery often these quotes are not necessary)
+-1.11 F 2.642(,i)-.65 G .142(.e., the)-2.642 F 2.642(yc)-.15 G .142
+(an be omitted.)-2.642 F .142(But it is normally safer to k)5.142 F(eep)
+-.1 E .587(them in.)108 420 R(Ev)5.587 E .587
+(en though the rules for quoting v)-.15 F .586
+(ary between operating systems, command shells and indi)-.25 F(vid-)-.25
+E(ual pieces of softw)108 432 Q(are, the quotes in the abo)-.1 E .3 -.15
+(ve ex)-.15 H(amples do not cause problems in the cases I ha).15 E .3
+-.15(ve t)-.2 H(ested.).15 E F2 .271(Note 2:)108 456 R F0 .272(One case\
+ in which the quotes are important is when the \214les are in a subdire\
+ctory and your operat-)2.771 F .832(ing system is Microsoft W)108 468 R
+(indo)-.4 E 3.332(ws. Then)-.25 F .831
+(the separator character for directory components can be either a)3.331
+F(forw)108 480 Q .758(ard slash '/' or Microsoft')-.1 F 3.258(sm)-.55 G
+.759(ore usual backw)-3.258 F .759(ard slash sanity from softw)-.1 F
+.759(are lik)-.1 F 3.259(eM)-.1 G(iKT)-3.259 E .759(eX that mix)-.7 F
+(es)-.15 E .768(both directory separators; b)108 492 R .768
+(ut their correct use normally requires quoted \214lenames.)-.2 F .767
+(\(See a log \214le from a)5.767 F(run of MiKT)108 504 Q
+(eX \(at least in v)-.7 E 2.5(.2)-.65 G(.9\) for an e)-2.5 E
+(xample of the use of both directory separators.\))-.15 E .01(If you ha)
+108 528 R .31 -.15(ve s)-.2 H .011(ome general custom dependencies de\
+\214ned in the system or user initialization \214le, you may \214nd).15
+F 1.437(that for a particular project the)108 540 R 3.937(ya)-.15 G
+1.437(re undesirable.)-3.937 F 1.436(So you might w)6.437 F 1.436
 (ant to delete the unneeded ones.)-.1 F -.15(Fo)6.436 G(r).15 E -.15(ex)
-108 408 S(ample, you remo).15 E .3 -.15(ve a)-.15 H .3 -.15(ny ").15 H
-(\214g" to "eps" rule by the line).15 E(remo)118 432 Q -.15(ve)-.15 G
-(_cus_dep\( '\214g', 'eps' \);).15 E .648(If you ha)108 456 R .949 -.15
+108 552 S(ample, you remo).15 E .3 -.15(ve a)-.15 H .3 -.15(ny ").15 H
+(\214g" to "eps" rule by the line).15 E(remo)118 576 Q -.15(ve)-.15 G
+(_cus_dep\( '\214g', 'eps' \);).15 E .648(If you ha)108 600 R .949 -.15
 (ve c)-.2 H .649(omplicated sets of custom dependencies, you may w).15 F
 .649(ant to get a listing of the custom depen-)-.1 F 2.5(dencies. This)
-108 468 R(is done by using the line)2.5 E(sho)118 492 Q(w_cus_dep\(\);)
--.25 E(in an initialization \214le.)108 516 Q .852(Another e)108 540 R
+108 612 R(is done by using the line)2.5 E(sho)118 636 Q(w_cus_dep\(\);)
+-.25 E(in an initialization \214le.)108 660 Q .852(Another e)108 684 R
 .852(xample of a custom dependenc)-.15 F 3.352(yo)-.15 G -.15(ve)-3.502
 G .851(rcomes a limitation of).15 F F1(late)3.351 E(xmk)-.2 E F0 .851
 (concerning inde)3.351 F 3.351<788c>-.15 G 3.351(les. The)-3.351 F .123
-(only inde)108 552 R .123(x-\214le con)-.15 F -.15(ve)-.4 G .123
+(only inde)108 696 R .123(x-\214le con)-.15 F -.15(ve)-.4 G .123
 (rsion b).15 F .123(uilt-in to)-.2 F F1(late)2.623 E(xmk)-.2 E F0 .123
 (is from an ".idx" \214le written on one run of late)2.623 F
 (x/pd\215ate)-.15 E 2.624(xt)-.15 G 2.624(oa)-2.624 G(n)-2.624 E .662
-(".ind" \214le to be read in on a subsequent run.)108 564 R .661
+(".ind" \214le to be read in on a subsequent run.)108 708 R .661
 (But with the inde)5.662 F .661(x.sty package you can create e)-.15 F
-.661(xtra inde)-.15 F -.15(xe)-.15 G(s).15 E .689(with e)108 576 R .689
-(xtensions that you con\214gure.)-.15 F F1(Late)5.689 E(xmk)-.2 E F0
-.689(does not kno)3.189 F 3.189(wh)-.25 G 1.189 -.25(ow t)-3.189 H 3.19
-(od).25 G .69(educe the e)-3.19 F .69(xtensions from the infor)-.15 F(-)
--.2 E .335(mation it has.)108 588 R .335
-(But you can easily write a custom dependenc)5.335 F 4.135 -.65(y. F)
--.15 H .335(or e).5 F .335(xample if your late)-.15 F 2.834<788c>-.15 G
-.334(le uses the com-)-2.834 F 1.242(mand "\\ne)108 600 R(winde)-.25 E
-1.242(x{special}{ndx}{nnd}{Special inde)-.15 F 1.243
-(x}" you will need to con)-.15 F -.15(ve)-.4 G 1.243
-(rt \214les with the e).15 F(xtension)-.15 E F1(.ndx)108 612 Q F0(to)2.5
-E F1(.nnd)2.5 E F0 5(.T)C(he follo)-5 E
-(wing lines in an initialization RC \214le will cause this to happen:)
--.25 E(add_cus_dep\('ndx', 'nnd', 0, 'mak)118 636 Q(endx2nnd'\);)-.1 E
-(sub mak)118 648 Q(endx2nnd {)-.1 E(system\("mak)128 660 Q(einde)-.1 E
-2.5(x-)-.15 G 2.5(o$)-2.5 G(_[0].nnd $_[0].ndx"\);)-2.5 E(})118 672 Q
-(\(Y)108 696 Q .466(ou will need to modify this code if you use \214len\
-ames with spaces in them, to pro)-1.1 F .465(vide correct quoting of)
--.15 F(the \214lenames.\))108 708 Q 2.5(7M)281.835 768 S(ay 2011)-2.5 E
-(24)199.835 E 0 Cg EP
-%%Page: 25 25
+.661(xtra inde)-.15 F -.15(xe)-.15 G(s).15 E 2.406(with e)108 720 R
+2.406(xtensions that you con\214gure.)-.15 F F1(Late)7.406 E(xmk)-.2 E
+F0 2.407(does not kno)4.907 F 4.907(wh)-.25 G 2.907 -.25(ow t)-4.907 H
+4.907(od).25 G 2.407(educe the e)-4.907 F 2.407(xtensions from the)-.15
+F(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(30)185.545 E 0 Cg
+EP
+%%Page: 31 31
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E .977(Those of you with e)108 84 R .977
-(xperience with Mak)-.15 F .978
-(e\214les, will undoubtedly be concerned that the)-.1 F/F1 10
-/Times-Italic@0 SF(.ndx)3.478 E F0 .978(\214le is written)3.478 F .119
-(during a run of late)108 96 R(x/pd\215ate)-.15 E 2.619(xa)-.15 G .119
-(nd is al)-2.619 F -.1(wa)-.1 G .119(ys later than the).1 F F1(.nnd)
-2.619 E F0 .119(last read in.)2.619 F .119(Thus the)5.119 F F1(.nnd)
-2.619 E F0 .119(appears to be per)2.619 F(-)-.2 E .124
-(petually out-of-date.)108 108 R .125
+(TEXMK\(1L\))-1.11 E .554(information it has.)108 84 R .554
+(But you can easily write a custom dependenc)5.554 F 4.354 -.65(y. F)
+-.15 H .554(or e).5 F .554(xample if your late)-.15 F 3.054<788c>-.15 G
+.553(le uses the)-3.054 F .89(command "\\ne)108 96 R(winde)-.25 E .89
+(x{special}{ndx}{nnd}{Special inde)-.15 F .89(x}" you will need to con)
+-.15 F -.15(ve)-.4 G .89(rt \214les with the e).15 F(xten-)-.15 E(sion)
+108 108 Q/F1 10/Times-Italic@0 SF(.ndx)2.5 E F0(to)2.5 E F1(.nnd)2.5 E
+F0 5(.T)C(he follo)-5 E
+(wing lines in an initialization RC \214le will cause this to happen:)
+-.25 E(add_cus_dep\('ndx', 'nnd', 0, 'mak)118 132 Q(endx2nnd'\);)-.1 E
+(sub mak)118 144 Q(endx2nnd {)-.1 E(system\( "mak)128 156 Q(einde)-.1 E
+2.5(x-)-.15 G(o)-2.5 E(})118 168 Q(\(Y)108 192 Q .466(ou will need to m\
+odify this code if you use \214lenames with spaces in them, to pro)-1.1
+F .465(vide correct quoting of)-.15 F(the \214lenames.\))108 204 Q .977
+(Those of you with e)108 228 R .977(xperience with Mak)-.15 F .978
+(e\214les, will undoubtedly be concerned that the)-.1 F F1(.ndx)3.478 E
+F0 .978(\214le is written)3.478 F .119(during a run of late)108 240 R
+(x/pd\215ate)-.15 E 2.619(xa)-.15 G .119(nd is al)-2.619 F -.1(wa)-.1 G
+.119(ys later than the).1 F F1(.nnd)2.619 E F0 .119(last read in.)2.619
+F .119(Thus the)5.119 F F1(.nnd)2.619 E F0 .119(appears to be per)2.619
+F(-)-.2 E .124(petually out-of-date.)108 252 R .125
 (This situation, of circular dependencies, is endemic to late)5.124 F
 .125(x, and)-.15 F F1(late)2.625 E(xmk)-.2 E F0 .125(in its current)
-2.625 F -.15(ve)108 120 S .261(rsion w).15 F .261
+2.625 F -.15(ve)108 264 S .261(rsion w).15 F .261
 (orks correctly with circular dependencies.)-.1 F .261(It e)5.261 F .26
 (xamines the contents of the \214les \(by use of an md5)-.15 F
-(checksum\), and only does a remak)108 132 Q 2.5(ew)-.1 G
+(checksum\), and only does a remak)108 276 Q 2.5(ew)-.1 G
 (hen the \214le contents ha)-2.5 E .3 -.15(ve a)-.2 H(ctually changed.)
-.15 E .746(Of course if you choose to write random data to the)108 156 R
+.15 E .746(Of course if you choose to write random data to the)108 300 R
 F1(.nnd)3.247 E F0 .747(\(or and)3.247 F F1(.aux)3.247 E F0 .747
 (\214le, etc\) that changes on each ne)3.247 F(w)-.25 E .267
-(run, then you will ha)108 168 R .567 -.15(ve a p)-.2 H 2.767(roblem. F)
+(run, then you will ha)108 312 R .567 -.15(ve a p)-.2 H 2.767(roblem. F)
 .15 F .267(or real e)-.15 F .267(xperts: See the)-.15 F F1
 (%hash_cal_ignor)2.767 E(e_pattern)-.37 E F0 .267(if you ha)2.767 F .567
--.15(ve t)-.2 H 2.767(od).15 G(eal)-2.767 E(with such problems.)108 180
-Q(Glossaries can be dealt with similarly)108 204 Q(.)-.65 E/F2 10.95
-/Times-Bold@0 SF(OLD METHOD OF DEFINING CUST)72 232.8 Q(OM DEPENDENCIES)
--.197 E F0 .406(In pre)108 244.8 R .406(vious v)-.25 F .406(ersions of)
+-.15(ve t)-.2 H 2.767(od).15 G(eal)-2.767 E(with such problems.)108 324
+Q(Glossaries can be dealt with similarly)108 348 Q(.)-.65 E/F2 10.95
+/Times-Bold@0 SF(OLD METHOD OF DEFINING CUST)72 376.8 Q(OM DEPENDENCIES)
+-.197 E F0 .406(In pre)108 388.8 R .406(vious v)-.25 F .406(ersions of)
 -.15 F F1(late)2.906 E(xmk)-.2 E F0 2.906(,t)C .406
 (he only method of de\214ning custom dependencies w)-2.906 F .406
 (as to directly manipu-)-.1 F 1.557
-(late the table of custom dependencies.)108 256.8 R 1.557
+(late the table of custom dependencies.)108 400.8 R 1.557
 (This is contained in the)6.557 F/F3 10/Times-Bold@0 SF(@cus_dep_list)
 4.057 E F0(array)4.057 E 6.557(.I)-.65 G 4.057(ti)-6.557 G 4.057(sa)
 -4.057 G 4.057(na)-4.057 G 1.557(rray of)-4.057 F .454(strings, and eac\
 h string in the array has four items in it, each separated by a space, \
-the from-e)108 268.8 R .455(xtension, the)-.15 F(to-e)108 280.8 Q .686(\
+the from-e)108 412.8 R .455(xtension, the)-.15 F(to-e)108 424.8 Q .686(\
 xtension, the "must" item, and the name of the subroutine for the custo\
 m dependenc)-.15 F 4.485 -.65(y. T)-.15 H .685(hese were all).65 F
-(de\214ned abo)108 292.8 Q -.15(ve)-.15 G(.).15 E .195(An e)108 309.6 R
+(de\214ned abo)108 436.8 Q -.15(ve)-.15 G(.).15 E .195(An e)108 453.6 R
 .195
 (xample of the old method of de\214ning custom dependencies is as follo)
 -.15 F .196(ws. It is the code in an RC \214le to)-.25 F
-(ensure automatic con)108 321.6 Q -.15(ve)-.4 G(rsion of).15 E F1
+(ensure automatic con)108 465.6 Q -.15(ve)-.4 G(rsion of).15 E F1
 (.\214g)2.5 E F0(\214les to)2.5 E F1(.eps)2.5 E F0(\214les:)2.5 E
-(push @cus_dep_list, "\214g eps 0 \214g2eps";)118 345.6 Q
-(sub \214g2eps {)118 357.6 Q(system\("\214g2de)128 369.6 Q 2.5(v-)-.25 G
-(Lps $_[0].\214g $_[0].eps"\);)-2.5 E(})118 381.6 Q .245
-(This method still w)108 405.6 R .245(orks, and is equi)-.1 F -.25(va)
--.25 G .244
+(push @cus_dep_list, "\214g eps 0 \214g2eps";)118 489.6 Q
+(sub \214g2eps {)118 501.6 Q(system\( "\214g2de)128 513.6 Q 2.5(v-)-.25
+G(Lps)-2.5 E(})118 525.6 Q .245(This method still w)108 549.6 R .245
+(orks, and is equi)-.1 F -.25(va)-.25 G .244
 (lent to the earlier code using the add_cus_dep subroutine, e).25 F .244
-(xcept that)-.15 F .791(it doesn')108 417.6 R 3.291(td)-.18 G .791
+(xcept that)-.15 F .791(it doesn')108 561.6 R 3.291(td)-.18 G .791
 (elete an)-3.291 F 3.291(yp)-.15 G(re)-3.291 E .791
 (vious custom-dependenc)-.25 F 3.291(yf)-.15 G .791(or the same con)
 -3.291 F -.15(ve)-.4 G 3.291(rsion. So).15 F .792(the ne)3.292 F 3.292
-(wm)-.25 G .792(ethod is prefer)-3.292 F(-)-.2 E(able.)108 429.6 Q F2
-(USING)72 482.4 Q/F4 10.95/Times-Italic@0 SF(late)2.738 E(xmk)-.219 E/F5
+(wm)-.25 G .792(ethod is prefer)-3.292 F(-)-.2 E(able.)108 573.6 Q F2
+(USING)72 626.4 Q/F4 10.95/Times-Italic@0 SF(late)2.738 E(xmk)-.219 E/F5
 10.95/Times-Roman@0 SF(WITH)2.738 E F4(mak)2.738 E(e)-.11 E F0 .17
-(This section is tar)108 494.4 R .17(geted only at adv)-.18 F .17
+(This section is tar)108 638.4 R .17(geted only at adv)-.18 F .17
 (anced users who use the)-.25 F F1(mak)2.669 E(e)-.1 E F0 .169
 (program for comple)2.669 F 2.669(xp)-.15 G .169(rojects, as for soft-)
--2.669 F -.1(wa)108 506.4 S(re de).1 E -.15(ve)-.25 G
+-2.669 F -.1(wa)108 650.4 S(re de).1 E -.15(ve)-.25 G
 (lopment, with the dependencies speci\214ed by a Mak).15 E(e\214le.)-.1
-E(No)108 530.4 Q 3.272(wt)-.25 G .772(he basic task of)-3.272 F F1(late)
+E(No)108 674.4 Q 3.272(wt)-.25 G .772(he basic task of)-3.272 F F1(late)
 3.272 E(xmk)-.2 E F0 .773(is to run the appropriate programs to mak)
 3.272 F 3.273(eav)-.1 G(ie)-3.273 E -.1(wa)-.25 G .773(ble v).1 F .773
-(ersion of a LaT)-.15 F(eX)-.7 E 2.884(document. Ho)108 542.4 R(we)-.25
+(ersion of a LaT)-.15 F(eX)-.7 E 2.884(document. Ho)108 686.4 R(we)-.25
 E -.15(ve)-.25 G 1.184 -.4(r, t).15 H .384(he usual).4 F F1(mak)2.884 E
 (e)-.1 E F0 .384(program is not suited to this purpose for at least tw)
 2.884 F 2.884(or)-.1 G 2.883(easons. First)-2.884 F(is)2.883 E .633
-(that the use of LaT)108 554.4 R .633(eX in)-.7 F -.2(vo)-.4 G(lv).2 E
+(that the use of LaT)108 698.4 R .633(eX in)-.7 F -.2(vo)-.4 G(lv).2 E
 .634(es circular dependencies \(e.g., via .aux \214les\), and these can\
-not be handled by)-.15 F .257(the standard)108 566.4 R F1(mak)2.757 E(e)
+not be handled by)-.15 F .257(the standard)108 710.4 R F1(mak)2.757 E(e)
 -.1 E F0 2.757(program. Second)2.757 F .257(is that in a lar)2.757 F
 .257(ge document the set of source \214les can change quite fre-)-.18 F
-(quently)108 578.4 Q 3.201(,p)-.65 G .701
+(quently)108 722.4 Q 3.201(,p)-.65 G .701
 (articularly with included graphics \214les; in this situation k)-3.201
-F .702(eeping a Mak)-.1 F .702(e\214le manually updated is)-.1 F .49
-(inappropriate and error)108 590.4 R .49(-prone, especially when the de\
-pedencies can be determined automatically)-.2 F(.)-.65 E F1(Late)5.49 E
-(xmk)-.2 E F0(solv)108 602.4 Q(es both of these problems rob)-.15 E
-(ustly)-.2 E(.)-.65 E .762(Thus for man)108 626.4 R 3.262(ys)-.15 G .762
-(tandard LaT)-3.262 F .762(eX documents)-.7 F F1(late)3.262 E(xmk)-.2 E
-F0 .762(can be used by itself without the)3.262 F F1(mak)3.263 E(e)-.1 E
-F0 3.263(program. In)3.263 F(a)3.263 E(comple)108 638.4 Q 2.505(xp)-.15
-G .005(roject it simply needs to be suitably con\214gured.)-2.505 F
-2.504(As)5.004 G .004(tandard con\214guration w)-2.504 F .004
-(ould be to de\214ne cus-)-.1 F .259(tom dependencies to mak)108 650.4 R
+F .702(eeping a Mak)-.1 F .702(e\214le manually updated is)-.1 F(11 No)
+267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(31)185.545 E 0 Cg EP
+%%Page: 32 32
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E .49(inappropriate and error)108 84 R .49(-prone, e\
+specially when the depedencies can be determined automatically)-.2 F(.)
+-.65 E/F1 10/Times-Italic@0 SF(Late)5.49 E(xmk)-.2 E F0(solv)108 96 Q
+(es both of these problems rob)-.15 E(ustly)-.2 E(.)-.65 E .762
+(Thus for man)108 120 R 3.262(ys)-.15 G .762(tandard LaT)-3.262 F .762
+(eX documents)-.7 F F1(late)3.262 E(xmk)-.2 E F0 .762
+(can be used by itself without the)3.262 F F1(mak)3.263 E(e)-.1 E F0
+3.263(program. In)3.263 F(a)3.263 E(comple)108 132 Q 2.505(xp)-.15 G
+.005(roject it simply needs to be suitably con\214gured.)-2.505 F 2.504
+(As)5.004 G .004(tandard con\214guration w)-2.504 F .004
+(ould be to de\214ne cus-)-.1 F .259(tom dependencies to mak)108 144 R
 2.759(eg)-.1 G .259
 (raphics \214les from their source \214les \(e.g., as created by the)
 -2.759 F F1(x\214g)2.76 E F0 2.76(program\). Cus-)2.76 F
-(tom dependencies are)108 662.4 Q F1(late)2.5 E(xmk)-.2 E F0 1.1 -.55
+(tom dependencies are)108 156 Q F1(late)2.5 E(xmk)-.2 E F0 1.1 -.55
 ('s e)D(qui).55 E -.25(va)-.25 G(lent of pattern rules in Mak).25 E
-(e\214les.)-.1 E(Ne)108 686.4 Q -.15(ve)-.25 G 1.236
+(e\214les.)-.1 E(Ne)108 180 Q -.15(ve)-.25 G 1.236
 (rtheless there are projects for which a Mak).15 F 1.236
 (e\214le is appropriate, and it is useful to kno)-.1 F 3.736(wh)-.25 G
-1.736 -.25(ow t)-3.736 H 3.736(ou).25 G(se)-3.736 E F1(late)108 698.4 Q
+1.736 -.25(ow t)-3.736 H 3.736(ou).25 G(se)-3.736 E F1(late)108 192 Q
 (xmk)-.2 E F0 .998(from a Mak)3.498 F 3.498(e\214le. A)-.1 F .998
 (typical e)3.498 F .998(xample w)-.15 F .998
 (ould be to generate documentation for a softw)-.1 F .998(are project.)
 -.1 F .168
 (Potentially the interaction with the rest of the rules in the Mak)108
-710.4 R .168(e\214le could be quite complicated, for e)-.1 F(xample)-.15
-E(if some of the source \214les for a LaT)108 722.4 Q
+204 R .168(e\214le could be quite complicated, for e)-.1 F(xample)-.15 E
+(if some of the source \214les for a LaT)108 216 Q
 (eX document are generated by the project')-.7 E 2.5(ss)-.55 G(oftw)-2.5
-E(are.)-.1 E 2.5(7M)281.835 768 S(ay 2011)-2.5 E(25)199.835 E 0 Cg EP
-%%Page: 26 26
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E .555(In this section, I gi)108 84 R .855 -.15
-(ve a c)-.25 H .555(ouple of e).15 F .555(xamples of ho)-.15 F(w)-.25 E
-/F1 10/Times-Italic@0 SF(late)3.055 E(xmk)-.2 E F0 .555
-(can be usefully in)3.055 F -.2(vo)-.4 G -.1(ke).2 G 3.056(df).1 G .556
-(rom a Mak)-3.056 F 3.056(e\214le. The)-.1 F -.15(ex)108 96 S .036
-(amples use speci\214c features of current v).15 F .036(ersions of GNU)
--.15 F F1(mak)2.536 E(e)-.1 E F0 2.536(,w)C .035(hich is the def)-2.536
-F .035(ault on both linux and OS-)-.1 F 2.5(Xs)108 108 S 2.5
-(ystems. The)-2.5 F 2.5(ym)-.15 G(ay need modi\214cations for other v)
--2.5 E(ersions of)-.15 E F1(mak)2.5 E(e)-.1 E F0(.)A .622
-(The simplest method is simply to dele)108 132 R -.05(ga)-.15 G .622
-(te all the rele).05 F -.25(va)-.25 G .622(nt tasks to).25 F F1(late)
-3.122 E(xmk)-.2 E F0 3.122(,a)C 3.122(si)-3.122 G 3.123(ss)-3.122 G .623
-(uitable for a straightfor)-3.123 F(-)-.2 E -.1(wa)108 144 S(rd LaT).1 E
-(eX document.)-.7 E -.15(Fo)5 G 2.5(rt).15 G(his a suitable Mak)-2.5 E
-(e\214le is lik)-.1 E(e)-.1 E(.PHONY : FORCE_MAKE)118 168 Q(all : try)
-118 180 Q(.pdf)-.65 E(%.pdf : %.te)118 192 Q 2.5(xF)-.15 G(ORCE_MAKE)
--2.5 E(late)128 204 Q(xmk -pdf -dvi- -ps- $<)-.15 E .064
-(\(Note: the last line must be introduced by a tab for the Mak)108 228 R
+E(are.)-.1 E .555(In this section, I gi)108 240 R .855 -.15(ve a c)-.25
+H .555(ouple of e).15 F .555(xamples of ho)-.15 F(w)-.25 E F1(late)3.055
+E(xmk)-.2 E F0 .555(can be usefully in)3.055 F -.2(vo)-.4 G -.1(ke).2 G
+3.056(df).1 G .556(rom a Mak)-3.056 F 3.056(e\214le. The)-.1 F -.15(ex)
+108 252 S .036(amples use speci\214c features of current v).15 F .036
+(ersions of GNU)-.15 F F1(mak)2.536 E(e)-.1 E F0 2.536(,w)C .035
+(hich is the def)-2.536 F .035(ault on both linux and OS-)-.1 F 2.5(Xs)
+108 264 S 2.5(ystems. The)-2.5 F 2.5(ym)-.15 G
+(ay need modi\214cations for other v)-2.5 E(ersions of)-.15 E F1(mak)2.5
+E(e)-.1 E F0(.)A .622(The simplest method is simply to dele)108 288 R
+-.05(ga)-.15 G .622(te all the rele).05 F -.25(va)-.25 G .622
+(nt tasks to).25 F F1(late)3.122 E(xmk)-.2 E F0 3.122(,a)C 3.122(si)
+-3.122 G 3.123(ss)-3.122 G .623(uitable for a straightfor)-3.123 F(-)-.2
+E -.1(wa)108 300 S(rd LaT).1 E(eX document.)-.7 E -.15(Fo)5 G 2.5(rt).15
+G(his a suitable Mak)-2.5 E(e\214le is lik)-.1 E(e)-.1 E
+(.PHONY : FORCE_MAKE)118 324 Q(all : try)118 336 Q(.pdf)-.65 E
+(%.pdf : %.te)118 348 Q 2.5(xF)-.15 G(ORCE_MAKE)-2.5 E(late)128 360 Q
+(xmk -pdf -dvi- -ps- $<)-.15 E .064
+(\(Note: the last line must be introduced by a tab for the Mak)108 384 R
 .064(e\214le to function correctly!\))-.1 F(Naturally)5.064 E 2.563(,i)
--.65 G 2.563(fm)-2.563 G(aking)-2.563 E(try)108 240 Q 1.033
+-.65 G 2.563(fm)-2.563 G(aking)-2.563 E(try)108 396 Q 1.033
 (.pdf from its associated LaT)-.65 F 1.034(eX \214le try)-.7 F(.te)-.65
 E 3.534(xw)-.15 G 1.034
 (ere the only task to be performed, a direct use of)-3.534 F F1(late)
-3.534 E(xmk)-.2 E F0 .039(without a Mak)108 252 R .039(e\214le w)-.1 F
+3.534 E(xmk)-.2 E F0 .039(without a Mak)108 408 R .039(e\214le w)-.1 F
 .039(ould normally be better)-.1 F 5.039(.T)-.55 G .039
 (he bene\214t of using a Mak)-5.039 F .039(e\214le for a LaT)-.1 F .038
-(eX document w)-.7 F(ould)-.1 E(be in a lar)108 264 Q
+(eX document w)-.7 F(ould)-.1 E(be in a lar)108 420 Q
 (ger project, where lines such as the abo)-.18 E .3 -.15(ve w)-.15 H
 (ould be only be a small part of a lar).05 E(ger Mak)-.18 E(e\214le.)-.1
-E .241(The abo)108 288 R .541 -.15(ve ex)-.15 H .242
+E .241(The abo)108 444 R .541 -.15(ve ex)-.15 H .242
 (ample has a pattern rule for making a .pdf \214le from a .te).15 F
 2.742<788c>-.15 G .242(le, and it is de\214ned to use late)-2.742 F(xmk)
--.15 E .844(in the ob)108 300 R .844(vious w)-.15 F(ay)-.1 E 5.844(.T)
+-.15 E .844(in the ob)108 456 R .844(vious w)-.15 F(ay)-.1 E 5.844(.T)
 -.65 G .844(here is a con)-5.844 F -.15(ve)-.4 G .844(ntional def).15 F
 .844(ault tar)-.1 F .843(get named "all", with a prerequisite of try)
--.18 F 3.343(.pdf. So)-.65 F(when)108 312 Q F1(mak)2.591 E(e)-.1 E F0
+-.18 F 3.343(.pdf. So)-.65 F(when)108 468 Q F1(mak)2.591 E(e)-.1 E F0
 .091(is in)2.591 F -.2(vo)-.4 G -.1(ke).2 G .091(d, by def).1 F .091
 (ault it mak)-.1 F .091(es try)-.1 F 2.591(.pdf. The)-.65 F .091
 (only complication is that there may be man)2.591 F 2.592(ys)-.15 G
-(ource)-2.592 E .867(\214les be)108 324 R .867(yond try)-.15 F(.te)-.65
+(ource)-2.592 E .867(\214les be)108 480 R .867(yond try)-.15 F(.te)-.65
 E .867(x, b)-.15 F .867(ut these aren')-.2 F 3.367(ts)-.18 G .867
 (peci\214ed in the Mak)-3.367 F .866
 (e\214le, so changes in them will not by themselv)-.1 F(es)-.15 E(cause)
-108 336 Q F1(late)6.604 E(xmk)-.2 E F0 4.104(to be in)6.604 F -.2(vo)-.4
+108 492 Q F1(late)6.604 E(xmk)-.2 E F0 4.104(to be in)6.604 F -.2(vo)-.4
 G -.1(ke).2 G 6.604(d. Instead,).1 F 4.104
 (the pattern rule is equipped with a "phon)6.604 F 4.105
-(y" prerequisite)-.15 F .597(FORCE_MAKE; this has the ef)108 348 R .597
+(y" prerequisite)-.15 F .597(FORCE_MAKE; this has the ef)108 504 R .597
 (fect of causing the rule to be al)-.25 F -.1(wa)-.1 G .596
 (ys out-of-date, so that).1 F F1(late)3.096 E(xmk)-.2 E F0 .596(is al)
-3.096 F -.1(wa)-.1 G(ys).1 E 2.627(run. It)108 360 R(is)2.627 E F1(late)
+3.096 F -.1(wa)-.1 G(ys).1 E 2.627(run. It)108 516 R(is)2.627 E F1(late)
 2.627 E(xmk)-.2 E F0 .128(that decides whether an)2.627 F 2.628(ya)-.15
 G .128(ction is needed, e.g., a rerun of)-2.628 F F1(pd\215ate)2.628 E
 (x)-.2 E F0 5.128(.E)C -.25(ff)-5.128 G(ecti).25 E -.15(ve)-.25 G .128
-(ly the Mak).15 F(e-)-.1 E .011(\214le dele)108 372 R -.05(ga)-.15 G
+(ly the Mak).15 F(e-)-.1 E .011(\214le dele)108 528 R -.05(ga)-.15 G
 .011(tes all decisions to).05 F F1(late)2.511 E(xmk)-.2 E F0 2.511(,w)C
 (hile)-2.511 E F1(mak)2.511 E(e)-.1 E F0 .011(has no kno)2.511 F .01
 (wledge of the list of source \214les e)-.25 F .01(xcept for pri-)-.15 F
-.023(mary LaT)108 384 R .023(eX \214le for the)-.7 F 2.523(document. If)
+.023(mary LaT)108 540 R .023(eX \214le for the)-.7 F 2.523(document. If)
 5.023 F .024(there are, for e)2.524 F .024
 (xample, graphics \214les to be made, these must be made)-.15 F
-(by custom dependencies con\214gured in)108 396 Q F1(late)2.5 E(xmk)-.2
+(by custom dependencies con\214gured in)108 552 Q F1(late)2.5 E(xmk)-.2
 E F0(.)A .573
 (But something better is needed in more complicated situations, for e)
-108 420 R .572(xample, when the making of graphics)-.15 F
-(\214les needs to be speci\214ed by rules in the Mak)108 432 Q 2.5
+108 576 R .572(xample, when the making of graphics)-.15 F
+(\214les needs to be speci\214ed by rules in the Mak)108 588 Q 2.5
 (e\214le. T)-.1 F 2.5(od)-.8 G 2.5(ot)-2.5 G(his, one can use a Mak)-2.5
 E(e\214le lik)-.1 E 2.5(et)-.1 G(he follo)-2.5 E(wing:)-.25 E -.93(TA)
-120.5 456 S(RGETS = document1.pdf document2.pdf).93 E(DEPS_DIR = .deps)
-120.5 468 Q(LA)120.5 480 Q(TEXMK = late)-1.11 E(xmk -recorder -use-mak)
--.15 E 2.5(e-)-.1 G(deps \\)-2.5 E(-e 'w)135.5 492 Q(arn qq\(In Mak)-.1
+120.5 612 S(RGETS = document1.pdf document2.pdf).93 E(DEPS_DIR = .deps)
+120.5 624 Q(LA)120.5 636 Q(TEXMK = late)-1.11 E(xmk -recorder -use-mak)
+-.15 E 2.5(e-)-.1 G(deps \\)-2.5 E(-e 'w)135.5 648 Q(arn qq\(In Mak)-.1
 E(e\214le, turn of)-.1 E 2.5(fc)-.25 G(ustom dependencies0;' \\)-2.5 E
-(-e '@cus_dep_list = \(\);' \\)135.5 504 Q(-e ')135.5 516 Q(sho)-.55 E
-(w_cus_dep\(\);')-.25 E(all : $\(T)120.5 528 Q(ARGETS\))-.93 E
-($\(foreach \214le,$\(T)120.5 540 Q(ARGETS\),$\(e)-.93 E -.25(va)-.25 G
+(-e '@cus_dep_list = \(\);' \\)135.5 660 Q(-e ')135.5 672 Q(sho)-.55 E
+(w_cus_dep\(\);')-.25 E(all : $\(T)120.5 684 Q(ARGETS\))-.93 E
+($\(foreach \214le,$\(T)120.5 696 Q(ARGETS\),$\(e)-.93 E -.25(va)-.25 G
 2.5(l-).25 G(include $\(DEPS_DIR\)/$\(\214le\)P\)\))-2.5 E
-($\(DEPS_DIR\) :)120.5 552 Q(mkdir $@)138 564 Q(%.pdf : %.te)120.5 576 Q
-(x)-.15 E(if [ ! -e $\(DEPS_DIR\) ]; then mkdir $\(DEPS_DIR\); \214)138
-588 Q($\(LA)138 600 Q
-(TEXMK\) -pdf -dvi- -ps- -deps-out=$\(DEPS_DIR\)/$@P $<)-1.11 E
-(%.pdf : %.\214g)120.5 612 Q(\214g2de)138 624 Q 2.5(v-)-.25 G
-(Lpdf $< $@)-2.5 E(\(Ag)108 648 Q 1.102(ain, the lines containing the c\
+($\(DEPS_DIR\) :)120.5 708 Q(mkdir $@)138 720 Q(11 No)267.545 768 Q -.15
+(ve)-.15 G(mber 2012).15 E(32)185.545 E 0 Cg EP
+%%Page: 33 33
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E(%.pdf : %.te)120.5 84 Q(x)-.15 E
+(if [ ! -e $\(DEPS_DIR\) ]; then mkdir $\(DEPS_DIR\); \214)138 96 Q
+($\(LA)138 108 Q(TEXMK\) -pdf -dvi- -ps- -deps-out=$\(DEPS_DIR\)/$@P $<)
+-1.11 E(%.pdf : %.\214g)120.5 120 Q(\214g2de)138 132 Q 2.5(v-)-.25 G
+(Lpdf $< $@)-2.5 E(\(Ag)108 156 Q 1.102(ain, the lines containing the c\
 ommands for the rules should be started with tabs.\))-.05 F 1.102
-(This e)6.102 F 1.102(xample w)-.15 F(as)-.1 E(inspired by ho)108 660 Q
-2.5(wG)-.25 G(NU)-2.5 E F1(automak)2.5 E(e)-.1 E F0
+(This e)6.102 F 1.102(xample w)-.15 F(as)-.1 E(inspired by ho)108 168 Q
+2.5(wG)-.25 G(NU)-2.5 E/F1 10/Times-Italic@0 SF(automak)2.5 E(e)-.1 E F0
 (handles automatic dependenc)2.5 E 2.5(yt)-.15 G
-(racking of C source \214les.)-2.5 E .495(After each run of late)108 684
+(racking of C source \214les.)-2.5 E .495(After each run of late)108 192
 R .494(xmk, dependenc)-.15 F 2.994(yi)-.15 G .494
 (nformation is put in a \214le in the .deps subdirectory)-2.994 F 5.494
 (.T)-.65 G .494(he Mak)-5.494 F(e\214le)-.1 E .292
-(causes these dependenc)108 696 R 2.793<798c>-.15 G .293
+(causes these dependenc)108 204 R 2.793<798c>-.15 G .293
 (les to be read by)-2.793 F F1(mak)2.793 E(e)-.1 E F0 2.793(,w)C .293
 (hich no)-2.793 F 2.793(wh)-.25 G .293(as the full dependenc)-2.793 F
-2.793(yi)-.15 G .293(nformation for each)-2.793 F(tar)108 708 Q .442
+2.793(yi)-.15 G .293(nformation for each)-2.793 F(tar)108 216 Q .442
 (get .pdf \214le.)-.18 F 2.042 -.8(To m)5.442 H(ak).8 E 2.942(et)-.1 G
 .442(hings less tri)-2.942 F .442(vial it is speci\214ced that tw)-.25 F
 2.942<6f8c>-.1 G .441(les document1.pdf and document2.pdf)-2.942 F
-(are the tar)108 720 Q 2.5(gets. The)-.18 F(dependenc)2.5 E 2.5<798c>
+(are the tar)108 228 Q 2.5(gets. The)-.18 F(dependenc)2.5 E 2.5<798c>
 -.15 G(les are .deps/document1.pdfP and .deps/document2.pdfP)-2.5 E(.)
--1.11 E 2.5(7M)281.835 768 S(ay 2011)-2.5 E(26)199.835 E 0 Cg EP
-%%Page: 27 27
-%%BeginPageSetup
-BP
-%%EndPageSetup
-/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
-(TEXMK\(1L\))-1.11 E .688(There is no)108 84 R 3.188(wn)-.25 G 3.188(on)
--3.188 G .688(eed for the phon)-3.188 F 3.188(yp)-.15 G .689
+-1.11 E .688(There is no)108 252 R 3.188(wn)-.25 G 3.188(on)-3.188 G
+.688(eed for the phon)-3.188 F 3.188(yp)-.15 G .689
 (rerequisite for the rule to mak)-3.188 F 3.189(e.)-.1 G .689
 (pdf \214les from .te)-3.189 F 3.189<788c>-.15 G 3.189(les. But)-3.189 F
-3.189(Ih)3.189 G -2.25 -.2(av e)-3.189 H .714(added a rule to mak)108 96
-R 3.214(e.)-.1 G .714(pdf \214les from .\214g \214les produced by the)
--3.214 F/F1 10/Times-Italic@0 SF(x\214g)3.214 E F0 .713
-(program; these are commonly used for)3.213 F .057
-(graphics insertions in LaT)108 108 R .057(eX documents.)-.7 F F1(Late)
+3.189(Ih)3.189 G -2.25 -.2(av e)-3.189 H .714(added a rule to mak)108
+264 R 3.214(e.)-.1 G .714
+(pdf \214les from .\214g \214les produced by the)-3.214 F F1(x\214g)
+3.214 E F0 .713(program; these are commonly used for)3.213 F .057
+(graphics insertions in LaT)108 276 R .057(eX documents.)-.7 F F1(Late)
 5.057 E(xmk)-.2 E F0 .058(is arranged to output a dependenc)2.557 F
-2.558<798c>-.15 G .058(le after each run.)-2.558 F(It)5.058 E .414
-(is gi)108 120 R -.15(ve)-.25 G 2.914(nt).15 G(he)-2.914 E F1(-r)2.914 E
-(ecor)-.37 E(der)-.37 E F0 .414(option, which impro)2.914 F -.15(ve)-.15
-G 2.914(si).15 G .413(ts detection of \214les generated during a run of)
--2.914 F F1(pd\215ate)2.913 E(x)-.2 E F0 2.913(;s)C(uch)-2.913 E .304
-(\214les should not be in the dependenc)108 132 R 2.805(yl)-.15 G 2.805
-(ist. The)-2.805 F F1(-e)2.805 E F0 .305(options are used to turn of)
+2.558<798c>-.15 G .058(le after each run.)-2.558 F(It)5.058 E .251
+(is gi)108 288 R -.15(ve)-.25 G 2.751(nt).15 G(he)-2.751 E/F2 10
+/Times-Bold@0 SF(-r)2.751 E(ecorder)-.18 E F0 .251(option, which impro)
+2.751 F -.15(ve)-.15 G 2.751(si).15 G .25
+(ts detection of \214les generated during a run of)-2.751 F F1
+(pd\215ate)2.75 E(x)-.2 E F0 2.75(;s)C(uch)-2.75 E .304
+(\214les should not be in the dependenc)108 300 R 2.805(yl)-.15 G 2.805
+(ist. The)-2.805 F F2(-e)2.805 E F0 .305(options are used to turn of)
 2.805 F 2.805(fa)-.25 G .305(ll custom dependencies, and)-2.805 F
-(to document this.)108 144 Q(Instead the)5 E F1(-use-mak)2.5 E(e)-.1 E
+(to document this.)108 312 Q(Instead the)5 E F2(-use-mak)2.5 E(e)-.1 E
 F0(is used to dele)2.5 E -.05(ga)-.15 G
 (te the making of missing \214les to).05 E F1(mak)2.5 E(e)-.1 E F0
-(itself.)2.5 E .576(Suppose in the LaT)108 168 R .575
+(itself.)2.5 E .576(Suppose in the LaT)108 336 R .575
 (eX \214le there is a command \\include)-.7 F .575
 (graphics{graph}, and an)-.15 F F1(x\214g)3.075 E F0 .575
 (\214le "graph.\214g" e)3.075 F(xists.)-.15 E .626(On a \214rst run,)108
-180 R F1(pd\215ate)3.127 E(x)-.2 E F0 .627
+348 R F1(pd\215ate)3.127 E(x)-.2 E F0 .627
 (reports a missing \214le, named "graph".)3.127 F F1(Late)3.127 E(xmk)
 -.2 E F0 .627(succeeds in making "graph.pdf" by)3.127 F .892
-(calling "mak)108 192 R 3.392(eg)-.1 G .891
+(calling "mak)108 360 R 3.392(eg)-.1 G .891
 (raph.pdf", and after completion of its w)-3.392 F .891
 (ork, it lists "\214g.pdf" among the dependents of the)-.1 F(\214le)108
-204 Q F1(late)4.67 E(xmk)-.2 E F0 2.17(is making.)4.67 F 2.171
+372 Q F1(late)4.67 E(xmk)-.2 E F0 2.17(is making.)4.67 F 2.171
 (Then let "\214g.\214g" be updated, and then let)7.17 F F1(mak)4.671 E
 (e)-.1 E F0 2.171(be run.)4.671 F F1(Mak)7.171 E(e)-.1 E F0 2.171
 (\214rst remak)4.671 F(es)-.1 E("\214g.pdf", and only then reruns)108
-216 Q F1(late)2.5 E(xmk)-.2 E F0(.)A(Thus we no)108 240 Q 2.5(wh)-.25 G
+384 Q F1(late)2.5 E(xmk)-.2 E F0(.)A(Thus we no)108 408 Q 2.5(wh)-.25 G
 -2.25 -.2(av e)-2.5 H 2.5(am)2.7 G
 (ethod by which all the subsidiary processing is dele)-2.5 E -.05(ga)
--.15 G(ted to).05 E F1(mak)2.5 E(e)-.1 E F0(.)A/F2 10.95/Times-Bold@0 SF
-(SEE ALSO)72 268.8 Q F0(late)108 280.8 Q(x\(1\), bibte)-.15 E(x\(1\).)
--.15 E F2 -.11(BU)72 297.6 S(GS).11 E F0 .71(Sometimes a vie)108 309.6 R
+-.15 G(ted to).05 E F1(mak)2.5 E(e)-.1 E F0(.)A/F3 10.95/Times-Bold@0 SF
+(SEE ALSO)72 436.8 Q F0(late)108 448.8 Q(x\(1\), bibte)-.15 E(x\(1\).)
+-.15 E F3 -.11(BU)72 465.6 S(GS).11 E F0 .71(Sometimes a vie)108 477.6 R
 .71(wer \(gv\) tries to read an updated .ps or .pdf \214le after its cr\
 eation is started b)-.25 F .71(ut before the)-.2 F .947
-(\214le is complete.)108 321.6 R -.8(Wo)5.947 G .947
+(\214le is complete.)108 489.6 R -.8(Wo)5.947 G .947
 (rk around: manually refresh \(or reopen\) display).8 F 5.948(.O)-.65 G
 3.448(ru)-5.948 G .948(se one of the other pre)-3.448 F(vie)-.25 E(wers)
--.25 E(and update methods.)108 333.6 Q 1.53(\(The follo)108 357.6 R 1.53
+-.25 E(and update methods.)108 501.6 Q 1.53(\(The follo)108 525.6 R 1.53
 (wing isn')-.25 F 4.03(tr)-.18 G 1.53(eally a b)-4.03 F 1.529(ug, b)-.2
 F 1.529(ut concerns features of pre)-.2 F(vie)-.25 E 4.029(wers.\) Pre)
 -.25 F(vie)-.25 E 4.029(wc)-.25 G 1.529(ontinuous mode only)-4.029 F -.1
-(wo)108 369.6 S .397(rks perfectly with certain pre).1 F(vie)-.25 E .398
+(wo)108 537.6 S .397(rks perfectly with certain pre).1 F(vie)-.25 E .398
 (wers: Xdvi on UNIX/LINUX w)-.25 F .398(orks for dvi \214les.)-.1 F .398
-(Gv on UNIX/LINUX)5.398 F -.1(wo)108 381.6 S .568
+(Gv on UNIX/LINUX)5.398 F -.1(wo)108 549.6 S .568
 (rks for both postscript and pdf.).1 F(Ghostvie)5.567 E 3.067(wo)-.25 G
 3.067(nU)-3.067 G .567
 (NIX/LINUX needs a manual update \(reopen\); it vie)-3.067 F(ws)-.25 E
-1.846(postscript and pdf.)108 393.6 R(Gsvie)6.846 E 4.346(wu)-.25 G
+1.846(postscript and pdf.)108 561.6 R(Gsvie)6.846 E 4.346(wu)-.25 G
 1.846(nder MS-W)-4.346 F(indo)-.4 E 1.846(ws w)-.25 F 1.846
 (orks for both postscript and pdf, b)-.1 F 1.846(ut only reads the)-.2 F
-.249(updated \214le when its screen is refreshed.)108 405.6 R .248
+.249(updated \214le when its screen is refreshed.)108 573.6 R .248
 (Acroread under UNIX/LINUX vie)5.248 F .248(ws pdf, b)-.25 F .248
 (ut the \214le needs to be)-.2 F .525(closed and reopened to vie)108
-417.6 R 3.025(wa)-.25 G 3.025(nu)-3.025 G .525(pdated v)-3.025 F 3.025
+585.6 R 3.025(wa)-.25 G 3.025(nu)-3.025 G .525(pdated v)-3.025 F 3.025
 (ersion. Under)-.15 F(MS-W)3.025 E(indo)-.4 E .525
 (ws, acroread locks its input \214le and so)-.25 F
-(the pdf \214le cannot be updated.)108 429.6 Q(\(Remedy: con\214gure)5 E
-F1(late)2.5 E(xmk)-.2 E F0(to use gsvie)2.5 E 2.5(wi)-.25 G(nstead.\))
--2.5 E F2(THANKS T)72 446.4 Q(O)-.197 E F0 1.585(Authors of pre)108
-458.4 R 1.585(vious v)-.25 F 4.085(ersions. Man)-.15 F 4.085(yu)-.15 G
-1.585(sers with their feedback, and especially Da)-4.085 F 1.584
-(vid Coppit \(username)-.2 F(da)108 470.4 Q 1.325(vid at node coppit.or)
--.2 F 1.325(g\) who made man)-.18 F 3.825(yu)-.15 G 1.325
-(seful suggestions that contrib)-3.825 F 1.326(uted to v)-.2 F 1.326
-(ersion 3, and Herbert)-.15 F 3.655(Schulz. \(Please)108 482.4 R 1.154(\
-note that the e-mail addresses are not written in their standard form t\
-o a)3.655 F -.2(vo)-.2 G 1.154(id being har).2 F(-)-.2 E -.15(ve)108
-494.4 S(sted by w).15 E(orms and viruses.\))-.1 E F2 -.548(AU)72 511.2 S
-(THOR).548 E F0(Current v)108 523.2 Q
+(the pdf \214le cannot be updated.)108 597.6 Q(\(Remedy: con\214gure)5 E
+F1(late)2.5 E(xmk)-.2 E F0(to use)2.5 E F1(sumatr)2.5 E(apdf)-.15 E F0
+(instead.\))2.5 E F3(THANKS T)72 614.4 Q(O)-.197 E F0 1.585
+(Authors of pre)108 626.4 R 1.585(vious v)-.25 F 4.085(ersions. Man)-.15
+F 4.085(yu)-.15 G 1.585(sers with their feedback, and especially Da)
+-4.085 F 1.584(vid Coppit \(username)-.2 F(da)108 638.4 Q 1.325
+(vid at node coppit.or)-.2 F 1.325(g\) who made man)-.18 F 3.825(yu)-.15
+G 1.325(seful suggestions that contrib)-3.825 F 1.326(uted to v)-.2 F
+1.326(ersion 3, and Herbert)-.15 F 3.655(Schulz. \(Please)108 650.4 R
+1.154(note that the e-mail addresses are not written in their standard \
+form to a)3.655 F -.2(vo)-.2 G 1.154(id being har).2 F(-)-.2 E -.15(ve)
+108 662.4 S(sted by w).15 E(orms and viruses.\))-.1 E F3 -.548(AU)72
+679.2 S(THOR).548 E F0(Current v)108 691.2 Q
 (ersion, by John Collins \(username collins at node ph)-.15 E 2.5
-(ys.psu.edu\). \(V)-.05 F(ersion 4.24\).)-1.11 E 2.332(Released v)108
-547.2 R 2.332(ersion can be obtained from CT)-.15 F 2.333
+(ys.psu.edu\). \(V)-.05 F(ersion 4.35\).)-1.11 E 2.332(Released v)108
+715.2 R 2.332(ersion can be obtained from CT)-.15 F 2.333
 (AN: <http://www)-.93 F(.tug.or)-.65 E(g/te)-.18 E(x-archi)-.15 E -.15
 (ve)-.25 G(/support/late).15 E 2.333(xmk/>, and)-.15 F(from the author')
-108 559.2 Q 2.5(sw)-.55 G(ebsite <http://www)-2.5 E(.ph)-.65 E
-(ys.psu.edu/~collins/softw)-.05 E(are/late)-.1 E(xmk/>.)-.15 E
-(Modi\214cations and enhancements by Ev)108 571.2 Q(an McLean \(V)-.25 E
-(ersion 2.0\))-1.11 E(Original script called "go" by Da)108 583.2 Q
-(vid J. Musliner \(RCS V)-.2 E(ersion 3.2\))-1.11 E 2.5(7M)281.835 768 S
-(ay 2011)-2.5 E(27)199.835 E 0 Cg EP
+108 727.2 Q 2.5(sw)-.55 G(ebsite <http://www)-2.5 E(.ph)-.65 E
+(ys.psu.edu/~collins/softw)-.05 E(are/late)-.1 E(xmk/>.)-.15 E(11 No)
+267.545 768 Q -.15(ve)-.15 G(mber 2012).15 E(33)185.545 E 0 Cg EP
+%%Page: 34 34
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(LA)72 48 Q 334.42(TEXMK\(1L\) LA)-1.11 F
+(TEXMK\(1L\))-1.11 E(Modi\214cations and enhancements by Ev)108 84 Q
+(an McLean \(V)-.25 E(ersion 2.0\))-1.11 E
+(Original script called "go" by Da)108 96 Q(vid J. Musliner \(RCS V)-.2
+E(ersion 3.2\))-1.11 E(11 No)267.545 768 Q -.15(ve)-.15 G(mber 2012).15
+E(34)185.545 E 0 Cg EP
 %%Trailer
 end
 %%EOF
diff -Nru latexmk-4.24/latexmk.txt latexmk-4.35/latexmk.txt
--- latexmk-4.24/latexmk.txt	2011-05-07 22:34:26.000000000 +0000
+++ latexmk-4.35/latexmk.txt	2012-11-12 13:43:10.000000000 +0000
@@ -61,7 +61,7 @@
 
 
 
-                                  7 May 2011                                 1
+                               11 November 2012                              1
 
 
 
@@ -78,8 +78,14 @@
 
        Latexmk has the ability to print a banner  in  gray  diagonally  across
        each  page  when  making  the postscript file.  It can also, if needed,
-       call an external program to do other postprocessing  on  the  generated
-       files.
+       call an external program to do other postprocessing  on  generated  dvi
+       and postscript files.  (See the options -dF and -pF, and the documenta-
+       tion for  the  $dvi_filter  and  $ps_filter  configuration  variables.)
+       These  capabilities  are leftover from older versions of latexmk.  More
+       flexibility can be obtained in  current  versions,  since  the  command
+       strings  for  running latex, pdflatex, etc can now be configured to run
+       multiple commands.  This also extends the possibility of postprocessing
+       generated files to pdf files.  files.
 
        Latexmk  is highly configurable, both from the command line and in con-
        figuration files, so that it can accommodate a  wide  variety  of  user
@@ -104,37 +110,72 @@
 
 
 LATEXMK OPTIONS AND ARGUMENTS ON COMMAND LINE
-       (All options can be introduced by  single  or  double  "-"  characters,
-       e.g., "latexmk -help" or "latexmk --help".)
+       In general the command line to invoke latexmk has the form
 
-       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
+            latexmk [options] [file]
+
+       All options can be introduced by single or double "-" characters, e.g.,
+       "latexmk -help" or "latexmk --help".
+
+       Note:  In addition to the options in the list below, latexmk recognizes
+       almost all the options recognized by the latex and pdflatex programs in
+       one  of both of their current TeXLive and MiKTeX implementations.  Some
+       of the options for these programs also trigger special action or behav-
+       ior  by  latexmk, in which case they are in this list.  Otherwise, they
+       are just passed through to a called  latex  or  pdflatex  program.  Run
+       latexmk  with  the  -showextraoptions to get a list of the options that
+
+
+
+                               11 November 2012                              2
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
+       latexmk accepts and that are simply passed through to latex  or  pdfla-
+       tex.  See also the explanation of the -showextraoptions option for more
+       information.
+
+       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
               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"  extension
+       If  a file is specified without an extension, then the ".tex" extension
        is automatically added, just as LaTeX does.  Thus, if you specify:
 
             latexmk foo
 
        then latexmk will operate on the file "foo.tex".
 
-       -bibtex
-              When the source file uses bbl files for bibliography, run bibtex
-              or biber as needed to regenerate the bbl files.
-
 
+       -auxdir=FOO or -aux-directory=FOO
 
-                                  7 May 2011                                 2
+              Sets the directory for  auxiliary  output  files  of  (pdf)latex
+              (.aux,  .log  etc).  This achieves its effect by the -aux-direc-
+              tory option of (pdf)latex, which currently is  only  implemented
+              on the MiKTeX version of (pdf)latex.
+
+              See   also   the   -outdir/-output-directory  options,  and  the
+              $aux_dir,  $out_dir,  and  $search_path_separator  configuration
+              variables  of  latexmk.  In particular, see the documentation of
+              $out_dir for some complications  on  what  directory  names  are
+              suitable.
 
 
 
-
-
-LATEXMK(1L)                                                        LATEXMK(1L)
-
+       -bibtex
+              When the source file uses bbl files for bibliography, run bibtex
+              or biber as needed to regenerate the bbl files.
 
               This property can also be configured by setting the  $bibtex_use
               variable to 2 in a configuration file
@@ -149,6 +190,18 @@
               trying to run bibtex or biber, which would result in overwriting
               of the bbl files.
 
+
+
+
+                               11 November 2012                              3
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
        -bibtex-cond
               When the source file uses bbl file(s) for the bibliography,  run
               bibtex  or biber as needed to regenerate the bbl files, but only
@@ -189,19 +242,6 @@
               message.  The default is 220.0 which is just right for 5 charac-
               ter messages.
 
-
-
-
-
-                                  7 May 2011                                 3
-
-
-
-
-
-LATEXMK(1L)                                                        LATEXMK(1L)
-
-
        -commands
               List the commands used by latexmk for processing files, and then
               exit.
@@ -217,6 +257,17 @@
               This  cleanup  is instead of a regular make.  See the -gg option
               if you want to do a cleanup then a make.
 
+
+
+                               11 November 2012                              4
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
               If $bibtex_use is set to 0 or 1, bbl files are counted  as  non-
               regeneratable.
 
@@ -256,18 +307,6 @@
                    latexmk -bm DRAFT
 
               Note that if the -d option  is  specified,  the  -ps  option  is
-
-
-
-                                  7 May 2011                                 4
-
-
-
-
-
-LATEXMK(1L)                                                        LATEXMK(1L)
-
-
               assumed.
 
        -deps  Show a list of dependent files after processing.  This is in the
@@ -278,99 +317,112 @@
 
               By  default the list of dependent files is sent to stdout (i.e.,
               normally to the screen unless you've redirected  latexmk's  out-
-              put).   But  you  can set the filename where the list is sent by
-              the -deps-out= option.
+              put). But you can set the filename where the list is sent by the
+              -deps-out= option.
 
               See the section "USING latexmk WITH make" for an example of  how
               to use a dependency list with make.
 
+
+
+                               11 November 2012                              5
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
               Users  familiar  with  GNU  automake  and gcc will find that the
               -deps option is very similar in its purpose and results  to  the
-              -M option to gcc.
+              -M  option  to gcc.  (In fact, latexmk also has options -M, -MF,
+              and -MP options that behave like those of gcc.)
 
        -dependents
               Equivalent to -deps.
 
-       -deps- Do  not  show a list of dependent files after processing.  (This
+       -deps- Do not show a list of dependent files after  processing.   (This
               is the default.)
 
        -dependents-
               Equivalent to -deps-.
 
        -deps-out=FILENAME
-              Set the filename to which the list of dependent files  is  writ-
-              ten.   If  the  FILENAME argument is omitted or set to '-', then
+              Set  the  filename to which the list of dependent files is writ-
+              ten.  If the FILENAME argument is omitted or set  to  "-",  then
               the output is sent to stdout.
 
-              Use of this option also turns on  the  output  of  the  list  of
+              Use  of  this  option  also  turns  on the output of the list of
               dependent files after processing.
 
-       -dF    Dvi  file  filtering.   The  argument to this option is a filter
-              which will generate a  filtered  dvi  file  with  the  extension
-              ".dviF".   All  extra processing (e.g. conversion to postscript,
-              preview, printing) will then be performed on this  filtered  dvi
+       -dF    Dvi file filtering.  The argument to this  option  is  a  filter
+              which  will  generate  a  filtered  dvi  file with the extension
+              ".dviF".  All extra processing (e.g. conversion  to  postscript,
+              preview,  printing)  will then be performed on this filtered dvi
               file.
 
               Example usage: To use dviselect to select only the even pages of
               the dvi file:
 
-                   latexmk -dF 'dviselect even' foo.tex
+                   latexmk -dF "dviselect even" foo.tex
 
        -diagnostics
-              Print detailed diagnostics during a  run.   This  may  help  for
+              Print  detailed  diagnostics  during  a  run.  This may help for
               debugging problems or to understand latexmk's behavior in diffi-
               cult situations.
 
        -dvi   Generate dvi version of document.
 
+       -dvi-  Turn  off  generation of dvi version of document.  (This may get
+              overridden, if some other file is made (e.g., a .ps  file)  that
+              is  generated  from the dvi file, or if no generated file at all
+              is requested.)
 
+       -e <code>
+              Execute the specified  initialization  code  before  processing.
+              The  code  is Perl code of the same form as is used in latexmk's
+              initialization files -- for more details, see the information on
+              the  -r option, and the section about "Configuration/initializa-
+              tion (RC) files".  The code is typically a sequence  of  assign-
+              ment statements separated by semicolons.
 
-                                  7 May 2011                                 5
+              The  code  is  executed when the -e option is encountered during
 
 
 
+                               11 November 2012                              6
 
 
-LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-       -dvi-  Turn off generation of dvi version of document.  (This  may  get
-              overridden,  if  some other file is made (e.g., a .ps file) that
-              is generated from the dvi file, or if no generated file  at  all
-              is requested.)
 
-       -e <code>
-              Execute  the  specified  initialization  code before processing.
-              The code is Perl code of the same form as is used  in  latexmk's
-              initialization files -- for more details, see the information on
-              the -r option, and the section about  "Configuration/initializa-
-              tion  (RC)  files".  The code is typically a sequence of assign-
-              ment statements separated by semicolons.
+LATEXMK(1L)                                                        LATEXMK(1L)
+
 
-              The code is executed when the -e option  is  encountered  during
-              latexmk's  parsing of its command line.  See the -r option for a
-              way of executing initialization code  from  a  file.   An  error
-              results  in  latexmk stopping.  Multiple instances of the -r and
-              -e options can be used, and they are executed in the order  they
+              latexmk's parsing of its command line.  See the -r option for  a
+              way  of  executing  initialization  code  from a file.  An error
+              results in latexmk stopping.  Multiple instances of the  -r  and
+              -e  options can be used, and they are executed in the order they
               appear on the command line.
 
               Some care is needed to deal with proper quoting of special char-
-              acters in the code on the command line.   For  example,  suppose
-              you  want  to  set  the  latex  command to use its -shell-escape
+              acters  in  the  code on the command line.  For example, suppose
+              you want to set the  latex  command  to  use  its  -shell-escape
               option, then under UNIX/LINUX you could use the line
 
                    latexmk -e '$latex=q/latex %O -shell-escape %S/' file.tex
 
-              Note that the single  quotes  block  normal  UNIX/LINUX  command
-              shells  from  treating  the characters inside the quotes as spe-
-              cial.  (In this example, the q/.../ construct is  a  Perl  idiom
-              equivalent  to  using  single quotes.  This avoids the complica-
-              tions of getting a quote  character  inside  an  already  quoted
-              string  in  a  way that is independent of both the shell and the
+              Note  that  the  single  quotes  block normal UNIX/LINUX command
+              shells from treating the characters inside the  quotes  as  spe-
+              cial.   (In  this  example, the q/.../ construct is a Perl idiom
+              equivalent to using single quotes.  This  avoids  the  complica-
+              tions  of  getting  a  quote  character inside an already quoted
+              string in a way that is independent of both the  shell  and  the
               operating-system.)
 
-              The above command line  will  NOT  work  under  MS-Windows  with
-              cmd.exe  or  command.com  or 4nt.exe.  For MS-Windows with these
+              The  above  command  line  will  NOT  work under MS-Windows with
+              cmd.exe or command.com or 4nt.exe.  For  MS-Windows  with  these
               command shells you could use
 
                    latexmk -e "$latex=q/latex %O -shell-escape %S/" file.tex
@@ -379,44 +431,53 @@
 
                    latexmk -e "$latex='latex %O -shell-escape %S'" file.tex
 
-              The last two examples will  NOT  work  with  UNIX/LINUX  command
+              The  last  two  examples  will  NOT work with UNIX/LINUX command
               shells.
 
-       -f     Force  latexmk  to  continue document processing despite errors.
+       -f     Force latexmk to continue document  processing  despite  errors.
               Normally, when latexmk detects that LaTeX or another program has
               found an error which will not be resolved by further processing,
               no further processing is carried out.
 
        -f-    Turn off the forced processing-past-errors such as is set by the
+              -f option.  This could be used to override a setting in  a  con-
+              figuration file.
 
+       -g     Force  latexmk  to process document fully, even under situations
+              where latexmk would normally  decide  that  no  changes  in  the
+              source  files have occurred since the previous run.  This option
+              is useful, for example, if you change some options and  wish  to
+              reprocess the files.
 
+       -g-    Turn off -g.
 
-                                  7 May 2011                                 6
+       -gg    "Super go mode" or "clean make": clean out generated files as if
+              -C had been given, and then do a regular make.
 
 
 
 
+                               11 November 2012                              7
 
-LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-              -f  option.   This could be used to override a setting in a con-
-              figuration file.
 
-       -g     Force latexmk to process document fully, even  under  situations
-              where  latexmk  would  normally  decide  that  no changes in the
-              source files have occurred since the previous run.  This  option
-              is  useful,  for example, if you change some options and wish to
-              reprocess the files.
 
-       -g-    Turn off -g.
+LATEXMK(1L)                                                        LATEXMK(1L)
 
-       -gg    "Super go mode" or "clean make": clean out generated files as if
-              -C had been given, and then do a regular make.
 
        -h, -help
               Print help information.
 
+       -jobname=STRING
+              Set the basename of output files(s) to STRING,  instead  of  the
+              default, which is the basename of the specified TeX file.
+
+              This  is like the same option for current implementations of the
+              latex and pdflatex, and the passing of this option to these pro-
+              grams is part of latexmk's implementation of -jobname.
+
+
        -l     Run in landscape mode, using the landscape mode for the preview-
               ers and the dvi to postscript converters.  This  option  is  not
               normally  needed  nowadays,  since  current  previewers normally
@@ -424,15 +485,59 @@
 
        -l-    Turn off -l.
 
+       -latex="COMMAND"
+              This sets the string specifying the command to run latex, and is
+              typically  used  to  add desired options.  Since the string nor-
+              mally contains spaces, it should be quoted, e.g.,
+
+                   latex -latex="latex --shell-escape %O %S"  foo.tex
+
+              The specification of the contents of the string are the same  as
+              for  the $latex configuration variable.  Depending on your oper-
+              ating 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 pdflatex (rather than the command
+              for latex) see the -pdflatex option.
+
+              Note  that  the  effect  of  this option can also be achieved by
+              using the -e option with a suitable line of Perl code to set the
+              $latex variable.  See the explanation of the -e option.
+
+       -M     Show  list of dependent files after processing.  This is equiva-
+              lent to the -deps option.
+
+       -MF file
+              If a list of dependents is made, the -MF specifies the  file  to
+              write it to.
+
+       -MP    If  a list of dependents is made, includes phony target for each
+              source file.  If you use the dependents list in a Makefile,  the
+              dummy  rules  work around errors make gives if you remove header
+              files without updating the Makefile to match.
+
        -new-viewer
               When in continuous-preview mode, always start a  new  viewer  to
-              view  the generated file.  By default, latexmk will, in continu-
-              ous-preview mode, test for a previously  running  previewer  for
-              the same file and not start a new one if a previous previewer is
-              running.  However, its test sometimes fails (notably if there is
-              an  already-running previewer that is viewing a file of the same
-              name as the current file, but in a different  directory).   This
-              option turns off the default behavior.
+              view   the   generated  file.   By  default,  latexmk  will,  in
+
+
+
+                               11 November 2012                              8
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
+              continuous-preview mode, test for a previously running previewer
+              for  the  same  file  and not start a new one if a previous pre-
+              viewer is running.  However, its test sometimes  fails  (notably
+              if  there is an already-running previewer that is viewing a file
+              of the same name as the current file, but in a different  direc-
+              tory).  This option turns off the default behavior.
 
        -new-viewer-
               The  inverse  of the -new-viewer option.  It puts latexmk in its
@@ -449,15 +554,42 @@
               trying to run bibtex or biber, which would result in overwriting
               of the bbl files.
 
-       -p     Print out the document.  By default it is  the  generated  post-
-              script  file  that  is  printed.  But you can use the -print=...
+       -norc  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 -norc is an exception to  this  rule:  it  is
+              acted on first, no matter where is occurs on the command line.
+
+
+       -outdir=FOO or -output-directory=FOO
+
+              Sets  the  directory  for  the output files of (pdf)latex.  This
+              achieves  its  effect  by  the   -output-directory   option   of
+              (pdf)latex,  which  currently  (Dec. 2011) is implemented on the
+              common versions of (pdf)latex, i.e., MiKTeX and TeXLive.  It may
+              not be present in other versions.
+
+              See  also  the -auxdir/-aux-directory options, and the $aux_dir,
+              $out_dir, and $search_path_separator configuration variables  of
+              latexmk.   In  particular, see the documentation of $out_dir for
+              some complications on what directory names are suitable.
+
+
+
+
+              -p     Print out the document.  By default it is  the  generated
+              postscript file that is printed.  But you can use the -print=...
               option to print the dvi or pdf files instead, and you  can  con-
               figure this in a start up file (by setting the $print_type vari-
               able).
 
+              However, printing is enabled by default  only  under  UNIX/LINUX
+              systems,  where  the  default  is  to  use  the lpr command.  In
+
 
 
-                                  7 May 2011                                 7
+                               11 November 2012                              9
 
 
 
@@ -466,9 +598,7 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-              However, printing is enabled by default  only  under  UNIX/LINUX
-              systems,  where  the default is to use the lpr command.  In gen-
-              eral, the correct behavior for printing  very  much  depends  on
+              general, the correct behavior for printing very much depends  on
               your  system's  software.   In  particular, under MS-Windows you
               must have suitable program(s) available, and you must have  con-
               figured  the  print  commands used by latexmk.  This can be non-
@@ -479,159 +609,193 @@
               This option is incompatible with the -pv and -pvc options, so it
               turns them off.
 
-       -pdf   Generate pdf version of document using pdflatex.
+       -pdf   Generate  pdf  version  of  document  using  pdflatex.  (See the
+              -xelatex if you wish to use xelatex to make your pdf file(s).)
 
        -pdfdvi
-              Generate  pdf  version of document from the dvi file, by default
+              Generate pdf version of document from the dvi file,  by  default
               using dvipdf.
 
-       -pdfps Generate pdf version of document from the ps  file,  by  default
+       -pdfps Generate  pdf  version  of document from the ps file, by default
               using ps2pdf.
 
-       -pdf-  Turn  off  generation  of pdf version of document.  (This can be
-              used to override a setting in a configuration file.  It may  get
+       -pdf-  Turn off generation of pdf version of document.   (This  can  be
+              used  to override a setting in a configuration file.  It may get
               overridden if some other option requires the generation of a pdf
               file.)
 
+       -pdflatex="COMMAND"
+              This sets the string specifying the command to run pdflatex, and
+              is typically used to add desired options.  Since the string nor-
+              mally contains spaces, it should be quoted, e.g.,
+
+                   latex   -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.  Depending on your
+              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).
+
+              To set the command for running latex (rather  than  the  command
+              for pdflatex) see the -latex option.
+
+              Note  that  the  effect  of  this option can also be achieved by
+              using the -e option with a suitable line of Perl code to set the
+              $pdflatex variable. See the explanation of the -e option.
+
        -print=dvi, -print=ps, -print=pdf
-              Define which kind of file is printed.  This option also  ensures
-              that  the  requisite  file  is made, and turns on printing.  The
+              Define  which kind of file is printed.  This option also ensures
+              that the requisite file is made, and  turns  on  printing.   The
               default is to print a postscript file.
 
        -ps    Generate postscript version of document.
 
-       -ps-   Turn off generation of postscript version of document.  This can
-              be  used to override a setting in a configuration file.  (It may
-              get overridden by some other option that requires  a  postscript
-              file, for example a request for printing.)
 
-       -pF    Postscript  file  filtering.   The  argument to this option is a
-              filter which will generate a filtered postscript file  with  the
-              extension ".psF".  All extra processing (e.g. preview, printing)
-              will then be performed on this filtered postscript file.
 
-              Example of usage: Use psnup to print two pages on the one page:
 
-                   latexmk -ps -pF 'psnup -2' foo.tex
+                               11 November 2012                             10
 
-              or
 
-                   latexmk -ps -pF "psnup -2" foo.tex
 
-              Whether to use single or double quotes round the "psnup -2" will
-              depend  on  your  command interpreter, as used by the particular
 
 
+LATEXMK(1L)                                                        LATEXMK(1L)
 
-                                  7 May 2011                                 8
 
+       -ps-   Turn off generation of postscript version of document.  This can
+              be used to override a setting in a configuration file.  (It  may
+              get  overridden  by some other option that requires a postscript
+              file, for example a request for printing.)
 
+       -pF    Postscript file filtering.  The argument to  this  option  is  a
+              filter  which  will generate a filtered postscript file with the
+              extension ".psF".  All extra processing (e.g. preview, printing)
+              will then be performed on this filtered postscript file.
 
+              Example of usage: Use psnup to print two pages on the one page:
 
+                   latexmk -ps -pF 'psnup -2' foo.tex
 
-LATEXMK(1L)                                                        LATEXMK(1L)
+              or
 
+                   latexmk -ps -pF "psnup -2" foo.tex
 
+              Whether to use single or double quotes round the "psnup -2" will
+              depend on your command interpreter, as used  by  the  particular
               version of perl and the operating system on your computer.
 
-       -pv    Run file previewer.  If the -view  option  is  used,  this  will
-              select  the kind of file to be previewed (dvi, ps or pdf).  Oth-
-              erwise the viewer views the "highest" kind of file selected,  by
-              the  -dvi,  -ps, -pdf, -pdfps options, in the order dvi, ps, pdf
-              (low to high).  If no file type has been selected, the dvi  pre-
-              viewer  will  be  used.  This option is incompatible with the -p
+       -pv    Run  file  previewer.   If  the  -view option is used, this will
+              select the kind of file to be previewed (dvi, ps or pdf).   Oth-
+              erwise  the viewer views the "highest" kind of file selected, by
+              the -dvi, -ps, -pdf, -pdfps options, in the order dvi,  ps,  pdf
+              (low  to high).  If no file type has been selected, the dvi pre-
+              viewer will be used.  This option is incompatible  with  the  -p
               and -pvc options, so it turns them off.
 
        -pv-   Turn off -pv.
 
-       -pvc   Run a file previewer  and  continually  update  the  .dvi,  .ps,
+       -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
-              incompatible  with  the  -p  and  -pv options, so it turns these
+              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
+              incompatible with the -p and -pv  options,  so  it  turns  these
               options off.
 
-              The -pvc option also turns off force mode (-f), as  is  normally
-              best  for  continuous  preview  mode.   If you really want force
+              The  -pvc  option also turns off force mode (-f), as is normally
+              best for continuous preview mode.   If  you  really  want  force
               mode, use the options in the order -pvc -f.
 
               With a good previewer the display will be automatically updated.
-              (Under  some but not all versions of UNIX/Linux "gv -watch" does
-              this for postscript files; this can be set  by  a  configuration
-              variable.   This  would  also  work  for pdf files except for an
-              apparent bug in gv that causes an error when the  newly  updated
-              pdf  file  is  read.)   Many other previewers will need a manual
+              (Under some but not all versions of UNIX/Linux "gv -watch"  does
+              this  for  postscript  files; this can be set by a configuration
+              variable.  This would also work for  pdf  files  except  for  an
+              apparent  bug  in gv that causes an error when the newly updated
+              pdf file is read.)  Many other previewers  will  need  a  manual
               update.
 
-              Important note: the acroread program on MS-Windows locks the pdf
-              file,  and  prevents  new versions being written, so it is a bad
-              idea to use acroread to view  pdf  files  in  preview-continuous
-              mode.   It is better to use a dvi or ps viewer, as set by one of
-              the -view=dvi and -view=ps options.
 
-              There are some other methods for arranging  an  update,  notably
-              useful  for  many versions of xdvi and xpdf.  These are best set
-              in latexmk's configuration; see below.
 
-              Note that if latexmk  dies  or  is  stopped  by  the  user,  the
-              "forked" previewer will continue to run.  Successive invocations
-              with the -pvc option will not fork new previewers,  but  latexmk
-              will  normally  use the existing previewer.  (At least this will
-              happen when latexmk is running under an operating  system  where
-              it  knows how to determine whether an existing previewer is run-
-              ning.)
 
-       -pvc-  Turn off -pvc.
+                               11 November 2012                             11
 
 
 
 
-                                  7 May 2011                                 9
 
+LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+              Important note: the acroread program on MS-Windows locks the pdf
+              file, and prevents new versions being written, so it  is  a  bad
+              idea  to  use  acroread  to view pdf files in preview-continuous
+              mode.  It is better to use a different  viewer:  SumatraPDF  and
+              gsview are good possibilities.
 
+              There  are  some  other methods for arranging an update, notably
+              useful for many versions of xdvi and xpdf.  These are  best  set
+              in latexmk's configuration; see below.
 
-LATEXMK(1L)                                                        LATEXMK(1L)
+              Note  that  if  latexmk  dies  or  is  stopped  by the user, the
+              "forked" previewer will continue to run.  Successive invocations
+              with  the  -pvc option will not fork new previewers, but latexmk
+              will normally use the existing previewer.  (At least  this  will
+              happen  when  latexmk is running under an operating system where
+              it knows how to determine whether an existing previewer is  run-
+              ning.)
 
+       -pvc-  Turn off -pvc.
 
        -quiet Same as -silent
 
        -r <rcfile>
-              Read the specified initialization file ("RC file")  before  pro-
+              Read  the  specified initialization file ("RC file") before pro-
               cessing.
 
               Be careful about the ordering: (1) Standard initialization files
-              -- see the section below on  "Configuration/initialization  (RC)
-              files"  --  are read first.  (2) Then the options on the command
-              line are acted on in the order they are given.  Therefore if  an
-              initialization  file  is  specified by the -r option, it is read
-              during this second step.  Thus an initialization file  specified
+              --  see  the section below on "Configuration/initialization (RC)
+              files" -- are read first.  (2) Then the options on  the  command
+              line  are acted on in the order they are given.  Therefore if an
+              initialization file is specified by the -r option,  it  is  read
+              during  this second step.  Thus an initialization file specified
               with the -r option can override both the standard initialization
               files and previously specified options.  But all of these can be
               overridden by later options.
 
               The contents of the RC file just comprise a piece of code in the
-              Perl programming language (typically a  sequence  of  assignment
+              Perl  programming  language  (typically a sequence of assignment
               statements); they are executed when the -r option is encountered
               during latexmk's parsing of its command line.  See the -e option
-              for  a  way  of giving initialization code directly on latexmk's
-              command line.  An error results in latexmk  stopping.   Multiple
-              instances  of  the  -r  and -e options can be used, and they are
+              for a way of giving initialization code  directly  on  latexmk's
+              command  line.   An error results in latexmk stopping.  Multiple
+              instances of the -r and -e options can be  used,  and  they  are
               executed in the order they appear on the command line.
 
        -recorder
-              Use the -recorder option with latex  and  pdflatex.   In  (most)
-              modern  versions  of  these  programs, this results in a file of
-              extension .fls containing a list of the files  that  these  pro-
+              Use  the  -recorder  option  with latex and pdflatex.  In (most)
+              modern versions of these programs, this results  in  a  file  of
+              extension  .fls  containing  a list of the files that these pro-
               grams have read and written.  Latexmk will then use this file to
-              improve its detection of source files and generated files  after
+              improve  its detection of source files and generated files after
               a run of latex or pdflatex.
 
               For further information, see the documentation for the $recorder
+
+
+
+                               11 November 2012                             12
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
               configuration variable.
 
        -recorder-
@@ -640,22 +804,56 @@
        -rules Show a list of latemk's rules and dependencies after processing.
 
        -rules-
-              Do  not  show  a  list of latexmk's rules and dependencies after
+              Do not show a list of latexmk's  rules  and  dependencies  after
               processing.  (This is the default.)
 
+       -showextraoptions
+              Show  the  list of extra latex and pdflatex options that latexmk
+              recognizes.  These are options for the latex and  pdflatex  that
+              latexmk  recognizes, but simply passes through to these programs
+              when they are run.  These options are (currently) a  combination
+              of those allowed by the TeXLive and MiKTeX implementations.  (If
+              a particular option is given to latexmk but is  not  handled  by
+              the particular implementation of latex or pdflatex that is being
+              used, that program will probably give an error message.)   These
+              options are very numerous, but are not listed in this documenta-
+              tion because they have no effect on latexmk's actions.
+
+              There are a  few  options  (-includedirectory=dir,  -initialize,
+              -ini)  that  are  not  recognized, either because they don't fit
+              with latexmk's intended operations, or because they need special
+              processing  by  latexmk  that  isn't  implemented (at least, not
+              yet).
+
+              There are also options that  are  accepted  by  latex  etc,  but
+              instead trigger actions by latexmk: -help, -version.
+
+              Finally, there are certain options for latex and pdflatex (e.g.,
+              -recorder) that trigger special actions or behavior  by  latexmk
+              itself  as well as being passed in some form to the called latex
+              and pdflatex program, or that affect  other  programs  as  well.
+              These  options  do  have  entries  in this documentation.  These
+              options are: -jobname=STRING, -aux-directory=dir, -output-direc-
+              tory=DIR, -quiet, and -recorder.
+
+
        -silent
               Run commands silently, i.e., with options that reduce the amount
-              of  diagnostics  generated.   For example, with the default set-
-              tings, the command "latex -interaction=batchmode"  is  used  for
+              of diagnostics generated.  For example, with  the  default  set-
+              tings,  the  command  "latex -interaction=batchmode" is used for
               latex.
 
-              Also  reduce  the  number of informational messages that latexmk
+              Also reduce the number of informational  messages  that  latexmk
               generates.
 
+              To  change  the  options used to make the commands run silently,
+              you need to configure latexmk with changed values of its config-
+              uration    variables,    the    relevant    ones   being   $bib-
+              tex_silent_switch, $biber_silent_switch,  $dvipdf_silent_switch,
 
 
 
-                                  7 May 2011                                10
+                               11 November 2012                             13
 
 
 
@@ -664,11 +862,8 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-              To change the options used to make the  commands  run  silently,
-              you need to configure latexmk with changed values of its config-
-              uration   variables,   the    relevant    ones    being    $bib-
-              tex_silent_switch,  $biber_silent_switch,  $dvips_silent_switch,
-              $latex_silent_switch, and $pdflatex_silent_switch.
+              $dvips_silent_switch,       $latex_silent_switch,       $makein-
+              dex_silent_switch, and $pdflatex_silent_switch.
 
        -use-make
               When after a run of latex or pdflatex, there are warnings  about
@@ -703,6 +898,14 @@
               the -pv or -pvc switches).  The default is to view the "highest"
               kind of requested file (in the order dvi, ps, pdf).
 
+       -xelatex
+              Use xelatex.  That is, use xelatex to process the source file(s)
+              to  pdf  (in place of pdflatex).  This option is exactly equiva-
+              lent to specifying the following sequence of options:
+
+                   -pdflatex="xelatex %O %S" -pdf -dvi- -ps
+
+
        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.
@@ -713,15 +916,10 @@
 
 EXAMPLES
        % latexmk thesis    # run latex enough times to resolve
-                           cross-references
-
-       % latexmk -pvc -ps thesis# run latex enough times to resolve
-                           cross-references, make a postscript
-                           file, start a previewer.  Then
 
 
 
-                                  7 May 2011                                11
+                               11 November 2012                             14
 
 
 
@@ -730,6 +928,11 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+                           cross-references
+
+       % latexmk -pvc -ps thesis# run latex enough times to resolve
+                           cross-references, make a postscript
+                           file, start a previewer.  Then
                            watch for changes in the source
                            file thesis.tex and any files it
                            uses.  After any changes rerun latex
@@ -755,17 +958,20 @@
           "/usr/local/share/latexmk/LatexMk",
           "/usr/local/lib/latexmk/LatexMk".
           On a MS-WINDOWS system it looks for "C:\latexmk\LatexMk".
-          On a cygwin system (i.e., a MS-Windows system in which perl is
-          that of cygwin), latexmk reads for the first it finds of
+          On  a cygwin system (i.e., a MS-Windows system in which perl is that
+       of cygwin), latexmk reads for the first it finds of
           "/cygdrive/c/latexmk/LatexMk",
           "/opt/local/share/latexmk/LatexMk",
           "/usr/local/share/latexmk/LatexMk",
           "/usr/local/lib/latexmk/LatexMk".
 
        2) The user's RC file, "$HOME/.latexmkrc", if it exists.  Here $HOME is
-       the value of  the  environment  variable  HOME.   On  UNIX  and  clones
-       (including  LINUX),  this variable is set by the system; on MS-Windows,
-       the user may choose to set it.
+       the  user's home directory.  [Latexmk determines the user's home direc-
+       tory as follows:  It is the value of the environment variable HOME,  if
+       this  variable  exists, which normally is the case on UNIX-like systems
+       (including LINUX and OS-X).  Otherwise the environment  variable  USER-
+       PROFILE is used, if it exists, which normally is the case on MS-Windows
+       systems. Otherwise a blank string is used instead of $HOME.]
 
        3) The RC file in the current working  directory.   This  file  can  be
        named  either "latexmkrc" or ".latexmkrc", and the first of these to be
@@ -776,18 +982,10 @@
        Each RC file is a sequence of Perl commands.  Naturally, a user can use
        this  in  creative  ways.   But  for  most  purposes, one simply uses a
        sequence of assignment statements that override some  of  the  built-in
-       settings  of  Latexmk.   Straightforward  cases  can be handled without
-       knowledge of the Perl language by using the examples in  this  document
-       as templates.  Comment lines are introduced by the "#" character.
-
-       Note  that  command  line options are obeyed in the order in which they
-       are written; thus any RC file specified on the command line with the -r
-       option  can  override  previous options but can be itself overridden by
-       later options on the command line.  There is also the -e option,  which
 
 
 
-                                  7 May 2011                                12
+                               11 November 2012                             15
 
 
 
@@ -796,8 +994,20 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+       settings  of  Latexmk.   Straightforward  cases  can be handled without
+       knowledge of the Perl language by using the examples in  this  document
+       as templates.  Comment lines are introduced by the "#" character.
+
+       Note  that  command  line options are obeyed in the order in which they
+       are written; thus any RC file specified on the command line with the -r
+       option  can  override  previous options but can be itself overridden by
+       later options on the command line.  There is also the -e option,  which
        allows initialization code to be specified in latexmk's command line.
 
+         For  possible  examples  of code for in an RC file, see the directory
+       example_rcfiles   in   the   distribution   of   latexmk   (e.g.,    at
+       http://ctan.tug.org/tex-archive/support/latexmk/example_rcfiles).
+
 
 HOW TO SET VARIABLES IN INITIALIZATION FILES
        The  important  variables  that  can be configured are described in the
@@ -838,30 +1048,30 @@
 FORMAT OF COMMAND SPECIFICATIONS
        Some  of  the variables set the commands that latexmk uses for carrying
        out its work, for example to generate a dvi file from a tex file or  to
-       view a postscript file.  This section describes some important features
-       of how the commands are specified.
 
-       Placeholders:  Supposed you wanted latexmk to use the command elatex in
-       place  of  the  regular  latex  command,  and suppose moreover that you
-       wanted to give it the option "--shell-escape".  You could  do  this  by
-       the following setting:
 
-            $latex = 'elatex --shell-escape %O %S';
 
-       The  two  items  starting with the % character are placeholders.  These
-       are substituted by appropriate values before the command is run.   Thus
+                               11 November 2012                             16
 
 
 
-                                  7 May 2011                                13
 
 
+LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+       view a postscript file.  This section describes some important features
+       of how the commands are specified.
 
-LATEXMK(1L)                                                        LATEXMK(1L)
+       Placeholders:  Supposed you wanted latexmk to use the command elatex in
+       place  of  the  regular  latex  command,  and suppose moreover that you
+       wanted to give it the option "--shell-escape".  You could  do  this  by
+       the following setting:
 
+            $latex = 'elatex --shell-escape %O %S';
 
+       The  two  items  starting with the % character are placeholders.  These
+       are substituted by appropriate values before the command is run.   Thus
        %S  will be replaced by the source file that elatex will be applied to,
        and %O will be replaced by any options that latexmk has decided to  use
        for  this  command.   (E.g.,  if  you  used the -silent option it would
@@ -885,6 +1095,18 @@
 
        %T     The name of the primary tex file.
 
+       %Y     Name of directory for auxiliary output files (see the configura-
+              tion variable $aux_dir).  A directory separation character ('/')
+              is appended if $aux_dir is non-empty and does not end in a suit-
+              able character, with suitable characters being those appropriate
+              to UNIX and MS-Windows, i.e., ':', '/' and '\'.
+
+       %Z     Name of directory for output files (see the configuration  vari-
+              able  $out_dir).   A  directory  separation  character  ('/') is
+              appended if $out_dir is non-empty and does not end in a suitable
+              character,  with  suitable characters being those appropriate to
+              UNIX and MS-Windows, i.e., ':', '/' and '\'.
+
        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',
@@ -892,8 +1114,20 @@
        replaced by the source filename, which in this case would be  the  name
        of a postscript file to be viewed.
 
+
+
+
+                               11 November 2012                             17
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
        Appropriate  quoting  will be applied to the filename substitutions, so
-       you mustn't supply them yourself even if you the  names  of  your  have
+       you mustn't supply them yourself even if the names of your  files  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
@@ -917,17 +1151,6 @@
        usable in initialization files" for what is normally the most appropri-
        ate usage.
 
-
-
-                                  7 May 2011                                14
-
-
-
-
-
-LATEXMK(1L)                                                        LATEXMK(1L)
-
-
        If you omit to supply any placeholders whatever in the specification of
        a command, latexmk will supply what its author thinks  are  appropriate
        defaults.  This gives compatibility with configuration files for previ-
@@ -957,20 +1180,45 @@
        problem.
 
        Command names containing spaces: Under MS-Windows it is common that the
-       name of a command includes spaces, since software is often installed in
-       a  subdirectory  of  "C:\Program  Files".  Such command names should be
-       enclosed in double quotes, as in
 
-            $lpr_pdf  =  '"c:/Program  Files/Ghostgum/gsview/gsview32.exe"  /p
-       %S';
 
-       (Note  about the above example: Forward slashes are equivalent to back-
+
+                               11 November 2012                             18
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
+       name of a command includes spaces, since software is often installed in
+       a  subdirectory  of  "C:\Program  Files".  Such command names should be
+       enclosed in double quotes, as in
+
+            $lpr_pdf  =  '"c:/Program  Files/Ghostgum/gsview/gsview32.exe"  /p
+       %S';
+            $pdf_previewer   =   'start   "c:/Program   Files/SumatraPDF/Suma-
+       traPDF.exe" %O %S';
+            $pdf_previewer = 'start "c:/Program  Files/SumatraPDF  (x86)/Suma-
+       traPDF.exe" %O %S';
+
+
+       (Note  about the above example: Forward slashes are equivalent to back-
        slashes in filenames under MS-Windows, provided that  the  filename  is
        inside  double quotes.  It is easier to use forward slashes in examples
        like the one above, since then one does not have  to  worry  about  the
        rules  for  dealing  with  forward  slashes in strings in the Perl lan-
        guage.)
 
+       Command names under Cygwin: If latexmk is executed  by  Cygwin's  perl,
+       be particularly certain that pathnames in commands have forward slashes
+       not the usual backslashes for the  separator  of  pathname  components.
+       See  the  above  examples.  Backslashes often get misinterpreted by the
+       Unix shell used by Cygwin's Perl to execute external commands.  Forward
+       slashes don't suffer from this problem, and (when quoted, as above) are
+       equally acceptable to MS-Windows.
+
        Using MS-Windows file associations: A useful trick  under  modern  ver-
        sions of MS-Windows (e.g., WinXP) is to use just the command 'start' by
        itself:
@@ -979,21 +1227,13 @@
 
        Under recent versions of MS-Windows, this will cause to be run whatever
        program  the  system  has associated with dvi files.  (The same applies
-       for a postscript viewer and a pdf viewer.)
+       for a postscript viewer and a pdf viewer.)  But note that this trick is
+       not  always  suitable for the pdf previwer, if your system has acroread
+       for the default pdf viewer.  As explained elsewhere, acroread under MS-
+       Windows  does  not  work  well with latex and latexmk, because acroread
+       locks the pdf file.
 
        Not using a certain command: If a command is not to be run, the command
-
-
-
-                                  7 May 2011                                15
-
-
-
-
-
-LATEXMK(1L)                                                        LATEXMK(1L)
-
-
        name NONE is used, as in
 
             $lpr  = 'NONE lpr';
@@ -1007,27 +1247,58 @@
        enabled.   Then  you  might use the following line in an initialization
        file:
 
+
+
+                               11 November 2012                             19
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
             $latex = 'latex --src-specials %O %S';
 
 
-       Advanced tricks: Normally one specifies a single command for  the  com-
-       mands  invoked  by  latexmk.   Naturally,  if there is some complicated
+       Running a subroutine instead of an external command: Use  a  specifica-
+       tion starting with "internal", as in
+
+            $latex = 'internal mylatex %O %S';
+            sub mylatex {
+                my @args = @_;
+                # Possible preprocessing here
+                return system 'latex', @args;
+            }
+
+
+       Advanced  tricks:  Normally one specifies a single command for the com-
+       mands invoked by latexmk.  Naturally,  if  there  is  some  complicated
        additional processing you need to do in your special situation, you can
        write a script (or batch file) to do the processing, and then configure
        latexmk to use your script in place of the standard program.
 
        It is also possible to configure latexmk to run multiple commands.  For
-       example,  if  when  running  pdflatex to generate a pdf file from a tex
-       file you need to run another program after  pdflatex  to  perform  some
+       example, if when running pdflatex to generate a pdf  file  from  a  tex
+       file  you  need  to  run another program after pdflatex to perform some
        extra processing, you could do something like:
 
-            $pdflatex  =  'pdflatex  --shell-escape %O %S; pst2pdf_for_latexmk
+            $pdflatex = 'pdflatex --shell-escape  %O  %S;  pst2pdf_for_latexmk
        %B';
 
-       This definition assumes you are using a UNIX-like system, so  that  the
-       two  commands to be run are separated by the semicolon in the middle of
-       the string.
-
+       This  definition  assumes  you  are  using  a  UNIX-like  system (which
+       includes Linux and OS-X), so that the two commands to be run are  sepa-
+       rated by the semicolon in the middle of the string.
+
+       If you are using MS-Windows, you would replace the above line by
+
+          $pdflatex = 'cmd /c pdflatex --shell-escape %O %S'
+                      . '&& pst2pdf_for_latexmk %B';
+
+       Here,  the  UNIX  command  separator ; is replaced by &&.  In addition,
+       there is a problem that some versions of Perl on MS-Windows do not obey
+       the  command separator; this problem is overcome by explicitly invoking
+       the MS-Windows command-line processor cmd.exe.
 
 
 LIST OF CONFIGURATION VARIABLES USABLE IN INITIALIZATION FILES
@@ -1041,17 +1312,10 @@
               unfortunately.)
 
               This use of a temporary file solves a problem that the making of
-              these  files  can  occupy  a substantial time.  If a viewer sees
-              that the file has changed, it reads the new file, and  this  can
-              cause havoc if the program writing the file has not yet finished
-              its work.
 
-              See the $pvc_view_file_via_temporary variable for a setting that
-              applies  only  if preview-continuous mode (-pvc option) is used.
 
 
-
-                                  7 May 2011                                16
+                               11 November 2012                             20
 
 
 
@@ -1060,14 +1324,48 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+              these  files  can  occupy  a substantial time.  If a viewer sees
+              that the file has changed, it reads the new file, and  this  can
+              cause havoc if the program writing the file has not yet finished
+              its work.
+
+              See the $pvc_view_file_via_temporary variable for a setting that
+              applies  only  if preview-continuous mode (-pvc option) is used.
               See $tmpdir for the setting of the directory where the temporary
               file is created.
 
 
+       $auto_rc_use [1]
+              Whether  to  automatically read the standard initialization (rc)
+              files, which are the system RC file, the user's RC file, and the
+              RC file in the current directory.  The command line option -norc
+              can be used to turn this setting off.  Each RC file  could  also
+              turn  this  setting off, i.e., it could set $auto_rc_use to zero
+              to prevent automatic reading of the later RC files.
+
+              This variable does not affect the reading of RC files  specified
+              on the command line by the -r option.
+
+
+       $aux_dir [""]
+              The directory in which auxiliary files (aux, log, etc) are to be
+              written by a run of (pdf)latex.  If this variable  is  not  set,
+              but  $out_dir is set, then $aux_dir is set to $out_dir, which is
+              the directory to which general output files are to be written.
+
+              Important note:  The  effect  of  $aux_dir,  if  different  from
+              $out_dir,  is  achieved by giving (pdf)latex the -aux-directory.
+              Currently (Dec. 2011) this only works on the MiKTeX  version  of
+              (pdf)latex.
+
+              See also the documentation of $out_dir for some complications on
+              what directory names are suitable.
+
+
        $banner [0]
-              If  nonzero, the banner message is printed across each page when
-              converting the dvi file to postscript.   Without  modifying  the
-              variable  $banner_message,  this is equivalent to specifying the
+              If nonzero, the banner message is printed across each page  when
+              converting  the  dvi  file to postscript.  Without modifying the
+              variable $banner_message, this is equivalent to  specifying  the
               -d option.
 
               Note that if $banner is nonzero, the $postscript_mode is assumed
@@ -1076,28 +1374,40 @@
 
        $banner_intensity [0.95]
               Equivalent to the -bi option, this is a decimal number between 0
-              and  1 that specifies how dark to print the banner message. 0 is
+              and 1 that specifies how dark to print the banner message. 0  is
               black, 1 is white.  The default is just right if your toner car-
               tridge isn't running too low.
 
+
+
+
+                               11 November 2012                             21
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
        $banner_message ["DRAFT"]
               The banner message to print across each page when converting the
               dvi file to postscript.  This is equivalent to the -bm option.
 
        $banner_scale [220.0]
-              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 just right for  5  character  messages.
+              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 just right for 5 character messages.
               This is equivalent to the -bs option.
 
        @BIBINPUTS
-              This  is  an array variable, now mostly obsolete, that specifies
-              directories where  latexmk  should  look  for  .bib  files.   By
+              This is an array variable, now mostly obsolete,  that  specifies
+              directories  where  latexmk  should  look  for  .bib  files.  By
               default it is set from the BIBINPUTS environment variable of the
-              operating system.  If that environment variable is  not  set,  a
-              single  element list consisting of the current directory is set.
+              operating  system.   If  that environment variable is not set, a
+              single element list consisting of the current directory is  set.
               The format of the directory names depends on your operating sys-
               tem, of course.  Examples for setting this variable are:
 
@@ -1107,93 +1417,84 @@
                       @BIBINPUTS = ( ".", "//server/bibfiles" );
                       @BIBINPUTS = ( ".", "/usr/local/texmf/bibtex/bib" );
 
-              Note  that  under  MS  Windows,  either a forward slash "/" or a
-              backward slash "\" can be used to separate pathname  components,
-              so  the  first  two  and the second two examples are equivalent.
-              Each backward slash should be doubled to avoid running afoul  of
+              Note that under MS Windows, either a  forward  slash  "/"  or  a
+              backward  slash "\" can be used to separate pathname components,
+              so the first two and the second  two  examples  are  equivalent.
+              Each  backward slash should be doubled to avoid running afoul of
               Perl's rules for writing strings.
 
-       Important  note:  This  variable  is now mostly obsolete in the current
+              Important note: This variable is now mostly obsolete in the cur-
+              rent version of latexmk, since it has a better method of search-
+              ing for files using the kpsewhich  command.   However,  if  your
+              system  is an unusual one without the kpsewhich command, you may
+              need to set the variable @BIBINPUTS.
 
+       $biber ["biber %O %S"]
+              The biber processing program.
 
+       $biber_silent_switch ["--onlylog"]
+              Switch(es) for the biber processing program when silent mode  is
+              on.
 
-                                  7 May 2011                                17
+       $bibtex ["bibtex %O %S"]
+              The BibTeX processing program.
 
+       $bibtex_silent_switch ["-terse"]
+              Switch(es) for the BibTeX processing program when silent mode is
+              on.
 
 
 
 
-LATEXMK(1L)                                                        LATEXMK(1L)
 
+                               11 November 2012                             22
 
-       version of latexmk, since it has a better method of searching for files
-       using the kpsewhich command.  However, if your system is an unusual one
-       without the kpsewhich command, you may need to set the variable @BIBIN-
-       PUTS.
 
-       $biber ["biber %O %S"]
-              The biber processing program.
 
-       $biber_silent_switch ["--onlylog"]
-              Switch(es)  for the biber processing program when silent mode is
-              on.
 
-       $bibtex ["bibtex %O %S"]
-              The BibTeX processing program.
 
-       $bibtex_silent_switch ["-terse"]
-              Switch(es) for the BibTeX processing program when silent mode is
-              on.
+LATEXMK(1L)                                                        LATEXMK(1L)
+
 
        $bibtex_use [1]
               Under what conditions to run BibTeX or biber.  When latexmk dis-
-              covers from the log file that one (or more)  BibTeX/biber-gener-
-              ated  bibliographies  are used, it can run BibTeX or biber when-
-              ever it appears necessary to regenerate  the  bbl  file(s)  from
+              covers  from the log file that one (or more) BibTeX/biber-gener-
+              ated bibliographies are used, it can run BibTeX or  biber  when-
+              ever  it  appears  necessary  to regenerate the bbl file(s) from
               their source bib database file(s).
 
-              But  sometimes,  the  bib file(s) are not available (e.g., for a
-              document obtained from an external archive), but the  bbl  files
-              are  provided.   In that case use of BibTeX or biber will result
-              in incorrect overwriting of the precious bbl files.   The  vari-
-              able  $bibtex_use  controls  whether this happens.  Its possible
+              But sometimes, the bib file(s) are not available  (e.g.,  for  a
+              document  obtained  from an external archive), but the bbl files
+              are provided.  In that case use of BibTeX or biber  will  result
+              in  incorrect  overwriting of the precious bbl files.  The vari-
+              able $bibtex_use controls whether this  happens.   Its  possible
               values are: 0: never use BibTeX or biber.  1: only use BibTeX or
-              biber  if  the bib files exist.  2: run BibTeX or biber whenever
-              it appears necessary to update the bbl  files,  without  testing
+              biber if the bib files exist.  2: run BibTeX or  biber  whenever
+              it  appears  necessary  to update the bbl files, without testing
               for the existence of the bib files.
 
        $cleanup_includes_cusdep_generated [0]
-              If  nonzero,  specifies that cleanup also deletes files that are
+              If nonzero, specifies that cleanup also deletes files  that  are
               generated by custom dependencies.  (When doing a clean up, e.g.,
               by use of the -C option, custom dependencies are those listed in
               the .fdb_latexmk file from a previous run.)
 
        $cleanup_includes_generated [0]
-              If nonzero, specifies that cleanup also deletes files  that  are
-              detected  in log file as being generated (see the \openout lines
-              in the log file).  It will also include files  made  from  these
+              If  nonzero,  specifies that cleanup also deletes files that are
+              detected in log file as being generated (see the \openout  lines
+              in  the  log  file).  It will also include files made from these
               first generation generated files.
 
        $cleanup_mode [0]
-              If  nonzero,  specifies  cleanup mode: 1 for full cleanup, 2 for
-              cleanup except for dvi, ps and pdf files, 3 for  cleanup  except
-              for  dep and aux files.  (There is also extra cleaning as speci-
-              fied by  the  $clean_ext,  $clean_full_ext  and  @generated_exts
+              If nonzero, specifies cleanup mode: 1 for full  cleanup,  2  for
+              cleanup  except  for dvi, ps and pdf files, 3 for cleanup except
+              for dep and aux files.  (There is also extra cleaning as  speci-
+              fied  by  the  $clean_ext,  $clean_full_ext  and @generated_exts
               variables.)
 
-
-
-                                  7 May 2011                                18
-
-
-
-
-
-LATEXMK(1L)                                                        LATEXMK(1L)
-
-
-       This  variable is equivalent to specifying one of the -c or -C options.
-       But there should be no need to set this variable from an RC file.
+              This variable is equivalent to specifying one of the  -c  or  -C
+              options.   But there should be no need to set this variable from
+              an RC file.
 
        $clean_ext [""]
               Extra extensions of files for latexmk to remove when any of  the
@@ -1209,6 +1510,18 @@
 
               in an initialization file will imply that when a clean-up opera-
               tion is specified,  not  only  is  the  standard  set  of  files
+
+
+
+                               11 November 2012                             23
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
               deleted,  but  also  files  of the form FOO.out and FOO-blx.bib,
               where FOO stands for the basename of the  file  being  processed
               (as in FOO.tex).
@@ -1219,21 +1532,78 @@
               option is selected, i.e., extensions of files to remove when the
               .dvi, etc files are to be cleaned-up.
 
+              More general patterns are allowed, as for $clean_ext.
+
+
+       $compiling_cmd   [undefined],  $failure_cmd  [undefined],  $success_cmd
+       [undefined]
+
+              These  variables  specify  commands that are executed at certain
+              points of  compilations  during  preview-continuous  mode.   One
+              motivation  for  their  existance  is to allow convenient visual
+              indications of compilation status even when the window receiving
+              the screen output of the compilation is hidden.
+
+              The  commands  are  executed  at  the following points: $compil-
+              ing_cmd at the start of compilation, $success_cmd at the end  of
+              a  successful  compilation,  and  $failure_cmd  at the end of an
+              unsuccessful compilation.  If any of above  variables  is  unde-
+              fined  (the  default situation) or blank, then the corresponding
+              command is not executed.
+
+              An example of a typical setting of these variables is as follows
+
+                  $compiling_cmd  =  "xdotool  search --name \"%D\" set_window
+              --name \"%D compiling\"";
+                  $success_cmd   = "xdotool search  --name  \"%D\"  set_window
+              --name \"%D OK\"";
+                  $failure_cmd    =  "xdotool  search --name \"%D\" set_window
+              --name \"%D FAILURE\"";
+
+              These assume that the program xdotool  is  installed,  that  the
+              previewer  is using an X-Window system for display, and that the
+              title of the window contains the name of the displayed file,  as
+              it  normally  does.   When the commands are executed, the place-
+              holder string %D is replaced by  the  name  of  the  destination
+              file, which is the previewed file.  The above commands result in
+              an appropriate string being appended to the filename in the win-
+              dow title: " compiling", " OK", or " FAILURE".
+
+              Other  placeholders that can be used are %S, %T, and %R, with %S
+              and %T normally being identical. These can be useful for a  com-
+              mand  changing  the title of the edit window. The visual indica-
+              tion in a window title can useful, since the user does not  have
+              to  keep shifting attention to the (possibly hidden) compilation
+              window to know the status of the compilation.
+
+
+
+
+                               11 November 2012                             24
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
        @cus_dep_list [()]
-              Custom  dependency list -- see section on "Custom Dependencies".
+              Custom dependency list -- see section on "Custom  Dependencies".
+
 
        @default_files [("*.tex")]
               Default list of files to be processed.
 
-              Normally, if no filenames are specified  on  the  command  line,
-              latexmk  processes all tex files specified in the @default_files
-              variable, which by default is set to all tex files ("*.tex")  in
-              the  current directory.  This is a convenience: just run latexmk
-              and it will process an appropriate set of files.  But  sometimes
+              Normally,  if  no  filenames  are specified on the command line,
+              latexmk processes all tex files specified in the  @default_files
+              variable,  which by default is set to all tex files ("*.tex") in
+              the current directory.  This is a convenience: just run  latexmk
+              and  it will process an appropriate set of files.  But sometimes
               you want only some of these files to be processed.  In this case
-              you set the @default_files in an initialization file (e.g.,  the
-              file  "latexmkrc"  in  the current directory).  Then if no files
-              are specified on the command line then the files you specify  by
+              you  set the @default_files in an initialization file (e.g., the
+              file "latexmkrc" in the current directory).  Then  if  no  files
+              are  specified on the command line then the files you specify by
               setting @default_files are processed.
 
               Three examples:
@@ -1244,40 +1614,48 @@
 
                    @default_files = ("*.tex", "*.dtx");
 
-              Note  that  more  than  file  may be given, and that the default
-              extension is ".tex".  Wild cards are allowed.   The  parentheses
+              Note that more than file may be  given,  and  that  the  default
+              extension  is  ".tex".  Wild cards are allowed.  The parentheses
+              are  because  @default_files  is  an  array  variable,  i.e.,  a
+              sequence of filename specifications is possible.
+
+       $dependents_phony [0]
+              If  a  list  of dependencies is output, this variable determines
+              whether to include a phony target for each source file.  If  you
+              use  the  dependents  list  in  a Makefile, the dummy rules work
+              around errors make gives if  you  remove  header  files  without
+              updating the Makefile to match.
 
+       $dependents_list [0]
+              Whether  to  display  a  list(s) of dependencies at the end of a
+              run.
 
+       $dvi_filter [empty]
+              The dvi file filter to be run on the  newly  produced  dvi  file
+              before  other  processing.   Equivalent  to  specifying  the -dF
+              option.
 
-                                  7 May 2011                                19
+       $dvi_mode [See below for default]
+              If nonzero, generate a dvi version of the document.   Equivalent
+              to the -dvi option.
 
+              The  variable  $dvi_mode  defaults  to  0,  but  if  no explicit
+              requests are made for other types  of  file  (postscript,  pdf),
+              then  $dvi_mode will be set to 1.  In addition, if a request for
 
 
 
+                               11 November 2012                             25
 
-LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-              are  because  @default_files  is  an  array  variable,  i.e.,  a
-              sequence of filename specifications is possible.
 
-       $dependents_list [0]
-              Whether to display a list(s) of dependencies at  the  end  of  a
-              run.
 
-       $dvi_filter [empty]
-              The  dvi  file  filter  to be run on the newly produced dvi file
-              before other  processing.   Equivalent  to  specifying  the  -dF
-              option.
+LATEXMK(1L)                                                        LATEXMK(1L)
 
-       $dvi_mode [See below for default]
-              If  nonzero, generate a dvi version of the document.  Equivalent
-              to the -dvi option.
 
-       The variable $dvi_mode defaults to 0, but if no explicit  requests  are
-       made  for other types of file (postscript, pdf), then $dvi_mode will be
-       set to 1.  In addition, if a request for a file for which a  .dvi  file
-       is a prerequisite, then $dvi_mode will be set to 1.
+              a file for which a .dvi file is a prerequisite,  then  $dvi_mode
+              will be set to 1.
 
        $dvi_previewer ["start xdvi %O %S" under UNIX]
               The  command  to  invoke  a  dvi-previewer.  [Default is "start"
@@ -1285,6 +1663,17 @@
               will  cause to be run whatever command the system has associated
               with .dvi files.]
 
+              Important note: Normally you will want to have a  previewer  run
+              detached, so that latexmk doesn't wait for the previewer to ter-
+              minate before continuing its work.  So normally you should  pre-
+              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.
+
+
        $dvi_previewer_landscape ["start xdvi %O %S"]
               The  command  to  invoke  a  dvi-previewer  in  landscape  mode.
               [Default is "start" under MS-WINDOWS; under more recent versions
@@ -1303,19 +1692,26 @@
               That  script  should  be  modified to give dvips the options "-P
               pdf" to ensure that type 1 fonts are used in the pdf file.
 
+       $dvipdf_silent_switch ["-q"]
+              Switch(es) for dvipdf program when silent mode is on.
+
+              N.B. The standard dvipdf program runs silently,  so  adding  the
+              silent  switch has no effect, but is actually innocuous.  But if
+              an alternative program is used, e.g., dvipdfmx, then the  silent
+              switch  has  an  effect.   The  default  setting  is correct for
+              dvipdfm and dvipdfmx.
+
        $dvips ["dvips %O -o %D %S"]
               The program to used as a filter to convert a .dvi file to a  .ps
               file.   If pdf is going to be generated from pdf, then the value
               of the $dvips_pdf_switch -- see below -- will be included in the
               options substituted for "%O".
 
-       $dvips_landscape ["dvips -tlandscape %O -o %D %S"]
-              The  program to used as a filter to convert a .dvi file to a .ps
-              file in landscape mode.
 
 
 
-                                  7 May 2011                                20
+
+                               11 November 2012                             26
 
 
 
@@ -1324,6 +1720,10 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+       $dvips_landscape ["dvips -tlandscape %O -o %D %S"]
+              The  program to used as a filter to convert a .dvi file to a .ps
+              file in landscape mode.
+
        $dvips_pdf_switch ["-P pdf"]
               Switch(es) for dvips program when pdf file is  to  be  generated
               from ps file.
@@ -1363,6 +1763,9 @@
               variable  $dvi_update_method.   The  default  value  is  the one
               appropriate for xdvi on a UNIX system.
 
+       $failure_cmd [undefined]
+              See the documentation for $compiling_cmd.
+
        $fdb_ext ["fdb_latexmk"]
               The extension of the file which latexmk generates to  contain  a
               database  of information on source files.  You will not normally
@@ -1371,17 +1774,10 @@
        $force_mode [0]
               If nonzero, continue processing past minor latex errors  includ-
               ing unrecognized cross references.  Equivalent to specifying the
-              -f option.
-
-       @generated_exts [( aux , bbl , idx , ind , lof , lot  ,  out  ,  toc  ,
-       $fdb_ext )]
-              This contains a list of extensions for files that are  generated
-              during  a LaTeX run and that are read in by LaTeX in later runs,
-              either directly or indirectly.
 
 
 
-                                  7 May 2011                                21
+                               11 November 2012                             27
 
 
 
@@ -1390,6 +1786,14 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+              -f option.
+
+       @generated_exts [( aux , bbl , idx , ind , lof , lot  ,  out  ,  toc  ,
+       $fdb_ext )]
+              This contains a list of extensions for files that are  generated
+              during  a LaTeX run and that are read in by LaTeX in later runs,
+              either directly or indirectly.
+
               This list has two uses: (a) to set  the  kinds  of  file  to  be
               deleted in a cleanup operation (with the -c, -C, -CA, -g and -gg
               options), and (b) in the determination of  whether  a  rerun  of
@@ -1436,18 +1840,10 @@
               But the changing line has no real effect, since it is a comment.
               You can instruct latex to ignore the offending line as follows:
 
-                 $hash_calc_ignore_pattern{'eps'} = '^%%CreationDate: ';
-
-              This creates a rule for files with extension .eps about lines to
-              ignore.   The left-hand side is a Perl idiom for setting an item
-              in a hash.  Note that the file extension is specified without  a
-              period.  The value, on the right-hand side, is a string contain-
-              ing a regular expresssion.  (See documentation on Perl  for  how
-              they  are  to be specified in general.)  This particular regular
 
 
 
-                                  7 May 2011                                22
+                               11 November 2012                             28
 
 
 
@@ -1456,6 +1852,14 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+                 $hash_calc_ignore_pattern{'eps'} = '^%%CreationDate: ';
+
+              This creates a rule for files with extension .eps about lines to
+              ignore.   The left-hand side is a Perl idiom for setting an item
+              in a hash.  Note that the file extension is specified without  a
+              period.  The value, on the right-hand side, is a string contain-
+              ing a regular expresssion.  (See documentation on Perl  for  how
+              they  are  to be specified in general.)  This particular regular
               expression specifies that lines beginning with  "%%CreationDate:
               "  are  to  be  ignored  in deciding whether a file of the given
               extension .eps has changed.
@@ -1503,17 +1907,9 @@
               you can use this variable not just to change  the  name  of  the
               program used, but also specify options to the program.  E.g.,
 
-                                  $latex = "latex --src-specials";
-
-       %latex_input_extensions
-              This  variable specifies the extensions tried by latexmk when it
-              finds that a LaTeX run resulted in an error that a file has  not
-              been  found,  and  the file is given without an extension.  This
-              typically happens when LaTeX commands of the  form  \input{file}
-
 
 
-                                  7 May 2011                                23
+                               11 November 2012                             29
 
 
 
@@ -1522,6 +1918,13 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+                                  $latex = "latex --src-specials";
+
+       %latex_input_extensions
+              This  variable specifies the extensions tried by latexmk when it
+              finds that a LaTeX run resulted in an error that a file has  not
+              been  found,  and  the file is given without an extension.  This
+              typically happens when LaTeX commands of the  form  \input{file}
               or  \includegraphics{figure}, when the relevant source file does
               not exist.
 
@@ -1569,25 +1972,25 @@
               Under  MS-Windows (unlike UNIX/LINUX), there is no standard pro-
               gram for printing files.  But there are ways you can do it.  For
               example, if you have gsview installed, you could use it with the
-              option "/p":
 
-                  $lpr = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p';
 
-              If  gsview  is installed in a different directory, you will need
-              to make the appropriate change.  Note the combination of  single
-              and  double  quotes  around the name.  The single quotes specify
 
+                               11 November 2012                             30
 
 
-                                  7 May 2011                                24
 
 
 
+LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-LATEXMK(1L)                                                        LATEXMK(1L)
+              option "/p":
 
+                  $lpr = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p';
 
+              If  gsview  is installed in a different directory, you will need
+              to make the appropriate change.  Note the combination of  single
+              and  double  quotes  around the name.  The single quotes specify
               that this is a string to be assigned to the configuration  vari-
               able  $lpr.   The double quotes are part of the string passed to
               the operating system to get the command obeyed; this  is  neces-
@@ -1619,33 +2022,92 @@
        $makeindex ["makeindex %O -o %D %S"]
               The index processing program.
 
+       $makeindex_silent_switch ["-q"]
+              Switch(es) for the index processing program when silent mode  is
+              on.
+
        $max_repeat [5]
-              The maximum number of  times  latexmk  will  run  latex/pdflatex
-              before  deciding  that there may be an infinite loop and that it
+              The  maximum  number  of  times  latexmk will run latex/pdflatex
+              before deciding that there may be an infinite loop and  that  it
               needs to bail out, rather than rerunning latex/pdflatex again to
-              resolve  cross-references,  etc.   The  default value covers all
+              resolve cross-references, etc.  The  default  value  covers  all
               normal cases.
 
-              (Note that the "etc" covers a lot of  cases  where  one  run  of
+              (Note  that  the  "etc"  covers  a lot of cases where one run of
               latex/pdflatex generates files to be read in on a later run.)
 
+       $MSWin_back_slash [1]
+              This configuration variable only has an effect when  latexmk  is
+
+
+
+                               11 November 2012                             31
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
+              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, latexmk uses "/" for the directory  separator
+              character, which is the character used by Unix-like systems.
+
+              For many programs under MS-Windows, both "\" and "/" are accept-
+              able as the directory separator character.   But  some  programs
+              only  accept "\".  So for safety latexmk makes a translation, by
+              default.  It is conceivable that under certain  situations  this
+              is  undesirable, so the configuration can be changed.  (A possi-
+              ble example might be when some of the  software  is  implemented
+              using Cygwin, which provides an Unix-like environment inside MS-
+              Windows.)
+
+
        $new_viewer_always [0]
-              This  variable  applies  to  latexmk  only in continuous-preview
+              This variable applies  to  latexmk  only  in  continuous-preview
               mode.  If $new_viewer_always is 0, latexmk will check for a pre-
-              viously  running  previewer on the same file, and if one is run-
-              ning will not start a new one.  If  $new_viewer_always  is  non-
-              zero,  this check will be skipped, and latexmk will behave as if
+              viously running previewer on the same file, and if one  is  run-
+              ning  will  not  start a new one.  If $new_viewer_always is non-
+              zero, this check will be skipped, and latexmk will behave as  if
               no viewer is running.
 
+
+       $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) 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-
+              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
+              current working directory or one of its subdirectories.  This is
+              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
+              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.
+
+
        $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
 
 
 
-                                  7 May 2011                                25
+                               11 November 2012                             32
 
 
 
@@ -1654,97 +2116,150 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-              variable.  If equal to 3, generate a pdf version of the document
+              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.
 
               Equivalent to the -pdf-, -pdf, -pdfdvi, -pdfps options.
 
+
        $pdflatex ["pdflatex %O %S"]
               The LaTeX processing program in the version  that  makes  a  pdf
               file instead of a dvi file.
 
+              An example of the use of this variable is to arrange for xelatex
+              to be used instead of pdflatex, when you could set
+
+                   $pdflatex = "xelatex %O %S";
+
+              Note that xelatex only produces .pdf files (and not .dvi), so to
+              use  it  you will also need to turn on production of .pdf files,
+              and to turn off the production of .dvi (and .ps)  files,  either
+              by  command line options or by the following settings in an ini-
+              tialization file
+
+                  $pdf_mode = 1; $postscript_mode = $dvi_mode = 0;
+
+
+
        %pdflatex_input_extensions
-              This  variable specifies the extensions tried by latexmk when it
-              finds that a pdfLaTeX run resulted in an error that a  file  has
-              not  been  found,  and  the  file is given without an extension.
-              This  typically  happens  when  LaTeX  commands  of   the   form
+              This variable specifies the extensions tried by latexmk when  it
+              finds  that  a pdfLaTeX run resulted in an error that a file has
+              not been found, and the file  is  given  without  an  extension.
+              This   typically   happens  when  LaTeX  commands  of  the  form
               \input{file}  or  \includegraphics{figure},  when  the  relevant
               source file does not exist.
 
-              In this situation, latexmk searches for custom  dependencies  to
-              make  the  missing  file(s),  but restricts it to the extensions
-              specified  by  the  variable  %pdflatex_input_extensions.    The
+              In  this  situation, latexmk searches for custom dependencies to
+              make the missing file(s), but restricts  it  to  the  extensions
+              specified   by  the  variable  %pdflatex_input_extensions.   The
               default extensions are 'tex', 'pdf', 'jpg, and 'png'.
 
-              (For  Perl  experts:  %pdflatex_input_extensions is a hash whose
-              keys are the extensions.  The values are irrelevant.)  Two  sub-
-              routines  are  provided  for  manipulating  this and the related
-              variable     %latex_input_extensions,     add_input_ext      and
-              remove_input_ext.   They  are  used as in the following examples
+              (For Perl experts: %pdflatex_input_extensions is  a  hash  whose
+              keys  are the extensions.  The values are irrelevant.)  Two sub-
+              routines are provided for  manipulating  this  and  the  related
+              variable      %latex_input_extensions,     add_input_ext     and
+              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
 
+
+
+
+                               11 November 2012                             33
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
                   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-
+              add  the  extension  'asdf to pdflatex_input_extensions.  (Natu-
+              rally with such an extension, you should have made an  appropri-
               ate custom dependency for latexmk, and should also have done the
-              appropriate  programming  in the LaTeX source file to enable the
-              file to be read.  The standard extensions are handled by  pdfla-
+              appropriate programming in the LaTeX source file to  enable  the
+              file  to be read.  The standard extensions are handled by pdfla-
               tex and its graphics/graphicx packages.)
 
 
        $pdflatex_silent_switch ["-interaction=batchmode"]
-              Switch(es)  for  the pdflatex program (specified in the variable
+              Switch(es) for the pdflatex program (specified in  the  variable
               $pdflatex when silent mode is on.
 
-              If you use MikTeX, you may prefer the results if  you  configure
-              the  options  to include -c-style-errors, e.g., by the following
+              If  you  use MikTeX, you may prefer the results if you configure
+              the options to include -c-style-errors, e.g., by  the  following
               line in an initialization file
 
                 $latex_silent_switch   =   "-interaction=batchmode   -c-style-
               errors";
 
 
+       $pdf_previewer ["start acroread %O %S"]
+              The command to invoke a pdf-previewer.
+
+              On MS-WINDOWS, the default is changed  to  "cmd  /c  start  """;
+              under more recent versions of Windows, this will cause to be run
+              whatever command the system has associated with .pdf files.  But
+              this  may  be  undesirable if this association is to acroread --
+              see the notes in the explanation of the -pvc option.]
 
-                                  7 May 2011                                26
+              On OS-X the default is changed to "open %S",  which  results  in
+              OS-X  starting up (and detaching) the viewer associated with the
+              file.  By default, for pdf files this association is  to  OS-X's
+              preview, which is quite satisfactory.
 
+              WARNING:   Problem  under MS-Windows: if acroread is used as the
+              pdf previewer, and it is actually viewing a pdf  file,  the  pdf
+              file  cannot  be  updated.   Thus makes acroread a bad choice of
+              previewer if you use latexmk's previous-continuous mode  (option
+              -pvc)  under  MS-windows.   This  problem does not occur if, for
+              example, SumatraPDF or gsview is used to view pdf files.
 
+              Important note: Normally you will want to have a  previewer  run
+              detached, so that latexmk doesn't wait for the previewer to ter-
+              minate before continuing its work.  So normally you should  pre-
+              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.
 
 
 
-LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-       $pdf_previewer ["start acroread %O %S"]
-              The  command  to invoke a pdf-previewer.  [Default is changed to
-              "start" on MS-WINDOWS; under more recent  versions  of  Windows,
-              this  will cause to be run whatever command the system has asso-
-              ciated with .pdf files.]
-
-              WARNING: Potential problem under MS-Windows: if acroread is used
-              as the pdf previewer, and it is actually viewing a pdf file, the
-              pdf file cannot be updated.  Thus makes acroread a bad choice of
-              previewer  if you use latexmk's previous-continuous mode (option
-              -pvc)  under  MS-windows.   This  problem  does  not  occur   if
-              ghostview, gv or gsview is used to view pdf files.
+                               11 November 2012                             34
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
 
        $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
+              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
-              changed. See the information on the variable  $dvi_update_method
+              How the pdf viewer updates its display when  the  pdf  file  has
+              changed.  See the information on the variable $dvi_update_method
               for the codes.  (Note that information needs be changed slightly
-              so that for the value 4, to run a command to do the update,  the
-              command  is  specified  by the variable $pdf_update_command, and
-              for the value 2, to specify update  by  signal,  the  signal  is
+              so  that for the value 4, to run a command to do the update, the
+              command is specified by the  variable  $pdf_update_command,  and
+              for  the  value  2,  to  specify update by signal, the signal is
               specified by $pdf_update_signal.)
 
               Note that acroread under MS-Windows (but not UNIX) locks the pdf
@@ -1757,144 +2272,155 @@
                   $pdf_update_method = 4;
                   $pdf_update_command = "xpdf -remote %R -reload";
 
-              The  first  setting  arranges for the xpdf program to be used in
-              its "remote server mode", with the server name specified as  the
-              rootname  of  the  TeX  file.   The  second setting arranges for
+              The first setting arranges for the xpdf program to  be  used  in
+              its  "remote server mode", with the server name specified as the
+              rootname of the TeX  file.   The  second  setting  arranges  for
               updating to be done in response to a command, and the third set-
               ting sets the update command.
 
 
-       $pdf_update_signal  [Under  UNIX:  SIGHUP,  which is a system-dependent
+       $pdf_update_signal [Under UNIX: SIGHUP,  which  is  a  system-dependent
        value]
-              The  number of the signal that is sent to the pdf viewer when it
-              is updated by sending a signal -- see  the  information  on  the
-              variable  $pdf_update_method.   The  default  value  is  the one
+              The number of the signal that is sent to the pdf viewer when  it
+              is  updated  by  sending  a signal -- see the information on the
+              variable $pdf_update_method.   The  default  value  is  the  one
               appropriate for gv on a UNIX system.
 
        $pid_position[1 under UNIX, -1 under MS-Windows]
-              The variable $pid_position is used  to  specify  which  word  in
-              lines  of  the output from $pscmd corresponds to the process ID.
+              The  variable  $pid_position  is  used  to specify which word in
+              lines of the output from $pscmd corresponds to the  process  ID.
+              The  first word in the line is numbered 0.  The default value of
+              1 (2nd word in line) is correct for Solaris 2.6 and Linux.  Set-
+              ting  the  variable to -1 is used to indicate that $pscmd is not
+              to be used.
+
+       $postscript_mode [0]
+              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.
 
 
-                                  7 May 2011                                27
 
 
 
+                               11 November 2012                             35
 
 
-LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-              The first word in the line is numbered 0.  The default value  of
-              1 (2nd word in line) is correct for Solaris 2.6 and Linux.  Set-
-              ting the variable to -1 is used to indicate that $pscmd  is  not
-              to be used.
 
-       $postscript_mode [0]
-              If  nonzero,  generate  a  postscript  version  of the document.
-              Equivalent to the -ps option.
+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
+              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,
+              option.  Which previewer is run depends on the  other  settings,
               see the command line options -view=, and the variable $view.
 
        $preview_mode [0]
               If nonzero, run a previewer to preview the document.  Equivalent
-              to  the -pv option.  Which previewer is run depends on the other
-              settings, see the command line options -view=, and the  variable
+              to the -pv option.  Which previewer is run depends on the  other
+              settings,  see the command line options -view=, and the variable
               $view.
 
        $printout_mode [0]
-              If  nonzero, print the document using lpr.  Equivalent to the -p
+              If nonzero, print the document using lpr.  Equivalent to the  -p
               option.  This is recommended not to be set from an RC file, oth-
               erwise you could waste lots of paper.
 
        $print_type = ["ps"]
-              Type  of  file  to  printout:  possibilities  are "dvi", "none",
+              Type of file  to  printout:  possibilities  are  "dvi",  "none",
               "pdf", or "ps".
 
        $pscmd Command used to get all the processes currently run by the user.
-              The  -pvc  option  uses  the  command  specified by the variable
-              $pscmd to determine if there is an  already  running  previewer,
-              and  to  find  the process ID (needed if latexmk needs to signal
+              The -pvc option uses  the  command  specified  by  the  variable
+              $pscmd  to  determine  if there is an already running previewer,
+              and to find the process ID (needed if latexmk  needs  to  signal
               the previewer about file changes).
 
               Each line of the output of this command is assumed to correspond
-              to  one  process.   See  the  $pid_position variable for how the
+              to one process.  See the  $pid_position  variable  for  how  the
               process number is determined.
 
-              The default for pscmd is  "NONE"  under  MS-Windows  and  cygwin
+              The  default  for  pscmd  is  "NONE" under MS-Windows and cygwin
               (i.e.,  the  command  is  not  used),  "ps  --width  200  -f  -u
-              $ENV{USER}" under linux, "ps -ww  -u  $ENV{USER}"  under  darwin
-              (Macintosh  OS-X), and "ps -f -u $ENV{USER}" under other operat-
-              ing systems (including other flavors of UNIX).  In these  speci-
+              $ENV{USER}"  under  linux,  "ps  -ww -u $ENV{USER}" under darwin
+              (Macintosh OS-X), and "ps -f -u $ENV{USER}" under other  operat-
+              ing  systems (including other flavors of UNIX).  In these speci-
               fications "$ENV{USER}" is substituted by the username.
 
        $ps2pdf ["ps2pdf %O %S %D"]
               Command to convert ps to pdf file.
 
+       $ps_filter [empty]
+              The postscript file filter to be run on the newly produced post-
+              script  file  before other processing.  Equivalent to specifying
+              the -pF option.
 
+       $ps_previewer ["start gv %O %S", but start %O %S under MS-WINDOWS]
+              The command to invoke a ps-previewer.  (The  default  under  MS-
+              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
 
 
-                                  7 May 2011                                28
-
 
+                               11 November 2012                             36
 
 
 
-LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-       $ps_filter [empty]
-              The postscript file filter to be run on the newly produced post-
-              script file before other processing.  Equivalent  to  specifying
-              the -pF option.
+LATEXMK(1L)                                                        LATEXMK(1L)
 
-       $ps_previewer ["start gv %O %S", but "start %O %S" under MS-WINDOWS]
-              The  command  to  invoke a ps-previewer.  (The default under MS-
-              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
+              different  ways  of writing this option.  You can configure this
               variable apppropriately.
 
               WARNING: Linux systems may have installed one (or more) versions
-              of gv under different names, e.g.,  ggv,  kghostview,  etc,  but
+              of  gv  under  different  names, e.g., ggv, kghostview, etc, but
               perhaps not one called gv.
 
-       $ps_previewer_landscape  ["start  gv  -swap  %O  %S", but "start %O %S"
-       under MS-WINDOWS]
+              Important note: Normally you will want to have a  previewer  run
+              detached, so that latexmk doesn't wait for the previewer to ter-
+              minate before continuing its work.  So normally you should  pre-
+              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.
+
+
+       $ps_previewer_landscape ["start gv -swap %O %S", but start %O %S  under
+       MS-WINDOWS]
               The command to invoke a ps-previewer in landscape mode.
 
        $ps_update_command [""]
-              When  the postscript previewer is set to be updated by running a
-              command, this is the command that is run.  See  the  information
+              When the postscript previewer is set to be updated by running  a
+              command,  this  is the command that is run.  See the information
               for the variable $ps_update_method.
 
        $ps_update_method [0 under UNIX, 1 under MS-Windows]
-              How  the  postscript viewer updates its display when the ps file
-              has   changed.   See   the   information   on    the    variable
-              $dvi_update_method  for the codes.  (Note that information needs
+              How the postscript viewer updates its display when the  ps  file
+              has    changed.    See   the   information   on   the   variable
+              $dvi_update_method for the codes.  (Note that information  needs
               be changed slightly so that for the value 4, to run a command to
               do  the  update,  the  command  is  specified  by  the  variable
-              $ps_update_command, and for the value 2, to  specify  update  by
+              $ps_update_command,  and  for  the value 2, to specify update by
               signal, the signal is specified by $ps_update_signal.)
 
 
-       $ps_update_signal  [Under  UNIX:  SIGHUP,  which  is a system-dependent
+       $ps_update_signal [Under UNIX:  SIGHUP,  which  is  a  system-dependent
        value]
-              The  number of the signal that is sent to the pdf viewer when it
-              is updated by sending a signal --  see  $ps_update_method.   The
+              The number of the signal that is sent to the pdf viewer when  it
+              is  updated  by  sending a signal -- see $ps_update_method.  The
               default value is the one appropriate for gv on a UNIX system.
 
 
@@ -1906,10 +2432,12 @@
        $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.
 
 
 
-                                  7 May 2011                                29
+                               11 November 2012                             37
 
 
 
@@ -1918,16 +2446,14 @@
 LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-              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 spa-
-       ces.  (But note that many versions of LaTeX and  PdfLaTeX  cannot  cor-
-       rectly deal with TeX files whose names contain spaces.  Latexmk's quot-
-       ing only ensures that such filenames are correctly treated by the oper-
-       ating system in passing arguments to programs.)
+              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 pass-
+              ing arguments to programs.)
 
        $recorder [0]
               Whether  to  use the -recorder option to latex and pdflatex. Use
@@ -1951,78 +2477,122 @@
               tex.fls  to a file with the basename of the main LaTeX document,
               e.g., Document.fls.
 
+
+       $search_path_separator [See below for default]
+              The character separating paths in the environment variables TEX-
+              INPUTS,  BIBINPUTS, and BSTINPUTS.  This variable is mainly used
+              by latexmk when the -outdir, -output-directory, -auxdir,  and/or
+              -aux-directory  options are used.  In that case latexmk needs to
+              communicate appropriately  modified  search  paths  to  $bibtex,
+              dvipdf, dvips, and (pdf)latex.
+
+              [Comment  to technically savvy readers: (pdf)latex doesn't actu-
+              ally need the modified  search  path,  because  it  corrects  it
+              internally.   But,  surprisingly,  dvipdf  and dvips do, because
+              sometimes graphics files get generated  in  the  output  or  aux
+              directories.]
+
+              The  default  under  MSWin and Cygwin is ';' and under UNIX-like
+              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
+
+
+
+                               11 November 2012                             38
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
+              the MSWin, Linux, OS-X, Unix collection.)
+
+
        $sleep_time [2]
-              The time to sleep (in seconds) between checking for source  file
+              The  time to sleep (in seconds) between checking for source file
               changes when running with the -pvc option.  This is subject to a
-              minimum of one second delay, except  that  zero  delay  is  also
+              minimum  of  one  second  delay,  except that zero delay is also
               allowed.
 
-              A  value  of  exactly 0 gives no delay, and typically results in
+              A value of exactly 0 gives no delay, and  typically  results  in
               100% CPU usage, which may not be desirable.
 
        $texfile_search [""]
-              This is an obsolete variable,  replaced  by  the  @default_files
+              This  is  an  obsolete  variable, replaced by the @default_files
               variable.
 
-              For   backward   compatibility,  if  you  choose  to  set  $tex-
-              file_search, it is a string of  space-separated  filenames,  and
+              For  backward  compatibility,  if  you  choose  to   set   $tex-
+              file_search,  it  is  a string of space-separated filenames, and
               then latexmk replaces @default_files with the filenames in $tex-
               file_search to which is added "*.tex".
 
+
+       $success_cmd [undefined]
+              See the documentation for $compiling_cmd.
+
+
        $tmpdir [See below for default]
-              Directory to store temporary files  that  latexmk  may  generate
+              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
+              system  environment  variable  TMPDIR  if  it  exists, otherwise
+              "/tmp".
 
+       $use_make_for_missing_files [0]
+              Whether to use make to try and make files that are missing after
+              a  run  of  latex or pdflatex, and for which a custom dependency
+              has not been found.  This is generally useful only when  latexmk
+              is  used as part of a bigger project which is built by using the
+              make program.
 
-                                  7 May 2011                                30
+              Note that once a missing file has been made, no further calls to
+              make  will  be made on a subsequent run of latexmk to update the
+              file.  Handling this problem is the job of  a  suitably  defined
+              Makefile.   See the section "USING latexmk WITH make" for how to
+              do this.  The intent of calling make from latexmk is  merely  to
+              detect dependencies.
 
+       $view ["default"]
+              Which  kind  of  file is to be previewed if a previewer is used.
 
 
 
+                               11 November 2012                             39
 
-LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-              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".
 
-       $use_make_for_missing_files [0]
-              Whether to use make to try and make files that are missing after
-              a run of latex or pdflatex, and for which  a  custom  dependency
-              has  not been found.  This is generally useful only when latexmk
-              is used as part of a bigger project which is built by using  the
-              make program.
 
-              Note that once a missing file has been made, no further calls to
-              make will be made on a subsequent run of latexmk to  update  the
-              file.   Handling  this  problem is the job of a suitably defined
-              Makefile.  See the section "USING latexmk WITH make" for how  to
-              do  this.   The intent of calling make from latexmk is merely to
-              detect dependencies.
+LATEXMK(1L)                                                        LATEXMK(1L)
 
-       $view ["default"]
-              Which kind of file is to be previewed if a  previewer  is  used.
-              The  possible  values  are  "default",  "dvi", "ps", "pdf".  The
+
+              The possible values are  "default",  "dvi",  "ps",  "pdf".   The
               value of "default" means that the "highest" of the kinds of file
               generated is to be used (among dvi, ps and pdf).
 
 
 CUSTOM DEPENDENCIES
-       In  any RC file a set of custom dependencies can be set up to convert a
+       In any RC file a set of custom dependencies can be set up to convert  a
        file with one extension to a file with another.  An example use of this
        would be to allow latexmk to convert a .fig file to .eps to be included
        in the .tex file.
 
-       The old method of configuring latexmk was to  directly  manipulate  the
-       @cus_dep_list  array  that  contains  information  defining  the custom
-       dependencies.  This method still works.  But now there are  subroutines
-       that  allow  convenient  manipulations  of  the custom dependency list.
+       The  old  method  of configuring latexmk was to directly manipulate the
+       @cus_dep_list array  that  contains  information  defining  the  custom
+       dependencies.   This method still works.  But now there are subroutines
+       that allow convenient manipulations  of  the  custom  dependency  list.
        These are
 
            add_cus_dep( fromextension, toextension, must, subroutine )
@@ -2033,264 +2603,265 @@
        follow:
 
        from extension:
-              The  extension  of the file we are converting from (e.g. "fig").
+              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
-
-
-
-                                  7 May 2011                                31
-
-
-
-
-
-LATEXMK(1L)                                                        LATEXMK(1L)
-
-
               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
+       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:
-              The name of the subroutine that latexmk should call  to  perform
-              the  file  conversion.   The first argument to the subroutine is
+              The  name  of the subroutine that latexmk should call to perform
+              the file conversion.  The first argument to  the  subroutine  is
               the base name of the file to be converted without any extension.
-              The  subroutines  are declared in the syntax of Perl.  The func-
-              tion should return 0 if it was successful and a  nonzero  number
+              The subroutines are declared in the syntax of Perl.   The  func-
+              tion  should  return 0 if it was successful and a nonzero number
               if it failed.
 
-       It  is  invoked  whenever  latexmk detects that a run of latex/pdflatex
-       needs to read a file, like a graphics file, whose extension is the  to-
+       It is invoked whenever latexmk detects that  a  run  of  latex/pdflatex
+       needs  to read a file, like a graphics file, whose extension is the to-
        extension of a custom dependency.  Then latexmk examines whether a file
-       exists with the same name, but with the  corresponding  from-extension,
-       as  specified in the custom-dependency rule.  If it does, then whenever
-       the destination file (the one with  the  to-extension)  is  out-of-date
+       exists  with  the same name, but with the corresponding from-extension,
+       as specified in the custom-dependency rule.  If it does, then  whenever
+       the  destination  file  (the  one with the to-extension) is out-of-date
        with respect to the corresponding source file.
 
-       To  make the new destination file, the Perl subroutine specified in the
-       rule is invoked, with an argument that is the base name of the files in
-       question.   Simple cases just involve a subroutine invoking an external
-       program; this can be done by following the  templates  below,  even  by
-       those  without  knowledge of the Perl programming language.  Of course,
-       experts could do something much more elaborate.
+       To make the new destination file, the Perl subroutine specified in  the
 
-       One other item in each custom-dependency  rule  labelled  "must"  above
-       specifies  how the rule should be applied when the source file fails to
-       exist.
 
-       A simple and typical example of code in an initialization rcfile is
 
-           add_cus_dep( 'fig', 'eps', 0, 'fig2eps' );
-           sub fig2eps {
-               system("fig2dev -Leps $_[0].fig $_[0].eps");
-           }
+                               11 November 2012                             40
 
-       The first line adds a custom  dependency  that  converts  a  file  with
-       extension  "fig",  as  created  by the xfig program, to an encapsulated
-       postscript file, with extension "eps".  The remaining  lines  define  a
-       subroutine  that  carries out the conversion.  If a rule for converting
-       "fig" to "eps" files already exists (e.g., from  a  previously  read-in
-       initialization  file),  the latexmk will delete this rule before making
-       the new one.
 
-       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
 
 
 
-                                  7 May 2011                                32
+LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+       rule is invoked, with an argument that is the base name of the files in
+       question.  Simple cases just involve a subroutine invoking an  external
+       program;  this  can  be  done by following the templates below, even by
+       those without knowledge of the Perl programming language.   Of  course,
+       experts could do something much more elaborate.
 
+       One  other  item  in  each custom-dependency rule labelled "must" above
+       specifies how the rule should be applied when the source file fails  to
+       exist.
 
+       A simple and typical example of code in an initialization rcfile is
 
-LATEXMK(1L)                                                        LATEXMK(1L)
+           add_cus_dep( 'fig', 'eps', 0, 'fig2eps' );
+           sub fig2eps {
+               system( "fig2dev -Leps
+           }
 
+       The  first  line  adds  a  custom  dependency that converts a file with
+       extension "fig", as created by the xfig  program,  to  an  encapsulated
+       postscript  file,  with  extension "eps".  The remaining lines define a
+       subroutine that carries out the conversion.  If a rule  for  converting
+       "fig"  to  "eps"  files already exists (e.g., from a previously read-in
+       initialization file), the latexmk will delete this rule  before  making
+       the new one.
 
+       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-
+       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
-       return  value  is  the value returned by the last (and only) statement,
+       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
+       return value is the value returned by the last  (and  only)  statement,
        i.e., the invocation of system, which returns the value 0 on success.
 
-       If you use filenames with spaces in them, and if your LaTeX system  and
-       all  other  relevant software correctly handle such filenames, then you
-       could put single quotes around filenames in the command  line  that  is
-       executed:
-
-           add_cus_dep( 'fig', 'eps', 0, 'fig2eps' );
-           sub fig2eps {
-               system("fig2dev -Lps '$_[0].fig' '$_[0].eps'");
-           }
-
-       This  causes the invocation of the fig2dev program to have quoted file-
-       names; it should therefore work with filenames containing spaces.  How-
-       ever, not all software deals correctly with filenames that contain spa-
-       ces.  Moreover, the rules, if any, for quoting filenames  vary  between
-       operating systems, command shells and individual pieces of software, so
-       this code may not always work.
-
-       If you use pdflatex instead of latex, then you will probably prefer  to
-       convert  your  graphics  files  to  pdf format, in which case you would
+       If  you use pdflatex instead of latex, then you will probably prefer to
+       convert your graphics files to pdf format,  in  which  case  you  would
        replace the above code in an initialization file by
 
            add_cus_dep( 'fig', 'pdf, 0, 'fig2pdf' );
            sub fig2pdf {
-               system("fig2dev -Lpdf $_[0].fig $_[0].pdf");
+               system( "fig2dev -Lpdf
            }
 
-       If you have some general custom dependencies defined in the  system  or
-       user  initialization  file,  you may find that for a particular project
-       they are undesirable.  So you might want to delete the  unneeded  ones.
-       For example, you remove any "fig" to "eps" rule by the line
+       Note  1: In the command lines given in the system commands in the above
+       examples, double quotes  have  been  inserted  around  the  file  names
+       (implemented  by  '  of the program against special characters in file-
+       names.  Very often these quotes are not necessary, i.e.,  they  can  be
 
-           remove_cus_dep( 'fig', 'eps' );
 
-       If  you  have  complicated sets of custom dependencies, you may want to
-       get a listing of the custom dependencies.  This is done  by  using  the
-       line
 
-           show_cus_dep();
+                               11 November 2012                             41
 
-       in an initialization file.
 
-       Another  example  of  a  custom  dependency  overcomes  a limitation of
-       latexmk concerning index files.  The only index-file conversion  built-
 
 
 
-                                  7 May 2011                                33
+LATEXMK(1L)                                                        LATEXMK(1L)
 
 
+       omitted.   But  it  is normally safer to keep them in.  Even though the
+       rules for quoting vary between operating systems,  command  shells  and
+       individual  pieces of software, the quotes in the above examples do not
+       cause problems in the cases I have tested.
 
+       Note 2: One case in which the quotes are important is  when  the  files
+       are  in  a subdirectory and your operating system is Microsoft Windows.
+       Then the separator character for directory components can be  either  a
+       forward  slash '/' or Microsoft's more usual backward slash sanity from
+       software like MiKTeX that mixes both directory  separators;  but  their
+       correct use normally requires quoted filenames.  (See a log file from a
+       run of MiKTeX (at least in v. 2.9) for an example of the  use  of  both
+       directory separators.)
 
+       If  you  have some general custom dependencies defined in the system or
+       user initialization file, you may find that for  a  particular  project
+       they  are  undesirable.  So you might want to delete the unneeded ones.
+       For example, you remove any "fig" to "eps" rule by the line
 
-LATEXMK(1L)                                                        LATEXMK(1L)
+           remove_cus_dep( 'fig', 'eps' );
 
+       If you have complicated sets of custom dependencies, you  may  want  to
+       get  a  listing  of the custom dependencies.  This is done by using the
+       line
+
+           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
+       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
-       example  if  your  latex  file   uses   the   command   "\newindex{spe-
+       example   if   your   latex   file  uses  the  command  "\newindex{spe-
        cial}{ndx}{nnd}{Special index}" you will need to convert files with the
-       extension .ndx to .nnd.  The following lines in  an  initialization  RC
+       extension  .ndx  to  .nnd.  The following lines in an initialization RC
        file will cause this to happen:
 
            add_cus_dep('ndx', 'nnd', 0, 'makendx2nnd');
            sub makendx2nnd {
-               system("makeindex -o $_[0].nnd $_[0].ndx");
+               system( "makeindex -o
            }
 
-       (You  will need to modify this code if you use filenames with spaces in
+       (You will need to modify this code if you use filenames with spaces  in
        them, to provide correct quoting of the filenames.)
 
-       Those of you with experience with Makefiles, will undoubtedly  be  con-
+       Those  of  you with experience with Makefiles, will undoubtedly be con-
        cerned that the .ndx file is written during a run of latex/pdflatex and
-       is always later than the .nnd last read in.  Thus the .nnd  appears  to
-       be  perpetually out-of-date.  This situation, of circular dependencies,
+       is  always  later than the .nnd last read in.  Thus the .nnd appears to
+       be perpetually out-of-date.  This situation, of circular  dependencies,
        is endemic to latex, and latexmk in its current version works correctly
-       with  circular dependencies.  It examines the contents of the files (by
-       use of an md5 checksum), and only does a remake when the file  contents
+
+
+
+                               11 November 2012                             42
+
+
+
+
+
+LATEXMK(1L)                                                        LATEXMK(1L)
+
+
+       with circular dependencies.  It examines the contents of the files  (by
+       use  of an md5 checksum), and only does a remake when the file contents
        have actually changed.
 
-       Of  course  if you choose to write random data to the .nnd (or and .aux
-       file, etc) that changes on each new run, then you will have a  problem.
-       For  real experts: See the %hash_cal_ignore_pattern if you have to deal
+       Of course if you choose to write random data to the .nnd (or  and  .aux
+       file,  etc) that changes on each new run, then you will have a problem.
+       For real experts: See the %hash_cal_ignore_pattern if you have to  deal
        with such problems.
 
        Glossaries can be dealt with similarly.
 
 
 OLD METHOD OF DEFINING CUSTOM DEPENDENCIES
-       In previous versions of latexmk, the only  method  of  defining  custom
-       dependencies  was  to directly manipulate the table of custom dependen-
+       In  previous  versions  of  latexmk, the only method of defining custom
+       dependencies was to directly manipulate the table of  custom  dependen-
        cies.  This is contained in the @cus_dep_list array.  It is an array of
-       strings,  and each string in the array has four items in it, each sepa-
-       rated by a space, the  from-extension,  the  to-extension,  the  "must"
-       item,  and the name of the subroutine for the custom dependency.  These
+       strings, and each string in the array has four items in it, each  sepa-
+       rated  by  a  space,  the  from-extension, the to-extension, the "must"
+       item, and the name of the subroutine for the custom dependency.   These
        were all defined above.
 
        An example of the old method of defining custom dependencies is as fol-
-       lows.  It  is  the code in an RC file to ensure automatic conversion of
+       lows. It is the code in an RC file to ensure  automatic  conversion  of
        .fig files to .eps files:
 
            push @cus_dep_list, "fig eps 0 fig2eps";
            sub fig2eps {
-               system("fig2dev -Lps $_[0].fig $_[0].eps");
+               system( "fig2dev -Lps
            }
 
-       This method still works, and is equivalent to the  earlier  code  using
+       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.
 
 
 
-                                  7 May 2011                                34
 
+USING latexmk WITH make
+       This section is targeted only at advanced users who use the  make  pro-
+       gram for complex projects, as for software development, with the depen-
+       dencies specified by a Makefile.
 
+       Now the basic task of latexmk is to run  the  appropriate  programs  to
+       make  a  viewable version of a LaTeX document.  However, the usual make
+       program is not suited to this purpose for at least two reasons.   First
+       is that the use of LaTeX involves circular dependencies (e.g., via .aux
+       files), and these cannot be handled by the standard make program.  Sec-
+       ond  is  that  in  a  large document the set of source files can change
+       quite frequently, particularly with included graphics  files;  in  this
+       situation  keeping  a  Makefile  manually  updated is inappropriate and
+       error-prone, especially when the depedencies can be determined automat-
+       ically.  Latexmk solves both of these problems robustly.
 
 
 
-LATEXMK(1L)                                                        LATEXMK(1L)
 
+                               11 November 2012                             43
 
-       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.
 
 
 
 
-USING latexmk WITH make
-       This  section  is targeted only at advanced users who use the make pro-
-       gram for complex projects, as for software development, with the depen-
-       dencies specified by a Makefile.
+LATEXMK(1L)                                                        LATEXMK(1L)
 
-       Now  the  basic  task  of latexmk is to run the appropriate programs to
-       make a viewable version of a LaTeX document.  However, the  usual  make
-       program  is not suited to this purpose for at least two reasons.  First
-       is that the use of LaTeX involves circular dependencies (e.g., via .aux
-       files), and these cannot be handled by the standard make program.  Sec-
-       ond is that in a large document the set  of  source  files  can  change
-       quite  frequently,  particularly  with included graphics files; in this
-       situation keeping a Makefile  manually  updated  is  inappropriate  and
-       error-prone, especially when the depedencies can be determined automat-
-       ically.  Latexmk solves both of these problems robustly.
 
-       Thus for many standard LaTeX documents latexmk can be  used  by  itself
-       without  the  make program.  In a complex project it simply needs to be
-       suitably configured.  A standard configuration would be to define  cus-
-       tom  dependencies to make graphics files from their source files (e.g.,
-       as created by the xfig program).   Custom  dependencies  are  latexmk's
+       Thus  for  many  standard LaTeX documents latexmk can be used by itself
+       without the make program.  In a complex project it simply needs  to  be
+       suitably  configured.  A standard configuration would be to define cus-
+       tom dependencies to make graphics files from their source files  (e.g.,
+       as  created  by  the  xfig program).  Custom dependencies are latexmk's
        equivalent of pattern rules in Makefiles.
 
-       Nevertheless  there  are  projects for which a Makefile is appropriate,
+       Nevertheless there are projects for which a  Makefile  is  appropriate,
        and it is useful to know how to use latexmk from a Makefile.  A typical
-       example  would  be  to  generate  documentation for a software project.
-       Potentially the interaction with the rest of the rules in the  Makefile
+       example would be to generate  documentation  for  a  software  project.
+       Potentially  the interaction with the rest of the rules in the Makefile
        could be quite complicated, for example if some of the source files for
        a LaTeX document are generated by the project's software.
 
        In this section, I give a couple of examples of how latexmk can be use-
-       fully  invoked  from a Makefile.  The examples use specific features of
-       current versions of GNU make, which is the default on  both  linux  and
-       OS-X  systems.  They may need modifications for other versions of make.
+       fully invoked from a Makefile.  The examples use specific  features  of
+       current  versions  of  GNU make, which is the default on both linux and
+       OS-X systems.  They may need modifications for other versions of  make.
 
-       The simplest method is simply to delegate all  the  relevant  tasks  to
+       The  simplest  method  is  simply to delegate all the relevant tasks to
        latexmk, as is suitable for a straightforward LaTeX document.  For this
        a suitable Makefile is like
 
@@ -2299,45 +2870,45 @@
            %.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
+       (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.
 
+       The above example has a pattern rule for making a .pdf file from a .tex
+       file, and it is defined to use latexmk in the obvious way.  There is  a
+       conventional  default  target  named  "all",  with  a  prerequisite  of
+       try.pdf.  So when make is invoked, by default it  makes  try.pdf.   The
+       only  complication  is  that  there  may  be  many  source files beyond
+       try.tex, but these aren't specified in the Makefile, so changes in them
+       will  not by themselves cause latexmk to be invoked.  Instead, the pat-
+       tern rule is equipped with a "phony" prerequisite FORCE_MAKE; this  has
+       the  effect  of  causing  the  rule  to  be always out-of-date, so that
+       latexmk is always run.  It is latexmk that decides whether  any  action
+       is  needed,  e.g., a rerun of pdflatex.  Effectively the Makefile dele-
+       gates all decisions to latexmk, while make has no knowledge of the list
+       of  source  files  except for primary LaTeX file for the  document.  If
+       there are, for example, graphics files to be made, these must  be  made
+       by custom dependencies configured in latexmk.
 
+       But  something  better  is  needed  in more complicated situations, for
+       example, when the making of graphics files needs  to  be  specified  by
 
-                                  7 May 2011                                35
 
 
+                               11 November 2012                             44
 
 
 
-LATEXMK(1L)                                                        LATEXMK(1L)
 
 
-       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.
+LATEXMK(1L)                                                        LATEXMK(1L)
 
-       The above example has a pattern rule for making a .pdf file from a .tex
-       file,  and it is defined to use latexmk in the obvious way.  There is a
-       conventional  default  target  named  "all",  with  a  prerequisite  of
-       try.pdf.   So  when  make is invoked, by default it makes try.pdf.  The
-       only complication is  that  there  may  be  many  source  files  beyond
-       try.tex, but these aren't specified in the Makefile, so changes in them
-       will not by themselves cause latexmk to be invoked.  Instead, the  pat-
-       tern  rule is equipped with a "phony" prerequisite FORCE_MAKE; this has
-       the effect of causing the  rule  to  be  always  out-of-date,  so  that
-       latexmk  is  always run.  It is latexmk that decides whether any action
-       is needed, e.g., a rerun of pdflatex.  Effectively the  Makefile  dele-
-       gates all decisions to latexmk, while make has no knowledge of the list
-       of source files except for primary LaTeX file for  the   document.   If
-       there  are,  for example, graphics files to be made, these must be made
-       by custom dependencies configured in latexmk.
 
-       But something better is needed  in  more  complicated  situations,  for
-       example,  when  the  making  of graphics files needs to be specified by
-       rules in the Makefile.  To do this, one can use  a  Makefile  like  the
+       rules  in  the  Makefile.   To do this, one can use a Makefile like the
        following:
 
             TARGETS = document1.pdf document2.pdf
@@ -2356,50 +2927,51 @@
             %.pdf : %.fig
                    fig2dev -Lpdf $< $@
 
-       (Again,  the  lines  containing  the  commands  for the rules should be
+       (Again, the lines containing the  commands  for  the  rules  should  be
        started with tabs.)  This example was inspired by how GNU automake han-
        dles automatic dependency tracking of C source files.
 
-       After  each  run of latexmk, dependency information is put in a file in
-       the .deps subdirectory.  The Makefile causes these dependency files  to
+       After each run of latexmk, dependency information is put in a  file  in
+       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-
+       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
+       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
+       pdflatex;  such  files  should  not  be in the dependency list.  The -e
+       options are used to turn off all custom dependencies, and  to  document
+       this.   Instead the -use-make is used to delegate the making of missing
+       files to make itself.
 
+       Suppose in the LaTeX file there is a  command  \includegraphics{graph},
+       and  an xfig file "graph.fig" exists.  On a first run, pdflatex reports
+       a missing file, named "graph". Latexmk succeeds in  making  "graph.pdf"
+       by calling "make graph.pdf", and after completion of its work, it lists
+       "fig.pdf" among the dependents of the file latexmk is making.  Then let
+       "fig.fig"  be  updated,  and  then let make be run.  Make first remakes
+       "fig.pdf", and only then reruns latexmk.
 
+       Thus we now have a method by which all  the  subsidiary  processing  is
+       delegated to make.
 
-                                  7 May 2011                                36
 
 
 
 
 
-LATEXMK(1L)                                                        LATEXMK(1L)
+                               11 November 2012                             45
 
 
-       .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
-       pdflatex; such files should not be in  the  dependency  list.   The  -e
-       options  are  used to turn off all custom dependencies, and to document
-       this.  Instead the -use-make is used to delegate the making of  missing
-       files to make itself.
 
-       Suppose  in  the LaTeX file there is a command \includegraphics{graph},
-       and an xfig file "graph.fig" exists.  On a first run, pdflatex  reports
-       a  missing  file, named "graph". Latexmk succeeds in making "graph.pdf"
-       by calling "make graph.pdf", and after completion of its work, it lists
-       "fig.pdf" among the dependents of the file latexmk is making.  Then let
-       "fig.fig" be updated, and then let make be  run.   Make  first  remakes
-       "fig.pdf", and only then reruns latexmk.
 
-       Thus  we  now  have  a method by which all the subsidiary processing is
-       delegated to make.
+
+LATEXMK(1L)                                                        LATEXMK(1L)
 
 
 SEE ALSO
@@ -2407,47 +2979,35 @@
 
 BUGS
        Sometimes a viewer (gv) tries to read an updated .ps or .pdf file after
-       its  creation is started but before the file is complete.  Work around:
+       its creation is started but before the file is complete.  Work  around:
        manually refresh (or reopen) display.  Or use one of the other preview-
        ers and update methods.
 
-       (The  following  isn't  really a bug, but concerns features of preview-
-       ers.)  Preview continuous mode only works perfectly with  certain  pre-
-       viewers:  Xdvi  on  UNIX/LINUX  works  for dvi files.  Gv on UNIX/LINUX
-       works for both postscript and pdf.  Ghostview  on  UNIX/LINUX  needs  a
-       manual  update (reopen); it views postscript and pdf.  Gsview under MS-
-       Windows works for both postscript and pdf, but only reads  the  updated
-       file  when  its  screen  is refreshed.  Acroread under UNIX/LINUX views
-       pdf, but the file needs to be closed and reopened to  view  an  updated
-       version.   Under  MS-Windows,  acroread locks its input file and so the
-       pdf file cannot be updated.  (Remedy: configure latexmk to  use  gsview
-       instead.)
+       (The following isn't really a bug, but concerns  features  of  preview-
+       ers.)   Preview  continuous mode only works perfectly with certain pre-
+       viewers: Xdvi on UNIX/LINUX works for  dvi  files.   Gv  on  UNIX/LINUX
+       works  for  both  postscript  and pdf.  Ghostview on UNIX/LINUX needs a
+       manual update (reopen); it views postscript and pdf.  Gsview under  MS-
+       Windows  works  for both postscript and pdf, but only reads the updated
+       file when its screen is refreshed.   Acroread  under  UNIX/LINUX  views
+       pdf,  but  the  file needs to be closed and reopened to view an updated
+       version.  Under MS-Windows, acroread locks its input file  and  so  the
+       pdf  file  cannot  be updated.  (Remedy: configure latexmk to use suma-
+       trapdf instead.)
 
 THANKS TO
-       Authors  of  previous  versions.   Many  users with their feedback, and
-       especially David Coppit (username david at node  coppit.org)  who  made
-       many  useful  suggestions  that  contributed  to version 3, and Herbert
-       Schulz.  (Please note that the e-mail  addresses  are  not  written  in
+       Authors of previous versions.  Many  users  with  their  feedback,  and
+       especially  David  Coppit  (username david at node coppit.org) who made
+       many useful suggestions that contributed  to  version  3,  and  Herbert
+       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  collins  at  node
-       phys.psu.edu).  (Version 4.24).
-
-
-
-
-                                  7 May 2011                                37
-
-
-
-
-
-LATEXMK(1L)                                                        LATEXMK(1L)
-
+       Current  version,  by  John   Collins   (username   collins   at   node
+       phys.psu.edu).  (Version 4.35).
 
        Released version can be obtained from CTAN: <http://www.tug.org/tex-ar-
-       chive/support/latexmk/>,     and     from    the    author's    website
+       chive/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)
@@ -2471,38 +3031,6 @@
 
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-                                  7 May 2011                                38
+                               11 November 2012                             46