From: Ryan Davis <ryand-ruby@...>
Date: 2009-10-09T03:15:33+09:00
Subject: Re: Documenting DSLs


On Oct 8, 2009, at 09:08 , Intransition wrote:

> Has anyone done any work on documenting Ruby DSLs? Eg. RDoc can
> document this:
>
>  # This plugin ...
>  class MyThing < Plugin
>     # This does ...
>     def some
>       ...
>     end
>  end
>
> But if one were to make a DSL out of it, say:
>
>  # This plugin ...
>  plugin 'MyThing' do
>    # This does ...
>    define 'some' do
>      ...
>    end
>  end
>
> Then no RDocy.

Seems you're not in "transition" anymore.

2.1.0 / 2008-07-20
	• 3 Major Enhancements:
		• RDoc now knows about meta-programmed methods, seeRDoc::Parser::Ruby

http://rdoc.rubyforge.org/RDoc/Parser/Ruby.html