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

[Frank Küster]

Author: frank
Date: 2006-12-01 14:51:53 +0100 (Fri, 01 Dec 2006)
New Revision: 1967

Modified:
   tex-common/trunk/doc/Debian-TeX-Policy.sgml
Log:
an attempt to make TDS more visible to packagers


Modified: tex-common/trunk/doc/Debian-TeX-Policy.sgml
===================================================================
--- tex-common/trunk/doc/Debian-TeX-Policy.sgml	2006-12-01 13:42:38 UTC (rev 1966)
+++ tex-common/trunk/doc/Debian-TeX-Policy.sgml	2006-12-01 13:51:53 UTC (rev 1967)
@@ -160,16 +160,32 @@
       <heading>File Placement</heading>
       <p>
       This chapter describes the placement of TeX input files, so that
-      they can be found by programs.  Files that are not TeX input
-      files must not be put in a TEXMF tree (put them into
+      they can be found by programs.  Files that are not input files
+      for TeX or related programs must not be put in a TEXMF tree (put
+      them into
       <file>/usr/share/<var>package</var></file> instead).  As an
       exception, documentation files in plain text may be used inside
       a <var>TEXMF</var> tree, e.g. to explain the purpose of an
       otherwise empty directory.
       </p>
       <sect>
-      <heading>Path searching and <package>libkpathsea</package> / <package>libkpse</package></heading>
+      <heading>File searching and <package>libkpathsea</package> / <package>libkpse</package></heading>
 
+        <p>
+        File locations must follow the TeX Directory Structure, TDS.
+        The TDS specification is installed in
+        the <package>texlive-doc-en</package>
+        and <package>tetex-doc</package> packages
+        as <file>tds.dvi</file>, and the latest version of the TDS is
+        available at <tt><url name="http://www.tug.org/twg/tds/"
+        id="http://www.tug.org/twg/tds/"></tt>.  It is a bug if a
+        package only conforms to an outdated TDS version.  It is a
+        more severe bug, however, if it conforms to the current TDS
+        version but does not make sure to depend on an appropriately
+        recent version of the Basic TeX packages or
+        <package>tex-common</package> (that support this TDS version).
+        </p>
+  
         <p>The Basic TeX packages must provide a mechanism for searching
         through <var>TEXMF</var> trees that allows different files to be
         found depending on the invoking program and the specified file
@@ -192,15 +208,6 @@
       <heading>Directory trees</heading>
 
         <p>
-        File locations must follow the TeX Directory Structure, TDS.  It
-        is a bug if a package only conforms to an outdated TDS version.
-        It is a more severe bug, however, if it conforms to the current
-        TDS version but does not make sure to depend on an appropriately
-        recent version of the Basic TeX packages or
-        <package>tex-common</package> (that support this TDS version).
-        </p>
-  
-        <p>
         The following <var>TEXMF</var> trees are defined, as outlined
         below:
         <enumlist>