README

This distribution contains experimental code that provides
system-global Undo functionality for system administrators and
operators, as described in the paper:

  A. Brown and D. Patterson, "Undo for Operators: Building an Undoable
  E-Mail Store." In Proceedings of the 2003 USENIX Annual Technical
  Conference, San Antonio, TX, June 2003.
  Available at http://roc.cs.berkeley.edu/

The distribution contains the generic undo infrastructure as well as a
specific specialization of that infrastructure to provide Undo for an
IMAP/SMTP-based Internet E-mail store service.

IMPORTANT NOTE: This code is still highly experimental and not
optimized for production use. It is intended solely to illustrate the
techniques and structures needed to enhance an e-mail server or other
service applications with "operator undo" functionality. As such, it
may be missing important pieces of functionality or error-handling
code that would be expected in a production version. No express or
implied guarantee is made concerning its completeness, robustness,
performance, safety, or correctness.

The distribution is organized as follows:

 README		    -- this file
 COPYING	    -- licensing and copying information
 SETUP		    -- basic setup instructions
 GNUMakefile	    -- GNU Makefile for compliling the distribution
 proxy.cfg.sample   -- sample e-mail proxy configuration file
 src/		    -- root of the source hierarchy
     copydirtree.sh -- helper script used by NetApp interface code
     roc/	    -- base of roc package
         email/	    -- code for e-mail instantiation of undo framework
	 undo/	    -- code for app-independent part of undo framework
 doc/		    -- Javadoc for packages roc.email and roc.undo
 class/		    -- location where compiled class files are placed


For further information, please contact undo-dev@roc.cs.berkeley.edu
or see http://roc.cs.berkeley.edu/undo/.