Corrections for Javadoc

Kevin Rushforth kevin.rushforth at oracle.com
Sat May 27 13:16:09 UTC 2017


I missed seeing this comment so did not add it to JDK-8180070. Sorry 
about that. I filed a new bug for this one...currently it is assigned to 
9, in case there is still time to get it fixed.

https://bugs.openjdk.java.net/browse/JDK-8181169

-- Kevin


Nir Lisker wrote:
> Looks like the above didn't make it in time. Can it be fixed in the 
> next batch?
>
> On Tue, May 23, 2017 at 9:26 PM, Nir Lisker <nlisker at gmail.com 
> <mailto:nlisker at gmail.com>> wrote:
>
>     Hopefully this makes it in time:
>
>     javafx.scene.control.TreeView<T> has wrong javadoc for the
>     queryAccessibleAttribute method. The source code uses javadoc
>     blocks as titles, but they should probably be regular comment blocks.
>     One of those blocks has been read as the doc for the method
>     because that method has no doc.
>
>     On Wed, May 10, 2017 at 7:25 PM, Kevin Rushforth
>     <kevin.rushforth at oracle.com <mailto:kevin.rushforth at oracle.com>>
>     wrote:
>
>         I just filed a new issue to catch any last minute typos:
>
>         https://bugs.openjdk.java.net/browse/JDK-8180070
>         <https://bugs.openjdk.java.net/browse/JDK-8180070>
>
>         I'll add your note to this new JBS bug.
>
>         Thank you.
>
>         -- Kevin
>
>
>
>
>         Nir Lisker wrote:
>
>             I'm looking at build 168 of JDK9 and there are a few
>             mistakes in the docs.
>             I can't submit issues to the JIRA so I'll list them here.
>             A similar issue
>             was https://bugs.openjdk.java.net/browse/JDK-8177341
>             <https://bugs.openjdk.java.net/browse/JDK-8177341>.
>
>
>                - The following use "a Observable..." instead of "an
>             Observable...".
>                - javafx.beans.property
>                      - ListProperty<E>
>                      - MapProperty<K,V>
>                      - ReadOnlyListPropertyBase<E>
>                      - SetProperty<E>
>                   - javafx.beans.binding
>                      - NumberExpression
>                      - BooleanExpression
>                      - DoubleExpression
>                      - FloatExpression
>                      - IntegerExpression
>                      - ListExpression
>                      - LongExpression
>                      - MapExpression
>                      - ObjectExpression
>                      - SetExpression
>                      - StringExpression
>                      - javafx.scene.shape.ObservableFaceArray copies
>             its description
>                from its superinteface ObservableIntegerArray, does not
>             declare any API
>                methods and is listed under package javafx.scene.shape.
>             It's not clear at
>                all what this interface is. As it is, it looks like
>             it's not meant to be
>                exposed.
>                - javafx.collections.ObservableIntegerArray uses "a
>             int[]" instead of
>                "an int[]". This writing ("a int") is found in
>             java.lang.Integer as well in
>                a few places.
>
>             Nir
>              
>
>
>


More information about the openjfx-dev mailing list