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:
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..
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.
There is also coloring of the arch names,
yellow: stable arches
white: dev arch
grey: expn arch