On Thu, 26 Sep 2024 21:33:10 GMT, Kevin Rushforth <k...@openjdk.org> wrote:
> This PR modifies the header and footer of the javadoc-generated API docs to > add "DRAFT $VER-ea+$BLD" to clearly identify an ea build of the docs, and > also to make it clear which build number the docs refer to. This matches was > the JDK does. For GA builds, there will be no change to what we generate > today. Since I had to add logic to filter the javadoc properties defined in > `build.javadoc` to add the DRAFT message if not a GA build, I also changed > the properties to not hard-code the major version of JavaFX, thus reducing > the duplication. > > I ran three builds to test this, an ordinary developer build, an EA build, > and a GA build as follows: > > #### Developer build > > Command line: > > gradle javadoc > > > Generated docs: https://cr.openjdk.org/~kcr/8340829/javadoc-internal/ > > #### EA build > > Command line: > > gradle -PPROMOTED_BUILD_NUMBER=98 -PHUDSON_BUILD_NUMBER=1234 > -PHUDSON_JOB_NAME=jfx-dev javadoc > > > Generated docs: https://cr.openjdk.org/~kcr/8340829/javadoc-ea/ > > #### GA build > > Command line: > > gradle -PMILESTONE_FCS=true -PPROMOTED_BUILD_NUMBER=99 > -PHUDSON_BUILD_NUMBER=4321 -PHUDSON_JOB_NAME=jfx-dev javadoc > > > Generated docs: https://cr.openjdk.org/~kcr/8340829/javadoc-fcs/ This pull request has now been integrated. Changeset: 4d3c3661 Author: Kevin Rushforth <k...@openjdk.org> URL: https://git.openjdk.org/jfx/commit/4d3c3661d3d64bf06c3772e3b35b7e2b09fc3f99 Stats: 22 lines in 3 files changed: 14 ins; 2 del; 6 mod 8340829: Generated API docs should clearly identify EA builds Reviewed-by: iris, arapte ------------- PR: https://git.openjdk.org/jfx/pull/1583