Bug 77289

Summary:	USE flags documentation not up to date
Product:	[OLD] Docs-user	Reporter:	Guy <notellin>
Component:	USE Variable HOWTO	Assignee:	Docs Team <docs-team>
Status:	RESOLVED INVALID
Severity:	normal
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
URL:	http://www.gentoo.org/dyn/use-index.xml
Whiteboard:
Package list:		Runtime testing required:	---

Description Guy 2005-01-09 16:03:37 UTC

With respect to the x11-base/xorg-x11 ebuilds, the USE flag documentation appears to be woefully out of date.

The following flags are not defined:

dlloader
dmx
font-server
insecure-drivers
sdk
truetype-fonts
type1-fonts

The following flag appears to have been superceded and dropped:

truetype

This is a problem as I'm having new messages about CID and local fonts not being present. Now I don't know if it's a USE flag issue or what.

Reproducible: Always
Steps to Reproduce:

Comment 1 Guy 2005-01-09 16:13:48 UTC

Add:

bitmap-fonts

to the above list of undocumented USE flags.

Also, it would be nice to know why the default settings for these undocumented USE flags are off with the sole exception of bitmp-fonts. I would have imagined that at least type1-fonts and possibly truetype-fonts would be on by default.

Comment 2 Ciaran McCreesh 2005-01-10 06:23:51 UTC

These aren't global USE flags. You're looking in the wrong place.

Comment 3 Guy 2005-01-11 05:41:14 UTC

This is a great answer. Not.

If I'm looking in the 'wrong' place, where is the 'right' place?

In the several years that I've been reading the Handbook and associated documentation, why haven't I seen reference to non-global USE flags and where they are documented?

I know the documentation is updated on an on-going basis, and I make a serious effort to keep up with it. I could have easily missed some new change however, consider this:

'truetype' _is_ documented and has apparently been superceded by 'bitmap-fonts', 'truetype-fonts' and 'type1-fonts'.

Really.

Comment 4 Ciaran McCreesh 2005-01-11 06:12:10 UTC

Global USE flags are listed in $(portageq portdir )/profiles/use.desc . Local USE flags are listed in $(portageq portdir )/profiles/use.local.desc . This is all explained in the "USE Flags" part of the handbook, which you can find at http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=2 .