diff --git a/core/src/main/java/org/mapstruct/Mapper.java b/core/src/main/java/org/mapstruct/Mapper.java index a92fcab7f..f6703b27d 100644 --- a/core/src/main/java/org/mapstruct/Mapper.java +++ b/core/src/main/java/org/mapstruct/Mapper.java @@ -69,15 +69,17 @@ public @interface Mapper { * * The method overrides an unmappedTargetPolicy set in a central configuration set * by {@link #config() } - -* @return The component model for the generated mapper. + * + * @return The component model for the generated mapper. */ String componentModel() default "default"; /** - * Central mapper configuration, carrying the {@link MapperConfig} annotation + * A class annotated with {@link MapperConfig} which should be used as configuration template. Any settings given + * via {@link Mapper} will take precedence over the settings from the referenced configuration source. The list of + * referenced mappers will contain all mappers given via {@link Mapper#uses()} and {@link MapperConfig#uses()}. * - * @return a centralized class with {@link MapperConfig} annotation. + * @return A class which should be used as configuration template. */ Class config() default void.class; diff --git a/core/src/main/java/org/mapstruct/ReportingPolicy.java b/core/src/main/java/org/mapstruct/ReportingPolicy.java index cbba67c1b..800bdb1e5 100644 --- a/core/src/main/java/org/mapstruct/ReportingPolicy.java +++ b/core/src/main/java/org/mapstruct/ReportingPolicy.java @@ -45,9 +45,12 @@ public enum ReportingPolicy { ERROR, /** - * A report with {@link Kind#WARNING} will be created for the given issue. - * - * This value is the default value and used to distinguish it from a user set WARNING level. + * When given as value for {@link Mapper#unmappedTargetPolicy()}, the setting from the configuration source + * referenced via {@link Mapper#config()} will be applied. + *

+ * Otherwise (no configuration source is referenced, or this value is given via + * {@link MapperConfig#unmappedTargetPolicy()}), a report with {@link Kind#WARNING} will be created for the given + * issue. */ DEFAULT; }