]> granicus.if.org Git - python/commit
Backport source role for linking to files in the cpython repo.
authorÉric Araujo <merwok@netwok.org>
Thu, 18 Aug 2011 22:12:33 +0000 (00:12 +0200)
committerÉric Araujo <merwok@netwok.org>
Thu, 18 Aug 2011 22:12:33 +0000 (00:12 +0200)
commitf595a76d3d56f09cb1565338f911309e9cc65304
tree54044103b6a598dce16d0142cfd8d2b478463c71
parent569ff91a5a89f1cf66cc0481bb33391285dd1468
Backport source role for linking to files in the cpython repo.

Georg added this role in our 3.2 doc tools and gave the greenlight for a
backport on python-dev.

This code is a simplified version of the 3.2 code; the version of Sphinx
used with Python 2.7 doesn’t have the function used to parse markup like
:role:`text to be displayed <text to be processed>` (I was persuaded it
was a standard reST construct, but it is actually a Sphinx innovation
that has to be supported explicitly in role code —I’ll be damned).  It
is thus not possible to write for example :source:`the NEWS file
<Misc/NEWS>`, but :source:`Misc/NEWS` will work.
Doc/tools/sphinxext/pyspecific.py