[Doc-SIG] Use cases for inline directive references

[David Goodger]

Great writeup, Alan. May I use it in the spec? A few details need work, but
overall you state the case very well.

As originally specified & implemented, substitution names were simple
reference names (i.e., a single alphanumeric word with internal ".-_" chars
but no whitespace). But I've been thinking (and your examples have
confirmed) that single words are too limited, that arbitrary text should be
allowed. I'll make the mods.

I'm leaning towards carets for syntax though, sorry. :-)

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