From: Ryan Davis <ryand-ruby@...>
Date: 2011-10-25T04:00:51+09:00
Subject: Re: [ANN] rdoc 3.10 Released


On Oct 24, 2011, at 08:26 , Matt Neuburg wrote:

> Eric Hodel <drbrain@segment7.net> wrote:
> 
>> * https://github.com/rdoc/rdoc
>> * http://rdoc.rubyforg.org
>> 
>> RDoc produces HTML and command-line documentation for Ruby projects.  RDoc
>> includes the +rdoc+ and +ri+ tools for generating and displaying online
>> documentation.
>> 
>> See RDoc for a description of RDoc's markup and basic use.
> 
> Take a peek at this page:
> 
>  http://ruby-doc.org/core-1.8.7/MatchData.html
> 
> Look at the first instance method, #[]:
> 
> ?mtch is equivalent to the special variable $&, and returns the entire
> matched string. mtch, mtch, and so on return the values of the matched
> backreferences "
> 
> Those nonsensical-looking, repeated "mtch" should be mtch[0], mtch[1],
> mtch[2] etc., but the [n] is getting eaten and turned into a false
> hyperlink.
> 
> I pointed this out via email to James Britt, who confirms that this
> might be something RDoc is doing; is that possible? If so, is a fix
> possible? (Perhaps not, since this might just be a source code comment
> that wasn't expecting RDoc to come along and try to reformat as HTML...)

Please file a bug on github.com/rdoc/rdoc. Thanks.