Integrated: 8340829: Generated API docs should clearly identify EA builds

[Kevin Rushforth]

On Thu, 26 Sep 2024 21:33:10 GMT, Kevin Rushforth <kcr at 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 <kcr at 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