On Tue, 15 Jul 2025 20:14:30 GMT, Roger Riggs <rri...@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

Reply via email to