Bug 170176 – Sentence about USE flags incomprehensible

• Product: [OLD] Docs on www.gentoo.org
• Status: RESOLVED FIXED

[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) 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) 2007-03-10 01:55:30 UTC]

Fixed in CVS.

[Comment 3 Xavier Neys (RETIRED) 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) 2007-03-10 09:13:27 UTC]

Sorry, I didn't mean to reopen.