Author: frn
Date: 2005-10-16 13:41:37 +0000 (Sun, 16 Oct 2005)
New Revision: 238
Modified:
tex-common/trunk/doc/Debian-TeX-Policy.sgml
Log:
Improve the section about font packages in the Debian TeX Policy.
Modified: tex-common/trunk/doc/Debian-TeX-Policy.sgml
===================================================================
--- tex-common/trunk/doc/Debian-TeX-Policy.sgml 2005-10-15 23:01:29 UTC (rev
237)
+++ tex-common/trunk/doc/Debian-TeX-Policy.sgml 2005-10-16 13:41:37 UTC (rev
238)
@@ -12,7 +12,7 @@
<name>The Debian teTeX mailing List</name>
<email>[email protected]</email>
</author>
- <version>version 0.3, 2005-07-18</version>
+ <version>version 0.31, 2005-10-16</version>
<abstract>
This document provides a set of rules for the packaging of
@@ -378,52 +378,86 @@
<prgn>updmap-sys</prgn>, packages that changed
<file>language.dat</file> or <file>fmtutil.cnf</file> must
call <prgn>fmtutil-sys</prgn>. They must make sure to issue
- the necessary <prgn>mktexlsr</prgn> commands before and after
- this.
+ the necessary <prgn>mktexlsr</prgn> commands before this.
</p>
<sect1>
<heading>Font configuration</heading>
<p>
- A package that provides additional Postscript Type1 fonts for
- TeX should put the necessary <tt>map</tt> files below
- <file>/etc/texmf/map/</file> (which must be symlinked from
+ A package named <var>package</var> that provides PostScript Type�1
+ fonts for TeX should put the necessary <tt>map</tt> files below
+ <file>/etc/texmf/map/</file><footnote>This directory (or relevant
+ subdirectories such as <file>dvipdfm</file>, <file>dvips</file> and
+ <file>pdftex</file>) is symlinked from
<file><var>TEXMFMAIN</var>/fonts/map</file> by the Basic TeX
- packages), and have them registered by putting a
+ packages.</footnote> and have them registered by putting a
configuration file with extension <tt>.cfg</tt> into
- <file>/etc/texmf/updmap.d/</file> and calling
- <tt>update-updmap --quiet</tt>. The file contents will then
- be incorporated into
+ <file>/etc/texmf/updmap.d/</file> and calling <tt>update-updmap
+ --quiet</tt>. The file contents will then be incorporated into
<file>/var/lib/texmf/web2c/updmap.cfg</file>, the effective
- configuration file for <prgn>updmap</prgn>. <prgn>updmap</prgn>
- has to be called afterwards.
+ configuration file for <prgn>updmap-sys</prgn>.
+ <prgn>updmap-sys</prgn> has to be called afterwards. It is
+ recommended to invoke the three commands in the following order:
+
+<example>
+update-updmap --quiet
+mktexlsr
+updmap-sys
+</example>
+
+ because the <prgn>mktexlsr</prgn> call is necessary for
+ <prgn>updmap-sys</prgn> to locate the newly installed files (map
+ files shipped by <var>package</var>; additionally,
+ <file>/var/lib/texmf/web2c/updmap.cfg</file> might have been created
+ by <prgn>update-updmap</prgn>, although it more probably already
+ existed), and it is of no use to <prgn>update-updmap</prgn>.
</p>
+
<p>
- If a package is removed, but not purged, its <tt>map</tt>
- files will stay in subdirectories of
- <file>/etc/texmf</file>, but the actual font files below
- <file>/usr/share/texmf</file> are removed, and the font is
- unusable. Therefore it must make sure that the
- <prgn>updmap</prgn> configuration file in
- <file>/etc/texmf/updmap.d</file> is ignored when the
- package is in this state. This can be achieved by putting
- the "magic comment"
+ If <var>package</var> is removed, but not purged, its map files will
+ stay in subdirectories of <file>/etc/texmf/map/</file>, but the
+ actual font files below <file>/usr/share/texmf/</file> are removed,
+ rendering the fonts unusable. Therefore, <var>package</var> has to
+ make sure that its <prgn>update-updmap</prgn> configuration files in
+ <file>/etc/texmf/updmap.d/</file> are ignored when it is in this
+ state. This can be achieved by putting the "magic comment":
+
<example>
# -_- DebPkgProvidedMaps -_-
</example>
- in the file, and installing a file in
- <file>/var/lib/tex-common/fontmap-cfg/</file> with the
- name <file><var>package</var>.list</file> and the content
+
+ in these files, and installing a file in
+ <file>/var/lib/tex-common/fontmap-cfg/</file> with the name
+ <file><var>package</var>.list</file> that contains:
+
<example>
10foo
12bar
</example>
- if the packages installs the files <file>10foo.cfg</file>
- and <file>12bar.cfg</file> in
- <file>/etc/texmf/updmap.d</file>. When the package is
- removed, but not purged, this file will be removed, thus
- disabling the <prgn>updmap</prgn> configuration files.
- </p>
+
+ if for instance <var>package</var> installs the files
+ <file>10foo.cfg</file> and <file>12bar.cfg</file> in
+ <file>/etc/texmf/updmap.d/</file>. When <var>package</var> is
+ removed, but not purged, <file><var>package</var>.list</file> is
+ removed, thus disabling the <file>10foo.cfg</file> and
+ <file>12bar.cfg</file> <prgn>update-updmap</prgn> configuration
+ files. As a consequence, after running <prgn>update-updmap</prgn>,
+ <prgn>mktexlsr</prgn> and <prgn>updmap-sys</prgn> in
+ <prgn><var>package</var>.postrm</prgn>, <var>package</var>'s map
+ files won't be listed anymore in the final map files
+ (<file>psfonts.map</file>, <file>pdftex.map</file>...) generated by
+ <prgn>updmap-sys</prgn>.
+ </p>
+
+ <p>That way, <file>10foo.cfg</file> and <file>12bar.cfg</file> can
+ (and should, unless there is a good reason not to) be shipped as
+ conffiles in <file>/etc/texmf/updmap.d/</file> (which implies they
+ stay there when <var>package</var> is removed, but not purged;
+ without the "magic comment", they would be unconditionally included
+ in <file>/var/lib/texmf/web2c/updmap.cfg</file> by
+ <prgn>update-updmap</prgn>, and in the final map files by
+ <prgn>updmap-sys</prgn>).
+ </p>
</sect1>
<sect1>
_______________________________________________
Pkg-tetex-commits mailing list
[email protected]
http://lists.alioth.debian.org/mailman/listinfo/pkg-tetex-commits
