I've installed evolution with USE="doc" flag enabled but was unable to read documentation. To read documentation I have to install yelp manually. I think this is missing dependency and shall be fixed. Below is suggested diff, I'll attach a bit later: --- evolution-2.2.3-r2.ebuild 2005-08-02 15:18:22.000000000 +0400 +++ evolution-2.2.3-r2.ebuild.new 2005-08-02 15:19:19.000000000 +0400 @@ -47,7 +47,8 @@ gstreamer? ( =media-libs/gstreamer-0.8* =media-libs/gst-plugins-0.8* ) dbus? ( <sys-apps/dbus-0.30 ) - mono? ( >=dev-lang/mono-1 )" + mono? ( >=dev-lang/mono-1 ) + doc? ( gnome-extra/yelp )" DEPEND="${RDEPEND} dev-util/pkgconfig Reproducible: Always Steps to Reproduce:
Created attachment 64929 [details, diff] Patch for evolution-2.2.3-r2.ebuild that fixes RDEPEND issue.
This sort of goes for every gnome app, because yelp is included in gnome meta it often doesn't get noticed. The trade-off is functionality versus amount of deps, since installing the actual user docs is not optional in gnome apps, we get those always, but people who just want evolution on their xfce environment might not like the amount of apps yelp implies (and that's a lot considering it also needs a gecko based browser these day). This was always sort of an intentional oversight, I'd like to hear some more opinions on what we should do here.
But what tools people with xfce desktop uses to look through gnome documentation? With doc USE flag I'm asking portage system to install documentation, but I can not read it without yelp, thus I have to install it manually. I don't see you reasons... If somebody do not want to install yelp he has an evident option to USE="-doc". But Ok. It's worth to wait for other opinions.
'doc' was not intended as a user, but as a developer documentation flag and so it is used here. XFCE is just an example, iirc it even has a decent helpbrowser.
(In reply to comment #4) > 'doc' was not intended as a user, but as a developer documentation flag and so > it is used here. But it disables installation of user documentation, sometimes. May be developers violate policy because it's nescessary to add another flag for user documentation? Or ever substitute doc flag with two. devdoc and usrdoc? But of course gentoo-dev is a better place for this discussion. > XFCE is just an example, iirc it even has a decent helpbrowser. But if it has helpbrowser that allows to read gnome docs, then it's worth to add something like: doc? || ( gnome-extra/yelp xfce-base/helpbrowser other/helpbrowsers )
I don't think we're going to change this, but you're right that the use.desc is a bit ambiguous: doc - Adds extra documentation (API, Javadoc, etc) It's intended to be used for API/Developer documentation, whereas yelp is a user-help browser. OR'ing (||) the dependencies is a slippery slope that I don't think we really want to start on.