mktex doc updates

git-svn-id: svn://tug.org/texlive/trunk@6608 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 266 insertions, 219 deletions

diff --git a/Build/source/texk/kpathsea/ChangeLog b/Build/source/texk/kpathsea/ChangeLog
index 8527c2dde98..84cc1e98341 100644
--- a/Build/source/texk/kpathsea/ChangeLog
+++ b/Build/source/texk/kpathsea/ChangeLog
@@ -1,3 +1,8 @@
+2008-02-11  Karl Berry  <karl@tug.org>
+
+	* install.texi: mention mktexfmt, other mktex updates.
+	(Bug report from Ken Brooks, 03 Aug 2006 15:15:03.)
+
 2008-02-08  Karl Berry  <karl@tug.org>
 
 	* texmf.in: texlive2008 to match texmf/web2c/texmf.cnf.
diff --git a/Build/source/texk/kpathsea/install.texi b/Build/source/texk/kpathsea/install.texi
index fee0dfdbec9..67e82a8acd1 100644
--- a/Build/source/texk/kpathsea/install.texi
+++ b/Build/source/texk/kpathsea/install.texi
@@ -858,11 +858,20 @@ fresh version every so often.
 @cindex EC fonts, and dynamic source creation
 If Kpathsea cannot otherwise find a file, for some file types it is
 configured by default to invoke an external program to create it
-dynamically (@pxref{mktex configuration}).  This is most useful for
-fonts (bitmaps, TFM's, and arbitrarily-sizable Metafont sources such as
-the Sauter and EC fonts), since any given document can use fonts never
-before referenced.  Trying to build all fonts in advance is therefore
-impractical, if not impossible.
+dynamically (@pxref{mktex configuration}).  These are collectively
+known as @dfn{@code{mktex} scripts}, since most of them are named
+@code{mktex...}.
+
+For example, this is useful for fonts (bitmaps, TFM's, and
+arbitrarily-sizable Metafont sources such as the Sauter and EC fonts),
+since any given document can use fonts never before referenced.
+Building all fonts in advance is therefore impractical, if not
+impossible.
+
+It is also useful for the @TeX{} @samp{.fmt} (and Metafont
+@samp{.base} and Metapost @samp{.mem} files, @pxref{Memory
+dumps,,,Web2c,web2c}), where pre-generating every format consumes a
+lot of both time and space.
 
 The script is passed the name of the file to create and possibly other
 arguments, as explained below.  It must echo the full pathname of the
@@ -870,9 +879,9 @@ file it created (and nothing else) to standard output; it can write
 diagnostics to standard error.
 
 @menu
-* mktex configuration::
-* mktex script names::
-* mktex script arguments::
+* config: mktex configuration.
+* names: mktex script names.
+* args: mktex script arguments.
 @end menu
 
 
@@ -884,22 +893,25 @@ diagnostics to standard error.
 @cindex enabling @file{mktex} scripts
 @cindex disabling @file{mktex} scripts
 
-The following file types can run an external program to create missing
-files: @file{pk}, @file{tfm}, @file{mf}, @file{tex}; the scripts are
-named @file{mktexpk}, @file{mktextfm}, @file{mktexmf}, and
-@file{mktextex}.
-
-In the absence of @code{configure} options specifying otherwise,
-everything but @file{mktextex} will be enabled by default. The
-@code{configure} options to change the defaults are:
+The list of file types and program names that can run an external
+program to create missing files is listed in the next section.  In the
+absence of @code{configure} options specifying otherwise, everything
+but @file{mktextex} will be enabled by default.  The @code{configure}
+options to change the defaults are:
 
 @cindex @code{configure} options for @file{mktex} scripts
+@opindex --without-mktexfmt-default
 @opindex --without-mktexmf-default
+@opindex --without-mktexocp-default
+@opindex --without-mktexofm-default
 @opindex --without-mktexpk-default
 @opindex --without-mktextfm-default
 @opindex --with-mktextex-default
 @example
+--without-mktexfmt-default
 --without-mktexmf-default
+--without-mktexocp-default
+--without-mktexofm-default
 --without-mktexpk-default
 --without-mktextfm-default
 --with-mktextex-default
@@ -909,23 +921,32 @@ The @code{configure} setting is overridden if the environment variable
 or configuration file value named for the script is set; e.g.,
 @file{MKTEXPK} (@pxref{mktex script arguments}).
 
+@flindex fmtutils.cnf
+@code{mktexfmt} reads a file @file{fmtutil.cnf}, typically located in
+@file{texmf/web2c/} to glean its configuration information.  The rest
+of the files and features in this section are primarily intended for
+the font generation scripts.
+
 @flindex mktex.cnf
+@flindex mktex.opt
 @cindex site overrides for @code{mktex@dots{}}
 As distributed, all the scripts source a file
-@file{texmf/web2c/mktex.cnf} if it exists, so you can override
-various defaults.  See @file{mktex.opt}, for instance, which defines
-the default mode, resolution, some special directory names, etc.  If you
-prefer not to change the distributed scripts, you can simply create
-@file{mktex.cnf} with the appropriate definitions (you do not need to
-create it if you have nothing to put in it).  @file{mktex.cnf} has no
-special syntax; it's an arbitrary Bourne shell script.  The distribution
-contains a sample @file{mktex.cnf} for you to copy and modify as you
-please (it is not installed anywhere).
+@file{texmf/web2c/mktex.cnf} if it exists, so you can override various
+defaults.  
+See @file{mktex.opt}, for instance, which defines the default mode,
+resolution, some special directory names, etc.  If you prefer not to
+change the distributed scripts, you can simply create @file{mktex.cnf}
+with the appropriate definitions (you do not need to create it if you
+have nothing to put in it).  @file{mktex.cnf} has no special syntax;
+it's an arbitrary Bourne shell script.  The distribution contains a
+sample @file{mktex.cnf} for you to copy and modify as you please (it
+is not installed anywhere).
 
 @flindex mktex.opt
 @vindex MT_FEATURES
 In addition, you can configure a number of features with the
 @code{MT_FEATURES} variable, which you can define:
+
 @itemize @bullet
 @item
 in @file{mktex.opt}, as just mentioned;
@@ -1051,34 +1072,46 @@ feature is enabled, and if set to @samp{0}, the feature is disabled.
 @cindex @file{mktex} script names
 @cindex names for @file{mktex} scripts
 
-@flindex tex-make.c
-@vindex kpse_make_specs
 The following table shows the default name of the script for each
-possible file types.  (The source is the variable @code{kpse_make_specs}
-in @file{kpathsea/tex-make.c}.)
+of the file types which support runtime generation.
 
 @table @file
+@item mktexfmt
+@pindex mktexfmt
+@pindex fmtutil
+(@samp{.fmt}, @samp{.base}, @samp{.mem}) @TeX{}/Metafont/MetaPost
+formats.  This script is also named @command{fmtutil}, and reads
+@file{fmtutil.cnf} for configuration information.
+
+@item mktexmf
+@pindex mktexmf
+(@samp{.mf}) Metafont input files.
+
+@item mkocp
+@pindex mkocp
+(@samp{.ocp}) Omega compiled process files.
+
+@item mkofm
+@pindex mkofm
+(@samp{.ofm}) Omega font metric files.
+
 @item mktexpk
 @pindex mktexpk
-Glyph fonts.
+(@samp{pk}) Glyph fonts.
 
 @item mktextex
 @pindex mktextex
-@TeX{} input files.
-
-@item mktexmf
-@pindex mktexmf
-Metafont input files.
+(@samp{.tex}) @TeX{} input files (disabled by default).
 
 @item mktextfm
 @pindex mktextfm
-TFM files.
+(@samp{.tfm}) TFM files.
 @end table
 
 @vindex DVIPSMAKEPK
 @vindex XDVIMAKEPK
 @vindex DVILJMAKEPK
-@noindent These names are overridden by an environment variable specific
+@noindent These names can be overridden by an environment variable specific
 to the program---for example, @code{DVIPSMAKEPK} for Dvipsk.
 
 @comment next two paragraphs are repeated in dvips.texi
@@ -1126,29 +1159,6 @@ Otherwise, it is appended to the root destination directory set in the
 script.
 @end table
 
-@c  The feature mentioned here doesn't seem to be implemented.
-@c  Worse, the variable name clashed with the "switch" used to select
-@c  whether a mktex program is run at all.  However, a dearth of
-@c  complains suggests that no-one was using it anyway.
-@c
-@c @vindex MKTEXPK @r{environment variable}
-@c @cindex specification for @code{mktexpk}
-@c You can change the specification for the arguments passed to the
-@c external script by setting the environment variable named as the script
-@c name, but all capitals---@code{MKTEXPK}, for example.  If you've
-@c changed the script name by setting (say) @code{DVIPSMAKEPK} to
-@c @samp{foo}, then the spec is taken from the environment variable
-@c @code{FOO}.
-@c
-@c The spec can contain any variable references, to the above variables or
-@c any others.  As an example, the default spec for @code{mktexpk} is:
-@c @example
-@c $KPATHSEA_DPI $MAKETEX_BASE_DPI $MAKETEX_MAG $MAKETEX_MODE
-@c @end example
-@c
-@c @noindent The convention of passing the name of the file to be created
-@c as the first argument cannot be changed.
-
 
 @node Installation testing 
 @subsection Installation testing
diff --git a/Build/source/texk/kpathsea/kpathsea.info b/Build/source/texk/kpathsea/kpathsea.info
index dd2bd8e320a..25caed427a9 100644
--- a/Build/source/texk/kpathsea/kpathsea.info
+++ b/Build/source/texk/kpathsea/kpathsea.info
@@ -4,11 +4,12 @@ This is kpathsea.info, produced by makeinfo version 4.11 from kpathsea.texi.
 
 * Kpathsea: (kpathsea).                       File lookup along search paths.
 * kpsewhich: (kpathsea)Invoking kpsewhich.    TeX file searching.
+* mktexfmt: (kpathsea)mktex scripts.          Format (fmt/base/mem) generation.
+* mktexlsr: (kpathsea)Filename database.      Update ls-R.
 * mktexmf: (kpathsea)mktex scripts.           MF source generation.
 * mktexpk: (kpathsea)mktex scripts.           PK bitmap generation.
 * mktextex: (kpathsea)mktex scripts.          TeX source generation.
 * mktextfm: (kpathsea)mktex scripts.          TeX font metric generation.
-* mktexlsr: (kpathsea)Filename database.      Update ls-R.
 END-INFO-DIR-ENTRY
 
    This file documents the Kpathsea library for path searching.
@@ -38,7 +39,7 @@ Kpathsea library
 
 This manual documents how to install and use the Kpathsea library for
 filename lookup.  It corresponds to version 3.5.6dev, released in
-January 2008.
+February 2008.
 
 * Menu:
 
@@ -59,7 +60,7 @@ File: kpathsea.info,  Node: Introduction,  Next: Installation,  Prev: Top,  Up:
 **************
 
 This manual corresponds to version 3.5.6dev of the Kpathsea library,
-released in January 2008.
+released in February 2008.
 
    The library's fundamental purpose is to return a filename from a
 list of directories specified by the user, similar to what shells do
@@ -847,11 +848,18 @@ File: kpathsea.info,  Node: mktex scripts,  Next: Installation testing,  Prev: F
 
 If Kpathsea cannot otherwise find a file, for some file types it is
 configured by default to invoke an external program to create it
-dynamically (*note mktex configuration::).  This is most useful for
-fonts (bitmaps, TFM's, and arbitrarily-sizable Metafont sources such as
-the Sauter and EC fonts), since any given document can use fonts never
-before referenced.  Trying to build all fonts in advance is therefore
-impractical, if not impossible.
+dynamically (*note mktex configuration::).  These are collectively
+known as "`mktex' scripts", since most of them are named `mktex...'.
+
+   For example, this is useful for fonts (bitmaps, TFM's, and
+arbitrarily-sizable Metafont sources such as the Sauter and EC fonts),
+since any given document can use fonts never before referenced.
+Building all fonts in advance is therefore impractical, if not
+impossible.
+
+   It is also useful for the TeX `.fmt' (and Metafont `.base' and
+Metapost `.mem' files, *note Memory dumps: (Web2c)Memory dumps.), where
+pre-generating every format consumes a lot of both time and space.
 
    The script is passed the name of the file to create and possibly
 other arguments, as explained below.  It must echo the full pathname of
@@ -860,9 +868,9 @@ diagnostics to standard error.
 
 * Menu:
 
-* mktex configuration::
-* mktex script names::
-* mktex script arguments::
+* config: mktex configuration.
+* names: mktex script names.
+* args: mktex script arguments.
 
 
 File: kpathsea.info,  Node: mktex configuration,  Next: mktex script names,  Up: mktex scripts
@@ -870,15 +878,16 @@ File: kpathsea.info,  Node: mktex configuration,  Next: mktex script names,  Up:
 2.2.9.1 `mktex' configuration
 .............................
 
-The following file types can run an external program to create missing
-files: `pk', `tfm', `mf', `tex'; the scripts are named `mktexpk',
-`mktextfm', `mktexmf', and `mktextex'.
-
-   In the absence of `configure' options specifying otherwise,
-everything but `mktextex' will be enabled by default. The `configure'
-options to change the defaults are:
+The list of file types and program names that can run an external
+program to create missing files is listed in the next section.  In the
+absence of `configure' options specifying otherwise, everything but
+`mktextex' will be enabled by default.  The `configure' options to
+change the defaults are:
 
+     --without-mktexfmt-default
      --without-mktexmf-default
+     --without-mktexocp-default
+     --without-mktexofm-default
      --without-mktexpk-default
      --without-mktextfm-default
      --with-mktextex-default
@@ -887,6 +896,11 @@ options to change the defaults are:
 configuration file value named for the script is set; e.g., `MKTEXPK'
 (*note mktex script arguments::).
 
+   `mktexfmt' reads a file `fmtutil.cnf', typically located in
+`texmf/web2c/' to glean its configuration information.  The rest of the
+files and features in this section are primarily intended for the font
+generation scripts.
+
    As distributed, all the scripts source a file
 `texmf/web2c/mktex.cnf' if it exists, so you can override various
 defaults.  See `mktex.opt', for instance, which defines the default
@@ -900,6 +914,7 @@ installed anywhere).
 
    In addition, you can configure a number of features with the
 `MT_FEATURES' variable, which you can define:
+
    * in `mktex.opt', as just mentioned;
 
    * by editing the file `mktex.opt', either before `make install' (in
@@ -996,24 +1011,34 @@ File: kpathsea.info,  Node: mktex script names,  Next: mktex script arguments,
 2.2.9.2 `mktex' script names
 ............................
 
-The following table shows the default name of the script for each
-possible file types.  (The source is the variable `kpse_make_specs' in
-`kpathsea/tex-make.c'.)
+The following table shows the default name of the script for each of
+the file types which support runtime generation.
+
+`mktexfmt'
+     (`.fmt', `.base', `.mem') TeX/Metafont/MetaPost formats.  This
+     script is also named `fmtutil', and reads `fmtutil.cnf' for
+     configuration information.
+
+`mktexmf'
+     (`.mf') Metafont input files.
+
+`mkocp'
+     (`.ocp') Omega compiled process files.
+
+`mkofm'
+     (`.ofm') Omega font metric files.
 
 `mktexpk'
-     Glyph fonts.
+     (`pk') Glyph fonts.
 
 `mktextex'
-     TeX input files.
-
-`mktexmf'
-     Metafont input files.
+     (`.tex') TeX input files (disabled by default).
 
 `mktextfm'
-     TFM files.
+     (`.tfm') TFM files.
 
-These names are overridden by an environment variable specific to the
-program--for example, `DVIPSMAKEPK' for Dvipsk.
+These names can be overridden by an environment variable specific to
+the program--for example, `DVIPSMAKEPK' for Dvipsk.
 
    If a `mktex...' script fails, the invocation is appended to a file
 `missfont.log' (by default) in the current directory.  You can then
@@ -3601,10 +3626,13 @@ Index
 * --var-value=VARIABLE:                  Auxiliary tasks.     (line  12)
 * --version:                             Standard options.    (line  10)
 * --with options:                        configure options.   (line  16)
-* --with-mktextex-default:               mktex configuration. (line  14)
-* --without-mktexmf-default:             mktex configuration. (line  14)
-* --without-mktexpk-default:             mktex configuration. (line  14)
-* --without-mktextfm-default:            mktex configuration. (line  14)
+* --with-mktextex-default:               mktex configuration. (line  12)
+* --without-mktexfmt-default:            mktex configuration. (line  12)
+* --without-mktexmf-default:             mktex configuration. (line  12)
+* --without-mktexocp-default:            mktex configuration. (line  12)
+* --without-mktexofm-default:            mktex configuration. (line  12)
+* --without-mktexpk-default:             mktex configuration. (line  12)
+* --without-mktextfm-default:            mktex configuration. (line  12)
 * -1 debugging value:                    Debugging.           (line  23)
 * -A option to ls:                       ls-R.                (line  33)
 * -Bdynamic:                             ShellWidgetClass.    (line  45)
@@ -3706,10 +3734,10 @@ Index
 * /etc/profile:                          Unable to find files.
                                                               (line  14)
 * /etc/profile and aliases:              ls-R.                (line  21)
-* /var/tmp/texfonts:                     mktex configuration. (line 107)
+* /var/tmp/texfonts:                     mktex configuration. (line 114)
 * 2602gf:                                Unable to generate fonts.
                                                               (line  36)
-* 8.3 filenames, using:                  mktex configuration. (line  62)
+* 8.3 filenames, using:                  mktex configuration. (line  69)
 * : may not be ::                        Searching overview.  (line  13)
 * :: expansion:                          Default expansion.   (line   6)
 * @VAR@ substitutions:                   Running configure.   (line   6)
@@ -3741,7 +3769,7 @@ Index
 * ANSI C:                                TeX or Metafont failing.
                                                               (line  30)
 * append-only directories and mktexpk:   Security.            (line  36)
-* appendonlydir:                         mktex configuration. (line  54)
+* appendonlydir:                         mktex configuration. (line  61)
 * architecture-(in)dependent files, installing only: Installing files.
                                                               (line  21)
 * architectures, compiling multiple:     configure scenarios. (line  18)
@@ -3851,7 +3879,7 @@ Index
 * configuration of optional features:    configure options.   (line  16)
 * configure error from sed:              Empty Makefiles.     (line   6)
 * configure options:                     configure options.   (line   6)
-* configure options for mktex scripts:   mktex configuration. (line  14)
+* configure options for mktex scripts:   mktex configuration. (line  12)
 * configure, running:                    Running configure.   (line   6)
 * context diff:                          Bug checklist.       (line  56)
 * continuation character:                Config files.        (line  26)
@@ -3892,7 +3920,7 @@ Index
                                                               (line  29)
 * directories, changing default installation: Default path generation.
                                                               (line   6)
-* directories, making append-only:       mktex configuration. (line  55)
+* directories, making append-only:       mktex configuration. (line  62)
 * directory permissions:                 Security.            (line  51)
 * directory structure, for TeX files:    TeX directory structure.
                                                               (line   6)
@@ -3915,22 +3943,22 @@ Index
 * dlsym.c:                               dlopen.              (line  21)
 * doc files:                             Supported file formats.
                                                               (line 158)
-* DOS compatible names:                  mktex configuration. (line  62)
+* DOS compatible names:                  mktex configuration. (line  69)
 * DOS support:                           Custom installation. (line  19)
 * DOS TeX implementations:               Other TeX packages.  (line   6)
-* dosnames:                              mktex configuration. (line  61)
+* dosnames:                              mktex configuration. (line  68)
 * dot files:                             ls-R.                (line  33)
 * doubled colons:                        Default expansion.   (line   6)
-* dpiNNN directories:                    mktex configuration. (line  62)
+* dpiNNN directories:                    mktex configuration. (line  69)
 * DVI drivers:                           Kpathsea application distributions.
                                                               (line  12)
-* DVILJMAKEPK:                           mktex script names.  (line  22)
+* DVILJMAKEPK:                           mktex script names.  (line  32)
 * DVILJSIZES:                            Fallback font.       (line   6)
 * DVIPSFONTS:                            Supported file formats.
                                                               (line 227)
 * DVIPSHEADERS:                          Supported file formats.
                                                               (line 184)
-* DVIPSMAKEPK:                           mktex script names.  (line  22)
+* DVIPSMAKEPK:                           mktex script names.  (line  32)
 * DVIPSSIZES:                            Fallback font.       (line   6)
 * dynamic creation of files:             mktex scripts.       (line   6)
 * dynamic linking problems with OpenWin libraries: ShellWidgetClass.
@@ -3967,7 +3995,7 @@ Index
 * externally-built filename database:    Filename database.   (line   6)
 * extra colons:                          Default expansion.   (line   6)
 * extraclean Make target:                Cleaning up.         (line  23)
-* failed mktex... script invocation:     mktex script names.  (line  25)
+* failed mktex... script invocation:     mktex script names.  (line  35)
 * fallback font:                         Fallback font.       (line   6)
 * fallback resolutions:                  Fallback font.       (line   6)
 * fallback resolutions, overriding:      Running make.        (line  10)
@@ -3993,14 +4021,16 @@ Index
                                                               (line   6)
 * filesystem search:                     Searching overview.  (line  22)
 * floating directories:                  Searching overview.  (line  22)
+* fmtutil:                               mktex script names.  (line  10)
+* fmtutils.cnf:                          mktex configuration. (line  24)
 * font alias files:                      Fontmap.             (line   6)
 * font generation failures:              Unable to generate fonts.
                                                               (line   6)
 * font of last resort:                   Fallback font.       (line   6)
 * font set, infinite:                    mktex scripts.       (line   6)
 * fontmap files:                         Fontmap.             (line   6)
-* fontmaps:                              mktex configuration. (line  80)
-* fontname:                              mktex configuration. (line  81)
+* fontmaps:                              mktex configuration. (line  87)
+* fontname:                              mktex configuration. (line  88)
 * fontnames, arbitrary length:           Fontmap.             (line  15)
 * fonts, being created:                  Simple installation. (line  79)
 * FOOINPUTS:                             Supported file formats.
@@ -4115,7 +4145,6 @@ Index
 * kpse_init_prog:                        Calling sequence.    (line  51)
 * kpse_init_prog, and MAKETEX_MODE:      Default path features.
                                                               (line  25)
-* kpse_make_specs:                       mktex script names.  (line   6)
 * kpse_open_file:                        Calling sequence.    (line  74)
 * kpse_program_name:                     Calling sequence.    (line  16)
 * kpse_set_progname:                     Calling sequence.    (line  30)
@@ -4149,7 +4178,7 @@ Index
 * LIGFONTS:                              Supported file formats.
                                                               (line  71)
 * lines, reading arbitrary-length:       Calling sequence.    (line  83)
-* Linux File System Standard:            mktex configuration. (line 107)
+* Linux File System Standard:            mktex configuration. (line 114)
 * Linux shells and configure:            configure shells.    (line  19)
 * Linux, using Web2c:                    CD-ROM distribution. (line  16)
 * lndir for building symlink trees:      configure scenarios. (line  18)
@@ -4185,7 +4214,7 @@ Index
 * MAKETEX_MODE:                          Default path features.
                                                               (line  19)
 * memory allocation routines:            Calling sequence.    (line  83)
-* metafont driver files:                 mktex configuration. (line  87)
+* metafont driver files:                 mktex configuration. (line  94)
 * Metafont failures:                     TeX or Metafont failing.
                                                               (line   6)
 * Metafont installation:                 Unable to generate fonts.
@@ -4208,24 +4237,27 @@ Index
                                                               (line 100)
 * mismatched checksum warnings:          Suppressing warnings.
                                                               (line  17)
-* missfont.log:                          mktex script names.  (line  25)
-* MISSFONT_LOG:                          mktex script names.  (line  30)
+* missfont.log:                          mktex script names.  (line  35)
+* MISSFONT_LOG:                          mktex script names.  (line  40)
 * missing character warnings:            Suppressing warnings.
                                                               (line  20)
+* mkocp:                                 mktex script names.  (line  18)
+* mkofm:                                 mktex script names.  (line  21)
 * mktex script configuration:            mktex configuration. (line   6)
 * mktex script names:                    mktex script names.  (line   6)
 * mktex scripts:                         mktex scripts.       (line   6)
-* mktex.cnf:                             mktex configuration. (line  23)
-* mktex.opt:                             mktex configuration. (line  34)
-* mktexdir:                              mktex configuration. (line  55)
-* mktexmf:                               mktex script names.  (line  17)
-* mktexpk:                               mktex script names.  (line  11)
+* mktex.cnf:                             mktex configuration. (line  29)
+* mktex.opt:                             mktex configuration. (line  29)
+* mktexdir:                              mktex configuration. (line  62)
+* mktexfmt:                              mktex script names.  (line  10)
+* mktexmf:                               mktex script names.  (line  15)
+* mktexpk:                               mktex script names.  (line  24)
 * mktexpk , initial runs:                Simple installation. (line  79)
 * mktexpk can't guess mode:              Unable to generate fonts.
                                                               (line  12)
-* mktextex:                              mktex script names.  (line  14)
-* mktextfm:                              mktex script names.  (line  20)
-* mode directory, omitting:              mktex configuration. (line  92)
+* mktextex:                              mktex script names.  (line  27)
+* mktextfm:                              mktex script names.  (line  30)
+* mode directory, omitting:              mktex configuration. (line  99)
 * Morgan, Tim:                           History.             (line  12)
 * mostlyclean Make target:               Cleaning up.         (line  10)
 * MPINPUTS:                              Supported file formats.
@@ -4236,7 +4268,7 @@ Index
                                                               (line 108)
 * MPSUPPORT:                             Supported file formats.
                                                               (line  84)
-* MT_FEATURES:                           mktex configuration. (line  34)
+* MT_FEATURES:                           mktex configuration. (line  40)
 * multiple architectures, compiling on:  configure scenarios. (line  18)
 * multiple architectures, directories for: configure scenarios.
                                                               (line  23)
@@ -4254,8 +4286,8 @@ Index
 * NFS and ls-R:                          ls-R.                (line  40)
 * NFS CTAN access:                       Electronic distribution.
                                                               (line  17)
-* nomfdrivers:                           mktex configuration. (line  86)
-* nomode:                                mktex configuration. (line  91)
+* nomfdrivers:                           mktex configuration. (line  93)
+* nomode:                                mktex configuration. (line  98)
 * non-English typesetting:               Kpathsea application distributions.
                                                               (line  28)
 * non-Unix operating systems:            Custom installation. (line  19)
@@ -4410,7 +4442,7 @@ Index
                                                               (line  10)
 * shells and configure:                  configure shells.    (line   6)
 * simple installation:                   Simple installation. (line   6)
-* site overrides for mktex...:           mktex configuration. (line  23)
+* site overrides for mktex...:           mktex configuration. (line  29)
 * size of distribution archives:         Disk space.          (line   6)
 * skeleton TeX directory:                TeX directory structure.
                                                               (line   6)
@@ -4431,15 +4463,15 @@ Index
 * static linking:                        ShellWidgetClass.    (line  39)
 * static linking and dlsym:              dlopen.              (line   6)
 * string routines:                       Calling sequence.    (line  83)
-* strip:                                 mktex configuration. (line 101)
-* stripsupplier:                         mktex configuration. (line  95)
-* striptypeface:                         mktex configuration. (line  98)
+* strip:                                 mktex configuration. (line 108)
+* stripsupplier:                         mktex configuration. (line 102)
+* striptypeface:                         mktex configuration. (line 105)
 * subdirectory searching:                Subdirectory expansion.
                                                               (line   6)
 * suggestions, making:                   Introduction.        (line  27)
 * Sun 2:                                 History.             (line  12)
 * Sun OpenWin patches:                   ShellWidgetClass.    (line  29)
-* supplier directory, omitting:          mktex configuration. (line  96)
+* supplier directory, omitting:          mktex configuration. (line 103)
 * supported file formats:                Supported file formats.
                                                               (line   6)
 * suppressing warnings:                  Suppressing warnings.
@@ -4489,7 +4521,6 @@ Index
                                                               (line  16)
 * tex-k-request@mail.tug.org:            Mailing lists.       (line   7)
 * tex-k@mail.tug.org (bug address):      Reporting bugs.      (line   8)
-* tex-make.c:                            mktex script names.  (line   6)
 * TEX_HUSH <1>:                          Suppressing warnings.
                                                               (line   6)
 * TEX_HUSH:                              Searching overview.  (line  56)
@@ -4533,11 +4564,11 @@ Index
 * TEXMFINI:                              Supported file formats.
                                                               (line  24)
 * TEXMFLOG:                              Logging.             (line  10)
-* TEXMFOUTPUT:                           mktex script names.  (line  30)
+* TEXMFOUTPUT:                           mktex script names.  (line  40)
 * TEXMFSCRIPTS:                          Supported file formats.
                                                               (line 164)
-* TEXMFVAR:                              mktex configuration. (line 117)
-* texmfvar:                              mktex configuration. (line 116)
+* TEXMFVAR:                              mktex configuration. (line 124)
+* texmfvar:                              mktex configuration. (line 123)
 * TEXPICTS:                              Supported file formats.
                                                               (line  62)
 * TEXPKS:                                Supported file formats.
@@ -4567,7 +4598,7 @@ Index
                                                               (line 181)
 * tug.org:                               unixtex.ftp.         (line   6)
 * tug@tug.org:                           Introduction.        (line  46)
-* typeface directory, omitting:          mktex configuration. (line  99)
+* typeface directory, omitting:          mktex configuration. (line 106)
 * ucbinclude, avoiding:                  Running make.        (line  44)
 * Ultrix shells and configure:           configure shells.    (line  25)
 * unable to find files:                  Unable to find files.
@@ -4586,16 +4617,16 @@ Index
 * unreadable files:                      Searching overview.  (line  56)
 * unusable ls-R warning:                 ls-R.                (line  45)
 * usage patterns, finding:               Logging.             (line   6)
-* USE_TEXMFVAR:                          mktex configuration. (line 122)
-* USE_VARTEXFONTS:                       mktex configuration. (line 112)
+* USE_TEXMFVAR:                          mktex configuration. (line 129)
+* USE_VARTEXFONTS:                       mktex configuration. (line 119)
 * Usenet TeX newsgroup:                  Mailing lists.       (line  29)
 * USERPROFILE, as ~ expansion:           Tilde expansion.     (line   6)
-* varfonts:                              mktex configuration. (line 106)
+* varfonts:                              mktex configuration. (line 113)
 * variable expansion:                    Variable expansion.  (line   6)
 * variable.c:                            Variable expansion.  (line  32)
 * variable.h:                            Programming with config files.
                                                               (line  10)
-* VARTEXFONTS:                           mktex configuration. (line 107)
+* VARTEXFONTS:                           mktex configuration. (line 114)
 * VAX 11/750:                            History.             (line  12)
 * version number, of Kpathsea:           Kpathsea application distributions.
                                                               (line   6)
@@ -4635,7 +4666,7 @@ Index
 * XDEFS:                                 Running make.        (line  23)
 * XDVIFONTS:                             Supported file formats.
                                                               (line 227)
-* XDVIMAKEPK:                            mktex script names.  (line  22)
+* XDVIMAKEPK:                            mktex script names.  (line  32)
 * XDVISIZES:                             Fallback font.       (line   6)
 * XLDFLAGS:                              Running make.        (line  29)
 * XLOADLIBES:                            Running make.        (line  32)
@@ -4649,85 +4680,85 @@ Index
 
 
 Tag Table:
-Node: Top1475
-Node: Introduction2124
-Node: History4106
-Node: Installation8198
-Node: Simple installation8988
-Node: Custom installation12571
-Node: Disk space13745
-Node: Kpathsea application distributions14629
-Node: Changing search paths15744
-Node: Default path features16926
-Node: Default path generation19062
-Node: Running configure20505
-Node: configure shells21556
-Node: configure options22608
-Node: configure environment24115
-Node: configure scenarios25917
-Node: Shared library27503
-Node: Running make28517
-Node: Installing files30564
-Node: Cleaning up32511
-Node: Filename database generation33559
-Node: mktex scripts34126
-Node: mktex configuration35083
-Node: mktex script names40627
-Node: mktex script arguments41725
-Node: Installation testing42615
-Node: Security42979
-Node: TeX directory structure45546
-Node: unixtex.ftp49968
-Node: Electronic distribution51983
-Node: CD-ROM distribution54748
-Node: Other TeX packages55718
-Node: Reporting bugs57014
-Node: Bug checklist57754
-Node: Mailing lists61456
-Node: Debugging62815
-Node: Logging67887
-Node: Common problems69757
-Node: Unable to find files70588
-Node: Slow path searching72999
-Node: Unable to generate fonts74376
-Node: TeX or Metafont failing76885
-Node: Empty Makefiles78763
-Node: XtStrings79993
-Node: dlopen80829
-Node: ShellWidgetClass81647
-Node: Pointer combination warnings83279
-Node: Path searching83668
-Node: Searching overview84315
-Node: Path sources87687
-Node: Config files88758
-Node: Path expansion92158
-Node: Default expansion93107
-Node: Variable expansion95177
-Node: Tilde expansion96580
-Node: Brace expansion97560
-Node: KPSE_DOT expansion98665
-Node: Subdirectory expansion99178
-Node: Filename database101527
-Node: ls-R102841
-Node: Filename aliases105735
-Node: Database format106913
-Node: Invoking kpsewhich107926
-Node: Path searching options108803
-Node: Auxiliary tasks115452
-Node: Standard options117273
-Node: TeX support117593
-Node: Supported file formats118884
-Node: File lookup126032
-Node: Glyph lookup127323
-Node: Basic glyph lookup128450
-Node: Fontmap129329
-Node: Fallback font131946
-Node: Suppressing warnings132911
-Node: Programming134016
-Node: Programming overview134529
-Node: Calling sequence136805
-Node: Program-specific files141834
-Node: Programming with config files142872
-Node: Index144172
+Node: Top1555
+Node: Introduction2205
+Node: History4188
+Node: Installation8280
+Node: Simple installation9070
+Node: Custom installation12653
+Node: Disk space13827
+Node: Kpathsea application distributions14711
+Node: Changing search paths15826
+Node: Default path features17008
+Node: Default path generation19144
+Node: Running configure20587
+Node: configure shells21638
+Node: configure options22690
+Node: configure environment24197
+Node: configure scenarios25999
+Node: Shared library27585
+Node: Running make28599
+Node: Installing files30646
+Node: Cleaning up32593
+Node: Filename database generation33641
+Node: mktex scripts34208
+Node: mktex configuration35485
+Node: mktex script names41304
+Node: mktex script arguments42695
+Node: Installation testing43585
+Node: Security43949
+Node: TeX directory structure46516
+Node: unixtex.ftp50938
+Node: Electronic distribution52953
+Node: CD-ROM distribution55718
+Node: Other TeX packages56688
+Node: Reporting bugs57984
+Node: Bug checklist58724
+Node: Mailing lists62426
+Node: Debugging63785
+Node: Logging68857
+Node: Common problems70727
+Node: Unable to find files71558
+Node: Slow path searching73969
+Node: Unable to generate fonts75346
+Node: TeX or Metafont failing77855
+Node: Empty Makefiles79733
+Node: XtStrings80963
+Node: dlopen81799
+Node: ShellWidgetClass82617
+Node: Pointer combination warnings84249
+Node: Path searching84638
+Node: Searching overview85285
+Node: Path sources88657
+Node: Config files89728
+Node: Path expansion93128
+Node: Default expansion94077
+Node: Variable expansion96147
+Node: Tilde expansion97550
+Node: Brace expansion98530
+Node: KPSE_DOT expansion99635
+Node: Subdirectory expansion100148
+Node: Filename database102497
+Node: ls-R103811
+Node: Filename aliases106705
+Node: Database format107883
+Node: Invoking kpsewhich108896
+Node: Path searching options109773
+Node: Auxiliary tasks116422
+Node: Standard options118243
+Node: TeX support118563
+Node: Supported file formats119854
+Node: File lookup127002
+Node: Glyph lookup128293
+Node: Basic glyph lookup129420
+Node: Fontmap130299
+Node: Fallback font132916
+Node: Suppressing warnings133881
+Node: Programming134986
+Node: Programming overview135499
+Node: Calling sequence137775
+Node: Program-specific files142804
+Node: Programming with config files143842
+Node: Index145142
 
 End Tag Table
diff --git a/Build/source/texk/kpathsea/kpathsea.texi b/Build/source/texk/kpathsea/kpathsea.texi
index bcfe71da4f9..d56a843003d 100644
--- a/Build/source/texk/kpathsea/kpathsea.texi
+++ b/Build/source/texk/kpathsea/kpathsea.texi
@@ -3,7 +3,7 @@
 @settitle Kpathsea: A library for path searching
 
 @set version 3.5.6dev
-@set month-year January 2008
+@set month-year February 2008
 
 @c Define new indices for commands, filenames, and options.
 @defcodeindex cm
@@ -24,11 +24,12 @@
 @direntry
 * Kpathsea: (kpathsea).                       File lookup along search paths.
 * kpsewhich: (kpathsea)Invoking kpsewhich.    TeX file searching.
+* mktexfmt: (kpathsea)mktex scripts.          Format (fmt/base/mem) generation.
+* mktexlsr: (kpathsea)Filename database.      Update ls-R.
 * mktexmf: (kpathsea)mktex scripts.           MF source generation.
 * mktexpk: (kpathsea)mktex scripts.           PK bitmap generation.
 * mktextex: (kpathsea)mktex scripts.          TeX source generation.
 * mktextfm: (kpathsea)mktex scripts.          TeX font metric generation.
-* mktexlsr: (kpathsea)Filename database.      Update ls-R.
 @end direntry
 
 @copying