Bug 146060

Summary:	document symbols for useflag status listed with emerge --verbose
Product:	Portage Development	Reporter:	Vlastimil Babka (Caster) (RETIRED) <caster>
Component:	Documentation	Assignee:	Portage team <dev-portage>
Status:	RESOLVED FIXED
Severity:	normal	CC:	alextarkovsky, esigra, zlin
Priority:	High	Keywords:	InVCS
Version:	2.1
Hardware:	All
OS:	All
Whiteboard:
Package list:		Runtime testing required:	---
Bug Depends on:
Bug Blocks:	136244
Attachments:	/tmp/emerge.1.patch brief description of symbols brief description of symbols

Description Vlastimil Babka (Caster) (RETIRED) gentoo-dev

2006-09-02 17:42:36 UTC

The symbols were recently updated but it's impossible to know their meaning unless you read bug 144661...

Comment 1 Vlastimil Babka (Caster) (RETIRED) gentoo-dev

2006-09-02 17:46:38 UTC

Created attachment 95799 [details]
/tmp/emerge.1.patch

Patch for man emerge based on commenst in bug 144661.

Comment 2 Zac Medico gentoo-dev

2006-09-02 22:29:12 UTC

Created attachment 95808 [details, diff]
brief description of symbols

I've committed this brief description of the symbols in svn r4381.  Do you think that will be enough?  I'm not sure if it's really necessary to list all the possible combinations.  Note that the list of combinations from bug 144661 doesn't include forced flags (the opposite of masked).

Comment 3 Zac Medico gentoo-dev

2006-09-02 22:30:35 UTC

Created attachment 95809 [details, diff]
brief description of symbols

Here's the correct attachment.

Comment 4 Vlastimil Babka (Caster) (RETIRED) gentoo-dev

2006-09-03 03:27:35 UTC

Yeah that should be enough, certainly better than now :)

Comment 5 Zac Medico gentoo-dev

2006-09-03 15:01:45 UTC

This has been released in 2.1.1_rc1-r3.

Comment 6 Alex Tarkovsky 2006-09-12 15:55:56 UTC

Please consider explicitly documenting all the combinations of annotations given in comment #7 of bug 144661, not just the basics. I find it confusing for instance that the parenthesis () take on different meanings depending on context.