Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 556352 - FEATURES="nodoc" should also remove /usr/share/gtk-doc
Summary: FEATURES="nodoc" should also remove /usr/share/gtk-doc
Status: CONFIRMED
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Enhancement/Feature Requests (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Portage team
URL:
Whiteboard:
Keywords:
: 597628 (view as bug list)
Depends on:
Blocks:
 
Reported: 2015-07-30 20:21 UTC by Fab
Modified: 2016-10-25 16:59 UTC (History)
2 users (show)

See Also:
Package list:
Runtime testing required: ---

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Fab 2015-07-30 20:21:07 UTC 
Title say it all. portage-2.2.20.

I was surprised on a system with FEATURES="nodoc" to see the following files installed :

> --- /usr/share/gtk-doc/html/
> >>> /usr/share/gtk-doc/html/rsvg-2.0/
> >>> /usr/share/gtk-doc/html/rsvg-2.0/home.png
> >>> /usr/share/gtk-doc/html/rsvg-2.0/index.sgml
> >>> /usr/share/gtk-doc/html/rsvg-2.0/left.png
> >>> /usr/share/gtk-doc/html/rsvg-2.0/right.png
> >>> /usr/share/gtk-doc/html/rsvg-2.0/style.css
> >>> /usr/share/gtk-doc/html/rsvg-2.0/up.png
> >>> /usr/share/gtk-doc/html/rsvg-2.0/rsvg-2.0.devhelp2
> >>> /usr/share/gtk-doc/html/rsvg-2.0/rsvg.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/rsvg-Version-check-and-feature-tests.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/rsvg-Using-RSVG-with-cairo.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/rsvg-Using-RSVG-with-GdkPixbuf.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/rsvg-Using-RSVG-with-GIO.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/object-tree.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/licence.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/index.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/api-index-full.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/api-index-deprecated.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/api-index-2-9.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/api-index-2-8.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/api-index-2-4.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/api-index-2-36.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/api-index-2-32.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/api-index-2-22.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/api-index-2-14.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/annotation-glossary.html
> >>> /usr/share/gtk-doc/html/rsvg-2.0/RsvgHandle.html

Thanks.
Comment 1 Zac Medico gentoo-dev 2015-07-30 20:51:31 UTC 
According to the make.conf man page, nodoc excludes only /usr/share/doc:

nodoc  
 Do not install doc files (/usr/share/doc).
Comment 2 Alexandre Rostovtsev (RETIRED) gentoo-dev 2015-07-30 23:07:24 UTC 
As gnome team member - yes, it would be nice if /usr/share/gtk-doc was filtered by nodoc.

Most gnome ebuilds install gtk-docs unconditionally because (1) build time requirements for gtk-docs in most gnome packages are trivial (if the requirements are not trivial, we add a "doc" USE flag), and (2) the docs are very often quite useful, and (3) a general scheme for controlling gtk-docs via USE flags (two or more flags would be needed to handle different cases) seemed too complicated to be worth it.

But there are specific situations where gtk-docs are undesirable, for example when creating an image for a device with very limited storage. At the moment, users in those situations have to know to add /usr/share/gtk-doc to INSTALL_MASK; nodoc would be more convenient.
Comment 3 Mike Gilbert gentoo-dev 2016-10-25 13:57:52 UTC 
*** Bug 597628 has been marked as a duplicate of this bug. ***
Comment 4 Zac Medico gentoo-dev 2016-10-25 16:59:43 UTC 
As discussed in bug 597628, maybe we should deprecate FEATURES=nodoc, since INSTALL_MASK functionality makes nodoc redundant.