[ruby-talk:00916] Re: RDtool-0.5.0

From: Toshiro Kuwabara <toshirok@...3.so-net.ne.jp>
Date: 1999-11-09 15:39:08 UTC
List: ruby-talk #916
Hi,

> |> I like POD way due to its simplicity.
> |
> |if we accept POD way, do we regard "((<foo>))" as reference to other
> |RD-page or man-page, instead of reference to a section of *same* RD?
> |and to refer to a section, we have to use '((<"section">))'?
> 
> Either OK.  I think "((<foo>))" can be reserved for in-file reference.

So,
  :((<foo>))
     Reference to label "foo" in same document
  :((<"file"/foo>))
     Reference to label "foo" of file "file"??
     This accepts file-path for "file"?? (like '((<"net/smtp.rb"/foo>))')
  :((<file/foo>))
     If "file" is simpe file name (not path), double-quote is omittable.
  :((<text|file/foo>))
     same as POD. if 'text' includes '|' or '/', 'text' must be double-quoted.

Like this??

---
Tosh

In This Thread