diff --git a/src/as/com/threerings/io/ObjectInputStream.as b/src/as/com/threerings/io/ObjectInputStream.as
index d80000101..6e9bd59a9 100644
--- a/src/as/com/threerings/io/ObjectInputStream.as
+++ b/src/as/com/threerings/io/ObjectInputStream.as
@@ -71,7 +71,8 @@ public class ObjectInputStream
      * @return the Object read, or null.
      * @throws TypeError if the object is read successfully but is the wrong type
      *
-     * @example
+     * @example This demonstrates how to type-check the objects read off the stream without
+     * having to cast them.
      * <listing version="3.0">
      *
      * public function readObject (ins :ObjectInputStream) :void