aboutsummaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
Diffstat (limited to 'src')
-rw-r--r--src/core/lombok/Builder.java7
1 files changed, 5 insertions, 2 deletions
diff --git a/src/core/lombok/Builder.java b/src/core/lombok/Builder.java
index 5bb978be..0639c4cb 100644
--- a/src/core/lombok/Builder.java
+++ b/src/core/lombok/Builder.java
@@ -124,14 +124,17 @@ public @interface Builder {
/**
* If true, generate an instance method to obtain a builder that is initialized with the values of this instance.
- * Legal only if {@code @Builder} is used on a constructor, on the type itself, or on a static method that returns itself.
+ * Legal only if {@code @Builder} is used on a constructor, on the type itself, or on a static method that returns
+ * an instance of the declaring type.
*/
boolean toBuilder() default false;
/**
* Put on a field (in case of {@code @Builder} on a type) or a parameter (for {@code @Builder} on a constructor or static method) to
- * indicate how lombok should obtain a value for this given an instance; this is only relevant if {@code toBuilder} is true.
+ * indicate how lombok should obtain a value for this field or parameter given an instance; this is only relevant if {@code toBuilder} is {@code true}.
*
+ * You do not need to supply an {@code @ObtainVia} annotation unless you wish to change the default behaviour: Use a field with the same name.
+ * <p>
* Note that one of {@code field} or {@code method} should be set, or an error is generated.
* <p>
* The default behaviour is to obtain a value by referencing the name of the parameter as a field on 'this'.