[gentoo-dev] Undocumented and unused USE variables

2012-03-16 Thread Christoph Niethammer
Hello.

Currently I am doing a from scratch installation of gentoo.

While setting up my USE flags I noticed, that some default USE flags in the 
default environment (default/linux/amd64/10.0/desktop/kde) are neither
documented (in /usr/portage/profiles/use.desc) nor used in IUSE by any package 
(amd64).

I am wondering if they are a leftover from older/outdated packages and could 
be removed.

Here is the list of USE flags I identified at my system:

* Undocumented use flags:
--
amd64
consolekit
declarative
gdu
kipi
mudflap
nptlonly
pango
phonon
pppd
qt3support
sysfs
xorg

* Unused and undocumented USE flags:
--
amd64
mudflap
sysfs


For those who want to search on their system I attached two scripts:
* find_undocumented_uses.sh : 
searches for use flags which are active but not documenten in
/usr/portage/profiles/use.desc.
* find_unused_uses.sh :
Checks for given USE flags if they are found in any ebuild's IUSE 
statment

find_undocumented_uses.sh
Description: application/shellscript


find_unused_uses.sh
Description: application/shellscript


Re: [gentoo-dev] Undocumented and unused USE variables

2012-03-16 Thread Christoph Niethammer
Hello.

I see. There is more documentation on a per package bases wich has to be 
considered, too. (Found already the metadata.xml files.)

As with the pango USE they may differe in their description - maybe also in 
their meaning for different packages. So local USE flags should only be used on 
a per package basis!

Here the euse command is realy handy. :-)
However the sysfs USE flag is still hiding its documentation.
So lets see if this is a bug or a feature. ;-)

Thx for the clarification so far.

Best regards
Christoph

René Neumann li...@necoro.eu schrieb:

 * Undocumented use flags:
 --
 pango


% euse -i pango
global use flags (searching: pango)

no matching entries found

local use flags (searching: pango)

[+  D   ] pango
app-i18n/fcitx: Enable support for x11-libs/pango
  3.6.3 [gentoo]
  3.6.4 [gentoo]
[+  ] 4.0.0 [gentoo]
[+  ] 4.0.1 [gentoo]
[+  ] 4.2.0-r2 [gentoo]
[+  ] 4.2.1 [gentoo]

[+  D   ] pango
media-gfx/fontforge: Enable pango font rendering
[+  ] 20100501 [gentoo]
[+  ] 20110222 [gentoo]
[+  ] 20110222-r1 [gentoo]

[+  D   ] pango
media-gfx/imagemagick: Enable Pango support using x11-libs/pango

[...]