Add since tag to new API elements

filiphr · filiphr · commit 9a43b210d39b · 2018-11-24T02:07:31.000+01:00
diff --git a/core/src/main/java/org/mapstruct/BeanMapping.java b/core/src/main/java/org/mapstruct/BeanMapping.java
@@ -69,6 +69,8 @@
      * {@link Mapper#nullValuePropertyMappingStrategy()} will be applied,
      * {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default.
      *
+     * @since 1.3
+     *
      * @return The strategy to be applied when {@code null} is passed as source property value or the source property
      * is not present.
      */
diff --git a/core/src/main/java/org/mapstruct/Mapper.java b/core/src/main/java/org/mapstruct/Mapper.java
@@ -153,6 +153,8 @@
      * configured, the strategy given via {@link MapperConfig#nullValuePropertyMappingStrategy()} will be applied,
      * {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default.
      *
+     * @since 1.3
+     *
      * @return The strategy to be applied when {@code null} is passed as source property value or the source property
      * is not present.
      */
diff --git a/core/src/main/java/org/mapstruct/MapperConfig.java b/core/src/main/java/org/mapstruct/MapperConfig.java
@@ -136,6 +136,8 @@
      * The strategy to be applied when a source bean property is {@code null} or not present. If no strategy is
      * configured, {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default.
      *
+     * @since 1.3
+     *
      * @return The strategy to be applied when {@code null} is passed as source property value or the source property
      * is not present.
      */
diff --git a/core/src/main/java/org/mapstruct/Mapping.java b/core/src/main/java/org/mapstruct/Mapping.java
@@ -264,6 +264,8 @@
      *
      * Can be overridden by the one on {@link MapperConfig}, {@link Mapper} or {@link BeanMapping}.
      *
+     * @since 1.3
+     *
      * @return strategy how to do null checking
      */
     NullValueCheckStrategy nullValueCheckStrategy() default ON_IMPLICIT_CONVERSION;
@@ -276,6 +278,8 @@
      *
      * {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default.
      *
+     * @since 1.3
+     *
      * @return The strategy to be applied when {@code null} is passed as source property value or the source property
      * is not present.
      */
diff --git a/core/src/main/java/org/mapstruct/NullValuePropertyMappingStrategy.java b/core/src/main/java/org/mapstruct/NullValuePropertyMappingStrategy.java
@@ -16,6 +16,7 @@
  * {@code @}{@link MappingTarget}).
  *
  * @author Sjaak Derksen
+ * @since 1.3
  */
 public enum NullValuePropertyMappingStrategy {
 
diff --git a/processor/src/main/java/org/mapstruct/ap/spi/AccessorNamingStrategy.java b/processor/src/main/java/org/mapstruct/ap/spi/AccessorNamingStrategy.java
@@ -19,6 +19,8 @@ public interface AccessorNamingStrategy {
      * Initializes the accessor naming strategy with the MapStruct processing environment.
      *
      * @param processingEnvironment environment for facilities
+     *
+     * @since 1.3
      */
     default void init(MapStructProcessingEnvironment processingEnvironment) {
 
diff --git a/processor/src/main/java/org/mapstruct/ap/spi/BuilderInfo.java b/processor/src/main/java/org/mapstruct/ap/spi/BuilderInfo.java
@@ -12,6 +12,8 @@
  * Holder for the builder information.
  *
  * @author Filip Hrisafov
+ *
+ * @since 1.3
  */
 public class BuilderInfo {
 
diff --git a/processor/src/main/java/org/mapstruct/ap/spi/BuilderProvider.java b/processor/src/main/java/org/mapstruct/ap/spi/BuilderProvider.java
@@ -11,6 +11,8 @@
  * A service provider interface that is used to detect types that require a builder for mapping.  This interface could
  * support automatic detection of builders for projects like Lombok, Immutables, AutoValue, etc.
  * @author Filip Hrisafov
+ *
+ * @since 1.3
  */
 public interface BuilderProvider {
 
diff --git a/processor/src/main/java/org/mapstruct/ap/spi/MapStructProcessingEnvironment.java b/processor/src/main/java/org/mapstruct/ap/spi/MapStructProcessingEnvironment.java
@@ -15,6 +15,8 @@
  *
  * @author Filip Hrisafov
  * @see javax.annotation.processing.ProcessingEnvironment
+ *
+ * @since 1.3
  */
 public interface MapStructProcessingEnvironment {
 

Original file line number	Diff line number	Diff line change
`@@ -69,6 +69,8 @@`
`69`	`69`	`* {@link Mapper#nullValuePropertyMappingStrategy()} will be applied,`
`70`	`70`	`* {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default.`
`71`	`71`	`*`
	`72`	`+ * @since 1.3`
	`73`	`+ *`
`72`	`74`	`* @return The strategy to be applied when {@code null} is passed as source property value or the source property`
`73`	`75`	`* is not present.`
`74`	`76`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -153,6 +153,8 @@`
`153`	`153`	`* configured, the strategy given via {@link MapperConfig#nullValuePropertyMappingStrategy()} will be applied,`
`154`	`154`	`* {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default.`
`155`	`155`	`*`
	`156`	`+ * @since 1.3`
	`157`	`+ *`
`156`	`158`	`* @return The strategy to be applied when {@code null} is passed as source property value or the source property`
`157`	`159`	`* is not present.`
`158`	`160`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -136,6 +136,8 @@`
`136`	`136`	`* The strategy to be applied when a source bean property is {@code null} or not present. If no strategy is`
`137`	`137`	`* configured, {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default.`
`138`	`138`	`*`
	`139`	`+ * @since 1.3`
	`140`	`+ *`
`139`	`141`	`* @return The strategy to be applied when {@code null} is passed as source property value or the source property`
`140`	`142`	`* is not present.`
`141`	`143`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -264,6 +264,8 @@`
`264`	`264`	`*`
`265`	`265`	`* Can be overridden by the one on {@link MapperConfig}, {@link Mapper} or {@link BeanMapping}.`
`266`	`266`	`*`
	`267`	`+ * @since 1.3`
	`268`	`+ *`
`267`	`269`	`* @return strategy how to do null checking`
`268`	`270`	`*/`
`269`	`271`	`NullValueCheckStrategy nullValueCheckStrategy() default ON_IMPLICIT_CONVERSION;`
`@@ -276,6 +278,8 @@`
`276`	`278`	`*`
`277`	`279`	`* {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default.`
`278`	`280`	`*`
	`281`	`+ * @since 1.3`
	`282`	`+ *`
`279`	`283`	`* @return The strategy to be applied when {@code null} is passed as source property value or the source property`
`280`	`284`	`* is not present.`
`281`	`285`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -16,6 +16,7 @@`
`16`	`16`	`* {@code @}{@link MappingTarget}).`
`17`	`17`	`*`
`18`	`18`	`* @author Sjaak Derksen`
	`19`	`+ * @since 1.3`
`19`	`20`	`*/`
`20`	`21`	`public enum NullValuePropertyMappingStrategy {`
`21`	`22`
Original file line number	Diff line number	Diff line change
`@@ -19,6 +19,8 @@ public interface AccessorNamingStrategy {`
`19`	`19`	`* Initializes the accessor naming strategy with the MapStruct processing environment.`
`20`	`20`	`*`
`21`	`21`	`* @param processingEnvironment environment for facilities`
	`22`	`+ *`
	`23`	`+ * @since 1.3`
`22`	`24`	`*/`
`23`	`25`	`default void init(MapStructProcessingEnvironment processingEnvironment) {`
`24`	`26`
Original file line number	Diff line number	Diff line change
`@@ -12,6 +12,8 @@`
`12`	`12`	`* Holder for the builder information.`
`13`	`13`	`*`
`14`	`14`	`* @author Filip Hrisafov`
	`15`	`+ *`
	`16`	`+ * @since 1.3`
`15`	`17`	`*/`
`16`	`18`	`public class BuilderInfo {`
`17`	`19`
Original file line number	Diff line number	Diff line change
`@@ -15,6 +15,8 @@`
`15`	`15`	`*`
`16`	`16`	`* @author Filip Hrisafov`
`17`	`17`	`* @see javax.annotation.processing.ProcessingEnvironment`
	`18`	`+ *`
	`19`	`+ * @since 1.3`
`18`	`20`	`*/`
`19`	`21`	`public interface MapStructProcessingEnvironment {`
`20`	`22`