From: Dave Thomas <Dave@...>
Date: 2003-09-03T22:34:15+09:00
Subject: Re: RDoc: how to turn off automatic linking for a word?


On Wednesday, September 3, 2003, at 03:15 AM, William Webber wrote:

> On Wed, Sep 03, 2003 at 12:32:23AM +0900, Yuri Leikind wrote:
>> How do I turn off creating a link out of a word that looks like
>> the name of a class I have? Preceding the word with "\" does not work,
>> looks like it handles explicit markup only.
>
> Unfortunately, there's no way to do this that I am aware of,
> short of mangling the name somehow (e.g. prepending a _).
>
Is the problem here that you want to mention the name of a class but 
don't want to link to it, or is it that you have a class whose name is 
also a common word in your comments?

One of the things I'm keen on is to keep the source comments looking as 
natural as possible, so I'm not too keen on having something like:

     Class CGI handles requests in a \CGI environment.

However, if this is a major problem, I guess I'll have to (unless folks 
have a neater way of flagging the "don't link" attribute).

Cheers

Dave