cleaning things up for javadoc

app/preproc/java.g

@@ -3,7 +3,7 @@ package antlr.java;
 }
 
 /** Java 1.3 Recognizer
- *
+ * <PRE>
  * Run 'java Main [-showtree] directory-full-of-java-files'
  *
  * [The -showtree option pops up a Swing frame that shows
@@ -109,6 +109,7 @@ package antlr.java;
  *	    and the 110k-line jGuru server source.
  *
  * This grammar is in the PUBLIC DOMAIN
+ * </PRE>
  */
 class JavaRecognizer extends Parser;
 options {

app/syntax/InputHandler.java

@@ -25,7 +25,6 @@ import java.util.*;
  *
  * @author Slava Pestov
  * @version $Id$
- * @see org.gjt.sp.jedit.textarea.DefaultInputHandler
  */
 public abstract class InputHandler extends KeyAdapter
 {
@@ -180,7 +179,6 @@ public abstract class InputHandler extends KeyAdapter
         /**
          * Grabs the next key typed event and invokes the specified
          * action with the key as a the action command.
-         * @param action The action
          */
         public void grabNextKeyStroke(ActionListener listener)
         {

app/syntax/JEditTextArea.java

@@ -1501,7 +1501,7 @@ public class JEditTextArea extends JComponent
 
   /**
    * Sets if the selection should be rectangular.
-   * @param overwrite True if the selection should be rectangular,
+   * @param rectSelect True if the selection should be rectangular,
    * false otherwise.
    */
   public final void setSelectionRectangular(boolean rectSelect)

app/syntax/KeywordMap.java

@@ -76,7 +76,7 @@ public class KeywordMap
         /**
          * Adds a key-value mapping.
          * @param keyword The key
-         * @Param id The value
+         * @param id The value
          */
         public void add(String keyword, byte id)
         {

opengl/PGraphicsGL.java

@@ -1209,12 +1209,12 @@ public class PGraphicsGL extends PGraphics3 {
     /**
      * Implementation of the GLU_TESS_COMBINE callback.
      * @param coords is the 3-vector of the new vertex
-     * @data is the vertex data to be combined, up to four elements.
+     * @param data is the vertex data to be combined, up to four elements.
      * This is useful when mixing colors together or any other
      * user data that was passed in to gluTessVertex.
-     * @weight is an array of weights, one for each element of "data"
+     * @param weight is an array of weights, one for each element of "data"
      * that should be linearly combined for new values.
-     * @outData is the set of new values of "data" after being
+     * @param outData is the set of new values of "data" after being
      * put back together based on the weights. it's passed back as a
      * single element Object[] array because that's the closest
      * that Java gets to a pointer.

video/Capture.java

@@ -35,7 +35,7 @@ import quicktime.util.RawEncodedImage;
 
 
 /**
- * whatchin shit on tv
+ * Watchin' shit, on the telly.
  * <p>
  * The useful ref page for <a href="http://developer.apple.com/documentation/Java/Reference/1.4.1/Java141API_QTJ/constant-values.html">quicktime constants</a>
  */