[Doc-SIG] rST hyperlink syntax

[David Goodger]

Alan brings up some good points about usability. I will be mulling it all
over for a while before I respond in detail. I would very much like to hear
what others think.

Meanwhile, a minor point I'd like to clarify:

Alan Jaffray wrote:
> I'll confess that I don't buy the argument that "allowing explicit markup
> to start with something other than ``.. `` adds complexity".
...
> Keeping the same number of constructs while making some of them simpler seems
> like a reduction of complexity to me,

It's *one more* distinct construct for the parser to catch (and the author &
reader to remember), not the same number, therefore one construct more
complex.

I meant that adding another line-starting construct adds complexity in and
of itself: one more string that a line can't otherwise start with. This
added initial complexity may be offset by the benefits it offers, in which
case there would be a net gain.

-- 
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