Installing for exemple x11-libs/cairo-1.12.10-r1 on a nodoc FEATURES host remove /usr/share/doc from this package but not /usr/share/gtk-doc. Need to manually add /usr/share/gtk-doc to INSTALL_MASK Reproducible: Always
FEATURES=nodoc is about everything in /usr/share/doc/$PF, and doesn't concern itself with anything outside it.
As with other things using gtk-doc, installing it in a place different than /usr/share/gtk-doc/${PN} would i.e. break devhelp.
We could make gtk-doc installation dependent on USE=doc
(In reply to comment #3) > We could make gtk-doc installation dependent on USE=doc That seems to be the right thing to do.
(In reply to comment #3) > We could make gtk-doc installation dependent on USE=doc Please don't do that. We (gnome team) just spent a lot of effort removing useless doc flags from our ebuilds; it's sad to see cairo go the other way. See http://wiki.gentoo.org/wiki/Gnome_Team_Policies for the reasoning. If you don't want gtk-docs installed, just use INSTALL_MASK, like you would to prevent man pages or header files from being installed.
(In reply to comment #5) > (In reply to comment #3) > > We could make gtk-doc installation dependent on USE=doc > > Please don't do that. We (gnome team) just spent a lot of effort removing > useless doc flags from our ebuilds; it's sad to see cairo go the other way. Here it's not a only cairo request, but a generic one. $ find /usr/share/gtk-doc/ -type f | xargs qfile -v | awk '{print $1}' | sort -u app-emulation/libvirt-0.10.2.1 app-i18n/enca-1.13-r3 app-text/evince-2.32.0-r4 app-text/gtkspell-2.0.16 dev-lang/orc-0.4.16-r1 dev-libs/atk-2.4.0 dev-libs/glib-2.32.4-r1 dev-libs/gobject-introspection-1.32.1 dev-libs/libcroco-0.6.5 dev-libs/libunique-1.1.6-r1 dev-python/pygobject-2.28.6-r52 dev-python/pygtk-2.24.0-r2 dev-util/gtk-doc-1.18-r1 gnome-base/gconf-3.2.5 gnome-base/libglade-2.6.4 gnome-base/librsvg-2.36.1 gnome-extra/libgsf-1.14.23 media-gfx/gimp-2.6.12-r5 media-libs/gst-plugins-base-0.10.35 media-libs/gstreamer-0.10.35 net-libs/farstream-0.1.2-r1 net-libs/libnice-0.1.2 net-libs/libsoup-2.38.1 net-libs/loudmouth-1.4.3-r2 net-libs/telepathy-glib-0.18.1 net-libs/webkit-gtk-1.8.3-r300 x11-libs/cairo-1.10.2-r3 x11-libs/gdk-pixbuf-2.26.4 x11-libs/goffice-0.8.17-r1 x11-libs/goocanvas-0.14 x11-libs/gtk+-2.24.12 x11-libs/gtk+-3.4.4 x11-libs/gtkglext-1.2.0 x11-libs/gtksourceview-2.10.5-r2 x11-libs/libnotify-0.7.5 x11-libs/libwnck-2.31.0 x11-libs/pango-1.30.1 x11-libs/vte-0.28.2-r204 > See http://wiki.gentoo.org/wiki/Gnome_Team_Policies for the reasoning. > > If you don't want gtk-docs installed, just use INSTALL_MASK, like you would > to prevent man pages or header files from being installed.
(In reply to comment #5) > Please don't do that. We (gnome team) just spent a lot of effort removing > useless doc flags from our ebuilds; it's sad to see cairo go the other way. That brings us back to the age old question whether USE=doc should control building or installing of documentation beyond what the user would normally expect. I have no strong opinion either way. However: > See http://wiki.gentoo.org/wiki/Gnome_Team_Policies for the reasoning. "for developer audience" I can understand why a user would not want that installed on his system.
Some weeks ago, while discussing this between us on gnome team, we thought on splitting "doc" USE flag to provide a new "api-docs" one that would allow people don't wanting to install that kind of docs to drop them... but this change would have need discussion in mailing list as would affect more packages.
Let's follow the Gnome team's policy on this. If anyone wants this changed, they need to bring it up on the gentoo-dev mailing list.
