Docs, renaming.

README

@@ -1,15 +1,16 @@
 NAME
-    display - script to display fragments of text on the web and elsewhere
+    Display - module to display fragments of text on the web and elsewhere
 
 DESCRIPTION
-    display started life as a way to concatenate fragments of handwritten
-    HTML by date. While the script has since haphazardly accumulated several
-    of the usual weblog features (comments, lightweight markup, feed
-    generation, embedded Perl, poetry tools, stupid dependencies), it hasn't
-    changed much in six years. The current version is intended to support
-    FastCGI via CGI::Fast, if available, and otherwise operate as a
-    traditional CGI or commandline utility. It may have some distance to go
-    towards this goal.
+    Display started life as a simple script to concatenate fragments of
+    handwritten HTML by date. While it's since haphazardly accumulated
+    several of the usual weblog features (comments, lightweight markup, feed
+    generation, embedded Perl, poetry tools, stupid dependencies), the
+    present module hasn't changed much in six years.
+
+    This version is intended to support FastCGI via CGI::Fast, if available,
+    and otherwise operate as a traditional CGI or commandline utility. It
+    may have some distance to go towards this goal.
 
     Entries are stored in a simple directory tree under
     $DISPLAY_CONF{ROOT_DIR}.
@@ -95,7 +96,8 @@ SUBROUTINES
     For no bigger than this thing is, it gets a little convoluted.
 
     handle()
-        Handle queries.
+        Handle queries. At the moment, expects a query object from CGI.pm or
+        CGI::Fast.
 
     dir_list()
         Return a $sort_order sorted list of files matching $pattern in a