It looks as if the devhelp ebook-libgnomeui ebuild is improperly configured. While the index displays in devhelp, contents don't. If I run devhelp from the cmd line and try to open the Gnome User Interface Library Reference I get the following error: Error opening url 'http://developer.gnome.org/doc/API/libgnomeui//libgnomeui.html' This URL is 404 anyway, and shouldn't devhelp be looking for the files installed locally instead of out on the Internet?
Whats the rationale behind assigning it to us? Don't just reassign. We didn't add this, we don't maintain it. Personally i don't even understand why this is in the tree, because it's already available in the source build. But I brought that up before without any response (from mholzer?).
sorry, i hate it when ChangeLog is incomplete Revision 1.1 - (download), view (text) (markup) (annotate) - [select for diffs] Thu May 9 21:45:19 2002 UTC (22 months ago) by bass Branch: MAIN Added ebuild files
Been trying to sort this stuff out, and it's a bit of a mess. It looks as if devhelp by default looks at documentation in /usr/share/gtk-doc/html, which is fine. It apparently referneces local files there, as it should. Subsequently emerged ebook packages, however, are put in /usr/share/devhelp/books, and _all_ the xml indexes for these ebooks, or at least ever one I looked at, refernece a remote base URL rather than the locally loaded files. For example, /usr/share/devhelp/books/libgnome/libgnome.devhelp contains: <book title="Gnome Library Reference Manual" name="libgnome" base="http://developer.gnome.org/doc/API/libgnome/" link="libgnome.html"> It looks as if these ebooks are being loaded from the Internet, hence if I'm offline for any reason, I won't be able to read them, even though pretty much the same files are loaded locally. In a couple of cases, notably the libgnomeui ebook and the gtk2 ebook the xml indexes appear to be out of sync with the filenames at developer.gnome.org and the information won't display. I can fix this on a book by book basis by replacing the base URL with something like "file:///usr/share/devhelp/books/libgnome" or the equivalent, but IMHO if the ebook files are going to be loaded onto the local system, the URLs should be patched in the ebuild to reference them rather than relying remote copies. There also appears to be some duplication. The app-doc/ebook-gtk ebuild appears to duplicate many of the chapter titles and headers in /usr/share/gtk-doc and it's unclear which reference is more current.
book.devhelp patched before install to fix the correct location. hugs :)
