[Python-checkins] r69742 - distutils/trunk/README.txt

[tarek.ziade]

Author: tarek.ziade
Date: Wed Feb 18 23:30:55 2009
New Revision: 69742

Log:
preparing README.txt for the diffent releases versions

Modified:
   distutils/trunk/README.txt

Modified: distutils/trunk/README.txt
==============================================================================
--- distutils/trunk/README.txt	(original)
+++ distutils/trunk/README.txt	Wed Feb 18 23:30:55 2009
@@ -2,16 +2,75 @@
 Distutils
 =========
 
-This is the standalone distribution of Distutils,
-that gets Distutils from Python into its own package.
+This is the standalone distribution of Distutils.
+
+..contents ::
+
+Installation
+============
 
 To install it, just run::
 
     $ python setup.py install
 
-And remove or rename the Distutils version located
-in your Python library directory.
+Then remove or rename the Distutils version located in your Python library
+directory.
+
+Feedback
+========
+
+- Bug tracker : http://bugs.python.org
+- Distutils Home page : http://www.python.org/community/sigs/current/distutils-sig
+
+More information on Distutils releases
+======================================
+
+Distutils comes in different flavors:
+
+- stable releases
+- development releases
+
+Stable releases
+---------------
+
+One distutils standalone release was made for each latest stable version of 
+Python of since the 2.3.x series.
+
+- distutils 2.3.7: XXX
+- distutils 2.4.5: XXX
+- distutils 2.5.4: XXX
+- distutils 2.6.1: XXX
+- distutils 3.0.1: XXX
+
+Development releases
+--------------------
+
+While Distutils lives in the standard library, it is evolving a lot. But the 
+release cycle of Python is too long to get an early taste of the new features 
+and bugfixes that were made.
+
+You can checkout the current Python trunk version of course, but you need to 
+build a new Python interpreter or extract the distutils directory to add it
+manually in your Python installation.
+
+For conveniency, regular development snapshots will be packaged and uploaded at 
+PyPI. They will be installable in your Python installation the same way the stable
+versions are.
+
+The version number will be computed using the current Python trunk version 
+and the svn revision number.
+
+For example, if the current Python trunk is at revision r69732, the Distutils
+release version will be **2.7a0dev-r69732**.
+
+Compatibility
+=============
+
+Distutils is intended to be compatible with any Python version from Python 
+2.3.7 to the current Python trunk.
 
-Distutils-SIG home page : http://www.python.org/community/sigs/current/distutils-sig
+If you want to get the latest Distutils features and bugfixes, consider 
+getting the latest release even if you are using Python 2.3, 2.4, 2.5 or 2.6.
 
+And if you dare, try out the development release and help us improve Distutils !