Bugzilla Bug 101084

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 an attachment (id=64929) [details]
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.