* java/io/ObjectStreamException

        * java/io/FileFilter
        * java/io/FilenameFilter
        * java/io/ObjectInput
        * java/io/ObjectOutput
        * java/io/ObjectStreamConstants
        Minor doc fixes, format fixes, spelling corrections, etc.
        * java/io/DataInput
        Corrected code samples in Javadocs to match reality
        * java/io/DataOutput
        * java/io/ObjectInputValidation
        Major documentation fixes - all Javadocs re-written or updated

1 files changed, 15 insertions, 4 deletions

diff --git a/java/io/ObjectInputValidation.java b/java/io/ObjectInputValidation.java
index 2259eb832..af9da5fa3 100644
--- a/java/io/ObjectInputValidation.java
+++ b/java/io/ObjectInputValidation.java
@@ -39,16 +39,27 @@ exception statement from your version. */
 package java.io; 
 
 /**
-  * What does this interface really do?
+  * This class allows an object to validate that it is valid after
+  * deserialization has run completely for it and all dependent objects.
+  * This allows an object to determine if it is invalid even if all
+  * state data was correctly deserialized from the stream.  It can also
+  * be used to perform re-initialization type activities on an object
+  * after it has been completely deserialized.
+  *
+  * Since this method functions as a type of callback, it must be 
+  * registered through <code>ObjectInputStream.registerValidation</code>
+  * in order to be invoked.  This is typically done in the
+  * <code>readObject</code> method.
   *
   * @author Aaron M. Renn (arenn@urbanophile.com)
+  *
+  * @see ObjectInputStream#registerValidation
   */
 public interface ObjectInputValidation
 {
-
   /**
-    * This method is called to validate an object.  If the object is invalid
-    * an exception is thrown.
+    * This method is called to validate an object after serialization
+    * is complete.  If the object is invalid an exception is thrown.
     *
     * @exception InvalidObjectException If the object is invalid
     */