Improve JavaDoc wrt FasterXML#2787

Author: JooHyukKim

src/main/java/com/fasterxml/jackson/databind/ser/BasicSerializerFactory.java

@@ -1229,23 +1229,23 @@ protected JsonSerializer<?> buildEnumSerializer(SerializationConfig config,
     }
 
     /**
-     * Helper method used in the serialization of an {@link Enum} to remove any self-referencing properties from 
-     * the bean description before it is transformed into a JSON Object as configured by {@link JsonFormat.Shape#OBJECT}.
+     * Helper method used for serialization {@link Enum} as {@link JsonFormat.Shape#OBJECT}. Removes any 
+     * self-referencing properties from its bean description before it is transformed into a JSON Object 
+     * as configured by {@link JsonFormat.Shape#OBJECT}.
      * <p>
-     * Basically, this method iterates through the properties of the bean description and removes any that are
-     * an enum type and a subtype of the enum class to be serialized.
+     * Internally, this method iterates through {@link BeanDescription#findProperties()} and removes self.
      *
      * @param beanDesc the bean description to remove Enum properties from.
      *
-     * @since 2.16 : [databind#2787]: remove self-referencing enum fields introduced by annotation flattening of mixins 
+     * @since 2.16
      */
     private void _removeEnumSelfReferences(BasicBeanDescription beanDesc) {
         Class<?> aClass = ClassUtil.findEnumType(beanDesc.getBeanClass());
         Iterator<BeanPropertyDefinition> it = beanDesc.findProperties().iterator();
         while (it.hasNext()) {
             BeanPropertyDefinition property = it.next();
-            // Remove enums, because they are self-referenced
             JavaType propType = property.getPrimaryType();
+            // is the property a self-reference?
             if (propType.isEnumType() && propType.isTypeOrSubTypeOf(aClass)) {
                 it.remove();
             }

src/main/java/com/fasterxml/jackson/databind/util/EnumResolver.java

@@ -77,7 +77,7 @@ protected EnumResolver(Class<Enum<?>> enumClass, Enum<?>[] enums,
      * Enum value.
      *
      * @since 2.12
-     * @deprecated Since 2.16 use {@link #constructFor(DeserializationConfig, Class)} instead
+     * @deprecated Since 2.16 use {@link #constructFor(DeserializationConfig, AnnotatedClass)} instead
      */
     public static EnumResolver constructFor(DeserializationConfig config,
             Class<?> enumCls) {
@@ -86,6 +86,7 @@ public static EnumResolver constructFor(DeserializationConfig config,
 
     /**
      * @since 2.15
+     * @deprecated Since 2.16 use {@link #_constructFor(DeserializationConfig, AnnotatedClass)} instead
      */
     protected static EnumResolver _constructFor(DeserializationConfig config, Class<?> enumCls0)
     {