From 1ea522b951eb8758ad40ba131e4b05097593cb86 Mon Sep 17 00:00:00 2001 From: Stefan Krah Date: Thu, 14 Mar 2013 12:50:00 +0100 Subject: [PATCH] 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. --- pep-0437.txt | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/pep-0437.txt b/pep-0437.txt index ff455aadd..140740c0c 100644 --- a/pep-0437.txt +++ b/pep-0437.txt @@ -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