Use Guido's preferred wording re: line length
This commit is contained in:
parent
1730f70421
commit
7de08107a4
19
pep-0008.txt
19
pep-0008.txt
|
@ -162,12 +162,11 @@ These options are highly recommended!
|
|||
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 @@ review tools that present the two versions in adjacent columns.
|
|||
|
||||
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
|
||||
|
|
Loading…
Reference in New Issue