Bug 385564 - [null] document which entities are affected by
@NonNullByDefault
Change-Id: Ie4794e6717b798d3132c4ad6a0d311e5be80b7e6
diff --git a/org.eclipse.jdt.annotation/src/org/eclipse/jdt/annotation/NonNullByDefault.java b/org.eclipse.jdt.annotation/src/org/eclipse/jdt/annotation/NonNullByDefault.java
index bb0f9b9..d5e5aa7 100644
--- a/org.eclipse.jdt.annotation/src/org/eclipse/jdt/annotation/NonNullByDefault.java
+++ b/org.eclipse.jdt.annotation/src/org/eclipse/jdt/annotation/NonNullByDefault.java
@@ -23,8 +23,14 @@
/**
* This annotation can be applied to a package, type, method or constructor in order to
- * define that all contained entities for which a null annotation is otherwise lacking
- * should be considered as {@link NonNull @NonNull}.
+ * define that contained entities for which a null annotation is otherwise lacking
+ * should be considered as {@link NonNull @NonNull}. Entities affected by
+ * <code>@NonNullByDefault</code> are:
+ * <ul>
+ * <li>method return values</li>
+ * <li>parameters of a method or constructor.</li>
+ * </ul>
+ * Local variables are <em>not</em> affected.
* <dl>
* <dt>Canceling a default</dt>
* <dd>By using a <code>@NonNullByDefault</code> annotation with the argument <code>false</code>,
