On Fri, 21 Apr 2023 13:30:38 GMT, Nir Lisker <nlis...@openjdk.org> wrote:

> 1. The `-since` option does not play well with the javafx one: if 
> documentation was added on a `private` property field with the `@since` tag, 
> it will not be included in the NEW and DEPRECATED lists. I presume that the 
> `-since` release version comparison detects only public APIs and does not 
> know that javafx generates public API from private members.

Confirmed. I can file a bug against the javadoc tool. This looks like one more 
place where they need to handle JavaFX properties.

> 2. I started from version 9, but there are also versions "8" and "8u20" in 
> the deprecation list, and "JavaFX 8u40" and "JavaFX 8.0" in `@since` tags. 
> For comparison, the JDK starts from 12 
> (https://docs.oracle.com/en/java/javase/20/docs/api/new-list.html). I'm not 
> sure what versions we want to include. Changing this is simply done by adding 
> the strings that appear in the tags to the `-since` option list.

I might recommend starting with 11, but I don't mind starting with 9 if others 
feel that's best.

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

PR Comment: https://git.openjdk.org/jfx/pull/1109#issuecomment-1574152608

Reply via email to