Dave Thomas wrote:
> 
> On Dec 2, 2004, at 20:07, Michael Neumann wrote:
> 
>> Hi,
>>
>> With the patch below, it's possible to wrap :section: tags like this:
>>
>>   # - - - - - - - - - - - - - - - - - -
>>   # :section: Section-header
>>   # - - - - - - - - - - - - - - - - - -
> 
> 
> Michael:
> 
> I've done something that has the same effect, but which I think is more 
> general.

Great!

> You can now have any number of lines before :section: in the comment 
> block. These will be stripped from the output. In addition, if the same 
> lines appear at the end of the block, they'll be ignored to.

How about this idea:

Lines before a section are handled as usual (how would they be handled? 
Probably best would be to ignore them). Lines after the section are 
included in the section description. Lines with two ## in front are ignored.

This would allow:

   # :section: My Section
   # Description of My Section...
   # ...

or:

   ## This is an rdoc comment
   ##---------------------------------------------
   # :section: My Section
   # Description of My Section
   ##---------------------------------------------

The description (if given) would be included in the Contents and after 
each Section-header.

What do you think?

Regards,

   Michael