Commit Graph

75 Commits

Author SHA1 Message Date
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
Benjamin Peterson 4cbb07b2a1 add a note about constant conventions 2009-01-22 03:33:57 +00:00
Guido van Rossum b4c0b18633 Clarify preferred way to break at a binary operator. 2008-06-06 18:48:49 +00:00
Skip Montanaro fe647edb10 Replace "looks ugly" with a hopefully more concrete explanation of why line
wrapping is bad - it disrupts the visual structure of the code.
2008-02-21 16:21:15 +00:00
Brett Cannon 9fe45a32c3 Make all meta-PEPs be Process PEPs. 2007-06-19 04:52:34 +00:00
Collin Winter 28930199da Convert two usages of StandardError into Exception. 2007-06-12 21:19:21 +00:00
Guido van Rossum 65d78ad8f2 Add policy about non-ASCII names to coding standard. 2007-05-17 16:48:09 +00:00
Andrew M. Kuchling 532382f5dc Fix 'the the' error 2007-04-28 00:36:48 +00:00
Guido van Rossum 38fbef2fb2 Add words discouraging overly-broad except clauses. 2007-04-06 15:09:21 +00:00
Andrew M. Kuchling a2a12a86ea Mention bare except: clauses in PEP 8; see the python-dev archive around Dec. 22 2007 for a short discussion 2007-02-01 21:09:28 +00:00
Andrew M. Kuchling 594770c5ec Wording fix 2007-02-01 21:04:19 +00:00
Andrew M. Kuchling 3be6bcdbc7 Be stricter about string exceptions 2007-02-01 21:03:07 +00:00
Barry Warsaw 4226413f7b Updated the rules for package names and module names, clarifying the use of
underscores.
2007-01-05 14:03:42 +00:00
David Goodger c5b5d3c83d added Last-Modified headers to all PEPs without 2006-03-23 20:13:19 +00:00
Guido van Rossum d9909922de Fix an inconsistency about whether 'cls' is preferred or not. 2006-03-23 18:56:43 +00:00
Guido van Rossum 8adb36ab81 Discourage relative imports. 2006-03-15 22:47:10 +00:00
Guido van Rossum 9feffcd8af /pubic/public/. Thanks Jennings Jared! 2006-03-02 03:46:55 +00:00
Barry Warsaw 9d3a63d38d Remove a bunch of Emacs references. They're unnecessary for making the point. 2005-12-15 15:44:35 +00:00
Barry Warsaw 1bd889d78c Fixed a couple of small tyops. 2005-12-14 22:54:57 +00:00
Guido van Rossum b7714412f7 Some additional tweakage, hopefully non-controversial. 2005-12-14 22:10:16 +00:00
Barry Warsaw 478d6d498e After lengthy discussion on python-dev, here is an update to the Python style
guide.  Hopefully it has been simplified and made more prescriptive, as well
as improved by all the great community suggestions.
2005-12-14 21:12:58 +00:00
David Goodger 7b245bb06d fixed raise syntax examples; closing http://python.org/sf/1264666 2005-08-20 13:48:50 +00:00
Andrew M. Kuchling ac8c835cce Record BDFL opinion on exception-raising style 2005-08-07 13:27:54 +00:00