Various javadoc fixes.

core/src/main/java/com/threerings/admin/client/TabbedDSetEditor.java

@@ -92,10 +92,6 @@ public class TabbedDSetEditor<E extends DSet.Entry> extends JPanel
             };
         }
 
-        /**
-         * Grinds through the
-         * @param entries
-         */
         public void computeGroups (Iterable<E> entries) {
             for (E entry : entries) {
                 String[] groups = computeGroups(entry);

core/src/main/java/com/threerings/presents/client/InvocationService.java

@@ -28,8 +28,8 @@ import com.threerings.presents.data.ClientObject;
  * extending this interface and defining service methods, as well as response listeners (which must
  * extend {@link InvocationListener}). For example:
  *
- * <pre>
+ * <pre>{@code
- * public interface LocationService extends InvocationService&lt;ClientObject>
+ * public interface LocationService extends InvocationService<ClientObject>
  * {
  *
  *     // Used to communicate responses to moveTo() requests.
@@ -45,13 +45,13 @@ import com.threerings.presents.data.ClientObject;
  *     // @param listener the listener that will be informed of success or failure.
  *     void moveTo (int placeId, MoveListener listener);
  * }
- * </pre>
+ * }</pre>
  *
  * From this interface, a <code>LocationProvider</code> interface will be generated which should be
  * implemented by whatever server entity that will actually provide the server side of this
  * invocation service. That provider interface would look like the following:
  *
- * <pre>
+ * <pre>{@code
  * public interface LocationProvider extends InvocationProvider
  * {
  *      // Requests that this client's body be moved to the specified location.
@@ -62,7 +62,7 @@ import com.threerings.presents.data.ClientObject;
  *     void moveTo (ClientObject caller, int placeId, MoveListener listener)
  *         throws InvocationException;
  * }
- * </pre>
+ * }</pre>
  */
 public interface InvocationService<T extends ClientObject>
 {

core/src/main/java/com/threerings/presents/server/net/AuthingConnection.java

@@ -135,7 +135,7 @@ public class AuthingConnection extends PresentsConnection
 
     /**
      * Returns the username that uniquely identifies this authenticated session. This will be used
-     * to map Name -> PresentsSession in the ClientManager and used elsewhere.
+     * to map {@code Name -> PresentsSession} in the {@code ClientManager} and used elsewhere.
      */
     public Name getAuthName ()
     {

core/src/main/java/com/threerings/util/Resulting.java

@@ -45,13 +45,13 @@ public class Resulting<T> extends Invoker.Unit
     implements ResultListener<T>,
         InvocationService.ConfirmListener, InvocationService.ResultListener
 {
-    /** A handy Object->Void function for when you wish to chain to a ResultListener<Void>. */
+    /** A handy {@code Object -> Void} function for when you wish to chain to a
-    public static final Function<Object, Void> TO_VOID =
+      * {@code ResultListener<Void>}. */
-        new Function<Object, Void>() {
+    public static final Function<Object, Void> TO_VOID = new Function<Object, Void>() {
-            public Void apply (Object o) {
+        public Void apply (Object o) {
-                return null;
+            return null;
-            }
+        }
-        };
+    };
 
     public Resulting (String name)
     {
@@ -116,8 +116,8 @@ public class Resulting<T> extends Invoker.Unit
     }
 
     /**
-     * Construct your Resulting<Integer>, overriding what you need to,
+     * Construct your {@code Resulting<Integer>}, overriding what you need to, then call this to
-     * then call this to adapt it.
+     * adapt it.
      */
     public final IntResultListener asIntResultListener ()
     {

core/src/test/java/com/threerings/presents/peer/server/PeerTestGroup.java

@@ -33,7 +33,7 @@ import com.google.inject.Inject;
 import com.google.inject.Injector;
 
 import com.samskivert.depot.PersistenceContext;
-import com.samskivert.jdbc.StaticConnectionProvider;
+import com.samskivert.depot.StaticConnectionProvider;
 
 import com.threerings.presents.server.PresentsServer;
 

pom.xml

@@ -77,13 +77,14 @@
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-javadoc-plugin</artifactId>
-        <version>2.7</version>
+        <version>2.9.1</version>
         <configuration>
           <quiet>true</quiet>
           <show>public</show>
+          <additionalparam>-Xdoclint:all -Xdoclint:-missing</additionalparam>
           <links>
             <link>http://samskivert.github.com/samskivert/apidocs/</link>
-            <link>http://depot.googlecode.com/svn/apidocs/</link>
+            <link>http://threerings.github.io/depot/apidocs/</link>
             <link>http://docs.guava-libraries.googlecode.com/git/javadoc/</link>
             <link>http://google-web-toolkit.googlecode.com/svn/javadoc/latest/</link>
             <link>http://www.jajakarta.org/ant/ant-1.6.1/docs/ja/manual/api/</link>

tools/src/main/java/com/threerings/presents/tools/GenServiceTask.java

@@ -49,13 +49,13 @@ import com.threerings.presents.server.InvocationException;
 import com.threerings.presents.server.InvocationProvider;
 
 /**
- * An Ant task for generating invocation service marshalling and
+ * An Ant task for generating invocation service marshalling and unmarshalling classes.
- * unmarshalling classes.
+ *
- * TODO: when generating the imports for exported action script files, there are just enough
+ * <p>TODO: when generating the imports for exported action script files, there are just enough
- * conversions of primitive types (e.g. float -> Number), array types (e.g. int[] -> TypedArray)
+ * conversions of primitive types (e.g. {@code float -> Number}), array types (e.g. {@code int[] ->
- * and three rings utility types (e.g. float -> Float) to make the existing serivces work. It
+ * TypedArray}) and three rings utility types (e.g. {@code float -> Float}) to make the existing
- * should be possible to create a complete list of these conversions so that future services
+ * serivces work. It should be possible to create a complete list of these conversions so that
- * can be generated without problems.
+ * future services can be generated without problems.
  */
 public class GenServiceTask extends InvocationTask
 {