[Doc-SIG] Implicit Link Targets

Tony J Ibbs (Tibs) tony@lsl.co.uk
Thu, 21 Jun 2001 10:41:00 +0100


David Goodger wrote:
...an explanation of how he proposed to make implicit links work...
> Does this allay your misgivings, Tony?

I think so. It's not something I'm *too* worried about (!) - since my
main concern is doc-strings, which don't normally have much sectional
structure, it's something I'm willing to let flow and develop itself, to
some extent. As you say, cross-reference rich documents will be simpler
to read (as text) with this scheme, which is a Good Thing given the
StructuredText principle of "the bare text must be readable".

(btw - the sort of overly formal document structure I was mentioning
last time is a pain for all sorts of reason, anyway, so I hope one
doesn't have to write too many of them).

I *am* glad you're not trying to support "scoping" (i.e., if I reference
"introduction" in *this* section, and there's an "introduction" in
another section, the one in this section gets chosen) since I think this
would make the scheme over-complex.

Tibs

--
Tony J Ibbs (Tibs)      http://www.tibsnjoan.co.uk/
"How fleeting are all human passions compared with the massive
continuity of ducks." - Dorothy L. Sayers, "Gaudy Night"
My views! Mine! Mine! (Unless Laser-Scan ask nicely to borrow them.)