summaryrefslogtreecommitdiffstats
path: root/Doc/templates/whatsnewXY.tex
blob: 6f62b9cb674e234ca93d36c8a185191ff1b1f4d6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
\documentclass{howto}
\usepackage{distutils}
% $Id$

% When creating a new ``What's New'' document, copy this to
% ../whatsnew/whatsnewXY.tex, where X is replaced by the major version
% number and Y, by the minor version number for the release of Python
% being described.
%
% The following replacements need to be made in the text:
%
% X.Y   -- the version of Python this document describes
% X.Y-1 -- previous minor release (not a maintenance release)
% X.Y-2 -- minor release before that one (optional; search the
%          template to see the usage
%
% Once done, write and edit to your heart's content!

\title{What's New in Python X.Y}
\release{0.0}
\author{Young Author}
\authoraddress{\email{ya@example.com}}

\begin{document}
\maketitle
\tableofcontents

This article explains the new features in Python X.Y.  No release date
for Python X.Y has been set; expect that this will happen next year.

% Compare with previous release in 2 - 3 sentences here.

This article doesn't attempt to provide a complete specification of
the new features, but instead provides a convenient overview.  For
full details, you should refer to the documentation for Python X.Y.
% add hyperlink when the documentation becomes available online.
If you want to understand the complete implementation and design
rationale, refer to the PEP for a particular new feature.


%======================================================================

% Large, PEP-level features and changes should be described here.


%======================================================================
\section{Other Language Changes}

Here are all of the changes that Python X.Y makes to the core Python
language.

\begin{itemize}
\item TBD

\end{itemize}


%======================================================================
\subsection{Optimizations}

\begin{itemize}

\item Optimizations should be described here.

\end{itemize}

The net result of the X.Y optimizations is that Python X.Y runs the
pystone benchmark around XX\% faster than Python X.Y-1.%
% only use the next line if you want to do the extra work ;) :
% and YY\% faster than Python X.Y-2.


%======================================================================
\section{New, Improved, and Deprecated Modules}

As usual, Python's standard library received a number of enhancements and
bug fixes.  Here's a partial list of the most notable changes, sorted
alphabetically by module name. Consult the
\file{Misc/NEWS} file in the source tree for a more
complete list of changes, or look through the CVS logs for all the
details.

\begin{itemize}

\item Descriptions go here.

\end{itemize}


%======================================================================
% whole new modules get described in \subsections here


% ======================================================================
\section{Build and C API Changes}

Changes to Python's build process and to the C API include:

\begin{itemize}

\item Detailed changes are listed here.

\end{itemize}


%======================================================================
\subsection{Port-Specific Changes}

Platform-specific changes go here.


%======================================================================
\section{Other Changes and Fixes \label{section-other}}

As usual, there were a bunch of other improvements and bugfixes
scattered throughout the source tree.  A search through the CVS change
logs finds there were XXX patches applied and YYY bugs fixed between
Python X.Y-1 and X.Y.  Both figures are likely to be underestimates.

Some of the more notable changes are:

\begin{itemize}

\item Details go here.

\end{itemize}


%======================================================================
\section{Porting to Python X.Y}

This section lists previously described changes that may require
changes to your code:

\begin{itemize}

\item Everything is all in the details!

\end{itemize}


%======================================================================
\section{Acknowledgements \label{acks}}

The author would like to thank the following people for offering
suggestions, corrections and assistance with various drafts of this
article: .

\end{document}