|
| 1 | +\documentclass{howto} |
| 2 | +\usepackage{distutils} |
| 3 | +% $Id$ |
| 4 | + |
| 5 | +% When creating a new ``What's New'' document, copy this to |
| 6 | +% ../whatsnew/whatsnewXY.tex, where X is replaced by the major version |
| 7 | +% number and Y, by the minor version number for the release of Python |
| 8 | +% being described. |
| 9 | +% |
| 10 | +% The following replacements need to be made in the text: |
| 11 | +% |
| 12 | +% X.Y -- the version of Python this document describes |
| 13 | +% X.Y-1 -- previous minor release (not a maintenance release) |
| 14 | +% X.Y-2 -- minor release before that one (optional; search the |
| 15 | +% template to see the usage |
| 16 | +% |
| 17 | +% In this document, these map to the following replacements: |
| 18 | +% (Please complete this section when specific replacements are made.) |
| 19 | +% |
| 20 | +% X.Y -- 2.5 |
| 21 | +% X.Y-1 -- 2.4.something (not yet determined) |
| 22 | +% X.Y-2 -- 2.4.something (not yet determined) |
| 23 | +% |
| 24 | +% Once done, write and edit to your heart's content! |
| 25 | + |
| 26 | +\title{What's New in Python 2.5} |
| 27 | +\release{0.0} |
| 28 | +\author{Young Author} |
| 29 | +\authoraddress{ \email{ [email protected]}} |
| 30 | + |
| 31 | +\begin{document} |
| 32 | +\maketitle |
| 33 | +\tableofcontents |
| 34 | + |
| 35 | +This article explains the new features in Python 2.5. No release date |
| 36 | +for Python 2.5 has been set; expect that this will happen next year. |
| 37 | + |
| 38 | +% Compare with previous release in 2 - 3 sentences here. |
| 39 | + |
| 40 | +This article doesn't attempt to provide a complete specification of |
| 41 | +the new features, but instead provides a convenient overview. For |
| 42 | +full details, you should refer to the documentation for Python 2.5. |
| 43 | +% add hyperlink when the documentation becomes available online. |
| 44 | +If you want to understand the complete implementation and design |
| 45 | +rationale, refer to the PEP for a particular new feature. |
| 46 | + |
| 47 | + |
| 48 | +%====================================================================== |
| 49 | + |
| 50 | +% Large, PEP-level features and changes should be described here. |
| 51 | + |
| 52 | + |
| 53 | +%====================================================================== |
| 54 | +\section{Other Language Changes} |
| 55 | + |
| 56 | +Here are all of the changes that Python 2.5 makes to the core Python |
| 57 | +language. |
| 58 | + |
| 59 | +\begin{itemize} |
| 60 | +\item TBD |
| 61 | + |
| 62 | +\end{itemize} |
| 63 | + |
| 64 | + |
| 65 | +%====================================================================== |
| 66 | +\subsection{Optimizations} |
| 67 | + |
| 68 | +\begin{itemize} |
| 69 | + |
| 70 | +\item Optimizations should be described here. |
| 71 | + |
| 72 | +\end{itemize} |
| 73 | + |
| 74 | +The net result of the 2.5 optimizations is that Python 2.5 runs the |
| 75 | +pystone benchmark around XX\% faster than Python X.Y-1.% |
| 76 | +% only use the next line if you want to do the extra work ;) : |
| 77 | +% and YY\% faster than Python X.Y-2. |
| 78 | + |
| 79 | + |
| 80 | +%====================================================================== |
| 81 | +\section{New, Improved, and Deprecated Modules} |
| 82 | + |
| 83 | +As usual, Python's standard library received a number of enhancements and |
| 84 | +bug fixes. Here's a partial list of the most notable changes, sorted |
| 85 | +alphabetically by module name. Consult the |
| 86 | +\file{Misc/NEWS} file in the source tree for a more |
| 87 | +complete list of changes, or look through the CVS logs for all the |
| 88 | +details. |
| 89 | + |
| 90 | +\begin{itemize} |
| 91 | + |
| 92 | +\item Descriptions go here. |
| 93 | + |
| 94 | +\end{itemize} |
| 95 | + |
| 96 | + |
| 97 | +%====================================================================== |
| 98 | +% whole new modules get described in \subsections here |
| 99 | + |
| 100 | + |
| 101 | +% ====================================================================== |
| 102 | +\section{Build and C API Changes} |
| 103 | + |
| 104 | +Changes to Python's build process and to the C API include: |
| 105 | + |
| 106 | +\begin{itemize} |
| 107 | + |
| 108 | +\item Detailed changes are listed here. |
| 109 | + |
| 110 | +\end{itemize} |
| 111 | + |
| 112 | + |
| 113 | +%====================================================================== |
| 114 | +\subsection{Port-Specific Changes} |
| 115 | + |
| 116 | +Platform-specific changes go here. |
| 117 | + |
| 118 | + |
| 119 | +%====================================================================== |
| 120 | +\section{Other Changes and Fixes \label{section-other}} |
| 121 | + |
| 122 | +As usual, there were a bunch of other improvements and bugfixes |
| 123 | +scattered throughout the source tree. A search through the CVS change |
| 124 | +logs finds there were XXX patches applied and YYY bugs fixed between |
| 125 | +Python X.Y-1 and 2.5. Both figures are likely to be underestimates. |
| 126 | + |
| 127 | +Some of the more notable changes are: |
| 128 | + |
| 129 | +\begin{itemize} |
| 130 | + |
| 131 | +\item Details go here. |
| 132 | + |
| 133 | +\end{itemize} |
| 134 | + |
| 135 | + |
| 136 | +%====================================================================== |
| 137 | +\section{Porting to Python 2.5} |
| 138 | + |
| 139 | +This section lists previously described changes that may require |
| 140 | +changes to your code: |
| 141 | + |
| 142 | +\begin{itemize} |
| 143 | + |
| 144 | +\item Everything is all in the details! |
| 145 | + |
| 146 | +\end{itemize} |
| 147 | + |
| 148 | + |
| 149 | +%====================================================================== |
| 150 | +\section{Acknowledgements \label{acks}} |
| 151 | + |
| 152 | +The author would like to thank the following people for offering |
| 153 | +suggestions, corrections and assistance with various drafts of this |
| 154 | +article: . |
| 155 | + |
| 156 | +\end{document} |
0 commit comments