[Doc-SIG] Use cases for inline directive references
Thu, 15 Nov 2001 23:17:45 -0500
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 firstname.lastname@example.org Open-source projects:
- Python Docstring Processing System: http://docstring.sourceforge.net
- reStructuredText: http://structuredtext.sourceforge.net
- The Go Tools Project: http://gotools.sourceforge.net