I'd much rather stick with a single style guide; PEP 8 can be revised as needed. I suggest that we preface the 2.x-specific things with words like "in Python 2, ..." but by and large focus the style guide on Py3k. We could even migrate the rules that are only relevant to 2.x to an Appendix-like chapter. That can then be easily deleted at some point in the future.
On Fri, May 2, 2008 at 5:02 PM, Terry Reedy <[EMAIL PROTECTED]> wrote: > At least one of the style recommendations in PEP 8 -- use class rather that > string exceptions -- is obsolete in Py 3. And there are others, and > perhaps others where the spirit of the recommendation is the same but > details are different. > > For a new Python 3 programmer who does not need or want to know anything > about Python 2, reading about 'string exceptions' would be confusing. > > One possibility for isolation is for each major section to have separate > 2.x and 3.x subsections. But where there are several scattered changes, > this would require large chunks of duplication. For instance, under > > Prescriptive: Naming Conventions > Package and Module Names > Modules should have... > > becomes Modules must have ... (I presume, hence the renaming project). > But all three paragraphs would have to be duplicated in 2.x and 3.x to be > coherent, and then they would not be in their sensible place. > > A couple of paragraphs on, 'because exceptions should be classes' becomes > 'because exceptions are classes'. Again, moving two variants to 2.x and > 3.x sections would be awkward. > > So, especially if PEP 8 is considered more or less frozen, I suggest the > possibility of a new PEP 3008, Python 3 style guide. > > Terry Jan Reedy > > > > _______________________________________________ > Python-3000 mailing list > Python-3000@python.org > http://mail.python.org/mailman/listinfo/python-3000 > Unsubscribe: > http://mail.python.org/mailman/options/python-3000/guido%40python.org > -- --Guido van Rossum (home page: http://www.python.org/~guido/) _______________________________________________ Python-3000 mailing list Python-3000@python.org http://mail.python.org/mailman/listinfo/python-3000 Unsubscribe: http://mail.python.org/mailman/options/python-3000/archive%40mail-archive.com
