better docs for FormatMapper

hibernate-core/src/main/java/org/hibernate/type/FormatMapper.java

@@ -11,8 +11,19 @@ import org.hibernate.type.descriptor.java.JavaType;
 
 /**
  * A mapper for mapping objects to and from a format.
+ * <ul>
+ * <li>A {@code FormatMapper} for JSON may be selected using the configuration
+ *     property {@value org.hibernate.cfg.AvailableSettings#JSON_FORMAT_MAPPER}.
+ * <li>A {@code FormatMapper} for XML may be selected using the configuration
+ *     property {@value org.hibernate.cfg.AvailableSettings#XML_FORMAT_MAPPER}.
+ * </ul>
+ *
  *
  * @see org.hibernate.cfg.AvailableSettings#JSON_FORMAT_MAPPER
+ * @see org.hibernate.cfg.AvailableSettings#XML_FORMAT_MAPPER
+ *
+ * @see org.hibernate.boot.spi.SessionFactoryOptions#getJsonFormatMapper()
+ * @see org.hibernate.boot.spi.SessionFactoryOptions#getXmlFormatMapper()
  *
  * @author Christian Beikov
  */

hibernate-core/src/main/java/org/hibernate/type/jackson/package-info.java

@@ -0,0 +1,11 @@
+/*
+ * Hibernate, Relational Persistence for Idiomatic Java
+ *
+ * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
+ * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
+ */
+
+/**
+ * Implementations of {@link org.hibernate.type.FormatMapper} using Jackson.
+ */
+package org.hibernate.type.jackson;

hibernate-core/src/main/java/org/hibernate/type/jakartajson/package-info.java

@@ -0,0 +1,11 @@
+/*
+ * Hibernate, Relational Persistence for Idiomatic Java
+ *
+ * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
+ * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
+ */
+
+/**
+ * An implementations of {@link org.hibernate.type.FormatMapper} using Jakarta JSON.
+ */
+package org.hibernate.type.jakartajson;

hibernate-core/src/main/java/org/hibernate/type/jaxb/package-info.java

@@ -0,0 +1,11 @@
+/*
+ * Hibernate, Relational Persistence for Idiomatic Java
+ *
+ * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
+ * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
+ */
+
+/**
+ * An implementations of {@link org.hibernate.type.FormatMapper} using JAXB.
+ */
+package org.hibernate.type.jaxb;

hibernate-core/src/main/java/org/hibernate/type/package-info.java

@@ -14,5 +14,9 @@
  * <li>a {@link org.hibernate.type.descriptor.java.JavaType}, with a
  * <li>a {@link org.hibernate.type.descriptor.jdbc.JdbcType}.
  * </ul>
+ *
+ * @see org.hibernate.type.Type
+ * @see org.hibernate.type.SqlTypes
+ * @see org.hibernate.type.FormatMapper
  */
 package org.hibernate.type;