Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 414655 - app-portage/gentoolkit - eshowkw undocumented output
Summary: app-portage/gentoolkit - eshowkw undocumented output
Status: UNCONFIRMED
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Tools (show other bugs)
Hardware: All Linux
: Normal minor (vote)
Assignee: Portage Tools Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: 346443
  Show dependency tree
 
Reported: 2012-05-04 23:32 UTC by Matthias Maier
Modified: 2016-02-20 00:27 UTC (History)
3 users (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 Matthias Maier gentoo-dev 2012-05-04 23:32:40 UTC
The output of eshowkw is completely undocumented. Neither the man page nor $ eshowkw --help give a hint on how to interpret the output. This renders part of the output hard to interpret:

An example:


tamiko@bluebird ~ % eshowkw ghc
Keywords for dev-lang/ghc:
            |                           | u   |  
            | a a             p     s   | n   |  
            | l m   h i m m   p s   p   | u s | r
            | p d a p a 6 i p c 3   a x | s l | e
            | h 6 r p 6 8 p p 6 9 s r 8 | e o | p
            | a 4 m a 4 k s c 4 0 h c 6 | d t | o
------------+---------------------------+-----+-------
  6.10.4-r1 | ~ ~ o o ~ o o ~ ~ o o ~ ~ | # 0 | gentoo
  6.12.3    | + + o o + o o + + o o + + | #   | gentoo
  6.12.3-r2 | + + o o + o o + + o o + + | o   | gentoo
   7.0.4    | ~ ~ o o - o o ~ ~ o o ~ ~ | #   | gentoo
[I]7.4.1    | ~ ~ o o - o o ~ ~ o o ~ ~ | o   | gentoo
   7.4.1-r1 | ~ ~ o o - o o ~ ~ o o ~ ~ | o   | gentoo

- I have no idea what the "unused" column is for and why it is showing grey 'o's or purple '#'s.

- It is easy to guess what '[I]' '+' and '~' stand for, but the difference between grey 'o', red '-' and red '*' is a bit tricky to guess.

So I would like to see a small description in the man page and the output of --help, indicating the exact meaning of '+', '~', '0', '-', '*' and [I]. As well as an explanation on what the unused column actually shows..

Reproducible: Always
Comment 1 Paul Varner (RETIRED) gentoo-dev 2012-05-08 21:10:08 UTC
I'll add it to the documentation.  The '#' in the unused column is a version that can be removed from the tree because there is a higher version available with the same keywords.  The 'o' in the unused column means that version is in use by at least one of the keywords being displayed.
Comment 2 Justin Lecher (RETIRED) gentoo-dev 2015-12-05 13:41:27 UTC
There is also coloring of the arch names,

yellow: stable arches
white: dev arch
grey: expn arch