070a23b4a0
Clarify dunders.
2016-06-08 10:43:53 -04:00
0aa70aebf1
Relax __all__ location.
...
Put all module level dunders together in the same location, and remove
the redundant version bookkeeping information.
Closes #27187 . Patch by Ian Lee.
2016-06-07 16:25:19 -04:00
efcd31a52f
Issue #27191 : Improve markup of PEP 8, patch by Ian Lee
2016-06-02 19:13:50 -07:00
4088a7dddc
Backed out changeset: c4aef26d128b
...
Unknown interpreted text role "kbd".
2016-05-03 14:10:04 +03:00
65c6f592cd
Use the kbd role.
2016-05-03 10:47:48 +03:00
7690a00d47
PEP-8 Update on Knuth style breaking of a long formula. #issue26780
...
Patch by Brandon Rhodes provides clarity and rationale for this suggestion.
Also fixes the example to use "+", "-" operators which have same precedence
level.
Reviewed by Guido van Rossum.
2016-04-19 23:14:50 -07:00
2caed0265e
Fix typo, resea[r]ch
2016-04-16 05:23:30 +10:00
21bdcd2e9b
Fix typo. Revert my previous diff that removed another example breaking before "and".
2016-04-15 09:54:42 -07:00
c59c4376ad
According to Knuth, it is better to break *before* a binary operator.
2016-04-15 09:43:52 -07:00
1a6cc45d06
Fix style inconsistency with "and" on continuation line.
2016-04-14 10:21:55 -07:00
e1d8f55b86
Just refer to the spec in PEP 484 for straddling annotations instead of repeating the info in PEP 8.
2016-03-21 13:30:24 -07:00
254ad75c22
Gramatical and other improvements given by thefourtheye.
...
Closes #26408
2016-02-22 09:05:45 -05:00
2d2ea7a703
Clarify that stdlib experiments with annotations are not encouraged.
2016-01-05 15:25:40 -08:00
544e54168a
fix grammar
2016-01-05 12:12:27 -08:00
146574f68a
Update rules for function annotations in the light of PEP 484.
2016-01-05 10:33:30 -08:00
8288ff6a15
Update PEP 8 to recommend against trailing whitespace.
2016-01-04 08:59:47 -08:00
e0e78d4b74
Remove outdated motivation for short module names.
2015-10-20 20:24:08 -07:00
9ef9e40080
Separate -> surround.
2015-04-22 14:09:41 -07:00
f80066c3fb
Describe an old but good rule for consistent return statements.
2015-04-06 18:07:10 -07:00
f76f34e7f4
Formatting fixes to new PEP8 text
2015-01-03 13:27:29 +11:00
44c193d765
Incorporate PEP 8 text from Ian Lee to clarify annotation policy
2015-01-03 13:22:31 +11:00
48e4630fce
remove trailing ws
2015-01-02 12:10:41 -06:00
ae0f50ead3
conjugate 'do' correctly ( closes #23149 )
2015-01-02 12:09:41 -06:00
9287cc8ab5
Last patch was by Akira Kitada, not Akira Li.
2014-11-29 19:02:36 -08:00
a4e187da6b
PEP 8 section on string quotes by Akira Li.
2014-11-29 19:01:24 -08:00
d2c09a26cf
Clarify space around colon in slice (severa cases).
2014-08-31 20:18:33 -07:00
422ebe6d79
A few extra clarifications about multiline if and with statements. Also,
...
conform the multiline-if statement conditionals to other recommendations in
the PEP, i.e. that lines in a multiline conditional end with the binary
operator.
2014-08-17 12:24:10 -04:00
a240f27644
PEP 8: try to better explain a somewhat cryptic guideline
2014-08-17 10:41:13 +10:00
4b19deca98
Clarify PEP 8 point about preferring def statements
2014-08-08 21:07:46 +10:00
58cc81fc33
Prefer "is not" over "not ... is". Closes 21540.
2014-05-20 18:14:17 -04:00
65da967dc2
PEP 8: tweak some awkward wording pointed out in private email
2014-05-13 13:36:23 +10:00
13e0bbf3fe
Nice simplification from Nick.
2014-04-27 16:26:18 -04:00
472d1422de
Wording.
2014-04-27 13:37:04 -04:00
eea38be724
Additional clarifications based on discussion amongst the PEP authors.
2014-04-27 13:34:33 -04:00
94af0e93e6
Make PEP 8 follow PEP 257 on docstring endings.
2014-03-02 09:29:33 -08:00
f13f2d6ae5
Bring PEP 8 in line with PEP 257
2014-03-01 10:57:51 -05:00
b7879b52e9
Ethan Furman's latest patch for Issue 19331.
2013-11-01 12:56:37 -04:00
fa09420ca3
Merge
2013-08-02 08:13:25 -07:00
f7025e0fcc
Another PEP 8 typo fix
...
Yay for not saving before committing :P
2013-08-02 20:46:19 +10:00
5dbb9a10f1
Tweak source encoding wording
2013-08-02 20:28:35 +10:00
05d72183a8
Fix typo
2013-08-02 20:20:17 +10:00
7de08107a4
Use Guido's preferred wording re: line length
2013-08-02 20:18:45 +10:00
1730f70421
Always defer to project specific guides
2013-08-02 12:30:37 +10:00
ad0edb7348
Additional PEP 8 tweaks
...
- be explicit that project style guides take precedence
- make a line splitting example consistent with other guidelines
- clarify wording of the def-vs-lambda guideline
2013-08-02 12:26:24 +10:00
5a0c59d25c
Reduce desirability of using 100 chars per line.
2013-08-01 18:12:07 -07:00
69ab45adcc
PEP 8 spelling corrections
2013-08-01 17:32:07 -04:00
fade322fd5
Fix a typo
2013-08-01 23:34:34 +10:00
7dba60ceea
PEP 8 modernisation
...
Thanks to Guido van Rossum, Barry Warsaw, Raymond Hettinger,
Terry Reedy, Thomas Wouters and others for the constructive
feedback :)
2013-08-01 22:25:37 +10:00
3a283f9827
Clarify the wording.
2013-07-09 09:27:16 -04:00
a87fddebef
Relax PEP 8's perceived (but incorrect) prohibition against backslashed.
2013-07-03 13:26:36 -04:00
Barry Warsaw
Berker Peksag
Serhiy Storchaka
Senthil Kumaran
Chris Angelico
Guido van Rossum
Ethan Furman
Benjamin Peterson
Nick Coghlan
Guido van Rossum
Brett Cannon
Terry Jan Reedy