--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.txt	Wed Feb 24 20:21:47 2010 -0500
@@ -0,0 +1,23 @@
+CAPTCHA Auth Middleware
+=======================
+
+CAPTCHAauthmiddleware is a WSGI middleware python packages for putting
+CAPTCHAs on forms for unauthorized users (those that haven't logged in
+yet).  If you aren't authorized -- in python terms, if remote_user is
+not set on the request -- then CAPTCHAs and a hidden key will be added
+to forms with ``method=POST``.  You will be required to correctly
+solve the CAPTCHA in order to submit the POST request.  Otherwise, the
+CAPTCHAauthmiddleware will stop your request and redirect you back to
+the form.
+
+
+What are CAPTCHAs?  -or- I hate those things
+--------------------------------------------
+
+CAPTCHAs are admittedly imperfect ways of telling humans and computers
+apart.  Presumedly if you are already identified (logged in), then the
+computer is satisfied that you are you.  But what if you want to make
+an anonymous comment on someone's blog post?  In a perfect world,
+there would be no CAPTCHAs.  In the real world, there is SPAM.  So if
+I want to protect my blog from SPAM-bots, I need to do something.
+Again, CAPTCHAs aren't perfect, but they're at least something.
\ No newline at end of file

--- a/setup.py	Wed Feb 24 20:11:25 2010 -0500
+++ b/setup.py	Wed Feb 24 20:21:47 2010 -0500
@@ -1,13 +1,18 @@
 from setuptools import setup, find_packages
 import sys, os
 
+# read the description from the file
+try:
+    description = file(os.path.join(os.path.dirname(__file__), 'README.txt')).read()
+except:
+    description = '' 
+
 version = "0.2"
 
 setup(name='CAPTCHAmiddleware',
       version=version,
       description="put CAPTCHAs on forms",
-      long_description="""
-""",
+      long_description=description,
       classifiers=[], # Get strings from http://www.python.org/pypi?%3Aaction=list_classifiers
       author='Jeff Hammel',
       author_email='k0scist@gmail.com',