Gimp comes with no help installed, or so it seems. This ebuild downloads the gimp help package, gimp-help-2 (app-doc/gimp-help_2), which is accessible via Help->Help or F1 in The Gimp. Works for me.
Created attachment 33355 [details] app-doc/gimp-help_2/gimp-help_2-0.3.ebuild I'm not sure about the license. This is most definitely NOT gimp-user-manual
Comment on attachment 33355 [details] app-doc/gimp-help_2/gimp-help_2-0.3.ebuild ahh I see, From the help docs: Legal Notice Permission is granted to copy, distribute, and/or modify this document under the terms of the GPL. See GIMP License for more.
Hi, rename the ebuild to: gimp-help-2.0.3.ebuild and use P=gimp-help-${PV/\.0/\-0} into the ebuild please ;) mfg Dietrich
LICENCE is the FDL-1.1 LICENCE="FDL-1.1" mfg Dietrich
ups, sorry it's version 1.2 ;) it's not jet in /usr/portage/licences/ but here: http://www.gnu.org/licenses/fdl.txt mfg Dietrich
gimp.org calls it "gimp help 2 version 0.3" I believe. I'll fix it up if that's what you want. FDL definitely.
the help is still incomplete.. i'm still in dubio if we want the help seperate or not.
foser: Actually, I'd love to see this ebuild gutted and merged with the gimp-2.0.* ebuilds, because IMHO the installation is not complete when pressing Help->Contents gives "Error: Could not find GIMP help files" or whatever it used to say. This will, of course, complicate the gimp ebuild, and require that users recompile gimp when a new -r* comes out just to update the help files. An alternative would be to keep a separate ebuild and make it depend on gimp-help-2.0.3; but I'm not sure (the docs seem to imply it though) if gimp-help-2 depends on gimp-2.
Seen the last logs. Seems like this problem is _not_ slated for correction in 2.0.2. Current work-around? BTW, I agree with John Moser (comment #8), but suggest the dependency be in the opposite direction i.e: make gimp-2 depend on gimp-help-2. This way the ebuilds are seperate as required, but when I emerge gimp 2, I get the necessary help file. TIA
Seems to have been fixed in media-gfx/gimp-2.0.4 with USE="doc". Could the reporter please confirm?
I am not the original submitter, but perhaps I can add something. USE="doc" does indeed include the Gimp help files in the 2.0.4 ebuild. It also adds dependencies for libgtkhtml and gtk-doc. Plus, it compiles Gimp with gtk-doc support. This is great if you really want to use Gimp's internal help system but it isn't necessary as Gimp can be easily configured to use an external browser and all of the help files are regular HTML. So ideally there should be a way to install the help files without including all of the extra dependencies for those who aren't interested (ie. those who don't use Gnome.) When I installed Gimp, I edited the ebuild removing all of the extra dependencies brought in by the "doc" flag and re-emerged. I got the help files but not the extra baggage. This isn't a great solution but it worked for me. :) Perhaps the gimp-help ebuild is the best solution after all. That way the "doc" flag for the Gimp ebuild will still add libgtkhtml and gtk-doc functionality to Gimp but not the help files themselves. They'd have to be emerged seperately... John
Answering foser (comment #7) I believe that there should be a separate package for the help files. The main reason being that it really is a separate package, as per Gimp.org, with different maintainers and consequentelly different release schedules. As John Richard Moser (Comment #8) and ferreira.hugo@mail.telepac.pt (Comment #9) already suggested, I also believe that separate packages making gimp depend on gimp-help when USE="doc" is the more appropriate solution. This would allow up to date help files without unnecessary gimp compilation. Answering Henrik Brix Andersen (Comment #10), I really don't think so as there is also the issue mentioned by John Mastwijk (Comment #11). I am including a new ebuild for gimp-help now. It gives a nice solution to the issue mentioned at Comment #11: the USE="html" flag. I am also including a patch for gimp so it will depend on gimp-help when USE="doc". As far as I can see, this is the most compreensive solution for this bug. Please consider the inclusion of this ebuild and of the patch for gimp in portage.
Created attachment 42924 [details] app-doc/gimp-help_2/gimp-help_2-0.4.ebuild
Created attachment 42925 [details, diff] Make gimp depend on gimp-help_2 instead of merging help files by itself. This patch changes the way gimp-2.0.5.ebuild deals with USE="doc" flag: instead of merging the help files by itself, it just depends on the new gimp-help_2-0.4.ebuild. It saves unnecessary gimp compilations and makes gimp-2.0.5.ebuild much simplier.
after discussing this with a few other devs, help will stay as part of the gimp ebuild. a seperate ebuild will not be created. Thanks for the help and discussion!
I'm aware that there are other discussion channels besides bugzilla so I assume the discussion John N. Laliberte mentioned in Comment #15 ocurred elsewhere. It's a shame because getting this discussion elsewhere blocked any participation I could contribute and probably others also interested in this matter. I would like to ask any of the devs that participated in this discussion somewhere else to, at least, explain the reasoning behind this decision here at this bug so everyone interested will get to know it or point a more appropriate discussion channel where I could get this info so I can bring it back here. Thanks again for the great work, Rodrigo Severo