diff options
Diffstat (limited to 'src/core')
| -rw-r--r-- | src/core/lombok/Builder.java | 7 |
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'. |