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

slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-shared-utils.git

commit b9e4061271ffba5716b3d4ada70cacf0acf799ad
Author: Sylwester Lachiewicz <[email protected]>
AuthorDate: Sun Nov 8 11:24:17 2026 +0000

    State the exact differences of the plexus-utils replacements
    
    plexus-utils' evaluate declares throws Exception, and its PropertyUtils
    has no loadOptionalProperties and throws IOException instead of
    returning null.
---
 src/main/java/org/apache/maven/shared/utils/PropertyUtils.java     | 7 +++++--
 .../maven/shared/utils/introspection/ReflectionValueExtractor.java | 3 ++-
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/main/java/org/apache/maven/shared/utils/PropertyUtils.java 
b/src/main/java/org/apache/maven/shared/utils/PropertyUtils.java
index 7739ce5..2ad755e 100644
--- a/src/main/java/org/apache/maven/shared/utils/PropertyUtils.java
+++ b/src/main/java/org/apache/maven/shared/utils/PropertyUtils.java
@@ -28,8 +28,11 @@ import java.util.Properties;
 /**
  * Static utility methods for loading properties.
  *
- * @deprecated use {@code org.codehaus.plexus.util.PropertyUtils} 
(plexus-utils) or
- *             {@link java.util.Properties#load(java.io.InputStream)} directly.
+ * @deprecated use {@code 
org.codehaus.plexus.util.PropertyUtils#loadProperties} (plexus-utils), which
+ *             throws {@code IOException} instead of returning {@code null}, or
+ *             {@link java.util.Properties#load(java.io.InputStream)} 
directly. For the
+ *             {@code loadOptionalProperties} methods, catch the {@code 
IOException} yourself; plexus-utils
+ *             has no optional variant.
  */
 @Deprecated
 public class PropertyUtils {
diff --git 
a/src/main/java/org/apache/maven/shared/utils/introspection/ReflectionValueExtractor.java
 
b/src/main/java/org/apache/maven/shared/utils/introspection/ReflectionValueExtractor.java
index 24216ac..527a7e6 100644
--- 
a/src/main/java/org/apache/maven/shared/utils/introspection/ReflectionValueExtractor.java
+++ 
b/src/main/java/org/apache/maven/shared/utils/introspection/ReflectionValueExtractor.java
@@ -39,7 +39,8 @@ import 
org.apache.maven.shared.utils.introspection.MethodMap.AmbiguousException;
  * http://struts.apache.org/1.x/struts-taglib/indexedprops.html</a>
  *
  * @deprecated use {@code 
org.codehaus.plexus.util.introspection.ReflectionValueExtractor}
- *             (plexus-utils), which has the same API.
+ *             (plexus-utils), which has the same {@code evaluate} methods but 
declares
+ *             {@code throws Exception} instead of {@code 
IntrospectionException}.
  */
 @Deprecated
 public class ReflectionValueExtractor {

Reply via email to