[Debian-tex-commits] SVN tex-common commit + diffs: r1993 -
tex-common/trunk/doc
Frank Küster
frank at alioth.debian.org
Wed Dec 6 18:03:30 CET 2006
Author: frank
Date: 2006-12-06 18:03:29 +0100 (Wed, 06 Dec 2006)
New Revision: 1993
Modified:
tex-common/trunk/doc/TeX-on-Debian.sgml
Log:
- replaces all &mdash by — and remove whitespace around it
- make the description of conffile merging/nonmerging consistent
Modified: tex-common/trunk/doc/TeX-on-Debian.sgml
===================================================================
--- tex-common/trunk/doc/TeX-on-Debian.sgml 2006-12-06 17:02:20 UTC (rev 1992)
+++ tex-common/trunk/doc/TeX-on-Debian.sgml 2006-12-06 17:03:29 UTC (rev 1993)
@@ -309,10 +309,18 @@
the system-wide configuration files. Users can invoke their user
counterparts <prgn>texconfig</prgn>, <prgn>fmtutil</prgn> and
<prgn>updmap</prgn>. This will put copies of the system-wide
- configuration files into the user's <var>TEXCONFIG</var> directory
+ configuration files into the user's <var>TEXMFCONFIG</var> directory
(by default, <file>$HOME/.texmf-config</file>), modify them and
generate according formats, if applicable.
</p>
+ <p>
+ There is no such mechanism for <file>texmf.cnf</file>.
+ However, the system will read all files of that name that
+ are found in the search path, and earlier definitions take
+ precedence over later ones. Therefore users can override
+ system-wide settings in their
+ own <file><var>TEXMFCONFIG</var>/web2c/texmf.cnf</file>.
+ </p>
<sect1>
<heading>Configuration file placement</heading>
@@ -369,14 +377,14 @@
<heading>Hyphenation</heading>
<p>
Hyphenation should pretty much work out of the box. In
- teTeX, there have been some changes in the past —
- see <file>NEWS.Debian</file> and
- <file>changelog.Debian</file> — but currently (nearly) all
+ teTeX, there have been some changes in the
+ past—see <file>NEWS.Debian</file> and
+ <file>changelog.Debian</file>—but currently (nearly) all
available patterns are enabled. If you want to use a reduced set of
hyphenation patterns (which might gain you a trifle more speed), you
can exclude them from the format file by changing the file specified
- in the third column of <file>fmtutil.cnf</file> — usually
- <file>language.dat</file> — and rebuild the formats with
+ in the third column of <file>fmtutil.cnf</file>—usually
+ <file>language.dat</file>—and rebuild the formats with
<prgn>fmtutil</prgn> or <prgn>fmtutil-sys</prgn>. Please note that
in Debian, language.dat is a generated file (see <ref
id="sec-core-config-files">).
@@ -386,7 +394,7 @@
For users of the norwegian language and teTeX, there are several
alternatives. For norwegian, there are different sets of patterns,
and upstream chose <file>nohyphb.tex</file>. Details can be found in
- <file>/usr/share/texmf/doc/generic/nohyph/README.nohyph</file> — you
+ <file>/usr/share/texmf/doc/generic/nohyph/README.nohyph</file>—you
can choose another one by editing <file>language.dat</file> or
rather <file>/etc/texmf/language.d/01tetex.cnf</file>.
</p>
@@ -421,8 +429,8 @@
<file>updmap.cfg</file> and <file>language.dat</file>
contain configuration options from teTeX and/or TeX Live,
possibly from you, and from other TeX-related packages. They
- are generated by scripts and should not &mdash in fact,
- except <file>texmf.cnf</file> may not &mdash be edited
+ are generated by scripts and should not—in fact,
+ except <file>texmf.cnf</file> may not—be edited
directly. Rather, you should work with the source files in the
respective directories below <file>/etc/texmf/</file>.
</p>
@@ -509,8 +517,10 @@
<prgn>update-updmap</prgn>, respectively. Only the files
in <file>/etc/texmf/updmap.d/</file>, <file>/etc/texmf/fmt.d/</file>
and <file>/etc/texmf/language.d/</file> will be treated as
- configuration files. Furthermore, there is no built-in
- merge mechanism at runtime, the files <file>fmtutil.cnf</file>,
+ configuration files. In contrast
+ to <file>texmf.cnf</file>, where all files of that name
+ that are found in the search path will be read, the
+ files <file>fmtutil.cnf</file>,
<file>updmap.cfg</file> and <file>language.dat</file> are
used on a first-found-first-used basis.
</p>
@@ -568,8 +578,8 @@
</p>
<p>
- In contrast to the above — TeX reading and merging all
- <file>texmf.cnf</file> files — the <em>first</em> found occurrence of
+ In contrast to the above—TeX reading and merging all
+ <file>texmf.cnf</file> files—the <em>first</em> found occurrence of
one of the files <file>updmap.cfg</file>, <file>language.dat</file>,
<file>fmtutil.cnf</file> are used. Thus, when called by a
user, the other configuration update programs also work
@@ -580,9 +590,9 @@
<var>TEXMFCONFIG</var> is usually
<file><var>HOME</var>/.texmf-config</file>. They combine
files in these directories with the files in the system-wide
- directories &mdash naturally the user-specific ones take
+ directories—naturally the user-specific ones take
precedence if the names are equal
- (see <ref id="sec-user-specific-installation">) &mdash and
+ (see <ref id="sec-user-specific-installation">) —and
drop the respective generated file into the user's
<var>TEXMFVAR</var>, effectively overriding the
system-wide config files. Note that changes to existing
@@ -672,7 +682,7 @@
<p>
In most cases, this error is the symptom of a syntax error in the
- document — TeX is getting into an infinite loop, and after
+ document—TeX is getting into an infinite loop, and after
some time all its internal registers have been used. Sometimes,
however, a large document that loads a package that uses a lot of
TeX's registers leads to that error, or to a similar error message.
More information about the Debian-tex-commits
mailing list