Javadocify

git-svn-id: svn+ssh://src.earth.threerings.net/nenya/trunk@1166 ed5b42cb-e716-0410-a449-f6a68f950b19

src/main/java/com/threerings/media/sprite/ImageSprite.java

@@ -117,11 +117,12 @@ public class ImageSprite extends Sprite
      * Sets the animation mode for this sprite. The available modes are:
      *
      * <ul>
-     * <li><code>TIME_BASED</code>: cues the animation based on a target
+     * <li>{@link #TIME_BASED}: cues the animation based on a target
-     * frame rate (specified via {@link #setFrameRate}).
+     * frame rate (specified via {@link #setFrameRate}).</li>
-     * <li><code>MOVEMENT_CUED</code>: ticks the animation to the next
+     * <li>{@link #MOVEMENT_CUED}: ticks the animation to the next
-     * frame every time the sprite is moved along its path.
+     * frame every time the sprite is moved along its path.</li>
-     * <li><code>NO_ANIMATION</code>: disables animation.
+     * <li>{@link #NO_ANIMATION}:
+     * disables animation.</li>
      * </ul>
      *
      * @param mode the desired animation mode.

src/main/java/com/threerings/media/sprite/Sprite.java

@@ -115,10 +115,10 @@ public abstract class Sprite extends AbstractMedia
     }
 
     /**
-     * Sprites have an orientation in one of the eight cardinal directions: <code>NORTH</code>,
+     * Sprites have an orientation in one of the eight cardinal directions:
-     * <code>NORTHEAST</code>, etc. Derived classes can choose to override this member function and
+     * {@link DirectionCodes#NORTH}, {@link DirectionCodes#NORTHEAST}, etc. Derived classes can
-     * select a different set of images based on their orientation, or they can ignore the
+     * choose to override this member function and select a different set of images based on their
-     * orientation information.
+     * orientation, or they can ignore the orientation information.
      *
      * @see DirectionCodes
      */
@@ -129,7 +129,7 @@ public abstract class Sprite extends AbstractMedia
 
     /**
      * Returns the sprite's orientation as one of the eight cardinal directions:
-     * <code>NORTH</code>, <code>NORTHEAST</code>, etc.
+     * {@link DirectionCodes#NORTH}, {@link DirectionCodes#NORTHEAST}, etc.
      *
      * @see DirectionCodes
      */
@@ -218,7 +218,7 @@ public abstract class Sprite extends AbstractMedia
     }
 
     /**
-     * Set the sprite's active path and start moving it along its merry way.  If the sprite is
+     * Set the sprite's active path and start moving it along its merry way. If the sprite is
      * already moving along a previous path the old path will be lost and the new path will begin
      * to be traversed.
      *
@@ -289,8 +289,8 @@ public abstract class Sprite extends AbstractMedia
     /**
      * Ticks any path assigned to this sprite.
      *
-     * @return true if the path relocated the sprite as a result of this
+     * @return true if the path relocated the sprite as a result of this tick, false if it
-     * tick, false if it remained in the same position.
+     * remained in the same position.
      */
     protected boolean tickPath (long tickStamp)
     {