[fixes #3147] Copy javadoc to generated SuperBuilder

test/transform/resource/before/SuperBuilderJavadoc.java

@@ -0,0 +1,53 @@
+import java.util.List;
+
+@lombok.experimental.SuperBuilder
+public abstract class SuperBuilderJavadoc {
+	/**
+	 * basic gets only a builder setter.
+	 * @see #getsetwith
+	 * @param tag is moved to the setter.
+	 * @return tag is removed from the setter.
+	 */
+	private final int basic;
+
+	/**
+	 * getsetwith gets a builder setter, an instance getter and setter, and a wither.
+	 * @param tag is moved to the setters and wither.
+	 * @return tag is moved to the getter.
+	 */
+	@lombok.Getter
+	@lombok.Setter
+	@lombok.experimental.Wither
+	private int getsetwith;
+
+	/**
+	 * Predef has a predefined builder setter with no javadoc, and the builder setter does not get this one.
+	 * @param tag remains on the field.
+	 * @return tag remains on the field.
+	 */
+	private final int predef;
+
+	/**
+	 * predefWithJavadoc has a predefined builder setter with javadoc, so it keeps that one untouched.
+	 * @param tag is removed from the field.
+	 * @return tag remains on the field.
+	 */
+	private final int predefWithJavadoc;
+
+	public static abstract class SuperBuilderJavadocBuilder<C extends SuperBuilderJavadoc, B extends SuperBuilderJavadocBuilder<C, B>> {
+		public B predef(final int x) {
+			this.predef = x * 10;
+			return self();
+		}
+
+		/**
+		 * This javadoc remains untouched.
+		 * @param x 1/100 of the thing
+		 * @return the updated builder
+		 */
+		public B predefWithJavadoc(final int x) {
+			this.predefWithJavadoc = x * 100;
+			return self();
+		}
+	}
+}