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 attachment 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 attachment 83068 [details] wxlib.eclass Modified version of wxlib.eclass - optionally depend on app-doc/wxWidgets-book - fix Homepage - fix installation of docs
Created attachment 83069 [details, diff] wxlib.eclass.patch This patch just show the changes made in wxlib.eclass
Created attachment 83070 [details] installed-docs.txt List of files now being installed in /usr/share/doc $ equery f wxGTK | grep "share/doc"
Comment on attachment 83069 [details, diff] wxlib.eclass.patch 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 :)
