Guido van Rossum
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
Barry Warsaw
254ad75c22
Gramatical and other improvements given by thefourtheye.
...
Closes #26408
2016-02-22 09:05:45 -05:00
Guido van Rossum
2d2ea7a703
Clarify that stdlib experiments with annotations are not encouraged.
2016-01-05 15:25:40 -08:00
Ethan Furman
544e54168a
fix grammar
2016-01-05 12:12:27 -08:00
Guido van Rossum
146574f68a
Update rules for function annotations in the light of PEP 484.
2016-01-05 10:33:30 -08:00
Guido van Rossum
8288ff6a15
Update PEP 8 to recommend against trailing whitespace.
2016-01-04 08:59:47 -08:00
Guido van Rossum
e0e78d4b74
Remove outdated motivation for short module names.
2015-10-20 20:24:08 -07:00
Guido van Rossum
9ef9e40080
Separate -> surround.
2015-04-22 14:09:41 -07:00
Guido van Rossum
f80066c3fb
Describe an old but good rule for consistent return statements.
2015-04-06 18:07:10 -07:00
Chris Angelico
f76f34e7f4
Formatting fixes to new PEP8 text
2015-01-03 13:27:29 +11:00
Chris Angelico
44c193d765
Incorporate PEP 8 text from Ian Lee to clarify annotation policy
2015-01-03 13:22:31 +11:00
Benjamin Peterson
48e4630fce
remove trailing ws
2015-01-02 12:10:41 -06:00
Benjamin Peterson
ae0f50ead3
conjugate 'do' correctly ( closes #23149 )
2015-01-02 12:09:41 -06:00
Guido van Rossum
9287cc8ab5
Last patch was by Akira Kitada, not Akira Li.
2014-11-29 19:02:36 -08:00
Guido van Rossum
a4e187da6b
PEP 8 section on string quotes by Akira Li.
2014-11-29 19:01:24 -08:00
Guido van Rossum
d2c09a26cf
Clarify space around colon in slice (severa cases).
2014-08-31 20:18:33 -07:00
Barry Warsaw
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
Nick Coghlan
a240f27644
PEP 8: try to better explain a somewhat cryptic guideline
2014-08-17 10:41:13 +10:00
Nick Coghlan
4b19deca98
Clarify PEP 8 point about preferring def statements
2014-08-08 21:07:46 +10:00
Barry Warsaw
58cc81fc33
Prefer "is not" over "not ... is". Closes 21540.
2014-05-20 18:14:17 -04:00
Nick Coghlan
65da967dc2
PEP 8: tweak some awkward wording pointed out in private email
2014-05-13 13:36:23 +10:00
Barry Warsaw
13e0bbf3fe
Nice simplification from Nick.
2014-04-27 16:26:18 -04:00
Barry Warsaw
472d1422de
Wording.
2014-04-27 13:37:04 -04:00
Barry Warsaw
eea38be724
Additional clarifications based on discussion amongst the PEP authors.
2014-04-27 13:34:33 -04:00
Guido van Rossum
94af0e93e6
Make PEP 8 follow PEP 257 on docstring endings.
2014-03-02 09:29:33 -08:00
Brett Cannon
f13f2d6ae5
Bring PEP 8 in line with PEP 257
2014-03-01 10:57:51 -05:00
Barry Warsaw
b7879b52e9
Ethan Furman's latest patch for Issue 19331.
2013-11-01 12:56:37 -04:00
Guido van Rossum
fa09420ca3
Merge
2013-08-02 08:13:25 -07:00
Nick Coghlan
f7025e0fcc
Another PEP 8 typo fix
...
Yay for not saving before committing :P
2013-08-02 20:46:19 +10:00
Nick Coghlan
5dbb9a10f1
Tweak source encoding wording
2013-08-02 20:28:35 +10:00
Nick Coghlan
05d72183a8
Fix typo
2013-08-02 20:20:17 +10:00
Nick Coghlan
7de08107a4
Use Guido's preferred wording re: line length
2013-08-02 20:18:45 +10:00
Nick Coghlan
1730f70421
Always defer to project specific guides
2013-08-02 12:30:37 +10:00
Nick Coghlan
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
Guido van Rossum
5a0c59d25c
Reduce desirability of using 100 chars per line.
2013-08-01 18:12:07 -07:00
Terry Jan Reedy
69ab45adcc
PEP 8 spelling corrections
2013-08-01 17:32:07 -04:00
Nick Coghlan
fade322fd5
Fix a typo
2013-08-01 23:34:34 +10:00
Nick Coghlan
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
Barry Warsaw
3a283f9827
Clarify the wording.
2013-07-09 09:27:16 -04:00
Barry Warsaw
a87fddebef
Relax PEP 8's perceived (but incorrect) prohibition against backslashed.
2013-07-03 13:26:36 -04:00
Barry Warsaw
f1d4e5f985
As per BDFL pronouncement (via private email), be explicit that both styles of
...
closing brace/bracket/paren indentation shall be allowed.
2013-04-18 20:31:05 -04:00
Guido van Rossum
8c159aab40
Fix typo (an mix -> a mix).
2013-04-11 15:42:57 -07:00
Georg Brandl
6bf3a71f57
Closes #16950 : update wording about raise syntax.
2013-01-13 11:28:10 +01:00
Georg Brandl
c9c784550d
Closes #16949 : update wording about string exceptions.
2013-01-13 11:27:31 +01:00
Guido van Rossum
1a6a2e8f72
Switch broken examples for spaces around operators. Fixes issue 16239.
2012-10-27 19:04:41 -07:00
Ezio Melotti
7c098c5c15
#16325 : remove outdated link and rephrase paragraph accordingly.
2012-10-28 00:33:29 +03:00
Raymond Hettinger
7cbdcfa301
Fix markup
2012-04-28 00:51:37 -07:00
Antoine Pitrou
36e5f61f80
Make context manager example likelier
2012-04-24 14:08:00 +02:00
Raymond Hettinger
660b6e478c
Note that context manager should be in separate classes if they implement non-obvious behaviors.
2012-04-23 23:34:26 -07:00
Raymond Hettinger
c0b1eb3d65
Restore the prohibition against using function annotations in the standard library.
...
At Guido's request, added notes regarding issues observed with various developer's
early attempts to use function annotations.
2012-04-22 21:32:34 -07:00