summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-07-04 00:42:47 +0000
committerKarl Berry <karl@freefriends.org>2008-07-04 00:42:47 +0000
commit4aab8d3e86b8369ab367c9a83ee2a747e6f70cff (patch)
treef85c979ce7dd1423c353e8beb77bdc4b6e9d14a9
parent84afcfa4f1d6ef99297910a2950641b51d21e1e4 (diff)
try to improve --engine=/ description, per peb
git-svn-id: svn://tug.org/texlive/trunk@9209 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Build/source/texk/kpathsea/kpathsea.info66
-rw-r--r--Build/source/texk/kpathsea/kpathsea.texi17
2 files changed, 46 insertions, 37 deletions
diff --git a/Build/source/texk/kpathsea/kpathsea.info b/Build/source/texk/kpathsea/kpathsea.info
index ce3ccadc6fe..c150186274f 100644
--- a/Build/source/texk/kpathsea/kpathsea.info
+++ b/Build/source/texk/kpathsea/kpathsea.info
@@ -2664,12 +2664,16 @@ filename, and returns the first file found.
`--engine=NAME'
Set the engine name to NAME. By default it is not set. The
engine name is used in some search paths to allow files with the
- same name but used by different engines to coexist. In
- particular, since the memory dump files (`.fmt'/`.base'/`.mem')
+ same name but used by different engines to coexist.
+
+ In particular, since the memory dump files (`.fmt'/`.base'/`.mem')
are now stored in subdirectories named for the engine (`tex',
`pdftex', `xetex', etc.), you must specify an engine name in order
- to find them. You can use `--engine=/' if you are a format exists
- for only one engine and you don't care what it is.
+ to find them. For example, `cont-en.fmt' typically exists for both
+ `pdftex' and `xetex'. You can use `--engine=/' to look for any
+ dump file, regardless of engine; if a dump file exists for more
+ than one engine, it's indeterminate which one is returned. (The
+ `/' ends up specifying a normal recursive search in `texmf/web2c'.)
`--format=NAME'
Set the format for lookup to NAME. By default, the format is
@@ -3668,23 +3672,23 @@ Index
* --expand-path=STRING: Auxiliary tasks. (line 24)
* --expand-var=STRING: Auxiliary tasks. (line 19)
* --format=NAME: Path searching options.
- (line 32)
+ (line 36)
* --help: Standard options. (line 8)
* --interactive: Path searching options.
- (line 100)
+ (line 104)
* --mode=STRING: Path searching options.
- (line 111)
+ (line 115)
* --must-exist: Path searching options.
- (line 116)
+ (line 120)
* --path=STRING: Path searching options.
- (line 121)
+ (line 125)
* --progname=NAME: Path searching options.
- (line 130)
+ (line 134)
* --show-path=NAME: Auxiliary tasks. (line 41)
* --srcdir, for building multiple architectures: configure scenarios.
(line 18)
* --subdir=STRING: Path searching options.
- (line 135)
+ (line 139)
* --var-value=VARIABLE: Auxiliary tasks. (line 12)
* --version: Standard options. (line 10)
* --with options: configure options. (line 16)
@@ -3705,9 +3709,9 @@ Index
* -g, compiling without: configure scenarios. (line 32)
* -L option to ls: ls-R. (line 38)
* -mktex=FILETYPE: Path searching options.
- (line 105)
+ (line 109)
* -no-mktex=FILETYPE: Path searching options.
- (line 105)
+ (line 109)
* -O, compiling with: configure scenarios. (line 32)
* -static: ShellWidgetClass. (line 43)
* . directories, ignored: ls-R. (line 33)
@@ -4169,7 +4173,7 @@ Index
* installation, simple: Simple installation. (line 6)
* installing files: Installing files. (line 6)
* interactive query: Path searching options.
- (line 100)
+ (line 104)
* interface, not frozen: Introduction. (line 27)
* introduction: Introduction. (line 6)
* kdebug:: Debugging. (line 105)
@@ -4826,22 +4830,22 @@ Node: Filename aliases106701
Node: Database format107879
Node: Invoking kpsewhich108892
Node: Path searching options109837
-Node: Specially-recognized files116530
-Node: Auxiliary tasks117854
-Node: Standard options119679
-Node: TeX support119999
-Node: Supported file formats121290
-Node: File lookup128438
-Node: Glyph lookup130166
-Node: Basic glyph lookup131293
-Node: Fontmap132172
-Node: Fallback font134789
-Node: Suppressing warnings135754
-Node: Programming136859
-Node: Programming overview137372
-Node: Calling sequence139648
-Node: Program-specific files144677
-Node: Programming with config files145715
-Node: Index147015
+Node: Specially-recognized files116756
+Node: Auxiliary tasks118080
+Node: Standard options119905
+Node: TeX support120225
+Node: Supported file formats121516
+Node: File lookup128664
+Node: Glyph lookup130392
+Node: Basic glyph lookup131519
+Node: Fontmap132398
+Node: Fallback font135015
+Node: Suppressing warnings135980
+Node: Programming137085
+Node: Programming overview137598
+Node: Calling sequence139874
+Node: Program-specific files144903
+Node: Programming with config files145941
+Node: Index147241

End Tag Table
diff --git a/Build/source/texk/kpathsea/kpathsea.texi b/Build/source/texk/kpathsea/kpathsea.texi
index e9e6e7af1cb..978278352bb 100644
--- a/Build/source/texk/kpathsea/kpathsea.texi
+++ b/Build/source/texk/kpathsea/kpathsea.texi
@@ -1093,12 +1093,17 @@ Dvips. Default is 600.
@cindex engine name
Set the engine name to @var{name}. By default it is not set. The
engine name is used in some search paths to allow files with the same
-name but used by different engines to coexist. In particular, since
-the memory dump files (@file{.fmt}/@file{.base}/@file{.mem}) are now
-stored in subdirectories named for the engine (@file{tex},
-@file{pdftex}, @file{xetex}, etc.), you must specify an engine name in
-order to find them. You can use @samp{--engine=/} if you are a format
-exists for only one engine and you don't care what it is.
+name but used by different engines to coexist.
+
+In particular, since the memory dump files
+(@file{.fmt}/@file{.base}/@file{.mem}) are now stored in
+subdirectories named for the engine (@file{tex}, @file{pdftex},
+@file{xetex}, etc.), you must specify an engine name in order to find
+them. For example, @file{cont-en.fmt} typically exists for both
+@file{pdftex} and @file{xetex}. You can use @samp{--engine=/} to look
+for any dump file, regardless of engine; if a dump file exists for
+more than one engine, it's indeterminate which one is returned. (The
+@samp{/} ends up specifying a normal recursive search in @file{texmf/web2c}.)
@item --format=@var{name}
@opindex --format=@var{name}