Rdoc comments

ruby-talk
1

Hi,

When I generate rdoc-output for:

···

#------------------------------------------------------------
   # :section: Decoration-related methods
   #------------------------------------------------------------

it creates horizontal rules. Is there a way to avoid this? Something like:

   ##-----------------
   # ....
   ##-----------------

where a double '#' is a comment from rdoc.

Regards.

   Michael

2

Could you get away with

    # - - - - - - - - - - - - - - -

or

    # -==================-

Cheers

Dave

···

On Nov 29, 2004, at 18:23, Michael Neumann wrote:

  #------------------------------------------------------------
  # :section: Decoration-related methods
  #------------------------------------------------------------

3

btw: how are sections working out for you? Do you have any examples online?

Cheers

Dave

···

On Nov 29, 2004, at 18:23, Michael Neumann wrote:

  #------------------------------------------------------------
  # :section: Decoration-related methods
  #------------------------------------------------------------

4

Dave Thomas wrote:

  #------------------------------------------------------------
  # :section: Decoration-related methods
  #------------------------------------------------------------

Could you get away with

   # - - - - - - - - - - - - - - -

that would be fine!

Regards,

   Michael

···

On Nov 29, 2004, at 18:23, Michael Neumann wrote:

5

Dave Thomas wrote:

  #------------------------------------------------------------
  # :section: Decoration-related methods
  #------------------------------------------------------------

btw: how are sections working out for you? Do you have any examples online?

I like them. Not sure whether I'll use them extensively.

http://ntecs.de/viewcvs/viewcvs/*checkout*/Wee/trunk/doc/rdoc/classes/Wee/Component.html#SEC00044

Regards,

   Michael

···

On Nov 29, 2004, at 18:23, Michael Neumann wrote:

6

> #------------------------------------------------------------
> # :section: Decoration-related methods
> #------------------------------------------------------------

btw: how are sections working out for you? Do you have any examples
online?

begin # Decoration-related methods
    def f1
    def f2
end

If you gotta say it, say it in the code as much as possible ?