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

Florent Rougon frn at costa.debian.org
Sun Jun 25 13:36:30 UTC 2006


Author: frn
Date: 2006-06-25 13:36:29 +0000 (Sun, 25 Jun 2006)
New Revision: 1456

Modified:
   tex-common/trunk/debian/changelog
   tex-common/trunk/doc/Debian-TeX-Policy.sgml
   tex-common/trunk/scripts/update-updmap.1
Log:
* Document the latest changes (.dpkg-new checking) in update-updmap.

* Replace a few instances of "Remember that dh_installtex can do the work for
  you" by "The recommended way for implementing this scheme is to use
  dh_installtex" (I think we all agree on that)


Modified: tex-common/trunk/debian/changelog
===================================================================
--- tex-common/trunk/debian/changelog	2006-06-24 12:07:33 UTC (rev 1455)
+++ tex-common/trunk/debian/changelog	2006-06-25 13:36:29 UTC (rev 1456)
@@ -1,5 +1,9 @@
 tex-common (0.24.1) UNRELEASED; urgency=low
 
+  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+  XXX Debian-TeX-Policy.pdf has to be updated before the package is built XXX
+  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+  
   * Translations:
     - Fix typos in french debconf translation, thanks to Florentin Duneau
       <f.baced at wanadoo.fr> (closes: #374632) [frank]
@@ -14,6 +18,9 @@
         see http://lists.debian.org/debian-tetex-maint/2006/06/msg00260.html
         for a discussion of this subject.
       - cosmetic fixes. [florent]
+  
+  * Update scripts/update-updmap.1 and doc/Debian-TeX-Policy.sgml
+    accordingly. [florent]
 
  -- Florent Rougon <frn at debian.org>  Sat, 24 Jun 2006 13:40:30 +0200
 

Modified: tex-common/trunk/doc/Debian-TeX-Policy.sgml
===================================================================
--- tex-common/trunk/doc/Debian-TeX-Policy.sgml	2006-06-24 12:07:33 UTC (rev 1455)
+++ tex-common/trunk/doc/Debian-TeX-Policy.sgml	2006-06-25 13:36:29 UTC (rev 1456)
@@ -636,8 +636,8 @@
 
           <p>
           A sample implementation of this scheme can be found in <ref
-          id="appen-sample-font">, but don't forget that
-          <prgn>dh_installtex</prgn> can do the work for you.
+          id="appen-sample-font">, but the recommended way to implement this
+          scheme is to use <prgn>dh_installtex</prgn>.
           </p>
 
           <p>
@@ -699,9 +699,19 @@
               <prgn>update-updmap</prgn>, so that whenever it sees a
               <file>.cfg</file> file (let's call it <file>10foo.cfg</file>)
               that has the "magic comment", it actually includes its contents
-              into <file>updmap.cfg</file> if, and only if <tt>10foo</tt>
-              appears on a line by itself in one of the <file>.list</file>
-              files in <file>/var/lib/tex-common/fontmap-cfg/</file>.
+              into <file>updmap.cfg</file> if, and only if:
+                <list>
+                  <item>
+                    it is up-to-date (which is assumed if
+                    <file>10foo.cfg.dpkg-new</file> doesn't exist in the same
+                    directory);
+                  </item>
+                  <item>
+                    <tt>10foo</tt> appears on a line by itself in one of the
+                    <file>.list</file> files in
+                    <file>/var/lib/tex-common/fontmap-cfg/</file>.
+                  </item>
+                </list>
               Additionally, that <file>.list</file> file should be named
               <file><var>package</var>.list</file> if <file>10foo.cfg</file>
               comes from <var>package</var>, for simple reasons of tidiness.
@@ -728,16 +738,25 @@
                 </item>
 
                 <item>
-                  If <var>package</var> is reinstalled later,
-                  <file><var>package</var>.list</file> first reappears in
-                  <file>/var/lib/tex-common/fontmap-cfg/</file>. Then,
-                  <file><var>package</var>.postinst</file> runs
+                  If <var>package</var> is reinstalled later, two files are
+                  first created by <prgn>dpkg</prgn> during the unpack phase:
+                  <file>/var/lib/tex-common/fontmap-cfg/<var>package</var>.list</file>
+                  and <file>/etc/texmf/updmap.d/10foo.cfg.dpkg-new</file>. As
+                  long as the second one exists, the conffile
+                  <file>/etc/texmf/updmap.d/10foo.cfg</file> will be ignored
+                  by <prgn>update-updmap</prgn><footnote>An
+                  <prgn>update-updmap</prgn> call could take place if another
+                  package such as <package>tetex-bin</package> is configured
+                  in the meantime. That happens sometimes with APT.</footnote>
+                  because it may be outdated. Eventually, <var>package</var>
+                  is configured; <file><var>package</var>.postinst</file> runs
                   <prgn>update-updmap</prgn>, <prgn>mktexlsr</prgn> and
                   <prgn>updmap-sys</prgn>, and the <file>.cfg</file> files
                   shipped by <var>package</var> aren't ignored by
                   <prgn>update-updmap</prgn> this time, since they are
                   referenced in
-                  <file>/var/lib/tex-common/fontmap-cfg/<var>package</var>.list</file>.
+                  <file>/var/lib/tex-common/fontmap-cfg/<var>package</var>.list</file>
+                  and the <file>.dpkg-new</file> files don't exist anymore.
                   Thus, the map files shipped by <var>package</var> do end up
                   in the final map files generated by <prgn>updmap-sys</prgn>.
                   </item> </list>
@@ -782,10 +801,21 @@
 <example>
 # -_- DebPkgProvidedMaps -_-
 </example>
-          it will only be used as long it is listed in a file in
-          <file>/var/lib/tex-common/language-cnf/</file> which should
-          have the name <file><var>package</var>.list</file>.
+          it will only be used as long it is:
+          <list>
+            <item>
+              up-to-date (which is assumed if the same file with
+              <file>.dpkg-new</file> suffix doesn't exist in the same
+              directory);
+            </item>
+            <item>
+              listed in a file in
+              <file>/var/lib/tex-common/language-cnf/</file> which should have
+              the name <file><var>package</var>.list</file>.
+            </item>
+          </list>
 	  </p>
+
 	  <p>
 	  Calling update-language is *not* sufficient to be able to
 	  use the new hyphenation patterns; instead the formats that
@@ -793,6 +823,7 @@
 	  <tt>fmtutil-sys --byhyphen `kpsewhich --progname=latex
 	  language.dat`</tt>.
 	  </p>
+
 	  <p>
 	  If a package that provides additional hyphenation patterns
 	  is removed, it must make sure the formats are properly
@@ -801,20 +832,24 @@
 	  <tt>fmtutil-sys --byhyphen `kpsewhich --progname=latex
 	  language.dat`</tt> in <file>postrm</file>
 	  </p>
+
 	  <p>
 	  There is currently no mechanism (i.e., no
 	  <prgn>update-language</prgn>) for automatic addition of
 	  hyphenation patterns to formats that do not use the same
 	  hyphenation configuration file as LaTeX.
 	  </p>
+
 	  <p>
-	  Don't forget that <prgn>dh_installtex</prgn> can do the work 
-	  for you.
+	  The recommended way for implementing this scheme is to use
+	  <prgn>dh_installtex</prgn>.
 	  </p>
+
 	</sect1>
 	
 	<sect1>
 	  <heading>Format configuration</heading>
+
 	  <p>
 	  As with font map configuration and language hyphenation patterns
 	  configuration, packages that provide additional formats should
@@ -838,22 +873,26 @@
 	  <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>
+
 	  <p>
 	  Upon package removal, <prgn>update-fmtutil</prgn> must be
 	  called in postrm, and the created formats and log files
 	  should be removed from the directory specified by
 	  <tt>`kpsewhich -var-value=TEXMFSYSVAR`/web2c</tt>.
 	  </p>
-          <p>
-          Don't forget that <prgn>dh_installtex</prgn> can do the work
-          for you.
-          </p>
+
+	  <p>
+	  The recommended way for implementing this scheme is to use
+	  <prgn>dh_installtex</prgn>.
+	  </p>
+
 	</sect1>
       </sect>
 

Modified: tex-common/trunk/scripts/update-updmap.1
===================================================================
--- tex-common/trunk/scripts/update-updmap.1	2006-06-24 12:07:33 UTC (rev 1455)
+++ tex-common/trunk/scripts/update-updmap.1	2006-06-25 13:36:29 UTC (rev 1456)
@@ -90,7 +90,10 @@
 .Pp
 or;
 .It
-they have this pseudo-comment and are listed in a
+they have this pseudo-comment, are up-to-date (i.e., the same file
+with suffix
+.Ql .dpkg-new
+doesn't exist) and are listed in a
 .Ql .list
 file under
 .Pa /var/lib/tex-common/fontmap-cfg/ ,




More information about the Pkg-tetex-commits mailing list