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