From 386bc6d38099d9e1f378d3e97654093bb9becbd9 Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Sun, 25 Apr 2010 10:19:53 +0000 Subject: [PATCH] Merged revisions 80150,80460-80461 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r80150 | r.david.murray | 2010-04-17 17:45:38 +0200 (Sa, 17 Apr 2010) | 2 lines Update link to Apple Publication Style guide. ........ r80460 | georg.brandl | 2010-04-25 12:16:00 +0200 (So, 25 Apr 2010) | 1 line #8528: fix typo. ........ r80461 | georg.brandl | 2010-04-25 12:17:27 +0200 (So, 25 Apr 2010) | 1 line #8522: use with statement instead of try-finally for file handling. ........ --- Doc/documenting/style.rst | 2 +- Doc/howto/doanddont.rst | 5 +---- Doc/library/argparse.rst | 2 +- 3 files changed, 3 insertions(+), 6 deletions(-) diff --git a/Doc/documenting/style.rst b/Doc/documenting/style.rst index 593f6dadfea..614555977ab 100644 --- a/Doc/documenting/style.rst +++ b/Doc/documenting/style.rst @@ -66,5 +66,5 @@ Unix 1970s. -.. _Apple Publications Style Guide: http://developer.apple.com/documentation/UserExperience/Conceptual/APStyleGuide/APSG_2008.pdf +.. _Apple Publications Style Guide: http://developer.apple.com/mac/library/documentation/UserExperience/Conceptual/APStyleGuide/APSG_2009.pdf diff --git a/Doc/howto/doanddont.rst b/Doc/howto/doanddont.rst index a9302edbf65..071eb2a1cc1 100644 --- a/Doc/howto/doanddont.rst +++ b/Doc/howto/doanddont.rst @@ -199,11 +199,8 @@ file would not be closed when an exception is raised until the handler finishes, and perhaps not at all in non-C implementations (e.g., Jython). :: def get_status(file): - fp = open(file) - try: + with open(file) as fp: return fp.readline() - finally: - fp.close() Using the Batteries diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst index 0515688d01b..89ab63ae9aa 100644 --- a/Doc/library/argparse.rst +++ b/Doc/library/argparse.rst @@ -1700,7 +1700,7 @@ Upgrading optparse code Originally, the argparse module had attempted to maintain compatibility with optparse. However, optparse was difficult to extend transparently, particularly with the changes required to support the new ``nargs=`` specifiers and better -usage messges. When most everything in optparse had either been copy-pasted +usage messages. When most everything in optparse had either been copy-pasted over or monkey-patched, it no longer seemed practical to try to maintain the backwards compatibility.