Improve JavaDoc of TypeResolverBuilder

FasterXML · May 16, 2023 · a4a272c · a4a272c
1 parent 65223e5
commit a4a272c
Showing 1 changed file with 7 additions and 3 deletions.
diff --git a/src/main/java/com/fasterxml/jackson/databind/jsontype/TypeResolverBuilder.java b/src/main/java/com/fasterxml/jackson/databind/jsontype/TypeResolverBuilder.java
@@ -155,14 +155,18 @@ public TypeDeserializer buildTypeDeserializer(DeserializationConfig config,
     public T typeIdVisibility(boolean isVisible);
 
     /**
-     * Method for specifying whether strict type ID handling should be used for this type or not.
+     * Specifies whether strict type ID handling should be used for this type.
      * Parameter {@code Boolean requireTypeId} is provided by {@link JsonTypeInfo#requireTypeIdForSubtypes()}.
-     * Configuration using this method will override {@link com.fasterxml.jackson.databind.MapperFeature#REQUIRE_TYPE_ID_FOR_SUBTYPES}.
+     * This configuration overrides the global setting defined by
+     * {@link com.fasterxml.jackson.databind.MapperFeature#REQUIRE_TYPE_ID_FOR_SUBTYPES}.
+     *
+     * @param requireTypeId {@code true} to enforce type ID handling, {@code false} otherwise.
+     *                     If {@code null}, the global setting will be used.
      *
      * @since 2.16
      */
     public default void requireTypeIdForSubtypes(Boolean requireTypeId) {
-        return;
+        // no-op
     }
 
     /*