1) Is there any document describing the syntax and rules that rdoc
uses?

2) Is it possible to place the rdoc documentation at the end of the
file (after __END__) as in perl?  This is for two reasons: a) speed up
ruby's compilation of it by not having it parse useless docs and b)
helping the programmer not be swamped when docs are several pages
long.

3) Are there any rules or distribution guidelines for releasing Ruby
modules on the net? (Test suites, directory organization, etc).  Any
info appreciated.

PS.  My port of Perl's Getopt::Declare is close to being done.  I will
put it on rubyforge when I'm done.  Thanks to all who helped me along
the way.  I've fallen in love with ruby.  Matz and all have written
one of the most beautiful languages I had the pleasure of working
with.

PS2.  I work in the computer graphics industry, and as such, as a next
project, I'd like to upgrade ruby's Matrix library which is somewhat
poor, imo.  I'd like to plug in a better C++ Matrix/Vector library
from the net.  I want to become more familiar with ruby's internals,
in the process, too.  So any additional references on doing so would
be useful, too.  If there is a way to expose C++ templates to ruby,
I'd love to hear it, as that would certainly expand the libraries to
be able to choose from.