Re: The RDoc Hyphen Anomaly (was Re: RDoc HTML links.)

On Tue, 25 Jul 2006, Dave Howell wrote:

> 
> > No, those four hyphens aren't supposed to do that.
> 
> Aren't supposed to . . . cut off the rest of the file, or aren't supposed to
> generate a horizontal line?
> 
> > --- generates a rule just fine, so long as you don't write a stopdoc when
> > you meant to write an rule.
> 
        [...]
> Well, there's a bug HERE. Of some kind. When you say "the hr problem...RDoc is
> being faithful to its design", am I to understand that four hyphens are
> another way of coding a stopdoc? If that's not what you mean, then I'm just
> not keeping up with you here. RDoc is demonstrating its faithfulness by doing
> . . . what?

I think I'm seeing the same thing, with Sunday's ruby stable snapshot too.

<quote>
#!/usr/local/bin/ruby -w

#
# A fairly normal comment
#
class FirstClass
end

#
#A fairly normal comment - with no leading space
#
class SecondClass
end

#--
#This comment should never appear
#++
class ThirdClass
end

#---
#Three dashes and thee pluses
#+++
class FourthClass
end

#----
#Four dashes and four pluses
#++++
class FifthClass
end
</quote>

I don't see the comemnts for the FourthClass or FifthClass. And I see
one or two plus signs for them.

> 
> it the answer is "no." At this point I guess I'll unpack a brand-new copy of
> 1.8.4, compile it, and see if I get the same results as I do with my current
> copy.

Best get the stable snapshot for something more recent.

ftp://ftp.ruby-lang.org/pub/ruby/stable-snapshot.tar.gz

That's what I was testing against

        HTH
        Hugh