--- a/README.txt	Sat Mar 06 13:22:31 2010 -0500
+++ b/README.txt	Sat Mar 06 14:55:04 2010 -0500
@@ -1,7 +1,8 @@
 cropresize
 ==========
 
-cropresize uses PIL to crop and resize an image as appropriate for web
+cropresize uses `PIL <http://www.pythonware.com/products/pil/>`_
+to crop and resize an image as appropriate for web
 presentation. cropresize is a convenience package that allows image
 resizing without aspect ratio distortion.
 
@@ -11,7 +12,7 @@
 cropresize contains one useful function, ``cropresize.crop_resize``.
 The function takes three arguments:
 
-    * image: a PIL image object
+    * image: a `PIL image <http://www.pythonware.com/library/pil/handbook/image.htm>`_ object
     * size: a 2-tuple of (width,height);  at least one must be specified
     * exact_size: whether to scale up for smaller images  
 
@@ -26,6 +27,15 @@
 package.  The help for the program is displayed by running
 ``crop-resize`` with no arguments or ``crop-resize --help``.
 
+
+Future Work
+-----------
+
+cropresize is written as a convenience function to PIL as this
+methodology for cropping and resizing images is often desired for
+presentation, particularly on the web.  Since the utility is in
+demand, the functionality should be ported upstream to PIL.
+
 --
 
 http://k0s.org/portfolio/software.html#cropresize