Bug List: (This bug is not in your last search results)   Show last search results      Search page      Enter new bug
Bug#: 224519
Alias:
Product:
Component:
Status: RESOLVED
Resolution: FIXED
Assigned To: Gentoo Linux Gnome Desktop Team <gnome@gentoo.org>
Hardware:
OS:
Version:
Priority:
Severity:
Reporter: Chris Mayo <mayo@clara.co.uk>
Add CC:
CC:
URL:
Summary:
Status Whiteboard:
Keywords:

Filename Description Type Creator Created Size Actions
gtk-doc-1.10-help-files-dir.patch fix to xmldocs.make to disambiguate docdir patch Arun Raghavan 2008-06-02 08:07 0000 1.98 KB Details | Diff
gtk-doc-1.10-docdir.patch patch help/manual/C/Makefile.in patch Chris Mayo 2008-06-02 17:23 0000 681 bytes Details | Diff
Create a New Attachment (proposed patch, testcase, etc.) View All

Bug 224519 depends on: Show dependency tree
Bug 224519 blocks:
Votes: 0    Show votes for this bug    Vote for this bug

Additional Comments: (this is where you put emerge --info)


Not eligible to see or edit group visibility for this bug.






View Bug Activity   |   Format For Printing   |   XML   |   Clone This Bug

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
Bug List: (This bug is not in your last search results)   Show last search results      Search page      Enter new bug