Bug 132192

Summary:	equery options unclear / non-obvious, could be expanded
Product:	Portage Development	Reporter:	Danny Sauer <gentoo_bugzilla>
Component:	Tools	Assignee:	Portage Tools Team <tools-portage>
Status:	RESOLVED DUPLICATE
Severity:	enhancement	CC:	esigra
Priority:	Lowest
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description Danny Sauer 2006-05-03 19:16:27 UTC

For months I've tried to determine how to replace "etcat -v" with an equivalent equery command, but have failed.  Doing "equery --help" shows some options, and it's presumed that the help is fairly complete based on the length of the output.  But tonight I looked at the man page (after seeing my question answered using some flags that I didn't know existed), and found that it's not.

Lines like
  "list(l) <local-opts> pkgspec - list all packages matching pkgspec"
should probably be rewritten more in the style of other *nix commands, where instead of <local-opts> there is a bracketed list of actual options.  Such as [-i -I -p -o -f -e -d] or [-<iIpofed>]  It doesn't take much more space to include something like that, and it would be much more helpful.  It would be helpfu to the new user, in that it would give her something to look up on the man page; and would be helpful to an experienced user in jogging his memory as to which letter those developers used.

Comment 1 Jakub Moc (RETIRED) gentoo-dev

2006-05-04 00:00:30 UTC

Not a documentation product bug.

Comment 2 michael@smith-li.com 2009-05-25 22:02:20 UTC

Let's call this solved when 269071 is resolved. They're not exactly the same thing, but this one will never be resolved on its own. Rather, the rewrite of equery and its subsequent documentation rewrite should illuminate problems like this...

*** This bug has been marked as a duplicate of bug 269071 ***