>You can more or less do that for rdoc because of the frames. Very
clunky, though.

firstly let me say, rdoc is great. parsing ruby is not an easy task and 
the work that went into rdoc is tremendous, but, it seriously needs an 
overhaul.

it uses constants to store templates in a non-standard format in such a 
way that you cannot for instance load the same template twice in one 
process w/o constant redefinition errors.

it is also quite difficult to write a template. it should all be erb, or 
even better, easily pluggable modules so that haml and company can also 
be used. actually, somebody already hacked this together and it is not a 
big hack (http://coderepos.org/share/wiki/Resh).

it should be easy to add things like syntax highlighted example code 
snippets for instance, and custom navigation schemes, plain html pages, 
etc...

just me 2 cents,
_c
-- 
Posted via http://www.ruby-forum.com/.