From: Austin Ziegler <austin@...>
Date: 2002-10-23T00:53:36+09:00
Subject: Re: Straight HTML in RDoc?

On Wed, 23 Oct 2002 00:17:11 +0900, Lyle Johnson wrote:
> Is there a way to embed "straight" HTML into RDoc sources (i.e.
> text that RDoc won't try to interpret)? I'm specifically
> interested in embedding a SourceForge URL like this:
> 
> <A href="http://sourceforge.net"> <IMG
> src="http://sourceforge.net/sflogo.php?group_id=61653&amp;type=5"
> width="210" height="62" border="0" alt="SourceForge Logo"> </A> 

No, there isn't. However, the ability to have labeled links has been
added to the CVS head revision, like so:

    Sourceforge[http://sourceforge.net]

This will result in:

    <a href="http://sourceforge.net">Sourceforge</a>

I just tried it with:

    http://image.jpg[http://target]

But, as I rather expected, it didn't work. (Could it be extended to
do so? Sure.) However, one of the things that Dave reminded me is
that rdoc is supposed to be both a commenting format and a
documentation producing format. There are other features that I'd
like to see, but they require explicit markup which could distract
the code-reader, as opposed to the doc-reader. (In particular, I
want to be able to disable crossref matching on a case-by-case
basis.)

-austin
-- Austin Ziegler, austin@halostatue.ca on 2002.10.22 at 11.46.29