summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAndrew M. Kuchling <amk@amk.ca>2003-01-03 16:52:27 (GMT)
committerAndrew M. Kuchling <amk@amk.ca>2003-01-03 16:52:27 (GMT)
commit5a22453d332e61cb2dd743712354defe6a37bdf1 (patch)
treeda36269a9e3e8c7f6b5a21be5b085cc5b717e1dc
parent747f8060a66c7e9a1f1613e30291965ef6206e55 (diff)
downloadcpython-5a22453d332e61cb2dd743712354defe6a37bdf1.zip
cpython-5a22453d332e61cb2dd743712354defe6a37bdf1.tar.gz
cpython-5a22453d332e61cb2dd743712354defe6a37bdf1.tar.bz2
Write PEP 301 section
Mention difference between 2.2.2 and 2.3 True and False
-rw-r--r--Doc/whatsnew/whatsnew23.tex41
1 files changed, 39 insertions, 2 deletions
diff --git a/Doc/whatsnew/whatsnew23.tex b/Doc/whatsnew/whatsnew23.tex
index 39bcb08..175d677 100644
--- a/Doc/whatsnew/whatsnew23.tex
+++ b/Doc/whatsnew/whatsnew23.tex
@@ -543,7 +543,12 @@ implemented by Vinay Sajip.}
A Boolean type was added to Python 2.3. Two new constants were added
to the \module{__builtin__} module, \constant{True} and
-\constant{False}. The type object for this new type is named
+\constant{False}. (\constant{True} and
+\constant{False} constants were added to the built-ins
+in Python 2.2.2, but the 2.2.2 versions simply have integer values of
+1 and 0 and aren't a different type.)
+
+The type object for this new type is named
\class{bool}; the constructor for it takes any Python value and
converts it to \constant{True} or \constant{False}.
@@ -704,7 +709,39 @@ See section~\ref{section-pep302} for a description of the new import hooks.
%======================================================================
\section{PEP 301: Package Index and Metadata for Distutils\label{section-pep301}}
-XXX This section needs to be written.
+Support for the long-requested Python catalog makes its first
+appearance in 2.3.
+
+The core component is the new Distutil \samp{register} command.
+Running \code{python setup.py register} will collect up the metadata
+describing a package, such as its name, version, maintainer,
+description, \&c., and sends it to a central catalog server.
+Currently the catalog can be browsed at
+\url{http://www.amk.ca/cgi-bin/pypi.cgi}, but it will move to
+some hostname in the \code{python.org} domain before the final version
+of 2.3 is released.
+
+To make the catalog a bit more useful, a new optional
+\samp{classifiers} keyword argument has been added to the Distutils
+\function{setup()} function. A list of
+\citetitle[http://www.tuxedo.org/\%7Eesr/trove/]{Trove}-style strings can be supplied to help classify the software.
+
+Here's an example \file{setup.py} with classifiers:
+
+\begin{verbatim}
+setup (name = "Quixote",
+ version = "0.5.1",
+ description = "A highly Pythonic Web application framework",
+ ...
+ classifiers= ['Topic :: Internet :: WWW/HTTP :: Dynamic Content',
+ 'Environment :: No Input/Output (Daemon)',
+ 'Intended Audience :: Developers'],
+ ...
+ )
+\end{verbatim}
+
+The full list of classifiers can be obtained by running
+\code{python setup.py register --list-classifiers}.
\begin{seealso}