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-" ]
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.