Skip to content

Add script to generate javadoc with JDK17 #19170

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 12 commits into from
Jun 25, 2025

Conversation

YanxuanLiu
Copy link
Contributor

@YanxuanLiu YanxuanLiu commented Jun 15, 2025

Description

Checklist

  • I am familiar with the Contributing Guidelines.
  • New or existing tests cover these changes.
  • The documentation is up to date with these changes.

fix #19062

Need to generate javadoc with JDK17 for search bar.

Created a script to generate javadoc to avoid modifying original pom.xml

Copy link

copy-pr-bot bot commented Jun 15, 2025

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@github-actions github-actions bot added the Java Affects Java cuDF API. label Jun 15, 2025
Copy link
Member

@pxLi pxLi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should be applied to the mvn phase directly instead of providing another specific script

@pxLi pxLi added improvement Improvement / enhancement to an existing function non-breaking Non-breaking change labels Jun 19, 2025
java/pom.xml Outdated
<artifactId>maven-javadoc-plugin</artifactId>
<version>3.6.3</version>
<configuration>
<classifier>javadoc-jdk17</classifier>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we were trying to override the default javadoc artifact, so rapids doc can simply use the default artifact for their pages instead of having another *-javadoc-jdk17 one

java/pom.xml Outdated
@@ -358,6 +358,35 @@
</plugins>
</build>
</profile>
<profile>
<id>javadoc</id>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: rename it to javadoc-jdk17

@pxLi pxLi removed their assignment Jun 19, 2025
@pxLi pxLi requested a review from Copilot June 19, 2025 01:01
Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR introduces a new Maven profile to generate javadoc using JDK17 and updates the Docker build script to optionally build the javadoc.

  • Added a new in pom.xml for generating javadoc with JDK17.
  • Updated java/ci/build-in-docker.sh to install Java 17 and trigger the javadoc build when enabled.

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
java/pom.xml New Maven profile to generate javadoc with JDK17 and custom configuration.
java/ci/build-in-docker.sh Added an option to install Java 17 and generate javadoc using the new profile.

if [ $BUILD_JAVADOC_JDK17 == true ]; then
yum install -y java-17-openjdk-devel
export JDK17_HOME=/usr/lib/jvm/java-17-openjdk
CUDF_INSTALL_DIR="$INSTALL_PREFIX" mvn -B javadoc:jar -P javadoc
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Q: can we add the profile config directly to BUILD_ARG when $BUILD_JAVADOC_JDK17 == true? we do not require 2 javadoc generation steps

Signed-off-by: Yanxuan Liu <[email protected]>
Signed-off-by: Yanxuan Liu <[email protected]>
Signed-off-by: Yanxuan Liu <[email protected]>
Signed-off-by: Yanxuan Liu <[email protected]>
@pxLi
Copy link
Member

pxLi commented Jun 25, 2025

/ok to test f0dd143

@pxLi pxLi marked this pull request as ready for review June 25, 2025 01:14
@pxLi pxLi requested a review from a team as a code owner June 25, 2025 01:14
@NvTimLiu NvTimLiu self-requested a review June 25, 2025 01:30
Copy link
Contributor

@NvTimLiu NvTimLiu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@pxLi
Copy link
Member

pxLi commented Jun 25, 2025

/merge

@rapids-bot rapids-bot bot merged commit f6c2a1c into rapidsai:branch-25.08 Jun 25, 2025
90 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
improvement Improvement / enhancement to an existing function Java Affects Java cuDF API. non-breaking Non-breaking change
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[FEA] Update Java Docs site to JDK 9+
3 participants