Subject: pkg/34159: devhelp does not use installed books
To: None <pkg-manager@netbsd.org, gnats-admin@netbsd.org,>
From: None <khorben@syn.localhost>
List: pkgsrc-bugs
Date: 08/07/2006 17:10:01
>Number:         34159
>Category:       pkg
>Synopsis:       devhelp does not use books from share/doc/*/*.devhelp
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pkg-manager
>State:          open
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Aug 07 17:10:00 +0000 2006
>Originator:     khorben@syn.localhost
>Release:        NetBSD 3.99.23
>Organization:
khorben
>Environment:
System: NetBSD syn 3.99.23 NetBSD 3.99.23 (GENERIC.MPACPI) #7: Sun Aug 6 16:26:28 CEST 2006 khorben@syn:/usr/obj/sys/arch/i386/compile/GENERIC.MPACPI i386
Architecture: i386
Machine: i386
>Description:
Launch devhelp, although the .devhelp file from Gtk+2 is installed in
share/doc/gtk/gtk.devhelp, the documentation is not listed in the interface.
>How-To-Repeat:
Install Gtk+2 and devhelp from pkgsrc.
>Fix:
An ugly work-around is to (taking Gtk+ as an example):
# ln -s ../gtk /usr/pkg/share/doc/html/gtk

devhelp is then apparently unable to properly display embedded images for this
book.

Moreover, the documentation from libglade2 is actually found in share/doc/html
by default. I would check if say freedesktop has established a standard for
development libraries documentation, and maybe if newest devhelp (0.12) fixes
this issue.
I also think it would be more elegant to unify things than to patch devhelp to
look for additional directories.

HTH.

>Unformatted: