From ece621094e6e2fec0ee7b90a073f9baecf05354c Mon Sep 17 00:00:00 2001
From: Tatu Saloranta <tatu.saloranta@iki.fi>
Date: Thu, 16 Jul 2020 19:42:21 -0700
Subject: Minor javadoc fixes

---
 .../fasterxml/jackson/databind/type/TypeFactory.java    | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

(limited to 'src/main/java')

diff --git a/src/main/java/com/fasterxml/jackson/databind/type/TypeFactory.java b/src/main/java/com/fasterxml/jackson/databind/type/TypeFactory.java
index 553acccec..147900057 100644
--- a/src/main/java/com/fasterxml/jackson/databind/type/TypeFactory.java
+++ b/src/main/java/com/fasterxml/jackson/databind/type/TypeFactory.java
@@ -880,8 +880,7 @@ public class TypeFactory // note: was final in 2.9, removed from 2.10
     /**
      * Method for constructing a {@link MapType} instance
      *<p>
-     * NOTE: type modifiers are NOT called on constructed type itself; but are called
-     * for contained types.
+     * NOTE: type modifiers are NOT called on constructed type itself.
      */
     public MapType constructMapType(Class<? extends Map> mapClass, JavaType keyType, JavaType valueType) {
         TypeBindings bindings = TypeBindings.createIfNeeded(mapClass, new JavaType[] { keyType, valueType });
@@ -921,8 +920,7 @@ public class TypeFactory // note: was final in 2.9, removed from 2.10
     /**
      * Method for constructing a {@link MapLikeType} instance
      *<p>
-     * NOTE: type modifiers are NOT called on constructed type itself; but are called
-     * for contained types.
+     * NOTE: type modifiers are NOT called on constructed type itself.
      */
     public MapLikeType constructMapLikeType(Class<?> mapClass, JavaType keyType, JavaType valueType) {
         // 19-Oct-2015, tatu: Allow case of no-type-variables, since it seems likely to be
@@ -938,7 +936,7 @@ public class TypeFactory // note: was final in 2.9, removed from 2.10
     /**
      * Method for constructing a type instance with specified parameterization.
      *<p>
-     * NOTE: was briefly deprecated for 2.6.
+     * NOTE: type modifiers are NOT called on constructed type itself.
      */
     public JavaType constructSimpleType(Class<?> rawType, JavaType[] parameterTypes) {
         return _fromClass(null, rawType, TypeBindings.create(rawType, parameterTypes));
@@ -959,6 +957,11 @@ public class TypeFactory // note: was final in 2.9, removed from 2.10
     } 
 
     /**
+     * Method for constructing a {@link ReferenceType} instance with given type parameter
+     * (type MUST take one and only one type parameter)
+     *<p>
+     * NOTE: type modifiers are NOT called on constructed type itself.
+     *
      * @since 2.6
      */
     public JavaType constructReferenceType(Class<?> rawType, JavaType referredType)
@@ -1040,12 +1043,12 @@ public class TypeFactory // note: was final in 2.9, removed from 2.10
      * In most cases distinction does not matter, but there are types where it does;
      * one such example is parameterization of types that implement {@link java.util.Iterator}.
      *<p>
-     * NOTE: type modifiers are NOT called on constructed type.
+     * NOTE: since 2.11.2 {@link TypeModifier}s ARE called on result (fix for [databind#2796])
      *
      * @param rawType Actual type-erased type
      * @param parameterTypes Type parameters to apply
      *
-     * @since 2.5 NOTE: was briefly deprecated for 2.6
+     * @return Fully resolved type for given base type and type parameters
      */
     public JavaType constructParametricType(Class<?> rawType, JavaType... parameterTypes)
     {
-- 
cgit v1.2.3