"P.J. Eby" <p...@telecommunity.com> writes:

> (For that matter, if anybody knows how to make it not turn *every* PEP
> reference into a link, that'd be good too! It doesn't really need to
> turn 5 or 6 occurrences of "PEP 333" in the same paragraph into
> separate links. ;-) )

reST, being designed explicitly for Python documentation, has support
for PEP references built in:

    The :pep-reference: role is used to create an HTTP reference to a
    PEP (Python Enhancement Proposal). The :PEP: alias is usually used.
    For example:

        See :PEP:`287` for more information about reStructuredText.

    This is equivalent to:

        See `PEP 287`__ for more information about reStructuredText.

        __ http://www.python.org/peps/pep-0287.html

    <URL:http://docutils.sourceforge.net/docs/ref/rst/roles.html#pep-reference>.

-- 
 \     “What is needed is not the will to believe but the will to find |
  `\              out, which is the exact opposite.” —Bertrand Russell |
_o__)                                                                  |
Ben Finney

_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com

Reply via email to