[issue10334] Add new reST directive for links to source code

Changes by Ezio Melotti : -- nosy: +ezio.melotti stage: -> committed/rejected ___ Python tracker ___ ___ Python-bugs-list mailing lis

[issue10334] Add new reST directive for links to source code

Georg Brandl added the comment: OK, I added a "source" role in r86256. It can be used as Alex showed: either like :source:`ast module Python source code ` (with an explicit link title) or like :source:`Lib/ast.py` (where the link title is the file name). -- resolution: -> accepted s

[issue10334] Add new reST directive for links to source code

Éric Araujo added the comment: A directive can take options, for example to control highlighting, display of line numbers, etc. Similar existing constructs like literalinclude are directives. Inline reST things are called roles :) -- nosy: +eric.araujo _

[issue10334] Add new reST directive for links to source code

Alex added the comment: Seems to me it should be an inline directive (or whatever they're called). i.e. it'd be written:: .. seealso:: Latest version of the :sourcecode:`ast module Python source code `. -- nosy: +alex ___ Python tracker

[issue10334] Add new reST directive for links to source code

New submission from Raymond Hettinger : In a few cases where the pure python source code is a helpful adjunct to the documentation, I've added some links using the "seealso" directive: .. seealso:: Latest version of the `ast module Python source code