add boilerplate "What's New" document so the docs will build
This commit is contained in:
parent
02743ca014
commit
62e955ad13
|
@ -122,7 +122,7 @@ EMACS= emacs
|
|||
|
||||
# The end of this should reflect the major/minor version numbers of
|
||||
# the release:
|
||||
WHATSNEW=whatsnew25
|
||||
WHATSNEW=whatsnew26
|
||||
|
||||
# what's what
|
||||
MANDVIFILES= paper-$(PAPER)/api.dvi paper-$(PAPER)/ext.dvi \
|
||||
|
|
|
@ -0,0 +1,134 @@
|
|||
\documentclass{howto}
|
||||
\usepackage{distutils}
|
||||
% $Id: whatsnew25.tex 37952 2004-12-03 13:54:09Z akuchling $
|
||||
|
||||
|
||||
\title{What's New in Python 2.6}
|
||||
\release{0.0}
|
||||
\author{A.M. Kuchling}
|
||||
\authoraddress{\email{amk@amk.ca}}
|
||||
|
||||
\begin{document}
|
||||
\maketitle
|
||||
\tableofcontents
|
||||
|
||||
This article explains the new features in Python 2.6. No release date
|
||||
for Python 2.6 has been set; it will probably be released in late 2007.
|
||||
|
||||
% 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 2.6.
|
||||
% 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 2.6 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 2.6 optimizations is that Python 2.6 runs the
|
||||
pystone benchmark around XX\% faster than Python 2.5.
|
||||
|
||||
|
||||
%======================================================================
|
||||
\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 change
|
||||
logs finds there were XXX patches applied and YYY bugs fixed between
|
||||
Python 2.5 and 2.6. 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 2.6}
|
||||
|
||||
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}
|
Loading…
Reference in New Issue