[Python-checkins] peps: Make it clear that the location of the docstring *specification* is a valid

[stefan.krah]

http://hg.python.org/peps/rev/528a18494b0a
changeset:   4797:528a18494b0a
user:        Stefan Krah <skrah at bytereef.org>
date:        Thu Mar 14 12:50:00 2013 +0100
summary:
  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.

files:
  pep-0437.txt |  14 ++++++++------
  1 files changed, 8 insertions(+), 6 deletions(-)


diff --git a/pep-0437.txt b/pep-0437.txt
--- a/pep-0437.txt
+++ b/pep-0437.txt
@@ -43,12 +43,14 @@
 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

-- 
Repository URL: http://hg.python.org/peps