Fix broken javadoc links and params to kill my Eclipse warnings. This includes

importing receivers from their senders to satisfy their links.



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

src/java/com/threerings/presents/client/Client.java

@@ -451,7 +451,7 @@ public class Client
      * user of the failure and then simply call {@link #logon} to attempt to reconnect to the old
      * server.
      *
-     * @param observer an observer that will be notified when we have successfully logged onto the
+     * @param obs an observer that will be notified when we have successfully logged onto the
      * other server, or if the move failed.
      */
     public void moveToServer (String hostname, int[] ports, InvocationService.ConfirmListener obs)
@@ -470,7 +470,7 @@ public class Client
      * user of the failure and then simply call {@link #logon} to attempt to reconnect to the old
      * server.
      *
-     * @param observer an observer that will be notified when we have successfully logged onto the
+     * @param obs an observer that will be notified when we have successfully logged onto the
      * other server, or if the move failed.
      */
     public void moveToServer (

src/java/com/threerings/presents/data/ClientObject.java

@@ -74,7 +74,7 @@ public class ClientObject extends DObject
     }
 
     /**
-     * A version of {@link #checkAccess(Permission,Object} that provides no context.
+     * A version of {@link #checkAccess(Permission,Object)} that provides no context.
      */
     public String checkAccess (Permission perm)
     {

src/java/com/threerings/presents/data/InvocationMarshaller.java

@@ -136,7 +136,7 @@ public class InvocationMarshaller
     }
 
     /**
-     * Defines a marshaller for the standard {@link ConfirmListener}.
+     * Defines a marshaller for the standard {@link InvocationService.ConfirmListener}.
      */
     public static class ConfirmMarshaller extends ListenerMarshaller
         implements ConfirmListener
@@ -167,7 +167,7 @@ public class InvocationMarshaller
     }
 
     /**
-     * Defines a marshaller for the standard {@link ResultListener}.
+     * Defines a marshaller for the standard {@link InvocationService.ResultListener}.
      */
     public static class ResultMarshaller extends ListenerMarshaller
         implements ResultListener

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

@@ -453,8 +453,7 @@ public class DObject
             return;
         }
 
-        for (int ii = 0, ll = _subs.length; ii < ll; ii++) {
-            Object sub = _subs[ii];
+        for (Object sub : _subs) {
             try {
                 if (sub != null && sub instanceof ProxySubscriber) {
                     ((ProxySubscriber)sub).eventReceived(event);
@@ -569,7 +568,7 @@ public class DObject
      * distributed object manager. This is called by the distributed object manager when an object
      * is created and registered with the system.
      *
-     * @see DObjectManager#createObject
+     * @see RootDObjectManager#registerObject(DObject)
      */
     public void setManager (DObjectManager omgr)
     {
@@ -580,7 +579,7 @@ public class DObject
      * Don't call this function. It is called by the distributed object manager when an object is
      * created and registered with the system.
      *
-     * @see DObjectManager#createObject
+     * @see RootDObjectManager#registerObject(DObject)
      */
     public void setOid (int oid)
     {

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

@@ -45,7 +45,7 @@ public class ElementUpdatedEvent extends NamedEvent
      * @param name the name of the attribute (data member) for which an element has changed.
      * @param value the new value of the element (in the case of primitive types, the
      * reflection-defined object-alternative is used).
-     * @param oldValue the previous value of the element (in the case of primitive types, the
+     * @param ovalue the previous value of the element (in the case of primitive types, the
      * reflection-defined object-alternative is used).
      * @param index the index in the array of the updated element.
      */
@@ -62,7 +62,7 @@ public class ElementUpdatedEvent extends NamedEvent
      * @param name the name of the attribute (data member) for which an element has changed.
      * @param value the new value of the element (in the case of primitive types, the
      * reflection-defined object-alternative is used).
-     * @param oldValue the previous value of the element (in the case of primitive types, the
+     * @param ovalue the previous value of the element (in the case of primitive types, the
      * reflection-defined object-alternative is used).
      * @param index the index in the array of the updated element.
      * @param transport a hint as to the type of transport desired for the event.

src/java/com/threerings/presents/server/ChainedAuthenticator.java

@@ -25,6 +25,7 @@ import com.samskivert.util.Invoker;
 import com.samskivert.util.ResultListener;
 
 import com.threerings.presents.server.net.AuthingConnection;
+import com.threerings.presents.server.net.ConnectionManager;
 
 /**
  * Handles certain special kinds of authentications and passes the remainder through to the default

src/java/com/threerings/presents/server/ClientManager.java

@@ -547,7 +547,7 @@ public class ClientManager
         protected ClientOp _clop;
     }
 
-    /** Used to resolve dependencies in {@link PresentClient} instances that we create. */
+    /** Used to resolve dependencies in {@link PresentsClient} instances that we create. */
     protected Injector _injector;
 
     /** A mapping from auth username to client instances. */

src/java/com/threerings/presents/server/PresentsDObjectMgr.java

@@ -73,7 +73,7 @@ public class PresentsDObjectMgr
     implements RootDObjectManager, RunQueue, ReportManager.Reporter
 {
     /** Contains operational statistics that are tracked by the distributed object manager between
-     * {@link ReportManager#Reporter} intervals. The snapshot for the most recently completed
+     * {@link ReportManager.Reporter} intervals. The snapshot for the most recently completed
      * period can be requested via {@link #getStats()}. . */
     public static class Stats
     {
@@ -380,13 +380,12 @@ public class PresentsDObjectMgr
         // deal with any remaining oid lists that reference this object
         Reference[] refs = _refs.remove(oid);
         if (refs != null) {
-            for (int i = 0; i < refs.length; i++) {
+            for (Reference ref : refs) {
                 // skip empty spots
-                if (refs[i] == null) {
+                if (ref == null) {
                     continue;
                 }
 
-                Reference ref = refs[i];
                 DObject reffer = _objects.get(ref.reffingOid);
 
                 // ensure that the referencing object is still around
@@ -405,9 +404,7 @@ public class PresentsDObjectMgr
         // to clear out those references
         Class<?> oclass = target.getClass();
         Field[] fields = oclass.getFields();
-        for (int f = 0; f < fields.length; f++) {
-            Field field = fields[f];
-
+        for (Field field : fields) {
             // ignore static and non-public fields
             int mods = field.getModifiers();
             if ((mods & Modifier.STATIC) != 0 || (mods & Modifier.PUBLIC) == 0) {

src/java/com/threerings/presents/server/PresentsServer.java

@@ -36,6 +36,7 @@ import com.threerings.presents.annotation.EventQueue;
 import com.threerings.presents.annotation.MainInvoker;
 import com.threerings.presents.client.Client;
 import com.threerings.presents.dobj.AccessController;
+import com.threerings.presents.dobj.DObject;
 import com.threerings.presents.dobj.DObjectManager;
 import com.threerings.presents.dobj.RootDObjectManager;
 import com.threerings.presents.server.net.ConnectionManager;

src/java/com/threerings/presents/tools/GenReceiverTask.java

@@ -69,8 +69,7 @@ public class GenReceiverTask extends InvocationTask
 
         // look through and locate our receiver methods
         Method[] methdecls = receiver.getDeclaredMethods();
-        for (int ii = 0; ii < methdecls.length; ii++) {
-            Method m = methdecls[ii];
+        for (Method m : methdecls) {
             // receiver interface methods must be public and abstract
             if (!Modifier.isPublic(m.getModifiers()) &&
                 !Modifier.isAbstract(m.getModifiers())) {
@@ -104,6 +103,7 @@ public class GenReceiverTask extends InvocationTask
         checkedAdd(implist, InvocationSender.class.getName());
         String dname = StringUtil.replace(rname, "Receiver", "Decoder");
         checkedAdd(implist, rpackage + "." + dname);
+        checkedAdd(implist, rpackage + "." + rname);
         implist.sort();
 
         VelocityContext ctx = new VelocityContext();

src/java/com/threerings/presents/util/ConfirmAdapter.java

@@ -21,11 +21,16 @@
 
 package com.threerings.presents.util;
 
+import com.samskivert.util.ResultListener;
+
 import com.threerings.presents.client.InvocationService;
+import com.threerings.presents.client.InvocationService.ConfirmListener;
+import com.threerings.presents.data.InvocationCodes;
+import com.threerings.presents.server.InvocationException;
 
 /**
  * Adapts the response from a {@link ResultListener} to a {@link ConfirmListener} if the failure is
- * an instance fo {@link InvocationException} the message will be passed on to the confirm
+ * an instance of {@link InvocationException} the message will be passed on to the confirm
  * listener, otherwise they will be provided with {@link InvocationCodes#INTERNAL_ERROR}.
  */
 public class ConfirmAdapter extends IgnoreConfirmAdapter<Void>

src/java/com/threerings/presents/util/IgnoreConfirmAdapter.java

@@ -24,6 +24,7 @@ package com.threerings.presents.util;
 import com.samskivert.util.ResultListener;
 
 import com.threerings.presents.client.InvocationService;
+import com.threerings.presents.client.InvocationService.ConfirmListener;
 import com.threerings.presents.data.InvocationCodes;
 import com.threerings.presents.server.InvocationException;