[PYTHON DOC-SIG] Structured documentation syntax

[Skip Montanaro]

Ken Manheimer writes:
   
   Having not kept track of the specifics, i don't know what disqualifies
   what i would consider the obvious candidate - angle brackets, eg,
   "<http://www.python.org>".  This is the way i've frequently seen URLs
   distinguished - is there a reason not to use them generally for
   hyperlinks?  Maybe because they specifically imply URLs, or because
   they're already dedicated to some other purpose?

That was my thought also.  I believe the "official" way to distinguish URLs
in otherwise plain ASCII text is with a URL: prefix, as in:

	<URL:http://www.python.org/>

FWIW.

Skip Montanaro     |   Musi-Cal: http://concerts.calendar.com/
skip@calendar.com  |   Conference Calendar: http://conferences.calendar.com/
(518)372-5583      |   Python: http://www.python.org/

=================
DOC-SIG  - SIG for the Python Documentation Project

send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org
=================