From: Ryan Davis <ryand-ruby@...>
Date: 2007-12-15T18:16:53+09:00
Subject: Re: RDoc + irb (Was: Fix e2mmap.rb for 1.9)


On Dec 14, 2007, at 03:09 , Hugh Sasse wrote:

> 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.

you should look at evan weaver's rdoc templates. they're frameless. I  
really like the layout and would like to integrate it sans-ajax/ 
(much-)javascript. At the same time we could make sure it is as  
standards compliant and liquid as possible to suit everyone's needs.  
I've been moving up font sizes as well and it would be nice if more  
stuff laid out properly.

> 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.

Yeah. You'd have a lot of problems with that and probably have to  
include a type-inference layer. Seems a bit much. (or, you just punt  
and send the user off to a list of all #to_a methods).

P.S. pls let your mail reader wrap lines for you. it looks better on  
smaller email windows.