From: Clifford Heath <no@...>
Date: 2009-03-13T08:12:54+09:00
Subject: Re: RDoc (Darkfish) not ordering method by name

Eric Hodel wrote:
> On Mar 9, 2009, at 16:26, I�aki Baz Castillo wrote:
>> Is it possible RDoc not to order the methods by name?
> It isn't possible
> You can group methods by section, but currently Darkfish ignores  
> sections.  A future release will correct this.

As a kinda- feature request, I re-open the same class in
various different subsystems, where the subsystems provide
aspects of the system that can be either required or omitted.
Perhaps a better solution would be to do that with an include,
but anyhow... I'd like to be able to separate the features of
class X that belong to each aspect... is that what sections
are for? If not, I think it'd be nice if that was somehow
possible.

With this, I'd like to see the classname and description,
then a set of aspect/section names, each with a summary
listing of the method names - each method name to jump into
a (possibly global-sorted?) list of method descriptions.

Thoughts? Would anyone else use a feature like this?

A similar feature would allow, for example, to have Array
documentation include links to the Enumerable methods it
includes. Helpful for someone wanting to learn what an Array
can do.

Clifford Heath.