Move README.txt into package and enable it as a doctest.

setup.py

@@ -29,7 +29,8 @@ def read(*rnames):
       'environment for Python, e.g. for running untrusted code.',
       author='Zope Corporation and Contributors',
       author_email='zope3-dev@zope.org',
-      long_description=open('README.txt').read(),
+      long_description=open(
+          os.path.join('src', 'RestrictedPython', 'README.txt')).read(),
 
       packages = find_packages('src'),
       package_dir = {'': 'src'},

src/RestrictedPython/tests/testREADME.py

@@ -0,0 +1,27 @@
+##############################################################################
+#
+# Copyright (c) 2007 Zope Corporation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE.
+#
+##############################################################################
+"""Run tests in README.txt
+"""
+import unittest
+from zope.testing.doctestunit import DocFileSuite
+
+__docformat__ = "reStructuredText"
+
+def test_suite():
+    return unittest.TestSuite([
+        DocFileSuite('README.txt', package='RestrictedPython'),        
+        ])
+
+if __name__ == '__main__':
+    unittest.main(defaultTest='test_suite')