From: Joel VanderWerf <vjoel@...>
Date: 2008-06-14T09:44:10+09:00
Subject: Re: rdoc breaks on some types of links

Joel VanderWerf wrote:
> Ryan Davis wrote:
>>
>> On May 13, 2008, at 18:20 , Joel VanderWerf wrote:
>>
>>> Not sure exactly which link is causing this, but it seems like bug in 
>>> rdoc (and it wasn't a problem in earlier versions):
>>>
>>> /usr/local/lib/ruby/gems/1.8/gems/rdoc-2.0.0/lib/rdoc/markup/to_html.rb:50:in 
>>> `gen_url': uninitialized constant RDoc::Markup::ToHtml::HTML (NameError)
>>>        from 
>>> /usr/local/lib/ruby/gems/1.8/gems/rdoc-2.0.0/lib/rdoc/markup/to_html.rb:86:in 
>>> `handle_special_TIDYLINK'
>>
>> do you know how to repro that?
>>
>> was it a specific gem installed or command that caused it?
>>
>> Also, filing a bug is preferred.
> 
> Sorry, that was very vague. I was hoping that it was something obvious 
> about that line.
> 
> Will try to reproduce it and file a bug if I can make it concise....
> 
> Where should it be finding that constant, RDoc::Markup::ToHtml::HTML, 
> anyway? The file markup/to_html.rb doesn't seem to define it, and grep 
> doesn't find it:
> 
> $ grep -P '(class|module).*HTML' **/*.rb
> generator/chm.rb:class RDoc::Generator::CHM < RDoc::Generator::HTML
> generator/html/hefss.rb:module RDoc::Generator::HTML::HEFSS
> generator/html/html.rb:module RDoc::Generator::HTML::HTML
> generator/html/kilmer.rb:module RDoc::Generator::HTML::KILMER
> generator/html/one_page_html.rb:module RDoc::Generator::HTML::ONE_PAGE_HTML
> generator/html.rb:class RDoc::Generator::HTML
> generator/html.rb:class RDoc::Generator::HTMLInOne < RDoc::Generator::HTML
> generator/xml.rb:class RDoc::Generator::XML < RDoc::Generator::HTML
> markup.rb:# strike-through text.  When then subclass the HTML output 
> class to deal
> markup/to_flow.rb:    # required. This is a no-op in the base class, but 
> is overridden in HTML
> markup/to_html.rb:  # required. This is a no-op in the base class, but 
> is overridden in HTML

Ok found the cause of the bug, if it is a bug (maybe it's just a change 
in 2.0).

$ cat bug.rb
# [{foo/}[link:foo/]]
def bar
end

I'll file this on the tracker.

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