Igor Pirnovar wrote:
> What you think is the "maindocpage" is most likely the initial 
> documentation for your application, and it is part of the commented text 
> in front of your "rex.rb".
> 
> rdoc extracts three different kinds of info from your Ruby file:
> 
>   * (1) header or main documentation at the very beginning immediately 
> after the shebang
>   * (2) any comments preceding all classes
>   * (3) any comments before the methods you define

That's not the only way to do things. I like a separate README so that 
someone can find a top-level, greppable help file without going to the 
rdoc or digging in lib/. Also, I don't like all that extra front matter 
in my class definitions.

-- 
       vjoel : Joel VanderWerf : path berkeley edu : 510 665 3407