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
Description:   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.

------- Comment #1 From Arun Raghavan 2008-06-01 22:38:16 0000 -------
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.

------- Comment #2 From Arun Raghavan 2008-06-02 08:07:52 0000 -------
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.

------- Comment #3 From Chris Mayo 2008-06-02 17:23:43 0000 -------
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?

------- Comment #4 From Rémi Cardona 2008-06-06 15:00:28 0000 -------
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