RFR: 8356975: Provide alternative way to generate preview API docs [v2]

[Hannes Wallnöfer]

On Tue, 15 Jul 2025 20:14:30 GMT, Roger Riggs <rriggs at openjdk.org> wrote:

>> Hannes Wallnöfer has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Add warning for multiple preview notes
>
> "hidden" is an illusion, undocumented is closer to the truth.
> If the option is used in the make files, its just as visible as any other source change and is not optional.
> And since source files are changed to take advantage of it, its even less hidden; just obscure.

@RogerRiggs I agree, it's not ideal. JavaDoc has this dual personality as a tool to document Java/JDK libs and third party developer code, and these tasks are sometimes at odds. Since we don't want to make Preview Features a generic Java/JavaDoc feature a hidden/undocumented option is the only way to go here.

-------------

PR Comment: https://git.openjdk.org/jdk/pull/26267#issuecomment-3077774128