Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 170176 - Sentence about USE flags incomprehensible
Summary: Sentence about USE flags incomprehensible
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: nm (RETIRED)
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-03-09 20:59 UTC by Joachim Ziegler
Modified: 2007-03-10 09:13 UTC (History)
1 user (show)

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


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Joachim Ziegler 2007-03-09 20:59:15 UTC
Look at 

Code Listing 10: Checking the existence of a doc USE flag

The sentence

"You can also create a directory called /etc/portage/package.use and list it in a file inside this directory."

is incomprehensible without reading the USE falgs chapter. What does "it" refer to in this sentence?


Futhermore. the example cited says

# emerge -vp alsa-lib
[ebuild  N    ] media-libs/alsa-lib-1.0.9_rc3  +doc -jack 674 kB

On my machine, the output is

[ebuild  N    ] media-libs/alsa-lib-1.0.14_rc USE="-debug -doc" 697 kN

The handbook should be adapted to the current output.


Reproducible: Always
Comment 1 nm (RETIRED) gentoo-dev 2007-03-10 01:42:34 UTC
Dunno who thought package.use was a directory, but this is definitely inaccurate and should be fixed.
Comment 2 nm (RETIRED) gentoo-dev 2007-03-10 01:55:30 UTC
Fixed in CVS.
Comment 3 Xavier Neys (RETIRED) gentoo-dev 2007-03-10 08:58:32 UTC
The full 2 line paragraph is:
"You can enable or disable the doc USE flag either globally in the /etc/make.conf file or per package in the /etc/portage/package.use file. You can also create a directory called /etc/portage/package.use and list it in a file inside this directory. The USE Flags chapter covers this aspect in detail."

I don't see how "it" could be anything else but the USE flag.
Maybe the German version will be clearer to you.

The example was just an example.

(In reply to comment #1)
> Dunno who thought package.use was a directory, but this is definitely
> inaccurate and should be fixed.

man portage
Comment 4 Xavier Neys (RETIRED) gentoo-dev 2007-03-10 09:13:27 UTC
Sorry, I didn't mean to reopen.