[pkgsrc/trunk]: pkgsrc/doc/guide/files Add a section on how to use print/teTe...

[minskim <minskim%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/dbc25969cb1c
branches:  trunk
changeset: 503026:dbc25969cb1c
user:      minskim <minskim%pkgsrc.org@localhost>
date:      Sun Nov 13 03:27:20 2005 +0000

description:
Add a section on how to use print/teTeX/module.mk.  Thanks to hubertf@
and tonio@ for review.

diffstat:

 doc/guide/files/fixes.xml |  35 ++++++++++++++++++++++++++++++++++-
 1 files changed, 34 insertions(+), 1 deletions(-)

diffs (49 lines):

diff -r df32911077e6 -r dbc25969cb1c doc/guide/files/fixes.xml
--- a/doc/guide/files/fixes.xml Sun Nov 13 03:25:57 2005 +0000
+++ b/doc/guide/files/fixes.xml Sun Nov 13 03:27:20 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.37 2005/11/08 16:39:47 reed Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.38 2005/11/13 03:27:20 minskim Exp $ -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
   <title>Making your package work</title>
@@ -1493,6 +1493,39 @@
         deinstalled.</para>
     </sect2>
     
+    <sect2 id="tex-packages">
+      <title>Packages installing TeX modules</title>
+    
+      <para>If a package installs TeX packages into the texmf tree,
+        the <filename>ls-R</filename> database of the tree needs to be
+        updated.</para>
+      <note><para>Except the main TeX packages such as teTeX-texmf,
+         packages should install files
+         into <varname>PKG_LOCALTEXMFPREFIX</varname>,
+         not <varname>PKG_TEXMFPREFIX</varname>.</para></note>
+      
+      <orderedlist>
+       <listitem><para>Include
+            <filename>../../print/teTeX/module.mk</filename> instead
+            of <filename>../../mk/tex.buildlink3.mk</filename>.  This
+            takes care of rebuilding the <filename>ls-R</filename>
+            database at installation and deinstallation time.</para>
+       </listitem>
+       
+       <listitem><para>If your package installs files into a texmf
+            tree other than the one
+            at <varname>PKG_LOCALTEXMFPREFIX</varname>,
+            set <varname>TEXMFDIRS</varname> to the list of all texmf
+            trees that need database update.</para>
+       </listitem>
+      
+       <listitem><para>Make sure that none of <filename>ls-R</filename>
+            databases are included in <filename>PLIST</filename>, as
+            they will be removed only by the teTeX-bin package.</para>
+       </listitem>
+      </orderedlist>
+    </sect2>
+    
   </sect1>