--- loncom/build/Attic/CHECKRPMS.default	2002/09/09 15:04:48	1.7
+++ loncom/build/Attic/CHECKRPMS.default	2002/09/09 15:17:05	1.8
@@ -19,39 +19,42 @@ other modes can be specified as shown in
 
 =over 4
 
+=item DEFAULT
 
+When left blank, the script runs in interactive mode.  First, a proposed
+list of RPMs is presented to the user.  Then, the user is asked if he or
+she wants to download the RPMs to /tmp/loncapa_rpm_updates/.
 
-=back
+=item view
 
-=head1 DESCRIPTION
+A proposed list of RPMs to update is presented to the user.
 
-This file automates the usage of Martin Siegert's "check-rpms"
-script.  It runs through a list of possible mirror sites
-until it finds one with a reasonably good FTP connection.
+=item download
 
-=head2 Future directions
+A proposed set of RPMs to update are downloaded into /tmp/loncapa_rpm_updates/.
+Note that prior information inside /tmp/loncapa_rpm_updates/ is removed.
 
-Eventually, this script may have a simple argument format
-that allows the user to VIEW, DOWNLOAD, or AUTOUPDATE their
-computer.  Or, this script may evolve into an interactive
-series of steps:  For example, there may be questions like this:
+=item redownload
 
-=over 4
+A proposed set of RPMs to update are downloaded into /tmp/loncapa_rpm_updates/.
+Note that prior information inside /tmp/loncapa_rpm_updates/ is not removed.
+(This helps support continual attempts from dialup connections.)
 
-=item *
+=item html
 
-Do you want to (D)ownload or (A)utoupdate the RPMs
-in the list above?
+Similar to view mode. XHTML-formatted output is delivered; presumably
+to a web client.  html mode is automatically chosen if $ENV{'QUERY_STRING'} is
+defined.
 
-=item *
+=back
 
-Specify a download location for the RPMs
-(default=/tmp/update_my_rpms/)?
+=head1 DESCRIPTION
 
-=back
+This file automates the usage of Martin Siegert's "check-rpms"
+script.  It runs through a list of possible mirror sites
+until it finds one with a reasonably good FTP connection.
 
-Note that there are no current plans to automate a software upgrade of the
-kernel.  This step should be performed by a qualified system administrator.
+For instructions on usage, see L<SYNOPSIS>.
 
 =head1 AUTHOR