(commons-xml) branch main updated: Fix Javadoc.

[ggregory]

This is an automated email from the ASF dual-hosted git repository.

garydgregory pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/commons-xml.git


The following commit(s) were added to refs/heads/main by this push:
     new dec523a  Fix Javadoc.
dec523a is described below

commit dec523a7171d90ad7292750a72f314108bf67034
Author: Gary Gregory <garydgreg...@gmail.com>
AuthorDate: Sat Jun 27 19:03:10 2026 +0000

    Fix Javadoc.
---
 src/main/java/org/apache/commons/xml/JaxpSetters.java | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/main/java/org/apache/commons/xml/JaxpSetters.java 
b/src/main/java/org/apache/commons/xml/JaxpSetters.java
index e4ffa05..0f5bce0 100644
--- a/src/main/java/org/apache/commons/xml/JaxpSetters.java
+++ b/src/main/java/org/apache/commons/xml/JaxpSetters.java
@@ -55,7 +55,15 @@ static void setAttribute(final DocumentBuilderFactory 
factory, final String attr
         apply(factory, "attribute", attribute, () -> 
factory.setAttribute(attribute, value));
     }
 
-    /** @return {@code true} if the attribute was applied, {@code false} if 
the implementation rejected it. */
+    /**
+     * Sets an attribute on a {@link DocumentBuilderFactory} and returns 
whether the implementation accepted it. Some implementations may reject certain
+     * attributes, in which case this method will return {@code false}.
+     *
+     * @param factory   The target factory on which to set the attribute.
+     * @param attribute The name of the attribute to set.
+     * @param value     The value of the attribute to set.
+     * @return {@code true} if the attribute was applied, {@code false} if the 
implementation rejected it.
+     */
     static boolean trySetAttribute(final DocumentBuilderFactory factory, final 
String attribute, final Object value) {
         try {
             factory.setAttribute(attribute, value);