From 2628d4ed32294ea5aae28c547f501ba65fb0ce18 Mon Sep 17 00:00:00 2001
From: Mihai Nita <nmihai_2000@yahoo.com>
Date: Mon, 24 Mar 2025 12:05:35 -0700
Subject: [PATCH] ICU-23040 Doclet migration: add a way to run CheckTags

This is handy to have.

One can checkout at this CL and generate a report using the old version,
imperfect as it is.

That can be used for reference when trying to fix / improve the tool after
the migration to the new APIs.
---
 icu4j/pom.xml | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/icu4j/pom.xml b/icu4j/pom.xml
index 7d1e20c12bc..4eae13eb387 100644
--- a/icu4j/pom.xml
+++ b/icu4j/pom.xml
@@ -652,6 +652,42 @@
       </build>
     </profile>
 
+    <!-- This is used to check that all API are properly tagged
+      (regular, draft, deprecated, status consistency, etc.)
+      To run it:
+        mvn install -DskipITs -DskipTests
+        mvn site -DskipITs -DskipTests -P checktags
+    -->
+    <profile>
+      <id>checktags</id>
+      <build>
+        <plugins>
+          <plugin>
+            <artifactId>maven-javadoc-plugin</artifactId>
+            <executions>
+              <execution>
+                <id>aggregate</id>
+                <phase>site</phase>
+                <goals>
+                  <goal>aggregate</goal>
+                </goals>
+              </execution>
+            </executions>
+            <configuration>
+              <failOnError>false</failOnError>
+              <useStandardDocletOptions>false</useStandardDocletOptions>
+              <doclet>com.ibm.icu.dev.tool.docs.CheckTags</doclet>
+              <docletArtifact>
+                <groupId>com.ibm.icu</groupId>
+                <artifactId>tools_build</artifactId>
+                <version>${project.version}</version>
+              </docletArtifact>
+            </configuration>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+
     <!-- The tools/build module depends on the old tools.jar (jdk 1.8)
       The com.sun.javadoc package was deprecated in Java 11, and has been removed for Java 17.
       JDK 11 does not include tools.jar anymore. The code must be updated, see migration guide at