On branch jakartaee-api-main https://dev.azure.com/jakarta-ee-azdo/jakarta-ee-azdo/_workitems/edit/268

FAQ: grep thru maven output to see the invocation order of plugins

grep "^\[INFO\] --- " message.txt

Find command to show all relevant package-info.java files.

find ./jakartaee-web-api/target/api-javadoc/jakarta.xml.ws/jakarta/xml/ws/wsaddressing ./jakartaee-web-api/target/sources-dependency/jakarta.xml.ws/jakarta/xml/ws/wsaddressing ./jakartaee-web-api/target/sources-dependency/jakarta/xml/ws/wsaddressing ./jakartaee-web-api/target/api-sources-tmp/jakarta.xml.ws-api-sources-jar/jakarta/xml/ws/wsaddressing ./jakartaee-web-api/target/api-sources/jakarta.xml.ws/jakarta/xml/ws/wsaddressing ./jakartaee-web-api/target/apidocs/jakarta/xml/ws/wsaddressing ./jakartaee-api/target/api-javadoc/jakarta.xml.ws/jakarta/xml/ws/wsaddressing ./jakartaee-api/target/sources-dependency/jakarta.xml.ws/jakarta/xml/ws/wsaddressing ./jakartaee-api/target/sources-dependency/jakarta/xml/ws/wsaddressing ./jakartaee-api/target/api-sources-tmp/jakarta.xml.ws-api-sources-jar/jakarta/xml/ws/wsaddressing ./jakartaee-api/target/api-sources/jakarta.xml.ws/jakarta/xml/ws/wsaddressing -name package-info.java -exec cat {} \; -print

We find that the overwrite we perform in prepare-sources-platform produces the correct file, with the correct content in the correct place.
We find that this file is overwritten with the problematic content before the javadoc is generated.
We must identify who is doing the overwriting and when they are doing it.

Using the above grep, I discerned this is the plugins invoked, in order.

[INFO] --- clean:3.2.0:clean (default-clean) @ jakartaee-api-parent ---
[INFO] --- enforcer:3.4.1:enforce (enforce-maven) @ jakartaee-api-parent ---
[INFO] --- resources:2.4.3:copy-resources (copy-javadoc-resources) @ jakartaee-api-parent ---
[INFO] --- cyclonedx:2.7.9:makeAggregateBom (default) @ jakartaee-api-parent ---
[INFO] --- source:2.1:jar-no-fork (attach-sources) @ jakartaee-api-parent ---
[INFO] --- javadoc:3.1.0:jar (attach-javadocs) @ jakartaee-api-parent ---
[INFO] --- clean:3.2.0:clean (default-clean) @ jakarta.jakartaee-bom ---
[INFO] --- enforcer:3.4.1:enforce (enforce-maven) @ jakarta.jakartaee-bom ---
[INFO] --- resources:2.4.3:copy-resources (copy-javadoc-resources) @ jakarta.jakartaee-bom ---
[INFO] --- cyclonedx:2.7.9:makeAggregateBom (default) @ jakarta.jakartaee-bom ---
[INFO] --- source:2.1:jar-no-fork (attach-sources) @ jakarta.jakartaee-bom ---
[INFO] --- javadoc:3.1.0:jar (attach-javadocs) @ jakarta.jakartaee-bom ---
[INFO] --- glassfishbuild:3.2.28:generate-pom (generate-pom) @ jakarta.jakartaee-bom ---
[INFO] --- clean:3.2.0:clean (default-clean) @ jakarta.jakartaee-core-api ---
[INFO] --- enforcer:3.4.1:enforce (enforce-maven) @ jakarta.jakartaee-core-api ---
[INFO] --- dependency:3.6.0:unpack-dependencies (unpack-sources) @ jakarta.jakartaee-core-api ---
[INFO] --- antrun:3.1.0:run (prepare-sources) @ jakarta.jakartaee-core-api ---
[INFO] --- glassfishbuild:3.2.28:unpack-sources (unpack-sources) @ jakarta.jakartaee-core-api ---
[INFO] --- resources:2.4.3:resources (default-resources) @ jakarta.jakartaee-core-api ---
[INFO] --- resources:2.4.3:copy-resources (copy-javadoc-resources) @ jakarta.jakartaee-core-api ---
[INFO] --- compiler:3.8.1:compile (default-compile) @ jakarta.jakartaee-core-api ---
[INFO] --- antrun:3.1.0:run (build-javadocs) @ jakarta.jakartaee-core-api ---
[INFO] --- resources:2.4.3:testResources (default-testResources) @ jakarta.jakartaee-core-api ---
[INFO] --- compiler:3.8.1:testCompile (default-testCompile) @ jakarta.jakartaee-core-api ---
[INFO] --- surefire:3.0.0-M8:test (default-test) @ jakarta.jakartaee-core-api ---
[INFO] --- jar:2.4:jar (default-jar) @ jakarta.jakartaee-core-api ---
[INFO] --- cyclonedx:2.7.9:makeAggregateBom (default) @ jakarta.jakartaee-core-api ---
[INFO] --- glassfishbuild:3.2.28:generate-pom (generate-pom) @ jakarta.jakartaee-core-api ---
[INFO] --- source:2.1:jar-no-fork (attach-sources) @ jakarta.jakartaee-core-api ---
[INFO] --- javadoc:3.1.0:jar (attach-javadocs) @ jakarta.jakartaee-core-api ---
[INFO] --- clean:3.2.0:clean (default-clean) @ jakarta.jakartaee-web-api ---
[INFO] --- enforcer:3.4.1:enforce (enforce-maven) @ jakarta.jakartaee-web-api ---
[INFO] --- dependency:3.6.0:unpack-dependencies (unpack-sources) @ jakarta.jakartaee-web-api ---
[INFO] --- antrun:3.1.0:run (prepare-sources) @ jakarta.jakartaee-web-api ---
[INFO] --- antrun:3.1.0:run (prepare-sources-web) @ jakarta.jakartaee-web-api ---
[INFO] --- glassfishbuild:3.2.28:unpack-sources (unpack-sources) @ jakarta.jakartaee-web-api ---
[INFO] --- resources:2.4.3:resources (default-resources) @ jakarta.jakartaee-web-api ---
[INFO] --- resources:2.4.3:copy-resources (copy-javadoc-resources) @ jakarta.jakartaee-web-api ---
[INFO] --- compiler:3.8.1:compile (default-compile) @ jakarta.jakartaee-web-api ---
[INFO] --- antrun:3.1.0:run (build-javadocs) @ jakarta.jakartaee-web-api ---
[INFO] --- resources:2.4.3:testResources (default-testResources) @ jakarta.jakartaee-web-api ---
[INFO] --- compiler:3.8.1:testCompile (default-testCompile) @ jakarta.jakartaee-web-api ---
[INFO] --- surefire:3.0.0-M8:test (default-test) @ jakarta.jakartaee-web-api ---
[INFO] --- jar:2.4:jar (default-jar) @ jakarta.jakartaee-web-api ---
[INFO] --- cyclonedx:2.7.9:makeAggregateBom (default) @ jakarta.jakartaee-web-api ---
[INFO] --- source:2.1:jar-no-fork (attach-sources) @ jakarta.jakartaee-web-api ---
[INFO] --- glassfishbuild:3.2.28:generate-pom (generate-pom) @ jakarta.jakartaee-web-api ---
[INFO] --- javadoc:3.1.0:jar (attach-javadocs) @ jakarta.jakartaee-web-api ---
[INFO] --- clean:3.2.0:clean (default-clean) @ jakarta.jakartaee-api ---
[INFO] --- enforcer:3.4.1:enforce (enforce-maven) @ jakarta.jakartaee-api ---
[INFO] --- dependency:3.6.0:unpack-dependencies (unpack-sources) @ jakarta.jakartaee-api ---
[INFO] --- antrun:3.1.0:run (prepare-sources) @ jakarta.jakartaee-api ---
[INFO] --- antrun:3.1.0:run (prepare-sources-web) @ jakarta.jakartaee-api ---
[INFO] --- antrun:3.1.0:run (prepare-sources-platform) @ jakarta.jakartaee-api ---
[INFO] --- glassfishbuild:3.2.28:unpack-sources (unpack-sources) @ jakarta.jakartaee-api ---
[INFO] --- resources:2.4.3:resources (default-resources) @ jakarta.jakartaee-api ---
[INFO] --- resources:2.4.3:copy-resources (copy-javadoc-resources) @ jakarta.jakartaee-api ---
[INFO] --- compiler:3.8.1:compile (default-compile) @ jakarta.jakartaee-api ---
[INFO] --- antrun:3.1.0:run (build-javadocs) @ jakarta.jakartaee-api ---
[INFO] --- resources:2.4.3:testResources (default-testResources) @ jakarta.jakartaee-api ---
[INFO] --- compiler:3.8.1:testCompile (default-testCompile) @ jakarta.jakartaee-api ---
[INFO] --- surefire:3.0.0-M8:test (default-test) @ jakarta.jakartaee-api ---
[INFO] --- jar:2.4:jar (default-jar) @ jakarta.jakartaee-api ---
[INFO] --- cyclonedx:2.7.9:makeAggregateBom (default) @ jakarta.jakartaee-api ---
[INFO] --- source:2.1:jar-no-fork (attach-sources) @ jakarta.jakartaee-api ---
[INFO] --- glassfishbuild:3.2.28:generate-pom (generate-pom) @ jakarta.jakartaee-api ---
[INFO] --- javadoc:3.1.0:jar (attach-javadocs) @ jakarta.jakartaee-api ---

We learned that the initial file was getting written at

[INFO] --- antrun:3.1.0:run (prepare-sources) @ jakarta.jakartaee-web-api ---

And promptly overwritten at

[INFO] --- glassfishbuild:3.2.28:unpack-sources (unpack-sources) @ jakarta.jakartaee-web-api ---

We learned the

[INFO] --- javadoc:3.1.0:jar (attach-javadocs) @ jakarta.jakartaee-api ---

was being invoked in the package phase.

So, we moved the <echo> out into its own <execution> of <maven-antrun-plugin> and bound it to the prepare-package package phase. This caused the echo to overwrite the file as appropriate

jakartaee / jakartaee-api

On branch jakartaee-api-main https://dev.azure.com/jakarta-ee-azdo/jakarta-ee-azdo/_workitems/edit/268 #151