[Python-checkins] CVS: python/nondist/peps pep-0008.txt,1.2,1.3
Guido van Rossum
gvanrossum@users.sourceforge.net
Thu, 05 Jul 2001 13:38:13 -0700
- Previous message: [Python-checkins] CVS: python/nondist/peps pep-0239.txt,1.3,1.4 pep-0240.txt,1.4,1.5 pep-0243.txt,1.3,1.4 pep-0244.txt,1.1,1.2 pep-0245.txt,1.4,1.5 pep-0246.txt,1.2,1.3 pep-0255.txt,1.13,1.14 pep-0256.txt,1.1,1.2 pep-0257.txt,1.3,1.4 pep-0258.txt,1.1,1.2
- Next message: [Python-checkins] CVS: python/dist/src/Doc/lib liburllib2.tex,1.3,1.4
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]
Update of /cvsroot/python/python/nondist/peps
In directory usw-pr-cvs1:/tmp/cvs-serv11303
Modified Files:
pep-0008.txt
Log Message:
Make the section on consistency a separate section, as in the
original. Close an unmatched parenthesis at the very end.
Index: pep-0008.txt
===================================================================
RCS file: /cvsroot/python/python/nondist/peps/pep-0008.txt,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -r1.2 -r1.3
*** pep-0008.txt 2001/07/05 18:56:34 1.2
--- pep-0008.txt 2001/07/05 20:38:11 1.3
***************
*** 17,23 ****
guidelines for the C code in the C implementation of Python[1].
! Note, rules are there to be broken. Two good reasons to break a
! particular rule:
(1) When applying the rule would make the code less readable, even
for someone who is used to reading code that follows the rules.
--- 17,38 ----
guidelines for the C code in the C implementation of Python[1].
! This document was adapted from Guido's original Python Style
! Guide essay[2]. This PEP inherits that essay's incompleteness.
!
!
! A Foolish Consistency is the Hobgoblin of Little Minds
!
! A style guide is about consistency. Consistency with this style
! guide is important. Consistency within a project is more
! important. Consistency within one module or function is most
! important.
!
! But most importantly: know when to be inconsistent -- sometimes
! the style guide just doesn't apply. When in doubt, use your best
! judgement. Look at other examples and decide what looks best. And
! don't hesitate to ask!
+ Two good reasons to break a particular rule:
+
(1) When applying the rule would make the code less readable, even
for someone who is used to reading code that follows the rules.
***************
*** 27,33 ****
opportunity to clean up someone else's mess (in true XP style).
- This document was adapted from Guido's original Python Style
- Guide essay[2]. This PEP inherits that essay's incompleteness.
-
Code lay-out
--- 42,45 ----
***************
*** 378,382 ****
that only the current class accesses an attribute. (But realize
that Python contains enough loopholes so that an insistent user
! could gain access nevertheless, e.g. via the __dict__ attribute.
--- 390,394 ----
that only the current class accesses an attribute. (But realize
that Python contains enough loopholes so that an insistent user
! could gain access nevertheless, e.g. via the __dict__ attribute.)
- Previous message: [Python-checkins] CVS: python/nondist/peps pep-0239.txt,1.3,1.4 pep-0240.txt,1.4,1.5 pep-0243.txt,1.3,1.4 pep-0244.txt,1.1,1.2 pep-0245.txt,1.4,1.5 pep-0246.txt,1.2,1.3 pep-0255.txt,1.13,1.14 pep-0256.txt,1.1,1.2 pep-0257.txt,1.3,1.4 pep-0258.txt,1.1,1.2
- Next message: [Python-checkins] CVS: python/dist/src/Doc/lib liburllib2.tex,1.3,1.4
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]