Partial first draft documentation for setuptools. Split revision history

between setuptools and easy_install docs.  Pull project's long_description
from the documentation, for a more informative PyPI project page.

--HG--
branch : setuptools
extra : convert_revision : svn%3A6015fed2-1504-0410-9fe1-9d1591cc4771/sandbox/trunk/setuptools%4041097

setup.py

 #!/usr/bin/env python
 """Distutils setup file, used to install or test 'setuptools'"""
 
+def get_description():
+    # Get our long description from the documentation
+    f = file('setuptools.txt')
+    lines = []
+    for line in f:
+        if not line.strip():
+            break     # skip to first blank line
+    for line in f:
+        if line.startswith('.. contents::'):
+            break     # read to table of contents
+        lines.append(line)
+    f.close()
+    return ''.join(lines)
+    
 VERSION = "0.5a7"
-from setuptools import setup, find_packages, Require
 
+from setuptools import setup, find_packages, Require
 setup(
     name="setuptools",
     version=VERSION,
-
     description="Download, build, install, upgrade, and uninstall Python "
         "packages -- easily!",
-
     author="Phillip J. Eby",
     author_email="peak@eby-sarna.com",
     license="PSF or ZPL",
-    long_description =
-        "Setuptools enhances the distutils with support for Python Eggs "
-        "(http://peak.telecommunity.com/DevCenter/PythonEggs) and more.  Its "
-        "'EasyInstall' tool "
-        "(http://peak.telecommunity.com/DevCenter/EasyInstall) lets you "
-        "download and install (or cleanly upgrade) Python packages on your "
-        "system, from source distributions, subversion checkouts, SourceForge "
-        "download mirrors, or from Python Eggs.  Been looking for a CPAN "
-        "clone for Python? When combined with PyPI, this gets pretty darn "
-        "close. See the home page and download page for details and docs.",
-
+    long_description = get_description(),
     keywords = "CPAN PyPI distutils eggs package management",
     url = "http://peak.telecommunity.com/DevCenter/EasyInstall",
-
     test_suite = 'setuptools.tests.test_suite',
     requires = [
         Require('Distutils','1.0.3','distutils',
@@ -38,7 +39,6 @@ setup(
 
 
 
-
     packages = find_packages(),
     py_modules = ['pkg_resources'],
     scripts = ['easy_install.py'],