[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