svn commit: r1585288 - /commons/proper/lang/trunk/src/site/xdoc/index.xml

[br...@apache.org]

Author: britter
Date: Sun Apr  6 11:50:41 2014
New Revision: 1585288

URL: http://svn.apache.org/r1585288
Log:
Add a note about 3.3.2 and DocLint, since I can not get the site build working without fixing all the warnings DocLint generates.

Modified:
    commons/proper/lang/trunk/src/site/xdoc/index.xml

Modified: commons/proper/lang/trunk/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/site/xdoc/index.xml?rev=1585288&r1=1585287&r2=1585288&view=diff
==============================================================================
--- commons/proper/lang/trunk/src/site/xdoc/index.xml (original)
+++ commons/proper/lang/trunk/src/site/xdoc/index.xml Sun Apr  6 11:50:41 2014
@@ -71,7 +71,10 @@ The code base is monitored by a Sonar in
 <li>Examine the <a href="article3_0.html">2.x to 3.0 upgrade notes</a></li>
 <li>Compare major versions via the <a href="lang2-lang3-clirr-report.html">Lang2 to Lang3 Clirr report</a></li>
 </ul>
-
+<p><em>Special note on 3.3.2 and Java 8:</em> Due to the addition of <a href="http://openjdk.java.net/jeps/172">DocLint</a>
+to the JavaDoc tool <code>mvn site</code> will currently fail because the test code contains malformed JavaDoc comments.
+If you want to build the site yourself use Java 6 or Java 7 or deactivate DocLint by configuring the Maven JavaDoc with
+<code>&lt;additionalparam&gt;-Xdoclint:none&lt;&#47;additionalparam&gt;</code>.</p>
 <p>
 Alternatively you can pull it from the central Maven repositories:
 <pre>