EGAD! Eric's Grading Application Distrib Files

                           EGAD!   Eric's Grading Application Distribution
			  =================================================

To install EGAD, do the following:

 * Install Subversion and emacsclient
 * Untar egad.tar.(bz2|gz).
 * Move all of the files into some directory of your choosing.
   (it's /usr/share/egad/scripts on my machine)
 * Move or symlink the file 'egad' into your path.
 * Edit 'egad' to contain the correct directory for the location of the other scripts.
 * If you use emacs, move grade-setup.el into your load path, and add
   autoload or require statements to your .emacs file for it.
 * If you don't use emacs, edit the 'grade' script:  Comment out the
   editcommand  line for emacs and uncomment the vim one.  If you use
   neither, fix the script your own way.

To actually use EGAD, do the following:

 * Create a directory for the course.
 * Make this directory a Subversion working directory.
 * Create a file in that directory called '.egad_root'.
 * For every new assignment:
   + Create a sub-directory using 'egad -- add-prob <problem number>'.
   + In that sub-directory, edit 'hwdef.sh' to describe the  current
     assignment.
   + In that sub-directory, use 'egad -- file-prob' and 'egad -- file-ALL' 
     to enter assignments that you've received.  Both take the actual
     text on stdin. 
     (I use have these bound to key combinations in my e-mail client)
   + Use 'egad -- grade' to grade individual problems, or
   + Use 'egad -- grade-all' to grade all of them.
   + Use 'egad -- merge-grade' to combine problem grades into
     whole-assignment grades.
   + Use 'egad -- report-grades' to enter combined grades into a
     tab-separated-value spreadsheet.
   + Use 'egad -- mail-grade' to mail combined grade files back to
     students

              WARNING:
             ==========

This is in-development, and rather crufty.  Use it at your own risk!


              LICENSE:
	     ==========

EGAD is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your
option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA