Bug 224519 - dev-util/gtk-doc-1.10-r1 installs extra /usr/share/doc/ directory
|
Bug#:
224519
|
Product: Gentoo Linux
|
Version: 2007.0
|
Platform: All
|
|
OS/Version: Linux
|
Status: RESOLVED
|
Severity: trivial
|
Priority: P2
|
|
Resolution: FIXED
|
Assigned To: gnome@gentoo.org
|
Reported By: chris@mayos.plus.com
|
|
Component: Ebuilds
|
|
|
URL:
|
|
Summary: dev-util/gtk-doc-1.10-r1 installs extra /usr/share/doc/ directory
|
|
Keywords:
|
|
Status Whiteboard:
|
|
Opened: 2008-06-01 19:16 0000
|
gtk-doc-1.10-r1 installs:
/usr/share/doc/gtk-doc/fdl-appendix.xml
/usr/share/doc/gtk-doc/gtk-doc-manual.xml
as well as:
/usr/share/doc/gtk-doc-1.10-r1/
Adding G2CONF="--docdir=/usr/share/doc/${PF}"
to src_compile() fixed this for me.
Thanks for the investigation. However, from Makefile.in it appears the correct
directory might be different:
@ENABLE_SCROLLKEEPER_TRUE@docdir = $(datadir)/gnome/help/$(docname)/$(lang)
I wonder why this isn't being automatically used, though.
Created an attachment (id=155205) [details]
fix to xmldocs.make to disambiguate docdir
I think this patch should fix the issue (requires an eautoreconf).
@team, if you think this is fine, I'll submit the patch upstream.
Created an attachment (id=155257) [details]
patch help/manual/C/Makefile.in
Here's another thought:
docdir = @docdir@
comes after:
@ENABLE_SCROLLKEEPER_TRUE@docdir = $(datadir)/gnome/help/$(docname)/$(lang)
resetting it. Just reversing the order of these two seems to work:
/usr/share/gnome/help/gtk-doc-manual/C/fdl-appendix.xml
/usr/share/gnome/help/gtk-doc-manual/C/gtk-doc-manual.xml
Although even with a gnome2_scrollkeeper_update added it doesn't show up in
yelp?
I just went for the simple way out : gtk-doc-1.10-r2 no longer installs the
gtk-doc-manual that could have been viewed with yelp.
1) the current build uses the very *very* old scrollkeeper makefiles and I
don't want to touch them with a 10-foot pole. I don't think it's ever worked
properly as far as gtk-doc is concerned.
2) upstream actually fixed the manual by using gnome-doc-utils which is a bit
cleaner (and it handles a lot of the scrollkeeper details on its own) but the
patch is just too big.
3) the missing manual is available here :
http://library.gnome.org/devel/gtk-doc-manual/stable/
Of course, we'll add those files back when gtk-doc 1.11+ is released. I just
don't want any of us to waste a lot of time on this.
Thanks