From: Eric Hodel <drbrain@...7.net>
Date: 2009-03-17T03:47:43+09:00
Subject: Re: RDoc (Darkfish) not ordering method by name

On Mar 12, 2009, at 16:12, Clifford Heath wrote:
> 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.

You could use sections for this, yes

> 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.

Darkfish has links to included modules via the sidebar.