summaryrefslogtreecommitdiff
path: root/Build/source/texk/kpathsea/kpathsea.texi
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 /Build/source/texk/kpathsea/kpathsea.texi
parent84afcfa4f1d6ef99297910a2950641b51d21e1e4 (diff)
try to improve --engine=/ description, per peb
git-svn-id: svn://tug.org/texlive/trunk@9209 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/kpathsea/kpathsea.texi')
-rw-r--r--Build/source/texk/kpathsea/kpathsea.texi17
1 files changed, 11 insertions, 6 deletions
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}