[subversion-commit] SVN tetex commit + diffs: r341 - in tex-common/trunk: debian doc

[Frank Küster]

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 @@
       <yeager at lidkoping.net> (closes: #338866) [frank]
     - update Danish debconf translation, thanks to Claus Hindsgaul
       <claus_h at image.dk> (closes: #339354) [frank]
+  * The Policy draft has been extended [frank]
 
- -- Frank Küster <frank at debian.org>  Wed, 16 Nov 2005 13:37:31 +0100
+ -- Frank Küster <frank at debian.org>  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