From: Hugh Sasse <hgs@...>
Date: 2007-12-14T20:09:49+09:00
Subject: Re: RDoc + irb (Was: Fix e2mmap.rb for 1.9)

On Fri, 14 Dec 2007, Ryan Davis wrote:

> 
> On Dec 13, 2007, at 07:09 , Hugh Sasse wrote:
> 
> > When I've looked into rdoc, hoping to be able to modify it to
> > improve the accessibility of the output, at least for my needs, I've
> > found it difficult to see the wood for the trees, i.e. to get a
> > clear idea of how the components fit together.
> 
> agreed Hugh... which is why I'm planning on ripping it apart and tearing it
> down to bare essentials. "planning" in the unscheduled sense of course. :P

Specifically, I was trying to get the case where code is expanded
within the page by clicking a link, to put the code in a div with
scrollbars, "margins: auto;", so that when viewing it with large
print I can access the whole thing. Presently lines get clipped to
the "viewport".  I was hoping to be able to remove frames as well,
which would help when using a text browser.

I have had vague ideas about adding hyperlinks to the code views so
that when a method you are reading calls another, you can jump to
that method, but I think in a dynamic language that is probably "an
open problem" at the moment, because the method could be defined
anywhere, even by method_missing. 

Let it not go unsaid that I think Rdoc is extremely good at what it
does, and if "put together quickly" then I've still a lot to learn. 

        Hugh