I think RDoc is great.  Three questions:

1) How do I put RDoc's for an attribute?

2) Is there a way to tell RDoc to include htmlized source of the entire
file as well (not the just the popup source - the entire file) - on a
separate page.  I find this tremendously useful.  Ideally, the file
pages should have the entire file in html - so I can click and see the
whole thing in context.

3) Any chances of it hyperlinking part of the source code, not just
from the comments?  (I know this is hard to do in Ruby, but RDoc seems
to do a good enough job of heuristicallty guessing...)