Added a mechanism for pluggable event access control.

git-svn-id: svn+ssh://src.earth.threerings.net/narya/trunk@1135 542714f4-19e9-0310-aa3c-eee0fc999fb1

src/java/com/threerings/presents/dobj/DEvent.java

@@ -1,5 +1,5 @@
 //
-// $Id: DEvent.java,v 1.8 2001/11/18 04:27:56 mdb Exp $
+// $Id: DEvent.java,v 1.9 2002/03/20 03:19:51 mdb Exp $
 
 package com.threerings.presents.dobj;
 
@@ -36,8 +36,11 @@ public abstract class DEvent
         throws ObjectAccessException;
 
     /**
-     * Returns the object id of the client that generated this event. This
-     * will only be valid on the server, it will return -1 otherwise.
+     * Returns the object id of the client that generated this event. If
+     * the event was generated by the server, the value returned will be
+     * -1. This is not valid on the client, it will return -1 for all
+     * events there (it is primarily provided to allow for event-level
+     * access control).
      */
     public int getSourceOid ()
     {