homepage

Some proposed changes to the introductory section of the Python 2.7 What's New document. Key changes:
* I updated the Future of Python 2.x section to describe the status quo, rather than preserving the original speculation from 2010
* I added a new section to record the changes made in maintenance releases
* I moved the DeprecationWarning change down to its own section, since it is really independent of Python 2.7 being the last release
Open questions:
* the current wording makes it clear that while it's hard to get features backported, PEP 466 isn't necessarily a one time deal. I'm open to changing that to instead just describe PEP 466 as is, without saying anything about using the PEP process to get other changes backported
* I currently have the "New Features in Maintenance Releases" section near the top. Since it's hyperlinked from the "Future of Python 2.x" section anyway, perhaps I should move it towards the end instead?
It occurred to me while writing this that we'll potentially have an influx of conservative Python users reading the doc this year, as RHEL 7 and CentOS 7 become generally available, finally upgrading the default Python in that ecosystem to 2.7.

Added Brett to the nosy list for feedback, since the porting guide is mostly his work.

Did you intend to upload a diff with the current changes?
My answers:
* Just describe 466. Don't invite trouble.
* Move the section to its logical place in temporal order, with a clear link.

Ah, that *would* explain the lack of comments. I'll upload the missing
patch later today.

New patch, with the new section moved to the end of the file, just before the acknowledgements.
It now has subsections for each relevant PEP, as Ezio's comments made me realise that PEP 434 (the IDLE consistency PEP) also deserved a mention.
I'm happy with this version, so unless someone spots a glaring error in the next few days, I'll push it live.

I think the Idle section is such a great idea I propose to add something similar to future What's New for 3.x. See #21621.

New changeset 7c28b3a92f40 by Nick Coghlan in branch '2.7':
Updates to Python 2.7 What's New preamble
http://hg.python.org/cpython/rev/7c28b3a92f40 

New changeset d23cea976f46 by Nick Coghlan in branch '3.4':
Issue #21569: sync Python 2.7 What's New with 2.7 version
http://hg.python.org/cpython/rev/d23cea976f46
New changeset b167df2912d6 by Nick Coghlan in branch 'default':
Merge issue #21569 from 3.4
http://hg.python.org/cpython/rev/b167df2912d6 

These changes caused this warning (at least on default branch) from Sphinx:
${cpython_working_copy}/Doc/whatsnew/2.7.rst:442: WARNING: undefined label: argparse-from-optparse (if the link has no caption the label must precede a section header)

Huh, I thought I fixed that before pushing. Maybe I missed a commit after
editing...

New changeset 454d4a9a3088 by Nick Coghlan in branch '3.4':
Issue #21569: Fix incorrect cross reference
http://hg.python.org/cpython/rev/454d4a9a3088
New changeset 524d73b8f29e by Nick Coghlan in branch 'default':
Issue #21569: merge from 3.4
http://hg.python.org/cpython/rev/524d73b8f29e