Commit Graph

105 Commits

Author SHA1 Message Date
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
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