Javadoc tool version used to build JavaFX documentation

[Anirvan Sarkar]

I messed up before. I hadn't cleaned up my Javadoc directory before
building the documentation with jdk1.8.0_40.

The alignment issue exists with jdk1.8.0_40. After some searching in JBS I
found the javadoc bug JDK-8072461 [1].

According to the bug report the issue has been fixed in atleast jdk1.8.0_60.

Created JBS enhancement issue [2] to update javadoc tool version to
1.8.0_60 for generating JavaFX documentation

[1] : https://bugs.openjdk.java.net/browse/JDK-8072461
[2] : https://bugs.openjdk.java.net/browse/JDK-8151038


On 2 March 2016 at 17:56, Anirvan Sarkar <powers.anirvan at gmail.com> wrote:

> Hi,
>
> Is the Javadoc tool used to build JavaFX documentation not from the JDK
> used to build JavaFX ?
>
> If you view the javafx.event.Event 'Uses' webpage [1] source, you will see
> the comment:
>
> <!-- Generated by javadoc (1.8.0) on Tue Feb 10 11:39:35 PST 2015 -->
>
> So it looks like the documentation is built using jdk1.8.0 while JavaFX
> itself is built using jdk1.8.0_40 [2].
>
> The alignment in the concerned webpage is messed up. (Description column
> is all the way to the right and its width is very small).
>
> When I built the documentation locally using jdk1.8.0_40 the webpage is
> displayed properly.
>
> Seems like there was some Javadoc bug in 1.8.0 which was resolved in some
> subsequent releases.
>
>
> [1] :
> https://docs.oracle.com/javase/8/javafx/api/javafx/event/class-use/Event.html
> [2] : https://bugs.openjdk.java.net/browse/JDK-8097930
>
> --
> Anirvan
>



-- 
Anirvan