Commit Graph

61 Commits

Author SHA1 Message Date
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
Raymond Hettinger dec5ab7a7c SF patch #980695: efficient string concatenation
(Original patch by Armin Rigo).
2004-08-06 18:47:26 +00:00
Kurt B. Kaiser 9c67b23e5a Clarifications resulting from further discussion with Barry Warsaw. 2004-03-30 01:12:22 +00:00
Barry Warsaw e13d881fb8 updated a link 2004-03-27 20:37:02 +00:00
Barry Warsaw bae8037025 A few more minor updates for the Naming Conventions section:
- recommend that all new libraries use the standards, but point out that
  internal consistency with existing standards is more important.

- Use b and B instead of x and X (it's hard to distinguish the case of X in
  some fonts)

- StudlyCaps is another name for CapWords

- Re-order list so Function Names are followed by Method Names.  Also, added a
  few blank lines in the Method Names section, and described how underscores
  should separate words for readability.

- Added that double leading underscore is usually only necessary to resolve
  name conflicts in subclasses.
2004-03-27 20:14:19 +00:00
Kurt B. Kaiser fef61c2a39 Patch 919256
Clarify and standardize the format for names of modules, functions,
methods, and instance variables.

Consistent, I hope, with discussion on python-dev

http://mail.python.org/pipermail/python-dev/2004-March/043257.html

http://mail.python.org/pipermail/python-dev/2004-March/043259.html
2004-03-20 06:42:29 +00:00
Raymond Hettinger a37771e3cb * str.startwith() is less errorprone that slice comparisons but not as fast.
* Fix minor typos.
2003-09-27 02:53:59 +00:00
Barry Warsaw 99ab3d4e0c Setting my address back to barry@python.org for consistency and better
spam fighting defenses.
2003-09-22 04:51:50 +00:00
Barry Warsaw 8e4c8019b1 Added a note on compound statements after remarks from David Goodger.
Make the code samples agree with this recommendation. ;)
2002-10-17 15:32:18 +00:00
Guido van Rossum 36a82afee6 Add ruling about source code encodings. 2002-10-07 13:40:41 +00:00
Fred Drake d5b900cf13 Fix a couple of import statements. 2002-06-22 02:14:49 +00:00
Guido van Rossum 6655f152be Don't use 'strorunicodeobj' as the generic object name. Use just
'obj' -- after all, you don't know that it's a string or unicode
object just yet, that's what the test in these examples is for!
2002-06-04 17:02:07 +00:00
Neal Norwitz 22cf1a49f9 Update for all the various ways of checking for a string/unicode object
in 2.3, 2.2, 2.1/2.0.
2002-06-04 16:57:44 +00:00
Barry Warsaw 842de4b458 Slight change to the string methods recommendation; we mitigate the
recommendation if compatibility with pre-Python 2.0 is necessary.
2002-05-29 16:07:27 +00:00
Guido van Rossum 78c759d636 Two tiny clarifications. 2002-05-24 19:46:20 +00:00