On Monday 08 September 2003 06:58 am, Tobias Peters wrote:
> Ryan Pavlik wrote:
> >       method_info <<-DOC
> >         !Method:   initialize
> >         !Title:    Initialize
> >         !Category: constructors
> >         ... and so on ...
>
> I'd rather like
>    method_info <<-DOC
>      Create a new MyClass object giving optional defaults
>      for "a" and "b".
>
>      Category: constructors
>      ... and so on ...
>

Looks like YAML just about.  Save yourself the parsing and go for:

  # Call YAML::load inside method_info ..
  method_info <<-DOC
    Method:   initialize
    Title:    Initialize
    Category: constructors
    Desc: Create a new MyClass object giving optional defaults
          for "a" and "b".
    Parameters:
    - a: 'A: The "a" object; defaults to 5'
    - b: 'B'
  DOC

The parameter list comes back as an array.  Lovely.

Even better, check out the %y{ ... } patch:

   http://whytheluckystiff.net/ruby/ruby-1.8.0-yamlstr.patch

And then:

  method_info %y{
    Method:  initialize
    Title:   Initialize
    ...
  }

_why