[Python-checkins] peps: Use Guido's preferred wording re: line length

[nick.coghlan]

http://hg.python.org/peps/rev/82e24ac40255
changeset:   5018:82e24ac40255
user:        Nick Coghlan <ncoghlan at gmail.com>
date:        Fri Aug 02 20:18:45 2013 +1000
summary:
  Use Guido's preferred wording re: line length

files:
  pep-0008.txt |  19 ++++++++++++++-----
  1 files changed, 14 insertions(+), 5 deletions(-)


diff --git a/pep-0008.txt b/pep-0008.txt
--- a/pep-0008.txt
+++ b/pep-0008.txt
@@ -162,12 +162,11 @@
 Maximum Line Length
 -------------------
 
-Aim to limit all lines to a maximum of 79 characters, but up to 99
-characters is acceptable when it improves readability.
+Limit all lines to a maximum of 79 characters.
 
 For flowing long blocks of text with fewer structural restrictions
-(docstrings or comments), limiting the line length to 72 characters
-is recommended.
+(docstrings or comments), the line length should be limited to 72
+characters.
 
 Limiting the required editor window width makes it possible to have
 several files open side-by-side, and works well when using code
@@ -175,10 +174,20 @@
 
 The default wrapping in most tools disrupts the visual structure of the
 code, making it more difficult to understand. The limits are chosen to
-avoid wrapping in editors with the window width set to 80 (or 100), even
+avoid wrapping in editors with the window width set to 80, even
 if the tool places a marker glyph in the final column when wrapping
 lines. Some web based tools may not offer dynamic line wrapping at all.
 
+Some teams strongly prefer a longer line length. For code maintained
+exclusively or primarily by a team that can reach agreement on this
+issue, it is okay to increase the line nominal line length from 80 to
+100 characters (effectively increasing the maximum length to 99
+characters), provided that comments and docstrings are still wrapped
+at 72 characters.
+
+The Python standard library is conservative and requires limiting
+lines to 79 characters (and docstrings/comments to 72).
+
 The preferred way of wrapping long lines is by using Python's implied
 line continuation inside parentheses, brackets and braces.  Long lines
 can be broken over multiple lines by wrapping expressions in

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