Corrections for Javadoc

Nir Lisker nlisker at gmail.com
Fri May 26 22:11:27 UTC 2017


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> 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> wrote:
>
>> I just filed a new issue to catch any last minute typos:
>>
>> 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.
>>>
>>>
>>>    - 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