Author: frank
Date: 2005-11-17 15:59:33 +0000 (Thu, 17 Nov 2005)
New Revision: 341

Modified:
   tex-common/trunk/debian/changelog
   tex-common/trunk/debian/postinst.functions
   tex-common/trunk/doc/Debian-TeX-Policy.pdf
   tex-common/trunk/doc/Debian-TeX-Policy.sgml
Log:
wrote a section on update-fmtutil stuff in policy

Modified: tex-common/trunk/debian/changelog
===================================================================
--- tex-common/trunk/debian/changelog   2005-11-16 16:46:34 UTC (rev 340)
+++ tex-common/trunk/debian/changelog   2005-11-17 15:59:33 UTC (rev 341)
@@ -17,8 +17,9 @@
       <[EMAIL PROTECTED]> (closes: #338866) [frank]
     - update Danish debconf translation, thanks to Claus Hindsgaul
       <[EMAIL PROTECTED]> (closes: #339354) [frank]
+  * The Policy draft has been extended [frank]
 
- -- Frank Küster <[EMAIL PROTECTED]>  Wed, 16 Nov 2005 13:37:31 +0100
+ -- Frank Küster <[EMAIL PROTECTED]>  Thu, 17 Nov 2005 16:58:47 +0100
 
 tex-common (0.10) unstable; urgency=low
 

Modified: tex-common/trunk/debian/postinst.functions
===================================================================
--- tex-common/trunk/debian/postinst.functions  2005-11-16 16:46:34 UTC (rev 
340)
+++ tex-common/trunk/debian/postinst.functions  2005-11-17 15:59:33 UTC (rev 
341)
@@ -50,7 +50,9 @@
 This file contains the parts of what was called 00updmap.cfg in 
 teTeX-2.0.2 that now are handled by tetex-base in 10tetex-base.cfg
 
-If you have local changes, please transfer them manually
+If you have local changes, please transfer them manually.  Changes 
+in the items that are still in 00updmap.cfg have been transferred, 
+but changed comments are only here.
 
 EOF
       sed -e '0,/^# Map files should be marked by/ d; 1,/^$/ d' \
@@ -94,6 +96,7 @@
       chmod a+r $conffile
     else
       # this part is unchanged, just remove and copy the default file
+      # (a copy is already saved).
       rm -f $tempfile1 $conffile
       cp -p $dfltfile $conffile
     fi

Modified: tex-common/trunk/doc/Debian-TeX-Policy.pdf
===================================================================
(Binary files differ)

Modified: tex-common/trunk/doc/Debian-TeX-Policy.sgml
===================================================================
--- tex-common/trunk/doc/Debian-TeX-Policy.sgml 2005-11-16 16:46:34 UTC (rev 
340)
+++ tex-common/trunk/doc/Debian-TeX-Policy.sgml 2005-11-17 15:59:33 UTC (rev 
341)
@@ -382,9 +382,9 @@
        Packages that changed <file>updmap.cfg</file> must call
        <prgn>updmap-sys</prgn> as detailed in <ref
        id="sec-font-configuration">. 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
-       <prgn>mktexlsr</prgn> command before this.
+       <file>language.dat</file> or <file>fmtutil.cnf</file> must
+       call <prgn>fmtutil-sys</prgn> (see below). They must make sure
+       to issue the <prgn>mktexlsr</prgn> command before this.
        </p>
 
        <sect1 id="sec-font-configuration">
@@ -675,6 +675,29 @@
           have the name <file><var>package</var>.list</file>.
          </p>
        </sect1>
+       
+       <sect1>
+         <heading>Format configuration</heading>
+         <p>
+         Packages that provide additional formats should put a
+         configuration file according to <prgn>fmtutil.cnf(5)</prgn>
+         into <file>/etc/texmf/fmt.d/</file>, run
+         <prgn>update-fmtutil</prgn> and subsequently create the
+         format with <tt>fmtutil --byfmt <var>format</var></tt>.
+         <prgn>fmtutil</prgn> will only try to create the format if
+         it can find the corresponding
+         <file><var>format</var>.ini</file> file (the last argument
+         in an <prgn>fmtutil.cnf</prgn> line).  Therefore the
+         <file><var>format</var>.ini</file> file should not be a
+         conffile.
+         </p>
+         <p>
+         If a package needs to create formats at runtime, it should
+         use a local <prgn>fmtutil.cnf</prgn> with the appropriate
+         entries and specifiy its location to <prgn>fmtutil</prgn> on
+         the command line, using the <tt>--cnffile</tt> switch.
+         </p>
+       </sect1>
       </sect>
 
       <sect>
@@ -699,13 +722,21 @@
         <heading>Command execution and format files</heading>
        <p>
        If TeX formats need to be generated before execution, this
-       must be done in the post-installation script.  Packages that
+       should be done in the post-installation script.  Packages that
        depend on an executable can thus simply declare
        <tt>Depends:</tt> on the package providing the executable, and
        <em>only</em> do that.  Any additional checks, e.g. for the
        existence of format files, is unnecessary and harmful, causing
        internal changes (e.g. of format file extensions) to break the
-       depending package that does this check.
+       depending package that does this check.  Maintainer scripts or
+       programs in Debian packages should always use
+       <prgn>fmtutil</prgn> or <prgn>fmtutil-sys</prgn> for format
+       generation, and either add a <file>fmtutil.cnf</file> snippet
+       in <file>/etc/texmf/fmt.d/</file> (with
+       <prgn>fmtutil-sys</prgn>, for site-wide formats), or use
+       <prgn>fmtutil</prgn> with the <tt>--cnffile</tt> option and an
+       appropriate local <file>fmtutil.cnf</file> (for runtime
+       programs) 
        </p>
        <p>
        Local administrators can override settings from


_______________________________________________
Pkg-tetex-commits mailing list
[email protected]
http://lists.alioth.debian.org/mailman/listinfo/pkg-tetex-commits

Reply via email to