Make it clear that the location of the docstring *specification* is a valid

topic for this PEP. After all, some people prefer to include docstrings inside
the DSL comment.
This commit is contained in:
Stefan Krah 2013-03-14 12:50:00 +01:00
parent 7298016028
commit 1ea522b951
1 changed files with 8 additions and 6 deletions

View File

@ -43,12 +43,14 @@ section of this PEP.
Scope
=====
The PEP focuses exclusively on the DSL. Topics like the location of docstrings
are outside the scope of this PEP. It is however vital that the DSL is suitable
for generating custom argument parsers, a feature that is already implemented
in Cython. Therefore, one of the goals of this PEP is to keep the DSL close
to existing solutions, thus facilitating a possible inclusion of the relevant
parts of Cython into the CPython source tree.
The PEP focuses exclusively on the DSL. Topics like the output locations of
docstrings or the generated code are outside the scope of this PEP.
It is however vital that the DSL is suitable for generating custom argument
parsers, a feature that is already implemented in Cython. Therefore, one of
the goals of this PEP is to keep the DSL close to existing solutions, thus
facilitating a possible inclusion of the relevant parts of Cython into the
CPython source tree.
DSL overview