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 Scope
===== =====
The PEP focuses exclusively on the DSL. Topics like the location of docstrings The PEP focuses exclusively on the DSL. Topics like the output locations of
are outside the scope of this PEP. It is however vital that the DSL is suitable docstrings or the generated code are outside the scope of this PEP.
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 It is however vital that the DSL is suitable for generating custom argument
to existing solutions, thus facilitating a possible inclusion of the relevant parsers, a feature that is already implemented in Cython. Therefore, one of
parts of Cython into the CPython source tree. 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 DSL overview