[Doc-SIG] rST hyperlink syntax

[David Goodger]

[Alan re: semi-anonymous hyperlinks]
> Well, I think I've come to the conclusion that they're more trouble
> than they're worth

I concur. For now, at least, they'll be relegated to the "Or Not To Do?"
list.

[Garth]
> All we need to ensure correct matching is a rule somewhat like: if a
> target's name doesn't match any link's refname, *and* the target's name
> begins with an underscore, use the nearest preceding link whose refname
> contains the target's name with the underscore stripped.
> 
> How easy is that? :)

Not. For one thing, I wouldn't want to restrict the matching to "the nearest
preceding link". Imagine trying to debug a misbehaving bit of source text
having to remember a rule like that. Ugh. :-}

-- 
David Goodger    goodger@users.sourceforge.net    Open-source projects:
 - Python Docstring Processing System: http://docstring.sourceforge.net
 - reStructuredText: http://structuredtext.sourceforge.net
 - The Go Tools Project: http://gotools.sourceforge.net