You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@maven.apache.org by Gary Gregory <ga...@gmail.com> on 2025/01/19 12:43:40 UTC
Re: Javadoc warning: The code being documented uses packages in the unnamed module
Any thoughts on this?
Ty,
Gary
On Tue, Dec 17, 2024, 09:47 Gary D. Gregory <gg...@apache.org> wrote:
> Hi All:
>
> I'd like to build Apache Commons components with the build failing if
> there are Javadoc warnings. This idea would fail today for all components
> because we get this Javadoc warning:
>
> [INFO] --- javadoc:3.10.1:javadoc (default-cli) @ commons-csv ---
> [INFO] Configuration changed, re-generating javadoc.
> [WARNING] Javadoc Warnings
> [WARNING] warning: The code being documented uses packages in the unnamed
> module, but the packages defined in
> https://docs.oracle.com/en/java/javase/21/docs/api/ are in named modules.
> [WARNING] 1 warning
>
> For example, the above is from:
>
> git clone https://gitbox.apache.org/repos/asf/commons-csv.git
> cd commons-csv
> mvn clean package javadoc:javadoc -DskipTests
> -Dcommons.javadoc.version=3.11.2
>
> - The target byte code is Java 8, I never build with Java 8, always 17 or
> 21.
> - The GitHub CI builds with all Java LTS versions plus the latest and the
> latest EA.
> - The target JAR file includes JPMS module info generated by the Moditect
> plugin, works like a charm.
>
> Googling doesn't help much, using -X to get debug output doesn't seem
> helpful to me, but it is interesting that -X does not enable "verbose" for
> the Javadoc command.
>
> Is this some more JPMS messiness that I somehow need to account for in my
> POM? If so, any clues as to how do it?
>
> TY!
> Gary
>
> PS: My setup today:
>
> Microsoft Windows [Version 10.0.19045.5131]
> ~
> openjdk version "21.0.4" 2024-07-16 LTS
> OpenJDK Runtime Environment Temurin-21.0.4+7 (build 21.0.4+7-LTS)
> OpenJDK 64-Bit Server VM Temurin-21.0.4+7 (build 21.0.4+7-LTS, mixed mode,
> sharing)
> ~
> Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
> Maven home: C:\java\apache-maven-3.9.9
> Java version: 21.0.4, vendor: Eclipse Adoptium, runtime: C:\Program
> Files\Eclipse Adoptium\jdk-21.0.4.7-hotspot
> Default locale: en_US, platform encoding: UTF-8
> OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
> ~
> Docker version 27.3.1, build ce12230
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>
Re: Javadoc warning: The code being documented uses packages in the unnamed module
Posted by Gary Gregory <ga...@gmail.com>.
FYI, this is fixed this in the Commons parent POM, Javadoc does not
like you to link to Javadocs for Java 21 when the target release is
Java 8 (using Javadoc 17). I don't know what the version boundaries
are for the various pieces. Now, the build will just link to the
Javadoc that matches the target which is what it should have been
doing anyway.
TY
Gary
On Sun, Jan 19, 2025 at 2:25 PM Gary Gregory <ga...@gmail.com> wrote:
>
> On Sun, Jan 19, 2025 at 2:24 PM Gary Gregory <ga...@gmail.com> wrote:
> >
> > Right, if I run "mvn javadoc:javadoc -X", I see:
> >
> > [DEBUG] (f) release = 8
>
> The above is logged as part of:
>
> [DEBUG] Configuring mojo execution
> 'org.apache.maven.plugins:maven-javadoc-plugin:3.11.2:javadoc:default-cli'
> with basic configurator -->
>
> Gary
>
> >
> > So it feels like there is something else missing or at play.
> >
> > Gary
> >
> > On Sun, Jan 19, 2025 at 2:22 PM Thomas Broyer <t....@gmail.com> wrote:
> > >
> > > maven.compiler.release is set here
> > > https://github.com/apache/commons-parent/blob/87e668d63c62f57175585625d0176fc130ced38f/pom.xml#L1730
> > >
> > > On Sun, Jan 19, 2025 at 6:45 PM Tamás Cservenák <ta...@cservenak.net> wrote:
> > >
> > > > Hm, I dont see it here
> > > >
> > > > https://github.com/apache/commons-parent/blob/87e668d63c62f57175585625d0176fc130ced38f/pom.xml#L440
> > > >
> > > > I meant:
> > > >
> > > > https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#release
> > > >
> > > > On Sun, Jan 19, 2025 at 6:37 PM Gary Gregory <ga...@gmail.com>
> > > > wrote:
> > > > >
> > > > > Of course ;-) that's baked in our parent POM and set to 8 for most
> > > > > components.
> > > > >
> > > > > Gary
> > > > >
> > > > > On Sun, Jan 19, 2025, 11:35 Tamás Cservenák <ta...@cservenak.net> wrote:
> > > > >
> > > > > > Howdy.
> > > > > >
> > > > > > Did you try
> > > > > >
> > > > > >
> > > > https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release
> > > > > > ?
> > > > > >
> > > > > > I think javadoc has a "release" param... so no need to mess with args
> > > > or
> > > > > > alike
> > > > > >
> > > > > > Thanks
> > > > > >
> > > > > > On Sun, Jan 19, 2025 at 1:44 PM Gary Gregory <ga...@gmail.com>
> > > > > > wrote:
> > > > > > >
> > > > > > > Any thoughts on this?
> > > > > > >
> > > > > > > Ty,
> > > > > > > Gary
> > > > > > >
> > > > > > > On Tue, Dec 17, 2024, 09:47 Gary D. Gregory <gg...@apache.org>
> > > > wrote:
> > > > > > >
> > > > > > > > Hi All:
> > > > > > > >
> > > > > > > > I'd like to build Apache Commons components with the build failing
> > > > if
> > > > > > > > there are Javadoc warnings. This idea would fail today for all
> > > > > > components
> > > > > > > > because we get this Javadoc warning:
> > > > > > > >
> > > > > > > > [INFO] --- javadoc:3.10.1:javadoc (default-cli) @ commons-csv ---
> > > > > > > > [INFO] Configuration changed, re-generating javadoc.
> > > > > > > > [WARNING] Javadoc Warnings
> > > > > > > > [WARNING] warning: The code being documented uses packages in the
> > > > > > unnamed
> > > > > > > > module, but the packages defined in
> > > > > > > > https://docs.oracle.com/en/java/javase/21/docs/api/ are in named
> > > > > > modules.
> > > > > > > > [WARNING] 1 warning
> > > > > > > >
> > > > > > > > For example, the above is from:
> > > > > > > >
> > > > > > > > git clone https://gitbox.apache.org/repos/asf/commons-csv.git
> > > > > > > > cd commons-csv
> > > > > > > > mvn clean package javadoc:javadoc -DskipTests
> > > > > > > > -Dcommons.javadoc.version=3.11.2
> > > > > > > >
> > > > > > > > - The target byte code is Java 8, I never build with Java 8,
> > > > always 17
> > > > > > or
> > > > > > > > 21.
> > > > > > > > - The GitHub CI builds with all Java LTS versions plus the latest
> > > > and
> > > > > > the
> > > > > > > > latest EA.
> > > > > > > > - The target JAR file includes JPMS module info generated by the
> > > > > > Moditect
> > > > > > > > plugin, works like a charm.
> > > > > > > >
> > > > > > > > Googling doesn't help much, using -X to get debug output doesn't
> > > > seem
> > > > > > > > helpful to me, but it is interesting that -X does not enable
> > > > "verbose"
> > > > > > for
> > > > > > > > the Javadoc command.
> > > > > > > >
> > > > > > > > Is this some more JPMS messiness that I somehow need to account
> > > > for in
> > > > > > my
> > > > > > > > POM? If so, any clues as to how do it?
> > > > > > > >
> > > > > > > > TY!
> > > > > > > > Gary
> > > > > > > >
> > > > > > > > PS: My setup today:
> > > > > > > >
> > > > > > > > Microsoft Windows [Version 10.0.19045.5131]
> > > > > > > > ~
> > > > > > > > openjdk version "21.0.4" 2024-07-16 LTS
> > > > > > > > OpenJDK Runtime Environment Temurin-21.0.4+7 (build 21.0.4+7-LTS)
> > > > > > > > OpenJDK 64-Bit Server VM Temurin-21.0.4+7 (build 21.0.4+7-LTS,
> > > > mixed
> > > > > > mode,
> > > > > > > > sharing)
> > > > > > > > ~
> > > > > > > > Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
> > > > > > > > Maven home: C:\java\apache-maven-3.9.9
> > > > > > > > Java version: 21.0.4, vendor: Eclipse Adoptium, runtime: C:\Program
> > > > > > > > Files\Eclipse Adoptium\jdk-21.0.4.7-hotspot
> > > > > > > > Default locale: en_US, platform encoding: UTF-8
> > > > > > > > OS name: "windows 10", version: "10.0", arch: "amd64", family:
> > > > > > "windows"
> > > > > > > > ~
> > > > > > > > Docker version 27.3.1, build ce12230
> > > > > > > >
> > > > > > > >
> > > > > > > >
> > > > ---------------------------------------------------------------------
> > > > > > > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > > > > > > For additional commands, e-mail: users-help@maven.apache.org
> > > > > > > >
> > > > > > > >
> > > > > >
> > > > > > ---------------------------------------------------------------------
> > > > > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > > > > For additional commands, e-mail: users-help@maven.apache.org
> > > > > >
> > > > > >
> > > >
> > > > ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > > For additional commands, e-mail: users-help@maven.apache.org
> > > >
> > > >
> > >
> > > --
> > > Thomas Broyer
> > > /tɔ.ma.bʁwa.je/ <http://xn--nna.ma.xn--bwa-xxb.je/>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
Re: Javadoc warning: The code being documented uses packages in the unnamed module
Posted by Gary Gregory <ga...@gmail.com>.
On Sun, Jan 19, 2025 at 2:24 PM Gary Gregory <ga...@gmail.com> wrote:
>
> Right, if I run "mvn javadoc:javadoc -X", I see:
>
> [DEBUG] (f) release = 8
The above is logged as part of:
[DEBUG] Configuring mojo execution
'org.apache.maven.plugins:maven-javadoc-plugin:3.11.2:javadoc:default-cli'
with basic configurator -->
Gary
>
> So it feels like there is something else missing or at play.
>
> Gary
>
> On Sun, Jan 19, 2025 at 2:22 PM Thomas Broyer <t....@gmail.com> wrote:
> >
> > maven.compiler.release is set here
> > https://github.com/apache/commons-parent/blob/87e668d63c62f57175585625d0176fc130ced38f/pom.xml#L1730
> >
> > On Sun, Jan 19, 2025 at 6:45 PM Tamás Cservenák <ta...@cservenak.net> wrote:
> >
> > > Hm, I dont see it here
> > >
> > > https://github.com/apache/commons-parent/blob/87e668d63c62f57175585625d0176fc130ced38f/pom.xml#L440
> > >
> > > I meant:
> > >
> > > https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#release
> > >
> > > On Sun, Jan 19, 2025 at 6:37 PM Gary Gregory <ga...@gmail.com>
> > > wrote:
> > > >
> > > > Of course ;-) that's baked in our parent POM and set to 8 for most
> > > > components.
> > > >
> > > > Gary
> > > >
> > > > On Sun, Jan 19, 2025, 11:35 Tamás Cservenák <ta...@cservenak.net> wrote:
> > > >
> > > > > Howdy.
> > > > >
> > > > > Did you try
> > > > >
> > > > >
> > > https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release
> > > > > ?
> > > > >
> > > > > I think javadoc has a "release" param... so no need to mess with args
> > > or
> > > > > alike
> > > > >
> > > > > Thanks
> > > > >
> > > > > On Sun, Jan 19, 2025 at 1:44 PM Gary Gregory <ga...@gmail.com>
> > > > > wrote:
> > > > > >
> > > > > > Any thoughts on this?
> > > > > >
> > > > > > Ty,
> > > > > > Gary
> > > > > >
> > > > > > On Tue, Dec 17, 2024, 09:47 Gary D. Gregory <gg...@apache.org>
> > > wrote:
> > > > > >
> > > > > > > Hi All:
> > > > > > >
> > > > > > > I'd like to build Apache Commons components with the build failing
> > > if
> > > > > > > there are Javadoc warnings. This idea would fail today for all
> > > > > components
> > > > > > > because we get this Javadoc warning:
> > > > > > >
> > > > > > > [INFO] --- javadoc:3.10.1:javadoc (default-cli) @ commons-csv ---
> > > > > > > [INFO] Configuration changed, re-generating javadoc.
> > > > > > > [WARNING] Javadoc Warnings
> > > > > > > [WARNING] warning: The code being documented uses packages in the
> > > > > unnamed
> > > > > > > module, but the packages defined in
> > > > > > > https://docs.oracle.com/en/java/javase/21/docs/api/ are in named
> > > > > modules.
> > > > > > > [WARNING] 1 warning
> > > > > > >
> > > > > > > For example, the above is from:
> > > > > > >
> > > > > > > git clone https://gitbox.apache.org/repos/asf/commons-csv.git
> > > > > > > cd commons-csv
> > > > > > > mvn clean package javadoc:javadoc -DskipTests
> > > > > > > -Dcommons.javadoc.version=3.11.2
> > > > > > >
> > > > > > > - The target byte code is Java 8, I never build with Java 8,
> > > always 17
> > > > > or
> > > > > > > 21.
> > > > > > > - The GitHub CI builds with all Java LTS versions plus the latest
> > > and
> > > > > the
> > > > > > > latest EA.
> > > > > > > - The target JAR file includes JPMS module info generated by the
> > > > > Moditect
> > > > > > > plugin, works like a charm.
> > > > > > >
> > > > > > > Googling doesn't help much, using -X to get debug output doesn't
> > > seem
> > > > > > > helpful to me, but it is interesting that -X does not enable
> > > "verbose"
> > > > > for
> > > > > > > the Javadoc command.
> > > > > > >
> > > > > > > Is this some more JPMS messiness that I somehow need to account
> > > for in
> > > > > my
> > > > > > > POM? If so, any clues as to how do it?
> > > > > > >
> > > > > > > TY!
> > > > > > > Gary
> > > > > > >
> > > > > > > PS: My setup today:
> > > > > > >
> > > > > > > Microsoft Windows [Version 10.0.19045.5131]
> > > > > > > ~
> > > > > > > openjdk version "21.0.4" 2024-07-16 LTS
> > > > > > > OpenJDK Runtime Environment Temurin-21.0.4+7 (build 21.0.4+7-LTS)
> > > > > > > OpenJDK 64-Bit Server VM Temurin-21.0.4+7 (build 21.0.4+7-LTS,
> > > mixed
> > > > > mode,
> > > > > > > sharing)
> > > > > > > ~
> > > > > > > Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
> > > > > > > Maven home: C:\java\apache-maven-3.9.9
> > > > > > > Java version: 21.0.4, vendor: Eclipse Adoptium, runtime: C:\Program
> > > > > > > Files\Eclipse Adoptium\jdk-21.0.4.7-hotspot
> > > > > > > Default locale: en_US, platform encoding: UTF-8
> > > > > > > OS name: "windows 10", version: "10.0", arch: "amd64", family:
> > > > > "windows"
> > > > > > > ~
> > > > > > > Docker version 27.3.1, build ce12230
> > > > > > >
> > > > > > >
> > > > > > >
> > > ---------------------------------------------------------------------
> > > > > > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > > > > > For additional commands, e-mail: users-help@maven.apache.org
> > > > > > >
> > > > > > >
> > > > >
> > > > > ---------------------------------------------------------------------
> > > > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > > > For additional commands, e-mail: users-help@maven.apache.org
> > > > >
> > > > >
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > For additional commands, e-mail: users-help@maven.apache.org
> > >
> > >
> >
> > --
> > Thomas Broyer
> > /tɔ.ma.bʁwa.je/ <http://xn--nna.ma.xn--bwa-xxb.je/>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
Re: Javadoc warning: The code being documented uses packages in the unnamed module
Posted by Gary Gregory <ga...@gmail.com>.
Right, if I run "mvn javadoc:javadoc -X", I see:
[DEBUG] (f) release = 8
So it feels like there is something else missing or at play.
Gary
On Sun, Jan 19, 2025 at 2:22 PM Thomas Broyer <t....@gmail.com> wrote:
>
> maven.compiler.release is set here
> https://github.com/apache/commons-parent/blob/87e668d63c62f57175585625d0176fc130ced38f/pom.xml#L1730
>
> On Sun, Jan 19, 2025 at 6:45 PM Tamás Cservenák <ta...@cservenak.net> wrote:
>
> > Hm, I dont see it here
> >
> > https://github.com/apache/commons-parent/blob/87e668d63c62f57175585625d0176fc130ced38f/pom.xml#L440
> >
> > I meant:
> >
> > https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#release
> >
> > On Sun, Jan 19, 2025 at 6:37 PM Gary Gregory <ga...@gmail.com>
> > wrote:
> > >
> > > Of course ;-) that's baked in our parent POM and set to 8 for most
> > > components.
> > >
> > > Gary
> > >
> > > On Sun, Jan 19, 2025, 11:35 Tamás Cservenák <ta...@cservenak.net> wrote:
> > >
> > > > Howdy.
> > > >
> > > > Did you try
> > > >
> > > >
> > https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release
> > > > ?
> > > >
> > > > I think javadoc has a "release" param... so no need to mess with args
> > or
> > > > alike
> > > >
> > > > Thanks
> > > >
> > > > On Sun, Jan 19, 2025 at 1:44 PM Gary Gregory <ga...@gmail.com>
> > > > wrote:
> > > > >
> > > > > Any thoughts on this?
> > > > >
> > > > > Ty,
> > > > > Gary
> > > > >
> > > > > On Tue, Dec 17, 2024, 09:47 Gary D. Gregory <gg...@apache.org>
> > wrote:
> > > > >
> > > > > > Hi All:
> > > > > >
> > > > > > I'd like to build Apache Commons components with the build failing
> > if
> > > > > > there are Javadoc warnings. This idea would fail today for all
> > > > components
> > > > > > because we get this Javadoc warning:
> > > > > >
> > > > > > [INFO] --- javadoc:3.10.1:javadoc (default-cli) @ commons-csv ---
> > > > > > [INFO] Configuration changed, re-generating javadoc.
> > > > > > [WARNING] Javadoc Warnings
> > > > > > [WARNING] warning: The code being documented uses packages in the
> > > > unnamed
> > > > > > module, but the packages defined in
> > > > > > https://docs.oracle.com/en/java/javase/21/docs/api/ are in named
> > > > modules.
> > > > > > [WARNING] 1 warning
> > > > > >
> > > > > > For example, the above is from:
> > > > > >
> > > > > > git clone https://gitbox.apache.org/repos/asf/commons-csv.git
> > > > > > cd commons-csv
> > > > > > mvn clean package javadoc:javadoc -DskipTests
> > > > > > -Dcommons.javadoc.version=3.11.2
> > > > > >
> > > > > > - The target byte code is Java 8, I never build with Java 8,
> > always 17
> > > > or
> > > > > > 21.
> > > > > > - The GitHub CI builds with all Java LTS versions plus the latest
> > and
> > > > the
> > > > > > latest EA.
> > > > > > - The target JAR file includes JPMS module info generated by the
> > > > Moditect
> > > > > > plugin, works like a charm.
> > > > > >
> > > > > > Googling doesn't help much, using -X to get debug output doesn't
> > seem
> > > > > > helpful to me, but it is interesting that -X does not enable
> > "verbose"
> > > > for
> > > > > > the Javadoc command.
> > > > > >
> > > > > > Is this some more JPMS messiness that I somehow need to account
> > for in
> > > > my
> > > > > > POM? If so, any clues as to how do it?
> > > > > >
> > > > > > TY!
> > > > > > Gary
> > > > > >
> > > > > > PS: My setup today:
> > > > > >
> > > > > > Microsoft Windows [Version 10.0.19045.5131]
> > > > > > ~
> > > > > > openjdk version "21.0.4" 2024-07-16 LTS
> > > > > > OpenJDK Runtime Environment Temurin-21.0.4+7 (build 21.0.4+7-LTS)
> > > > > > OpenJDK 64-Bit Server VM Temurin-21.0.4+7 (build 21.0.4+7-LTS,
> > mixed
> > > > mode,
> > > > > > sharing)
> > > > > > ~
> > > > > > Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
> > > > > > Maven home: C:\java\apache-maven-3.9.9
> > > > > > Java version: 21.0.4, vendor: Eclipse Adoptium, runtime: C:\Program
> > > > > > Files\Eclipse Adoptium\jdk-21.0.4.7-hotspot
> > > > > > Default locale: en_US, platform encoding: UTF-8
> > > > > > OS name: "windows 10", version: "10.0", arch: "amd64", family:
> > > > "windows"
> > > > > > ~
> > > > > > Docker version 27.3.1, build ce12230
> > > > > >
> > > > > >
> > > > > >
> > ---------------------------------------------------------------------
> > > > > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > > > > For additional commands, e-mail: users-help@maven.apache.org
> > > > > >
> > > > > >
> > > >
> > > > ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > > For additional commands, e-mail: users-help@maven.apache.org
> > > >
> > > >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > For additional commands, e-mail: users-help@maven.apache.org
> >
> >
>
> --
> Thomas Broyer
> /tɔ.ma.bʁwa.je/ <http://xn--nna.ma.xn--bwa-xxb.je/>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
Re: Javadoc warning: The code being documented uses packages in the unnamed module
Posted by Thomas Broyer <t....@gmail.com>.
maven.compiler.release is set here
https://github.com/apache/commons-parent/blob/87e668d63c62f57175585625d0176fc130ced38f/pom.xml#L1730
On Sun, Jan 19, 2025 at 6:45 PM Tamás Cservenák <ta...@cservenak.net> wrote:
> Hm, I dont see it here
>
> https://github.com/apache/commons-parent/blob/87e668d63c62f57175585625d0176fc130ced38f/pom.xml#L440
>
> I meant:
>
> https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#release
>
> On Sun, Jan 19, 2025 at 6:37 PM Gary Gregory <ga...@gmail.com>
> wrote:
> >
> > Of course ;-) that's baked in our parent POM and set to 8 for most
> > components.
> >
> > Gary
> >
> > On Sun, Jan 19, 2025, 11:35 Tamás Cservenák <ta...@cservenak.net> wrote:
> >
> > > Howdy.
> > >
> > > Did you try
> > >
> > >
> https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release
> > > ?
> > >
> > > I think javadoc has a "release" param... so no need to mess with args
> or
> > > alike
> > >
> > > Thanks
> > >
> > > On Sun, Jan 19, 2025 at 1:44 PM Gary Gregory <ga...@gmail.com>
> > > wrote:
> > > >
> > > > Any thoughts on this?
> > > >
> > > > Ty,
> > > > Gary
> > > >
> > > > On Tue, Dec 17, 2024, 09:47 Gary D. Gregory <gg...@apache.org>
> wrote:
> > > >
> > > > > Hi All:
> > > > >
> > > > > I'd like to build Apache Commons components with the build failing
> if
> > > > > there are Javadoc warnings. This idea would fail today for all
> > > components
> > > > > because we get this Javadoc warning:
> > > > >
> > > > > [INFO] --- javadoc:3.10.1:javadoc (default-cli) @ commons-csv ---
> > > > > [INFO] Configuration changed, re-generating javadoc.
> > > > > [WARNING] Javadoc Warnings
> > > > > [WARNING] warning: The code being documented uses packages in the
> > > unnamed
> > > > > module, but the packages defined in
> > > > > https://docs.oracle.com/en/java/javase/21/docs/api/ are in named
> > > modules.
> > > > > [WARNING] 1 warning
> > > > >
> > > > > For example, the above is from:
> > > > >
> > > > > git clone https://gitbox.apache.org/repos/asf/commons-csv.git
> > > > > cd commons-csv
> > > > > mvn clean package javadoc:javadoc -DskipTests
> > > > > -Dcommons.javadoc.version=3.11.2
> > > > >
> > > > > - The target byte code is Java 8, I never build with Java 8,
> always 17
> > > or
> > > > > 21.
> > > > > - The GitHub CI builds with all Java LTS versions plus the latest
> and
> > > the
> > > > > latest EA.
> > > > > - The target JAR file includes JPMS module info generated by the
> > > Moditect
> > > > > plugin, works like a charm.
> > > > >
> > > > > Googling doesn't help much, using -X to get debug output doesn't
> seem
> > > > > helpful to me, but it is interesting that -X does not enable
> "verbose"
> > > for
> > > > > the Javadoc command.
> > > > >
> > > > > Is this some more JPMS messiness that I somehow need to account
> for in
> > > my
> > > > > POM? If so, any clues as to how do it?
> > > > >
> > > > > TY!
> > > > > Gary
> > > > >
> > > > > PS: My setup today:
> > > > >
> > > > > Microsoft Windows [Version 10.0.19045.5131]
> > > > > ~
> > > > > openjdk version "21.0.4" 2024-07-16 LTS
> > > > > OpenJDK Runtime Environment Temurin-21.0.4+7 (build 21.0.4+7-LTS)
> > > > > OpenJDK 64-Bit Server VM Temurin-21.0.4+7 (build 21.0.4+7-LTS,
> mixed
> > > mode,
> > > > > sharing)
> > > > > ~
> > > > > Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
> > > > > Maven home: C:\java\apache-maven-3.9.9
> > > > > Java version: 21.0.4, vendor: Eclipse Adoptium, runtime: C:\Program
> > > > > Files\Eclipse Adoptium\jdk-21.0.4.7-hotspot
> > > > > Default locale: en_US, platform encoding: UTF-8
> > > > > OS name: "windows 10", version: "10.0", arch: "amd64", family:
> > > "windows"
> > > > > ~
> > > > > Docker version 27.3.1, build ce12230
> > > > >
> > > > >
> > > > >
> ---------------------------------------------------------------------
> > > > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > > > For additional commands, e-mail: users-help@maven.apache.org
> > > > >
> > > > >
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > For additional commands, e-mail: users-help@maven.apache.org
> > >
> > >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>
--
Thomas Broyer
/tɔ.ma.bʁwa.je/ <http://xn--nna.ma.xn--bwa-xxb.je/>
Re: Javadoc warning: The code being documented uses packages in the unnamed module
Posted by Tamás Cservenák <ta...@cservenak.net>.
Hm, I dont see it here
https://github.com/apache/commons-parent/blob/87e668d63c62f57175585625d0176fc130ced38f/pom.xml#L440
I meant:
https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#release
On Sun, Jan 19, 2025 at 6:37 PM Gary Gregory <ga...@gmail.com> wrote:
>
> Of course ;-) that's baked in our parent POM and set to 8 for most
> components.
>
> Gary
>
> On Sun, Jan 19, 2025, 11:35 Tamás Cservenák <ta...@cservenak.net> wrote:
>
> > Howdy.
> >
> > Did you try
> >
> > https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release
> > ?
> >
> > I think javadoc has a "release" param... so no need to mess with args or
> > alike
> >
> > Thanks
> >
> > On Sun, Jan 19, 2025 at 1:44 PM Gary Gregory <ga...@gmail.com>
> > wrote:
> > >
> > > Any thoughts on this?
> > >
> > > Ty,
> > > Gary
> > >
> > > On Tue, Dec 17, 2024, 09:47 Gary D. Gregory <gg...@apache.org> wrote:
> > >
> > > > Hi All:
> > > >
> > > > I'd like to build Apache Commons components with the build failing if
> > > > there are Javadoc warnings. This idea would fail today for all
> > components
> > > > because we get this Javadoc warning:
> > > >
> > > > [INFO] --- javadoc:3.10.1:javadoc (default-cli) @ commons-csv ---
> > > > [INFO] Configuration changed, re-generating javadoc.
> > > > [WARNING] Javadoc Warnings
> > > > [WARNING] warning: The code being documented uses packages in the
> > unnamed
> > > > module, but the packages defined in
> > > > https://docs.oracle.com/en/java/javase/21/docs/api/ are in named
> > modules.
> > > > [WARNING] 1 warning
> > > >
> > > > For example, the above is from:
> > > >
> > > > git clone https://gitbox.apache.org/repos/asf/commons-csv.git
> > > > cd commons-csv
> > > > mvn clean package javadoc:javadoc -DskipTests
> > > > -Dcommons.javadoc.version=3.11.2
> > > >
> > > > - The target byte code is Java 8, I never build with Java 8, always 17
> > or
> > > > 21.
> > > > - The GitHub CI builds with all Java LTS versions plus the latest and
> > the
> > > > latest EA.
> > > > - The target JAR file includes JPMS module info generated by the
> > Moditect
> > > > plugin, works like a charm.
> > > >
> > > > Googling doesn't help much, using -X to get debug output doesn't seem
> > > > helpful to me, but it is interesting that -X does not enable "verbose"
> > for
> > > > the Javadoc command.
> > > >
> > > > Is this some more JPMS messiness that I somehow need to account for in
> > my
> > > > POM? If so, any clues as to how do it?
> > > >
> > > > TY!
> > > > Gary
> > > >
> > > > PS: My setup today:
> > > >
> > > > Microsoft Windows [Version 10.0.19045.5131]
> > > > ~
> > > > openjdk version "21.0.4" 2024-07-16 LTS
> > > > OpenJDK Runtime Environment Temurin-21.0.4+7 (build 21.0.4+7-LTS)
> > > > OpenJDK 64-Bit Server VM Temurin-21.0.4+7 (build 21.0.4+7-LTS, mixed
> > mode,
> > > > sharing)
> > > > ~
> > > > Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
> > > > Maven home: C:\java\apache-maven-3.9.9
> > > > Java version: 21.0.4, vendor: Eclipse Adoptium, runtime: C:\Program
> > > > Files\Eclipse Adoptium\jdk-21.0.4.7-hotspot
> > > > Default locale: en_US, platform encoding: UTF-8
> > > > OS name: "windows 10", version: "10.0", arch: "amd64", family:
> > "windows"
> > > > ~
> > > > Docker version 27.3.1, build ce12230
> > > >
> > > >
> > > > ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > > For additional commands, e-mail: users-help@maven.apache.org
> > > >
> > > >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > For additional commands, e-mail: users-help@maven.apache.org
> >
> >
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
Re: Javadoc warning: The code being documented uses packages in the unnamed module
Posted by Gary Gregory <ga...@gmail.com>.
Of course ;-) that's baked in our parent POM and set to 8 for most
components.
Gary
On Sun, Jan 19, 2025, 11:35 Tamás Cservenák <ta...@cservenak.net> wrote:
> Howdy.
>
> Did you try
>
> https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release
> ?
>
> I think javadoc has a "release" param... so no need to mess with args or
> alike
>
> Thanks
>
> On Sun, Jan 19, 2025 at 1:44 PM Gary Gregory <ga...@gmail.com>
> wrote:
> >
> > Any thoughts on this?
> >
> > Ty,
> > Gary
> >
> > On Tue, Dec 17, 2024, 09:47 Gary D. Gregory <gg...@apache.org> wrote:
> >
> > > Hi All:
> > >
> > > I'd like to build Apache Commons components with the build failing if
> > > there are Javadoc warnings. This idea would fail today for all
> components
> > > because we get this Javadoc warning:
> > >
> > > [INFO] --- javadoc:3.10.1:javadoc (default-cli) @ commons-csv ---
> > > [INFO] Configuration changed, re-generating javadoc.
> > > [WARNING] Javadoc Warnings
> > > [WARNING] warning: The code being documented uses packages in the
> unnamed
> > > module, but the packages defined in
> > > https://docs.oracle.com/en/java/javase/21/docs/api/ are in named
> modules.
> > > [WARNING] 1 warning
> > >
> > > For example, the above is from:
> > >
> > > git clone https://gitbox.apache.org/repos/asf/commons-csv.git
> > > cd commons-csv
> > > mvn clean package javadoc:javadoc -DskipTests
> > > -Dcommons.javadoc.version=3.11.2
> > >
> > > - The target byte code is Java 8, I never build with Java 8, always 17
> or
> > > 21.
> > > - The GitHub CI builds with all Java LTS versions plus the latest and
> the
> > > latest EA.
> > > - The target JAR file includes JPMS module info generated by the
> Moditect
> > > plugin, works like a charm.
> > >
> > > Googling doesn't help much, using -X to get debug output doesn't seem
> > > helpful to me, but it is interesting that -X does not enable "verbose"
> for
> > > the Javadoc command.
> > >
> > > Is this some more JPMS messiness that I somehow need to account for in
> my
> > > POM? If so, any clues as to how do it?
> > >
> > > TY!
> > > Gary
> > >
> > > PS: My setup today:
> > >
> > > Microsoft Windows [Version 10.0.19045.5131]
> > > ~
> > > openjdk version "21.0.4" 2024-07-16 LTS
> > > OpenJDK Runtime Environment Temurin-21.0.4+7 (build 21.0.4+7-LTS)
> > > OpenJDK 64-Bit Server VM Temurin-21.0.4+7 (build 21.0.4+7-LTS, mixed
> mode,
> > > sharing)
> > > ~
> > > Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
> > > Maven home: C:\java\apache-maven-3.9.9
> > > Java version: 21.0.4, vendor: Eclipse Adoptium, runtime: C:\Program
> > > Files\Eclipse Adoptium\jdk-21.0.4.7-hotspot
> > > Default locale: en_US, platform encoding: UTF-8
> > > OS name: "windows 10", version: "10.0", arch: "amd64", family:
> "windows"
> > > ~
> > > Docker version 27.3.1, build ce12230
> > >
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > > For additional commands, e-mail: users-help@maven.apache.org
> > >
> > >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>
Re: Javadoc warning: The code being documented uses packages in the unnamed module
Posted by Tamás Cservenák <ta...@cservenak.net>.
Howdy.
Did you try
https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release
?
I think javadoc has a "release" param... so no need to mess with args or alike
Thanks
On Sun, Jan 19, 2025 at 1:44 PM Gary Gregory <ga...@gmail.com> wrote:
>
> Any thoughts on this?
>
> Ty,
> Gary
>
> On Tue, Dec 17, 2024, 09:47 Gary D. Gregory <gg...@apache.org> wrote:
>
> > Hi All:
> >
> > I'd like to build Apache Commons components with the build failing if
> > there are Javadoc warnings. This idea would fail today for all components
> > because we get this Javadoc warning:
> >
> > [INFO] --- javadoc:3.10.1:javadoc (default-cli) @ commons-csv ---
> > [INFO] Configuration changed, re-generating javadoc.
> > [WARNING] Javadoc Warnings
> > [WARNING] warning: The code being documented uses packages in the unnamed
> > module, but the packages defined in
> > https://docs.oracle.com/en/java/javase/21/docs/api/ are in named modules.
> > [WARNING] 1 warning
> >
> > For example, the above is from:
> >
> > git clone https://gitbox.apache.org/repos/asf/commons-csv.git
> > cd commons-csv
> > mvn clean package javadoc:javadoc -DskipTests
> > -Dcommons.javadoc.version=3.11.2
> >
> > - The target byte code is Java 8, I never build with Java 8, always 17 or
> > 21.
> > - The GitHub CI builds with all Java LTS versions plus the latest and the
> > latest EA.
> > - The target JAR file includes JPMS module info generated by the Moditect
> > plugin, works like a charm.
> >
> > Googling doesn't help much, using -X to get debug output doesn't seem
> > helpful to me, but it is interesting that -X does not enable "verbose" for
> > the Javadoc command.
> >
> > Is this some more JPMS messiness that I somehow need to account for in my
> > POM? If so, any clues as to how do it?
> >
> > TY!
> > Gary
> >
> > PS: My setup today:
> >
> > Microsoft Windows [Version 10.0.19045.5131]
> > ~
> > openjdk version "21.0.4" 2024-07-16 LTS
> > OpenJDK Runtime Environment Temurin-21.0.4+7 (build 21.0.4+7-LTS)
> > OpenJDK 64-Bit Server VM Temurin-21.0.4+7 (build 21.0.4+7-LTS, mixed mode,
> > sharing)
> > ~
> > Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
> > Maven home: C:\java\apache-maven-3.9.9
> > Java version: 21.0.4, vendor: Eclipse Adoptium, runtime: C:\Program
> > Files\Eclipse Adoptium\jdk-21.0.4.7-hotspot
> > Default locale: en_US, platform encoding: UTF-8
> > OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
> > ~
> > Docker version 27.3.1, build ce12230
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > For additional commands, e-mail: users-help@maven.apache.org
> >
> >
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org