[Python-checkins] r45579 - python/trunk/Doc/whatsnew/whatsnew25.tex

[andrew.kuchling]

Author: andrew.kuchling
Date: Thu Apr 20 15:36:06 2006
New Revision: 45579

Modified:
   python/trunk/Doc/whatsnew/whatsnew25.tex
Log:
Add some items; add "New module" consistently; make contextlib.closing example more interesting and more correct (thanks Gustavo!); add a name

Modified: python/trunk/Doc/whatsnew/whatsnew25.tex
==============================================================================
--- python/trunk/Doc/whatsnew/whatsnew25.tex	(original)
+++ python/trunk/Doc/whatsnew/whatsnew25.tex	Thu Apr 20 15:36:06 2006
@@ -865,9 +865,12 @@
 and calls \code{\var{object}.close()} at the end of the block.
 
 \begin{verbatim}
-with closing(open('/tmp/file', 'r')) as f:
+import urllib, sys
+from contextlib import closing
+
+with closing(urllib.urlopen('http://www.yahoo.com')) as f:
     for line in f:
-        ... 
+        sys.stdout.write(line)
 \end{verbatim}
 
 \begin{seealso}
@@ -1193,11 +1196,6 @@
 % the cPickle module no longer accepts the deprecated None option in the
 % args tuple returned by __reduce__().
 
-% XXX fileinput: opening hook used to control how files are opened.
-% .input() now has a mode parameter
-% now has a fileno() function
-% accepts Unicode filenames
-
 \item The \module{audioop} module now supports the a-LAW encoding,
 and the code for u-LAW encoding has been improved.  (Contributed by
 Lars Immisch.)
@@ -1242,11 +1240,12 @@
 method that removes the first occurrence of \var{value} in the queue,
 raising \exception{ValueError} if the value isn't found.
 
-\item The \module{contextlib} module contains helper functions for use 
-with the new \keyword{with} statement.  See section~\ref{module-contextlib}
-for more about this module.  (Contributed by Phillip J. Eby.)
+\item New module: The \module{contextlib} module contains helper functions for use 
+with the new \keyword{with} statement.  See
+section~\ref{module-contextlib} for more about this module.
+(Contributed by Phillip J. Eby.)
 
-\item The \module{cProfile} module is a C implementation of 
+\item New module: The \module{cProfile} module is a C implementation of 
 the existing \module{profile} module that has much lower overhead.
 The module's interface is the same as \module{profile}: you run
 \code{cProfile.run('main()')} to profile a function, can save profile
@@ -1279,6 +1278,17 @@
                        '%H:%M:%S %Y-%m-%d')
 \end{verbatim}
 
+\item The \module{fileinput} module was made more flexible.
+Unicode filenames are now supported, and a \var{mode} parameter that
+defaults to \code{"r"} was added to the
+\function{input()} function to allow opening files in binary or
+universal-newline mode.  Another new parameter, \var{openhook},
+lets you use a function other than \function{open()} 
+to open the input files.  Once you're iterating over 
+the set of files, the \class{FileInput} object's new
+\method{fileno()} returns the file descriptor for the currently opened file.
+(Contributed by Georg Brandl.)
+
 \item In the \module{gc} module, the new \function{get_count()} function
 returns a 3-tuple containing the current collection counts for the
 three GC generations.  This is accounting information for the garbage
@@ -1385,9 +1395,9 @@
 \method{gettype()}, and \method{getproto()} methods to retrieve the
 family, type, and protocol values for the socket.
 
-\item New module: \module{spwd} provides functions for accessing the
-shadow password database on systems that support it.
-% XXX give example
+\item New module: the \module{spwd} module provides functions for
+accessing the shadow password database on systems that support 
+shadow passwords.
 
 \item The Python developers switched from CVS to Subversion during the 2.5
 development process.  Information about the exact build version is 
@@ -1418,7 +1428,20 @@
 by some specifications, so it's still available as 
 \member{unicodedata.db_3_2_0}.
 
-% patch #754022: Greatly enhanced webbrowser.py (by Oleg Broytmann).
+\item The \module{webbrowser} module received a number of
+enhancements.
+It's now usable as a script with \code{python -m webbrowser}, taking a
+URL as the argument; there are a number of switches 
+to control the behaviour (\programopt{-n} for a new browser window, 
+\programopt{-t} for a new tab).  New module-level functions,
+\function{open_new()} and \function{open_new_tab()}, were added 
+to support this.  The module's \function{open()} function supports an
+additional feature, an \var{autoraise} parameter that signals whether
+to raise the open window when possible. A number of additional
+browsers were added to the supported list such as Firefox, Opera,
+Konqueror, and elinks.  (Contributed by Oleg Broytmann and George
+Brandl.)
+% Patch #754022
 
 
 \item The \module{xmlrpclib} module now supports returning 
@@ -1434,9 +1457,6 @@
 
 
 %======================================================================
-% whole new modules get described in subsections here
-
-%======================================================================
 \subsection{The ctypes package}
 
 The \module{ctypes} package, written by Thomas Heller, has been added 
@@ -1878,6 +1898,10 @@
 now uses the \cfunction{dlopen()} function instead of MacOS-specific
 functions.
 
+\item Windows: \file{.dll} is no longer supported as a filename extension for 
+extension modules.  \file{.pyd} is now the only filename extension that will
+be searched for.
+
 \end{itemize}
 
 
@@ -1972,7 +1996,7 @@
 
 The author would like to thank the following people for offering
 suggestions, corrections and assistance with various drafts of this
-article: Phillip J. Eby, Kent Johnson, Martin von~L\"owis, Mike
-Rovner, Thomas Wouters.
+article: Phillip J. Eby, Kent Johnson, Martin von~L\"owis, Gustavo
+Niemeyer, Mike Rovner, Thomas Wouters.
 
 \end{document}