[Checkins] SVN: zope.optionalextension/trunk/ Make the package work as a distutils 'command_packages' plugin.

[Tres Seaver]

Log message for revision 114146:
  Make the package work as a distutils 'command_packages' plugin.

Changed:
  U   zope.optionalextension/trunk/CHANGES.txt
  U   zope.optionalextension/trunk/README.txt

-=-
Modified: zope.optionalextension/trunk/CHANGES.txt
===================================================================
--- zope.optionalextension/trunk/CHANGES.txt	2010-07-03 18:53:31 UTC (rev 114145)
+++ zope.optionalextension/trunk/CHANGES.txt	2010-07-03 18:53:33 UTC (rev 114146)
@@ -1,6 +1,12 @@
 ``zope.optionalextension`` Changelog
 =====================================
 
+1.1 (unreleased)
+----------------
+
+- Make the package work as a distutils ``command_packages`` plugin.
+
+
 1.0 (2010-07-03)
 ----------------
 

Modified: zope.optionalextension/trunk/README.txt
===================================================================
--- zope.optionalextension/trunk/README.txt	2010-07-03 18:53:31 UTC (rev 114145)
+++ zope.optionalextension/trunk/README.txt	2010-07-03 18:53:33 UTC (rev 114146)
@@ -6,17 +6,37 @@
 implementation of one or more features, and which can function without
 needing any C extensions to be successfully compiled.
 
-Using the Command
------------------
+Using the Command with bare ``distutils``
+-----------------------------------------
 
 In the ``setup.py`` for your package::
 
-  from distutils import setup # or setuptools
-  from zope.optionalextension import optional_build_ext
+  from distutils.core import setup
 
   setup(name='your.package',
         ...
-        cmdclass = {'build_ext': optional_build_ext,
-                    },
+        command_packages = ['zope.optionalextension',
+                            'distutils.command',
+                           ]
         ...
        )
+
+You need to ensure that ``zope.optionalextension`` is installed first
+yourself.
+
+
+Using the Command with bare ``setuptools``
+------------------------------------------
+
+In the ``setup.py`` for your package::
+
+  from setuptools import setup 
+
+  setup(name='your.package',
+        ...
+        setup_requires=['zope.optionalextension'],
+        command_packages=['zope.optionalextension',
+                          'distutils.command',
+                         ]
+        ...
+       )