Normalize package structure.

README.rst in root, w/ prolog.

CHANGES.rst in foot.

src/Acquisition/README.txt → README.rst

+============================
+Environmental Acquisiton
+============================
+
+This package implements "environmental acquisiton" for Python, as
+proposed in `1996 OOPSLA paper by Joseph Gil and David H. Lorenz 
+http://www.cs.virginia.edu/~lorenz/papers/oopsla96/>`_:
+
+    We propose a new programming paradigm, environmental acquisition in
+    the context of object aggregation, in which objects acquire
+    behaviour from their current containers at runtime. The key idea is
+    that the behaviour of a component may depend upon its enclosing
+    composite(s). In particular, we propose a form of feature sharing in
+    which an object "inherits" features from the classes of objects in
+    its environment.  By examining the declaration of classes, it is
+    possible to determine which kinds of classes may contain a
+    component, and which components must be contained in a given kind of
+    composite. These relationships are the basis for language constructs
+    that supports acquisition.
+
 .. contents::
 
 Introductory Example

README.txt

-Please refer to src/Acquisition/README.txt.

setup.py

@@ -16,6 +16,12 @@
 import os
 from setuptools import setup, find_packages, Extension
 
+with open('README.rst') as f:
+    README = f.read()
+
+with open('CHANGES.rst') as f:
+    CHANGES = f.read()
+
 setup(
     name='Acquisition',
     version='4.0.1dev',
@@ -25,9 +31,7 @@ setup(
     "attributes from the containment hierarchy they're in.",
     author='Zope Foundation and Contributors',
     author_email='zope-dev@zope.org',
-    long_description=open(
-        os.path.join('src', 'Acquisition', 'README.txt')).read() + '\n' +
-        open('CHANGES.txt').read(),
+    long_description='\n\n'.join([README, CHANGES]),
     packages=find_packages('src'),
     package_dir={'': 'src'},
     classifiers=[

src/Acquisition/tests.py

@@ -2595,7 +2595,7 @@ class TestUnicode(unittest.TestCase):
 def test_suite():
     return unittest.TestSuite((
         DocTestSuite(),
-        DocFileSuite('README.txt', package='Acquisition'),
+        DocFileSuite('../../README.rst'),
         unittest.makeSuite(TestParent),
         unittest.makeSuite(TestAcquire),
         unittest.makeSuite(TestUnicode),