From: Clifford Heath <no.spam@...>
Date: 2007-04-03T21:05:07+09:00
Subject: Modify RDoc to pick up my attribute metaprogramming methods?

Those of you who might have used my Chattr gem will
have found that RDoc doesn't find the attributes it
defines. This is because hidden inside RDoc's Ruby
parser (parsers/parse_rb.rb), in parse_statements,
is a case statement that matches the known kernel
metaprogramming methods.

If you want to add to these methods, you can add them
on the command line if you use --accessors, which is
fine if the syntax is the same (parameters are all
Symbols), but mine aren't.

Really I need a way during Chattr's initialization,
to add an accessor and associated block to RDoc, so
RDoc passes an array of params to the block, from
which it can filter the symbols. That way any program
that requires Chattr automagically gets RDoc for
Chattrs methods.

What do you reckon? Is this a good idea? Is there a
better way? Who do I need to contact about the required
RDoc changes - is this core now?

Clifford Heath.