List of type annotations is hard-coded

Author: mernst

CHANGES.md

@@ -11,7 +11,7 @@ We adhere to the [keepachangelog](https://keepachangelog.com/en/1.0.0/) format (
 
 ## [Unreleased]
 ### Added
-* `typeAnnotations()` step to correct formatting of type annotations.  It puts type annotations on the same line as the type that they qualify.  Run it after a Java formattng step, such as `googleJavaFormat()`. ([#1275](https://github.com/diffplug/spotless/pull/1275))
+* `typeAnnotations()` step to correct formatting of type annotations.  It puts type annotations on the same line as the type that they qualify.  Run it after a Java formatting step, such as `googleJavaFormat()`. ([#1275](https://github.com/diffplug/spotless/pull/1275))
 
 ## [2.29.0] - 2022-08-23
 ### Added

plugin-gradle/CHANGES.md

@@ -4,7 +4,7 @@ We adhere to the [keepachangelog](https://keepachangelog.com/en/1.0.0/) format (
 
 ## [Unreleased]
 ### Added
-* `typeAnnotations()` step to correct formatting of type annotations.  It puts type annotations on the same line as the type that they qualify.  Run it after a Java formattng step, such as `googleJavaFormat()`. ([#1275](https://github.com/diffplug/spotless/pull/1275))
+* `typeAnnotations()` step to correct formatting of type annotations.  It puts type annotations on the same line as the type that they qualify.  Run it after a Java formatting step, such as `googleJavaFormat()`. ([#1275](https://github.com/diffplug/spotless/pull/1275))
 
 ## [6.10.0] - 2022-08-23
 ### Added

plugin-gradle/README.md

@@ -262,8 +262,6 @@ 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
@@ -287,6 +285,11 @@ spotless {
 
 This does not re-order annotations, it just removes incorrect newlines.
 
+A type annotation is an annotation that is meta-annotated with `@Target({ElementType.TYPE_USE})`.
+Because Spotless cannot necessarily examine the annotation definition, it uses a hard-coded
+list of well-known type annotations.  You can make a pull request to add new ones.
+In the future there will be mechanisms to add/remove annotations from the list.
+
 
 <a name="applying-to-groovy-source"></a>
 

plugin-maven/CHANGES.md

@@ -4,7 +4,7 @@ We adhere to the [keepachangelog](https://keepachangelog.com/en/1.0.0/) format (
 
 ## [Unreleased]
 ### Added
-* `typeAnnotations` step to correct formatting of type annotations.  It puts type annotations on the same line as the type that they qualify.  Run it after a Java formattng step, such as `googleJavaFormat`. ([#1275](https://github.com/diffplug/spotless/pull/1275))
+* `typeAnnotations` step to correct formatting of type annotations.  It puts type annotations on the same line as the type that they qualify.  Run it after a Java formatting step, such as `googleJavaFormat`. ([#1275](https://github.com/diffplug/spotless/pull/1275))
 
 ## [2.25.0] - 2022-08-23
 ### Added

plugin-maven/README.md

@@ -267,8 +267,6 @@ 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
@@ -288,6 +286,12 @@ To fix the incorrect formatting, add the `typeAnnotations()` rule after a Java f
 
 This does not re-order annotations, it just removes incorrect newlines.
 
+A type annotation is an annotation that is meta-annotated with `@Target({ElementType.TYPE_USE})`.
+Because Spotless cannot necessarily examine the annotation definition, it uses a hard-coded
+list of well-known type annotations.  You can make a pull request to add new ones.
+In the future there will be mechanisms to add/remove annotations from the list.
+
+
 ## Groovy
 
 [code](https://github.com/diffplug/spotless/blob/main/plugin-maven/src/main/java/com/diffplug/spotless/maven/groovy/Groovy.java). [available steps](https://github.com/diffplug/spotless/tree/main/plugin-maven/src/main/java/com/diffplug/spotless/maven/groovy).