[Debian-tex-commits] SVN tex-common commit + diffs: r2577 - tex-common/trunk/doc

[Florent Rougon]

Author: frn
Date: 2007-03-14 17:50:08 +0000 (Wed, 14 Mar 2007)
New Revision: 2577

Modified:
   tex-common/trunk/doc/TeX-on-Debian.sgml
Log:
Add missing markup in section "Font caching" (<file>, <prgn>, <var>).


Modified: tex-common/trunk/doc/TeX-on-Debian.sgml
===================================================================
--- tex-common/trunk/doc/TeX-on-Debian.sgml	2007-03-14 16:22:27 UTC (rev 2576)
+++ tex-common/trunk/doc/TeX-on-Debian.sgml	2007-03-14 17:50:08 UTC (rev 2577)
@@ -609,29 +609,34 @@
 	<heading>Font caching</heading>
 	<p>
 	  A TeX system needs to generate new font data (pixel data, metric,
-	  sources) on the fly. These files can be saved into the TeX font cache
-	  and later be reused.  By default, a separate font cache is created
-	  for each user in their own TEXMFVAR directory ($HOME/.texmf-var/).
-	  If this directory is not writable, e.g. during automated package
-	  building, a directory called VARTEXFONTS, /tmp/texfonts/, is used
+	  sources) on the fly. These files can be saved into the TeX font
+	  cache and later be reused. By default, a separate font cache is
+	  created for each user in their own <var>TEXMFVAR</var> directory
+	  (<file>$<var>HOME</var>/.texmf-var/</file>). If this directory is
+	  not writable, e.g. during automated package building, a directory
+	  called <var>VARTEXFONTS</var>, <file>/tmp/texfonts/</file>, is used
 	  instead, but this directory is cleaned up regularly.
 	</p>
 	<p>
 	  On multi-user machines, it might be advisable that the local
-	  administrator enables a site-wide font cache and sets VARTEXFONTS to
-	  a persistent directory, e.g. /var/cache/fonts.  The variable is set
-	  in /etc/texmf/texmf.d/05TeXMF.cnf and can either be changed there or
-	  preferrably overwritten in a file that sorts before 05TeXMF.cnf, e.g.
-	  /etc/texmf/texmf.d/04VARTEXFONTS.cnf.  Do not forget to run
-	  update-texmf after making the change.  To enable a side-wide font
-	  caching the admin should edit /etc/texmf/web2c/mktex.cnf and use
-	  'varfonts' instead of 'texmfvar' in MT_FEATURES.  Care should be
-	  taken to specifiy appropriate permissions for the directory
-	  containing the font cache.  Either the local admin should create all
-	  available font data and not allow write access, or else write access
-	  should be limited to trusted users.  Yet an other alternative is to
-	  bind-mount /var/cache/fonts from a separate partition, so that users
-	  are not able to fill up the /var partition with font data.
+	  administrator enables a site-wide font cache and sets
+	  <var>VARTEXFONTS</var> to a persistent directory, e.g.
+	  <file>/var/cache/fonts</file>. The variable is set in
+	  <file>/etc/texmf/texmf.d/05TeXMF.cnf</file> and can either be
+	  changed there or preferrably overwritten in a file that sorts before
+	  <file>05TeXMF.cnf</file>, e.g.
+	  <file>/etc/texmf/texmf.d/04VARTEXFONTS.cnf</file>. Do not forget to
+	  run <prgn>update-texmf</prgn> after making the change. To enable a
+	  side-wide font caching the admin should edit
+	  <file>/etc/texmf/web2c/mktex.cnf</file> and use 'varfonts' instead
+	  of 'texmfvar' in <var>MT_FEATURES</var>. Care should be taken to
+	  specifiy appropriate permissions for the directory containing the
+	  font cache. Either the local admin should create all available font
+	  data and not allow write access, or else write access should be
+	  limited to trusted users. Yet an other alternative is to bind-mount
+	  <file>/var/cache/fonts</file> from a separate partition, so that
+	  users are not able to fill up the <file>/var</file> partition with
+	  font data.
 	</p>
       </sect>