Fixed some javadoc errors

Author: elecharny

ldap/extras/trigger/src/main/java/org/apache/directory/api/ldap/trigger/TriggerSpecificationModifier.java

@@ -64,7 +64,7 @@ public TriggerSpecification create()
     /**
      * Sets the action time.
      *
-     * @param the action time
+     * @param actionTime the action time
      */
     public void setActionTime( ActionTime actionTime )
     {
@@ -75,7 +75,7 @@ public void setActionTime( ActionTime actionTime )
     /**
      * Sets the LDAP operation.
      *
-     * @param the LDAP operation
+     * @param ldapOperation the LDAP operation
      */
     public void setLdapOperation( LdapOperation ldapOperation )
     {
@@ -86,7 +86,7 @@ public void setLdapOperation( LdapOperation ldapOperation )
     /**
      * Add a stored procedure spec.
      *
-     * @param the stored procedure spec to add
+     * @param spSpec the stored procedure spec to add
      */
     public void addSPSpec( SPSpec spSpec )
     {
@@ -117,7 +117,7 @@ public SPSpecModifier()
         /**
          * Set the name.
          *
-         * @param the name
+         * @param name the name
          */
         public void setName( String name )
         {
@@ -147,6 +147,11 @@ public void addParameter( StoredProcedureParameter parameter )
         }
 
 
+        /**
+         * Generate a new SPSpec based on the name, options and parameters
+         * 
+         * @return A new SPSpecs
+         */
         public SPSpec getSPSpec()
         {
             return new SPSpec( name, options, parameters );

ldap/model/src/main/java/org/apache/directory/api/ldap/model/subtree/SubtreeSpecificationParser.java

@@ -96,8 +96,8 @@
  * and = ID_and ( SP )* COLON ( SP )* refinements
  * or = ID_or ( SP )* COLON ( SP )* refinements
  * not = ID_not ( SP )* COLON ( SP )* refinement
- * [FILTER = '(' ( '&' (SP)* FILTER+ | '|' (SP)* FILTER+ | '!' (SP)* FILTER | FILTER_VALUE ) ')' (SP)*
- * FILTER_VALUE = every char but '(', ')', '&', '|', '!']
+ * [FILTER = '(' ( '&' (SP)* FILTER+ | '|' (SP)* FILTER+ | '!' (SP)* FILTER | FILTER_VALUE ) ')' (SP)*
+ * FILTER_VALUE = every char but '(', ')', '&', '|', '!']
  * </pre>
  * 
  * Note: the 'filter' part is not present in RFC 3672

ldap/schema/converter/src/main/java/org/apache/directory/api/ldap/schema/converter/SchemaParser.java

@@ -959,7 +959,7 @@ private SchemaElement parseSchemaElement( String schema, Position pos ) throws P
     /**
      * Parses an OpenLDAP schemaObject elements/objects.
      *
-     * @param SchemaStr a LDAP schema to parse
+     * @param schemaStr As LDAP schema to parse
      * @return A list of schema elements
      * @throws ParseException  If we weren't able to parse the schema
      */

util/src/main/java/org/apache/directory/api/util/ParserUtil.java

@@ -278,7 +278,6 @@ public static boolean isMatchChar( String str, char c, Position pos )
      * Check if a specific character is present at the current position in the string.
      * If the character is found, the position will be moved forward.
      * 
-     * @param bytes The byte[] to process
      * @param c The expected character
      * @param pos The current position in the string
      * @return <code>true</code> if the character is present at the current position,
@@ -312,7 +311,7 @@ public static boolean isMatchChar( byte c, Position pos )
      * @param pos The current position in the string
      * @return The parsed NumericOid
      */
-    public static String parseNumericOid( String str, Position pos ) throws ParseException
+    public static String parseNumericOid( String str, Position pos )
     {
         int start = pos.start;
 

util/src/main/java/org/apache/directory/api/util/Position.java

@@ -54,6 +54,8 @@ public Position()
 
     /**
      * A public constructor
+     * 
+     * @param text The String to parse
      */
     public Position( String text )
     {
@@ -63,6 +65,8 @@ public Position( String text )
 
     /**
      * A public constructor
+     * 
+     * @param bytes The bytes to parse
      */
     public Position( byte[] bytes )
     {
@@ -71,6 +75,8 @@ public Position( byte[] bytes )
 
 
     /**
+     * Get the byte at the current position
+     * 
      * @return the byte at the current position
      */
     public byte getByte()
@@ -80,6 +86,8 @@ public byte getByte()
 
 
     /**
+     * Get the stored bytes
+     * 
      * @return The interned byte[]
      */
     public byte[] getBytes()