[Python-checkins] peps: PEP 8: try to better explain a somewhat cryptic guideline

[nick.coghlan]

http://hg.python.org/peps/rev/111a5667de1e
changeset:   5521:111a5667de1e
user:        Nick Coghlan <ncoghlan at gmail.com>
date:        Sun Aug 17 10:41:13 2014 +1000
summary:
  PEP 8: try to better explain a somewhat cryptic guideline

files:
  pep-0008.txt |  9 ++++++---
  1 files changed, 6 insertions(+), 3 deletions(-)


diff --git a/pep-0008.txt b/pep-0008.txt
--- a/pep-0008.txt
+++ b/pep-0008.txt
@@ -121,9 +121,12 @@
       var_one, var_two,
       var_three, var_four)
 
-This PEP explicitly takes no position on how or whether to further
-visually distinguish continuation lines after multi-line ``if``
-statements.  Some acceptable options include::
+This PEP explicitly takes no position on how (or whether) to further
+visually distinguish continuation lines in the header from the nested suite
+in an ``if`` statement, where the combination of a two character keyword, a
+single space and an opening parenthesis creates a natural 4-space indent for
+the expression in the header.  Some acceptable options in this situation
+include::
 
     # No extra indentation.
     if (this

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