From: Matt Armstrong <matt@...>
Date: 2003-01-28T01:57:04+09:00
Subject: Re: My last word on aliases ;)

Gavin Sinclair <gsinclair@soyabean.com.au> writes:

> when I view the RDoc for a large module like FileUtils, it's a bit
> of a forest/trees scenario.

Yes I've been thinking about an RDoc feature that allows the
programmer to organize the method list into functional groups.

E.g. I now have a class with 60 methods, but they divide up into nice
groups of functionality.  The RDoc output is currently a flat list of
methods so this structure is not immediately evident to the reader and
the class appears more complex than it really is.

This would solve the 'alias' problem too, since you could put all the
aliases at the end under a "method aliases" section.