146060 – document symbols for useflag status listed with emerge --verbose

Bug 146060 - document symbols for useflag status listed with emerge --verbose

Summary: document symbols for useflag status listed with emerge --verbose

Status:	RESOLVED FIXED

Alias:	None

Product:	Portage Development
Classification:	Unclassified
Component:	Documentation (show other bugs)
Hardware:	All All

Importance:	High normal (vote)
Assignee:	Portage team

URL:
Whiteboard:
Keywords:	InVCS

Depends on:
Blocks:	136244
	Show dependency tree

Reported:	2006-09-02 17:42 UTC by Vlastimil Babka (Caster) (RETIRED)
Modified:	2006-09-12 16:09 UTC (History)
CC List:	3 users (show)

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

Attachments
/tmp/emerge.1.patch (emerge.1.patch,1.31 KB, text/plain) 2006-09-02 17:46 UTC, Vlastimil Babka (Caster) (RETIRED)	Details
brief description of symbols (emerge.1.patch,1.31 KB, patch) 2006-09-02 22:29 UTC, Zac Medico	Details \| Diff
brief description of symbols (use_symbols.patch,818 bytes, patch) 2006-09-02 22:30 UTC, Zac Medico	Details \| Diff
Show Obsolete (1) View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.

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.