From: Dave Thomas <pragdave@...>
Date: 2004-12-04T14:37:33+09:00
Subject: Re: [rdoc] sections-patch


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.

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.

This means that

    # :section: My Section
    # This is the section
    # that I wrote

    # ---------------------------------
    # :section: My Section
    # This is the section
    # that I wrote
    # ---------------------------------

and

    # SECTION SECTION SECTION
    # !!!! !!!! !!!! !!!!
    # :section: My Section
    # This is the section
    # that I wrote
    # SECTION SECTION SECTION
    # !!!! !!!! !!!! !!!!

will all generate the same output.

I've checked the change into the 1.8 and 1.9 HEADs


Cheers

Dave