Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 117198 - equery: suggest add headers to list command
Summary: equery: suggest add headers to list command
Status: RESOLVED FIXED
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Enhancement/Feature Requests (show other bugs)
Hardware: All Linux
: High enhancement with 1 vote (vote)
Assignee: Portage Tools Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-12-30 07:17 UTC by Peter Hyman
Modified: 2010-03-06 15:27 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 Peter Hyman 2005-12-30 07:17:48 UTC
The output of equery list is not 100% clear. The columns would be more clear with a header line.

Current output:
mars peter # equery l gentoolkit                              
[ Searching for package 'gentoolkit' in all categories among: ]
 * installed packages
[I--] [  ] app-portage/gentoolkit-0.2.0-r3 (0)

Proposed enhancement:
mars peter # /usr/local/bin/equerylist l gentoolkit
[ Searching for package 'gentoolkit' in all categories among: ]
 * installed packages
 INS  MASK Ebuild Name and (SLOT)
[I--] [  ] app-portage/gentoolkit-0.2.0-r3 (0)

In particular, the second [  ] is explained, and the (SLOT) is explained. I could not find what the (0) stood for in the doc. Only by reading the source could I figure it out.

Trivial diff output follows. If you consider, you may wish to include some highlighting or other format. If not, consider adding a clarification in the docs about what the display means (similar to the way man emerge explains the bracketed columns).

--- /usr/bin/equery     2005-11-11 05:45:48.000000000 -0500
+++ /usr/local/bin/equerylist   2005-12-30 10:10:52.000000000 -0500
@@ -1200,6 +1200,7 @@
 
     def _generic_print(self, header, exclude, matches, rx, status):
         print_info(1, header)
+        print_info(1, " INS  MASK Ebuild Name and (SLOT)")
 
         pfxmodes = [ "---", "I--", "-P-", "--O" ]
         maskmodes = [ "  ", " ~", " -", "M ", "M~", "M-" ]
Comment 1 Douglas Anderson 2010-03-06 15:27:58 UTC
For gentoolkit 0.3.0, the man page has been completely rewritten with a much clearer explanation of each field. Moreover, a new --format option to list and hasuse will necessitate a least a brief mention of each field in the --help screen. Since the information is now available to anyone who makes even the slightest effort to look for it (which it was not before), I think I'm going to leave the output uncluttered, and call this FIXED.