Better explain how getArgs works. Thanks to Thomas Brand for pointing this out.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/cli/trunk@1756753 13f79535-47bb-0310-9956-ffa450edef68

Author: britter

src/main/java/org/apache/commons/cli/Option.java

@@ -415,8 +415,17 @@ public boolean hasValueSeparator()
 
     /** 
      * Returns the number of argument values this Option can take.
+     * 
+     * <p>
+     * A value equal to the constant {@link #UNINITIALIZED} (= -1) indicates
+     * the number of arguments has not been specified.
+     * A value equal to the constant {@link #UNLIMITED_VALUES} (= -2) indicates
+     * that this options takes an unlimited amount of values.
+     * </p>
      *
      * @return num the number of argument values
+     * @see #UNINITIALIZED
+     * @see #UNLIMITED_VALUES
      */
     public int getArgs()
     {