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-secure-xml.git
The following commit(s) were added to refs/heads/main by this push:
new 7ad8992 Javadoc
7ad8992 is described below
commit 7ad89922fe98426e1634eb92c497fd089f77868a
Author: Gary Gregory <[email protected]>
AuthorDate: Mon Sep 14 09:48:24 2026 -0700
Javadoc
---
.../commons/xml/secure/FallbackIgnoreEntityResolver2.java | 10 ++++++----
1 file changed, 6 insertions(+), 4 deletions(-)
diff --git
a/src/main/java/org/apache/commons/xml/secure/FallbackIgnoreEntityResolver2.java
b/src/main/java/org/apache/commons/xml/secure/FallbackIgnoreEntityResolver2.java
index fd47576..6a9346e 100644
---
a/src/main/java/org/apache/commons/xml/secure/FallbackIgnoreEntityResolver2.java
+++
b/src/main/java/org/apache/commons/xml/secure/FallbackIgnoreEntityResolver2.java
@@ -86,9 +86,9 @@ private static String absolutize(final String baseURI, final
String systemId) {
}
/**
- * Gets the delegate provided by the constructor or set by {@link
#setDelegate}, may be {@code null}.
+ * Gets the delegate provided by the constructor or set by {@link
#setDelegate}, or {@code null}.
*
- * @return The delegate provided by the constructor or set by {@link
#setDelegate}, may be {@code null}.
+ * @return The delegate provided by the constructor or set by {@link
#setDelegate}, or {@code null}.
*/
EntityResolver getDelegate() {
return delegate;
@@ -103,7 +103,7 @@ public InputSource getExternalSubset(final String name,
final String baseURI) th
/**
* Outcome when neither the caller delegate nor this resolver provides the
entity. Resolves to empty content by default, so the external resource is
neither
* fetched nor leaked and the parse continues with no replacement text.
The returned source echoes the requested identifiers (with {@code systemId}
- * absolutized): the parser reads the empty byte stream, but Xerces still
derives the entity's base URI from the system id and fails on a {@code null}
one.
+ * absolutized): the parser reads the empty byte stream, but Xerces still
derives the entity's base URI from the system ID and fails on a {@code null}
one.
*
* @param name The entity name, or {@code null} on the 2-arg
resolution path.
* @param publicId The public identifier, or {@code null} if none.
@@ -146,7 +146,9 @@ private InputSource resolveWithDelegate(final String name,
final String publicId
}
/**
- * Replaces the caller resolver consulted ahead of the floor; lets a
single floor instance back successive {@code setEntityResolver} calls.
+ * Sets the caller resolver consulted ahead of the floor.
+ *
+ * <p>A single floor instance can back successive {@code
setEntityResolver} calls.</p>
*
* @param delegate The caller-supplied resolver, or {@code null} for a
pure ignore-all floor.
*/