Re: svn commit: r1679676 - in /xmlgraphics/fop/trunk/src/java/org/apache/fop/afp: ./ fonts/ modca/ modca/triplets/ svg/ util/

[Andreas Delmelle <an...@telenet.be>]

Just a heads-up to anyone using JDK 1.8 who is unaware, and tries to run FOP's javadoc target: 
You will get a torrent of warnings and errors about malformed/illegal HTML all over the place.

> On 16 May 2015, at 04:10, adelmelle@apache.org wrote:
> 
> Author: adelmelle
> Date: Sat May 16 02:10:42 2015
> New Revision: 1679676
> 
> URL: http://svn.apache.org/r1679676
> Log:
> Javadoc fixups
<snip />
> @@ -31,7 +31,6 @@ import org.apache.fop.fonts.Typeface;
> /**
>  * All implementations of AFP fonts should extend this base class,
>  * the object implements the FontMetrics information.
> - * <p/>
>  */

... and here I was wondering why that was reported as an issue, while at the same time empty <p>'s are being used in the Javadoc examples themselves.

As it turns out, this was an issue triggered by the use of Oracle's 1.8 doclet, and can be avoided by adding

    additionalparam="-Xdoclint:none"

to the javadoc target in the build.xml.

Should have looked around a bit more before removing or replacing those with <br>...

At this point, not sure if said change to build.xml is OK to commit permanently, so I will keep it locally enabled for now.

Since the committed changes work in both scenarios (with or without the parameter), I will leave those in for now, but at least I now know this doesn't have to be done in all the other packages...



KR

Andreas