- updated javadoc

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

Author: John Keyes

src/java/org/apache/commons/cli2/validation/Validator.java

@@ -1,5 +1,5 @@
-/**
- * Copyright 2003-2004 The Apache Software Foundation
+/*
+ * Copyright 2003-2005 The Apache Software Foundation
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -18,18 +18,25 @@
 import java.util.List;
 
 /**
- * Identifies (and maybe converts) the acceptable Argument values 
+ * The validation interface for validating argument values(s).
+ *
+ * A validator can replace the argument string value with a
+ * specific class instance e.g. the {@link UrlValidator} replaces
+ * the string value with a {@link java.net.URL} instance.
+ *
+ * @author Rob Oxspring
+ * @author John Keyes
  */
 public interface Validator {
 
     /**
      * Validate the specified values (List of Strings).
      * 
-     * @param values
-     *            the values to validate
+     * @param values The values to validate.
      * 
-     * @throws InvalidArgumentException
-     *             if any of the specified values are not valid
+     * @throws InvalidArgumentException If any of the 
+     * specified values are not valid.
      */
     void validate(final List values) throws InvalidArgumentException;
+
 }