Bugzilla Bug 123786

wxlib eclass is used to install wxWidgets documentation, but it uses only a
small part of it and with bad manner.

dohtml is used but it only copies files, and don't go recursively and don't
work with directories, in case of other packages cp is used to copy multilevel
html documentation (like python-docs-2.4.2). But i must admit i don't know
exactly how dohtml works, this is only my thought about it and results for
wxGTK ebuild.

Created an attachment (id=83067) [details]
wxWidgets-book-1.ebuild


Ebuild for the book "Cross-Platform GUI Programming with wxWidgets"
by Stefan Csomor, Kevin Hock and Julian Smart published by Prentice Hall
under OPL.

This should go to app-doc/wxWidgets-book/

Created an attachment (id=83068) [details]
wxlib.eclass


Modified version of wxlib.eclass

 - optionally depend on app-doc/wxWidgets-book
 - fix Homepage
 - fix installation of docs

Created an attachment (id=83069) [details]
wxlib.eclass.patch


This patch just show the changes made in wxlib.eclass

Created an attachment (id=83070) [details]
installed-docs.txt


List of files now being installed in /usr/share/doc

$ equery f wxGTK | grep "share/doc"

(From update of attachment 83069 [details])
This patch just shows the changes made in wxlib.eclass

I do not feel adding a book like this comfortable, especially it being a
published one. A separate ebuild perhaps, but it's a simple PDF download from
the O'Reilly network.
Would correctly installing the whole reference manual with doc USE flag
suffice?

Downloading and "installing" a pdf seems quite wasteful.  Lets just make it so
USE=doc installs the documentation that comes with wxwidgets.

(In reply to comment #5)
> This patch just shows the changes made in wxlib.eclass

All these Makefile.*-s that aren't relevant to our build systems takes quite a
bit of space.
I don't find a reason to install anything from the utils/ directory as
documentation (even though it seems like old versions tried to do that). demos
has the same problem as samples.
I will have to try to hack some on the build system probably.
When I'm happy with what files are installed out of samples/ and so on, I will
add an "examples" USE flag for that. USE=doc will just mean if the html
documentation will be downloaded and installed.


Consider HOMEPAGE fixed.

wxGTK-2.6.3.3 should install HTML docs now with USE=doc, and some basic text
files always (changes.txt, etc).

I hope to look at adding examples at some later date. Needs some sorting out in
the build system to do it in a clean manner.

Docs should be covered now, so closing bug :)