[Doc-SIG] URI schemes (was Re: [Docstring-develop] DPS -
possible bugs/features)
David Goodger
goodger@users.sourceforge.net
Tue, 25 Sep 2001 19:20:49 -0400
Thanks for the references.
Tony J Ibbs (Tibs) wrote:
> The third way (not that I'm recommending *it*, either), is to
> identify a "common subset" of schemes that we recognise. ...
>
> A fourth way (again, not necessarily one I'm advocating - but it's
> only moderately yucky) would be to say "these 'common' schemes are
> recognised as-is/inline, but if you want an 'odd' scheme, you need
> to delimit your uri" - in the context of reST, I guess that would
> mean something like::
>
> :uri:`strange-scheme:hum-ti-hum`
These are certainly worth further consideration. Although it's easy
for me to glibly say, "If you want something like 'a:b' in your text,
use inline literals as in ``a:b``", it would be better to avoid such
accidents in the first place. The "signal:noise" example always comes
to mind. An explicit "uri" role would be useful to have as an example,
as well.
--
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