(sis) branch geoapi-3.1 updated: Ensure that the Javadoc is the same as on the main branch.

[desruisseaux]

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

desruisseaux pushed a commit to branch geoapi-3.1
in repository https://gitbox.apache.org/repos/asf/sis.git


The following commit(s) were added to refs/heads/geoapi-3.1 by this push:
     new 789cd85c1a Ensure that the Javadoc is the same as on the main branch.
789cd85c1a is described below

commit 789cd85c1af3187c53a5cfa4782e0ac862ee56a9
Author: Martin Desruisseaux <martin.desruisse...@geomatys.com>
AuthorDate: Wed Sep 3 18:13:19 2025 +0200

    Ensure that the Javadoc is the same as on the main branch.
---
 .../sis/referencing/factory/GeodeticAuthorityFactory.java     | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git 
a/endorsed/src/org.apache.sis.referencing/main/org/apache/sis/referencing/factory/GeodeticAuthorityFactory.java
 
b/endorsed/src/org.apache.sis.referencing/main/org/apache/sis/referencing/factory/GeodeticAuthorityFactory.java
index efc870eb1f..e1dae75671 100644
--- 
a/endorsed/src/org.apache.sis.referencing/main/org/apache/sis/referencing/factory/GeodeticAuthorityFactory.java
+++ 
b/endorsed/src/org.apache.sis.referencing/main/org/apache/sis/referencing/factory/GeodeticAuthorityFactory.java
@@ -177,13 +177,16 @@ public abstract class GeodeticAuthorityFactory extends 
AbstractFactory implement
      * Returns a description of the object corresponding to a code.
      *
      * @param  code  value allocated by authority.
-     * @return a description of the object, or empty if the object 
corresponding to the specified code has no description.
-     * @throws FactoryException if an error occurred while fetching the 
description.
+     * @return a description of the object, or {@code null} if the object
+     *         corresponding to the specified {@code code} has no description.
+     * @throws NoSuchAuthorityCodeException if the specified {@code code} was 
not found.
+     * @throws FactoryException if the query failed for some other reason.
      *
-     * @deprecated Replaced by {@link #getDescriptionText(Class, String)} 
because authority code without type are ambiguous.
+     * @deprecated This method is ambiguous because the EPSG geodetic registry 
may allocate
+     *             the same code to different kinds of object.
      */
     @Override
-    @Deprecated(since="1.5")
+    @Deprecated(since = "1.5")
     @SuppressWarnings("removal")    // Cannot be removed before a migration to 
GeoAPI 4.0.
     public InternationalString getDescriptionText(final String code) throws 
FactoryException {
         return getDescriptionText(CoordinateReferenceSystem.class, 
code).orElse(null);