Clarify where gtk-doc documentation should be installed to match current

practices in pkgsrc.

1 files changed, 12 insertions, 4 deletions

diff --git a/doc/guide/files/gnome.xml b/doc/guide/files/gnome.xml
index bee276782bf..d95485f32bb 100644
--- a/doc/guide/files/gnome.xml
+++ b/doc/guide/files/gnome.xml
@@ -1,4 +1,4 @@
-<!-- $NetBSD: gnome.xml,v 1.2 2006/09/13 23:30:15 wiz Exp $ -->
+<!-- $NetBSD: gnome.xml,v 1.3 2006/09/17 15:48:45 jmmv Exp $ -->
 
 <chapter id="gnome"> <?dbhtml filename="gnome.html"?>
 <title>GNOME packaging and porting</title>
@@ -138,10 +138,18 @@ USE_TOOLS+=gmake</programlisting>
     tool is rather big and the distfile should come with pregenerated
     documentation anyway; if it does not, it is a bug that you ought to
     report.  For such packages you should disable gtk-doc (unless it is
-    the default) and change the location of installed HTML files:</para>
+    the default):</para>
 
-    <programlisting>CONFIGURE_ARGS+=--disable-gtk-doc
-CONFIGURE_ARGS+=--with-html-dir=${PREFIX}/share/doc</programlisting>
+    <programlisting>CONFIGURE_ARGS+=--disable-gtk-doc</programlisting>
+    
+    <para>The default location of installed HTML files
+    (<filename>share/gtk-doc/&lt;package-name&gt;</filename>) is correct
+    and should not be changed unless the package insists on installing
+    them somewhere else.  Otherwise programs as
+    <command>devhelp</command> will not be able to open them.  You can
+    do that with an entry similar to:</para>
+
+    <programlisting>CONFIGURE_ARGS+=--with-html-dir=${PREFIX}/share/gtk-doc/...</programlisting>
   </listitem>
 </itemizedlist>