From: Gavin Sinclair <gsinclair@...>
Date: 2003-01-27T17:33:11+09:00
Subject: My last word on aliases ;)

Hi Dave,

Fair enough, you don't want to group aliases before their target, but
when I view the RDoc for a large module like FileUtils, it's a bit
of a forest/trees scenario.  The basic problem is, the aliases aren't
important enough to justify the amount of screen real-estate they
occupy, and the fact that they are presented just like methods makes
it difficult to subconciously locate the important information on the
screen.

Therefore, I think aliases should be presented along these lines:
  * method name distinguished: grey and italic or something
  * target of alias on the same line as method name
  * an arrow or something instead of text ("Alias for")

Cheers,
Gavin