Provide better class documentation.

git-svn-id: https://samskivert.googlecode.com/svn/trunk@2504 6335cc39-0255-0410-8fd6-9bcaacd3b74c

src/java/com/samskivert/jdbc/RepositoryUnit.java

@@ -21,8 +21,26 @@
 package com.samskivert.jdbc;
 
 /**
- * Extends {@link WriteOnlyUnit} and allows for processing of results back on the event processing
+ * A specialized invoker unit that does one or more database operations and then sends the results
- * thread.
+ * back to the event processing thread. Override {@link #handleSuccess} to process your result on
+ * the event thread and {@link #handleFailure} to handle a failure on the event thread. For
+ * example:
+ *
+ * <pre>
+ * final int userId = 123;
+ * _invoker.postUnit(new RepositoryUnit("loadUser") {
+ *     public void invokePersist () throws Exception {
+ *         _user = _userRepo.loadUser(userId);
+ *     }
+ *     public void handleSuccess () {
+ *         // do something with _user
+ *     }
+ *     public void handleFailure (Exception cause) {
+ *         // report failure to load user
+ *     }
+ *     protected UserRecord _user;
+ * });
+ * </pre>
  */
 public abstract class RepositoryUnit extends WriteOnlyUnit
 {