Commit Graph

97 Commits

Author SHA1 Message Date
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
Barry Warsaw 5ca34439af Guido suggests alternative language for whitespace around operators. 2012-04-19 13:42:24 -04:00
Georg Brandl 0d61249dee Fix more markup. 2012-03-15 08:24:13 +01:00
Georg Brandl d8498d616a Fix markup. 2012-03-15 08:23:23 +01:00
Georg Brandl 3153cd2e37 Convert PEP 7 and PEP 8 to rst. 2012-03-15 08:18:38 +01:00
Guido van Rossum c606a1fdfe Delete rule forbidding function type annotations in the stdlib. 2012-03-02 10:18:31 -08:00
Barry Warsaw e12e762a54 PEP 8 updates on hanging continuation lines, based on discussion from
python-ideas (contributed by Steven Klass).
2011-06-13 12:48:33 -04:00
Guido van Rossum 848640dd6b Add rules for indenting continuation lines. 2011-06-02 11:09:20 -07:00
Raymond Hettinger bba94bd03d Add PEP 207 guidance on rich comparisons to PEP 8. 2011-04-06 13:53:31 -07:00
Michael Foord cf8828a7e3 Typo correction in pep 8 2011-02-17 23:12:04 +00:00
Raymond Hettinger bbc55dbeb2 Add note about how Control-L gets displayed. Fix whitespace. 2011-02-09 06:50:14 +00:00
Raymond Hettinger 56dcd4ff1e Issue #10899: Function annotations being kept out of the standard library. 2011-01-12 23:22:08 +00:00
Michael Foord 3b0897884e Modify the advice on line continuations to not recommend backslashes.
As discussed with Guido.
Also remove references to Python 2.0, 2.1 and 2.2
2010-11-28 19:45:15 +00:00
Georg Brandl 5e2069ee4c declarations are very rare in Python 2010-11-17 18:26:43 +00:00
Georg Brandl 7c4473de5c Even if utf-8 is the default for Python, it may not be for the editor. 2010-08-29 19:54:09 +00:00
Georg Brandl fe792444b7 Fix typo. 2009-01-22 08:36:39 +00:00