[#3006] mismatched quotation — "stevan apter" <apter@...>

ruby documentation uses a punctuation convention i've never seen

13 messages 2000/05/27

[ruby-talk:02854] Re: dev.rubycentral.com

From: Dave Thomas <Dave@...>
Date: 2000-05-17 14:03:57 UTC
List: ruby-talk #2854
"Conrad Schneiker" <schneiker@jump.net> writes:

> On "module Process" page, when following the link after "See" below
> 
>   setpriority Process.setpriority( kind, anInteger, anIntPriority )
>   -> 0
>        See Process#getpriority.
> 
> I get "Following page cannot be found" at

Yup - that's a bug in the actual book :-(

We differentiate between all the different kinds of names using LaTeX
macros: \CIM{File.tell} is a class instance method, \MMM{GC.start} is
a module method, and so on. The stuff that translates this to XML
relies on this information to work out the file name of the html page: 
a class method will be in a file called ref_c_xxx, and a module method 
in ref_m_xxx. When we get it wrong, the typeset results look the same, 
so we don't notice.

We're going to have to write ourselves some Ruby to check all these
links!

> Likewise for links with embedded "::" in the sections labeled

Separate bug - I wasn't linking module constants correctly.


> When I bookmark these items in Explorer 5, I get:
> 
>     RubyCentral
>     http--dev.rubycentral.com-ref-

I _think_ I've added titles to everything, which should fix this.


Thanks for all the great feedback.



Dave

In This Thread

Prev Next