[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.)