Sun Mar 8 15:55:32 2009 UTC ()
Update section about scrollkeeper.


(wiz)
diff -r1.96 -r1.97 pkgsrc/doc/guide/files/fixes.xml

cvs diff -r1.96 -r1.97 pkgsrc/doc/guide/files/fixes.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/fixes.xml 2009/02/23 17:45:17 1.96
+++ pkgsrc/doc/guide/files/fixes.xml 2009/03/08 15:55:32 1.97
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: fixes.xml,v 1.96 2009/02/23 17:45:17 joerg Exp $ --> 1<!-- $NetBSD: fixes.xml,v 1.97 2009/03/08 15:55:32 wiz Exp $ -->
2 2
3<chapter id="fixes"> <?dbhtml filename="fixes.html"?> 3<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
4<title>Making your package work</title> 4<title>Making your package work</title>
5 5
6<sect1 id="general-operation"> 6<sect1 id="general-operation">
7 <title>General operation</title> 7 <title>General operation</title>
8 8
9 <sect2 id="portability-of-packages"> 9 <sect2 id="portability-of-packages">
10 <title>Portability of packages</title> 10 <title>Portability of packages</title>
11 11
12 <para>One appealing feature of pkgsrc is that it runs on many 12 <para>One appealing feature of pkgsrc is that it runs on many
13 different platforms. As a result, it is important to ensure, 13 different platforms. As a result, it is important to ensure,
14 where possible, that packages in pkgsrc are portable. This 14 where possible, that packages in pkgsrc are portable. This
@@ -1568,51 +1568,52 @@ PERL5_PACKLIST= ${PERL5_SITEARCH}/auto/P @@ -1568,51 +1568,52 @@ PERL5_PACKLIST= ${PERL5_SITEARCH}/auto/P
1568 1568
1569 <listitem> 1569 <listitem>
1570 <para>Define the <varname>GCONF_ENTRIES</varname> variable in 1570 <para>Define the <varname>GCONF_ENTRIES</varname> variable in
1571 your <filename>Makefile</filename> with a 1571 your <filename>Makefile</filename> with a
1572 list of all <filename>.entries</filename> files installed by the 1572 list of all <filename>.entries</filename> files installed by the
1573 package, if any. Names must not contain any directories in 1573 package, if any. Names must not contain any directories in
1574 them.</para> 1574 them.</para>
1575 </listitem> 1575 </listitem>
1576 </orderedlist> 1576 </orderedlist>
1577 </sect2> 1577 </sect2>
1578 1578
1579 1579
1580 <sect2 id="scrollkeeper-data-files"> 1580 <sect2 id="scrollkeeper-data-files">
1581 <title>Packages installing scrollkeeper data files</title> 1581 <title>Packages installing scrollkeeper/rarian data files</title>
1582 1582
1583 <para>If a package installs <filename>.omf</filename> files, used by 1583 <para>If a package installs <filename>.omf</filename> files, used by
1584 scrollkeeper, you need to take some extra steps to make sure they 1584 scrollkeeper/rarian, you need to take some extra steps to make sure they
1585 get registered in the database:</para> 1585 get registered in the database:</para>
1586 1586
1587 <orderedlist> 1587 <orderedlist>
1588 <listitem> 1588 <listitem>
1589 <para>Include 1589 <para>Include
1590 <filename>../../textproc/rarian/omf.mk</filename> 1590 <filename>../../mk/omf-scrollkeeper.mk</filename>
1591 instead of its <filename>buildlink3.mk</filename> file. This 1591 instead of rarian's <filename>buildlink3.mk</filename> file. This
1592 takes care of rebuilding the scrollkeeper database at 1592 takes care of rebuilding the scrollkeeper database at
1593 installation and deinstallation time, and disallows any access 1593 installation and deinstallation time, and disallows any access
1594 to it directly from the package.</para> 1594 to it directly from the package.</para>
1595 </listitem> 1595 </listitem>
1596 1596
1597 <listitem> 1597 <listitem>
1598 <para>Check the PLIST and remove any entries under the 1598 <para>Check the PLIST and remove any entries under the
1599 <filename>libdata/scrollkeeper</filename> directory, as they 1599 <filename>libdata/scrollkeeper</filename> directory, as they
1600 will be handled automatically.</para> 1600 will be handled automatically.</para>
1601 </listitem> 1601 </listitem>
1602 1602
1603 <listitem> 1603 <listitem>
1604 <para>Remove the <filename>share/omf</filename> directory from 1604 <para>Remove the <filename>share/omf</filename> directory from
1605 the PLIST. It will be handled by scrollkeeper.</para> 1605 the PLIST. It will be handled by rarian. (<command>make
 1606 print-PLIST</command> does this automatically.)</para>
1606 </listitem> 1607 </listitem>
1607 </orderedlist> 1608 </orderedlist>
1608 </sect2> 1609 </sect2>
1609 1610
1610 1611
1611 <sect2 id="x11-fonts"> 1612 <sect2 id="x11-fonts">
1612 <title>Packages installing X11 fonts</title> 1613 <title>Packages installing X11 fonts</title>
1613 1614
1614 <para>If a package installs font files, you will need to rebuild 1615 <para>If a package installs font files, you will need to rebuild
1615 the fonts database in the directory where they get installed at 1616 the fonts database in the directory where they get installed at
1616 installation and deinstallation time. This can be automatically 1617 installation and deinstallation time. This can be automatically
1617 done by using the pkginstall framework.</para> 1618 done by using the pkginstall framework.</para>
1618 1619