Define "type annotation"

Author: mernst

lib/src/main/java/com/diffplug/spotless/java/TypeAnnotationsStep.java

@@ -30,6 +30,9 @@
  * -- even type annotations, which should be on the same line as the type they qualify.
  * This class corrects the formatting.
  * This is useful as a postprocessing step after a Java formatter that is not cognizant of type annotations.
+
+ * <p>
+ * Note: A type annotation is an annotation that is meta-annotated with {@code @Target({ElementType.TYPE_USE})}.
  */
 public final class TypeAnnotationsStep {
 	private TypeAnnotationsStep() {}
@@ -54,6 +57,7 @@ private static final class State implements Serializable {
 						// Type annotations from the Checker Framework and all the tools it
 						// supports, including FindBugs, JetBrains (IntelliJ), Eclipse, NetBeans,
 						// Spring, JML, Android, etc.
+						// A type annotation is an annotation that is meta-annotated with @Target({ElementType.TYPE_USE}).
 						"A",
 						"ACCBottom",
 						"Acceleration",

plugin-gradle/README.md

@@ -262,6 +262,8 @@ Type annotations should be on the same line as the type that they qualify.
   @Nullable @Interned String s;
 ```
 
+(A type annotation is an annotation that is meta-annotated with `@Target({ElementType.TYPE_USE})`.)
+
 However, some tools format them incorrectly, like this:
 
 ```java

plugin-maven/README.md

@@ -267,6 +267,8 @@ Type annotations should be on the same line as the type that they qualify.
   @Nullable @Interned String s;
 ```
 
+(A type annotation is an annotation that is meta-annotated with `@Target({ElementType.TYPE_USE})`.)
+
 However, some tools format them incorrectly, like this:
 
 ```java