Corrections for Javadoc
kevin.rushforth at oracle.com
Tue May 16 19:51:11 UTC 2017
I added it to the list.
Nir Lisker wrote:
> Another thing:
> javafx.scene.canvas.GraphicsContext should have a link to Canvas,
> either in the first sentence or as a @see, or both.
> On Fri, May 12, 2017 at 12:02 AM, Kevin Rushforth
> <kevin.rushforth at oracle.com <mailto:kevin.rushforth at oracle.com>> wrote:
> Added. This is a questionable use of @see anyway.
> -- Kevin
> Nir Lisker wrote:
>> Add this to the list as well please:
>> javafx.scene.image.Image's constructors:
>> - Image(String url)
>> - Image(String url, boolean backgroundLoading)
>> - Image(String url, double requestedWidth, double
>> requestedHeight, boolean preserveRatio, boolean smooth)
>> all have a @see annotation pointing to a private constructor.
>> This makes the link in the generated docs do nothing.
>> On Wed, May 10, 2017 at 7:25 PM, Kevin Rushforth
>> <kevin.rushforth at oracle.com <mailto:kevin.rushforth at oracle.com>>
>> I just filed a new issue to catch any last minute typos:
>> 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
>> - 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
>> - 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.
More information about the openjfx-dev