From: Dave Thomas <Dave@...>
Date: 2001-12-17T07:51:04+09:00
Subject: [ruby-talk:28718] Re: RDoc - Document Ruby source files

Tobias DiPasquale <anany@ece.villanova.edu> writes:

> Hey Dave, this RDoc rocks the house!!! I will definitely be using
> this over any other documentation system in the future. One thing,
> though: will there eventually be a way for us to customize the
> output HTML? For instance, moving the position of the frames (which
> are currently at the top) or changing the color scheme, or other
> various mundane stuff like that? Basically, what I'm asking is, are
> you going to support RDoc or was it just a "throw it out there" kind
> of thing?

No - I plan to support it (and hope others will too).

The output format is all contained in the single template file
(html_page.rb), and I plan to allow you to be able to specify a
different file using a command line argument. In fact the code is
written to be fairly flexible in many ways, so that you can extend it
to recognize new patterns in the comment blocks and so on.

The reason I released it now was to shake out the parser errors (there
are a number of them) and to get feedback on the markup used in
comment blocks.


Cheers


Dave