This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-validator.git
The following commit(s) were added to refs/heads/master by this push:
new 1b819357 Javadoc @since tag should be after @return and @throws
1b819357 is described below
commit 1b819357972f5a0bbe26d81a469818c068da850f
Author: Gary D. Gregory <garydgreg...@gmail.com>
AuthorDate: Mon Mar 24 09:10:44 2025 -0400
Javadoc @since tag should be after @return and @throws
---
src/main/java/org/apache/commons/validator/Field.java | 11 ++++++-----
1 file changed, 6 insertions(+), 5 deletions(-)
diff --git a/src/main/java/org/apache/commons/validator/Field.java
b/src/main/java/org/apache/commons/validator/Field.java
index a4eb4a70..4aad7f18 100644
--- a/src/main/java/org/apache/commons/validator/Field.java
+++ b/src/main/java/org/apache/commons/validator/Field.java
@@ -155,8 +155,9 @@ public class Field implements Cloneable, Serializable {
/**
* Add an {@code Arg} to the replacement argument list.
- * @since 1.1
+ *
* @param arg Validation message's argument.
+ * @since 1.1
*/
public void addArg(final Arg arg) {
// TODO this first if check can go away after arg0, etc. are removed
from dtd
@@ -477,9 +478,9 @@ public class Field implements Cloneable, Serializable {
/**
* Retrieve a message object.
- * @since 1.1.4
* @param key Validation key.
* @return A validation message for a specified validator.
+ * @since 1.1.4
*/
public Msg getMessage(final String key) {
return getMsgMap().get(key);
@@ -488,8 +489,8 @@ public class Field implements Cloneable, Serializable {
/**
* The {@code Field}'s messages are returned as an
* unmodifiable {@link Map}.
- * @since 1.1.4
* @return Map of validation messages for the field.
+ * @since 1.1.4
*/
public Map<String, Msg> getMessages() {
return Collections.unmodifiableMap(getMsgMap());
@@ -507,8 +508,8 @@ public class Field implements Cloneable, Serializable {
/**
* Returns a Map of String Msg names to Msg objects.
- * @since 1.2.0
* @return A Map of the Field's messages.
+ * @since 1.2.0
*/
@SuppressWarnings("unchecked") // FastHashMap does not support generics
protected Map<String, Msg> getMsgMap() {
@@ -543,8 +544,8 @@ public class Field implements Cloneable, Serializable {
/**
* Returns a Map of String Var names to Var objects.
- * @since 1.2.0
* @return A Map of the Field's variables.
+ * @since 1.2.0
*/
@SuppressWarnings("unchecked") // FastHashMap does not support generics
protected Map<String, Var> getVarMap() {
