[Scamper-dev] more code for skitter code review, Tues Jun 8th

[Young Hyun]

I have more code for review.  I was hoping to better document all the code
before offering them up for review, but I'm running out of time.  I'll
continue to document them, but you can begin to review the code.

The new pieces of code are:

 * cvs:skitter/apps/skdest-server
   tag: code_review_ready_20040603

   - current.pl -- CGI script that returns the current Subversion
         repository revision ID

   - checkout.pl -- CGI script that checks out a particular revision of a
         file from the Subversion repository

 * cvs:skitter/apps/skdriver
   tag: code_review_ready_20040603

   - SKConfig.pm -- skitter monitor configuration file encoded as
         as a perl module; this file will be customized during
         installation of the new skitter on each monitor

   - skdriver -- the main control script on a skitter monitor responsible
         for downloading files, multiplexing lists, and executing skitter

--------------------------------------------------------------------------

The most important file is skdriver; spend the largest portion of your
time on it.  You may want to read the comments at the beginning of
skdriver first before looking at current.pl or checkout.pl.  These
comments provide a good (though incomplete) overview of how all the pieces
fit together and the rationale for the design.

Let me mention one fact, though.  I've chosen to use the Subversion
version control system to manage all the configuration files and
destination list files on the web server.  The comments in skdriver
provide the rationale.  I didn't have to use Subversion for this, but it
had the functionality I wanted, so I chose it out of convenience.

If you didn't attend my design meeting a while ago, then you may wish to
read cvs:skitter/apps/skdriver/skitter-driver-notes.txt.  This file
describes the preliminary design, and though outdated now, it may be
helpful in giving you a general feel for the design.  The character
of the final design is not too far from this initial design; only the
details (and names) have changed.

 --Young