<html>
<head>
<style>
body {
font-family: Verdana, sans-serif;
font-size: 0.8em;
color:#484848;
}
h1, h2, h3 { font-family: "Trebuchet MS", Verdana, sans-serif; margin: 0px; }
h1 { font-size: 1.2em; }
h2, h3 { font-size: 1.1em; }
a, a:link, a:visited { color: #2A5685;}
a:hover, a:active { color: #c61a1a; }
a.wiki-anchor { display: none; }
hr {
width: 100%;
height: 1px;
background: #ccc;
border: 0;
}
.footer {
font-size: 0.8em;
font-style: italic;
}
</style>
</head>
<body>
<span class="header"></span>
Issue #5834 has been updated by Christopher Brooks.
<ul>
<li><strong>Assignee</strong> deleted (<del><i>Ilkay Altintas</i></del>)</li>
</ul>
<p>Java 1.7.0_17 has a bug that prevents 'ant javadoc' from completing. The problem is that between Java 1.7.0_15 and 1.7.0_17, there was a regression where javadoc in _17 tries to parse the .class files. The errors look like:</p>
<p>create-javadoc] /home/hudson/jobs/kepler/workspace/r/target/classes/org/ecoinformatics/seek/R/RExpression.class:463: error: unmappable character for encoding UTF8<br />[create-javadoc] ^C�^Q^O^C�^Q=^C�^Q@^C�^QB^C�^QO^C�^QY^C�^Qb^C�^Qk^C�^Q�^C�^Q�^C�^Q�^C�^Q�^C�^Q�^C�^Q�^C�^Q�^C�^Q�^C�^Q�^C�^Q�^C�^Q�^C�^Q�^C�^Q�^C�^R^F^C�^R</p>
<p>The problem is that the resulting log file tends to be huge, on the order of >500 gig. The issue is that JDK1.7.0_15 has security problems and running javadoc under 1.7.0_15 results in the javadoc process going out over the network which triggers security tools that look for JDK 1.7.0_15 accesses on the network.</p>
<p>I tried using JDK 8 and while this bug is fixed, javadoc in JDK 8 marks many of what used to be warnings as errors.</p>
<p>For example:</p>
<p>[create-javadoc] /home/hudson/jobs/kepler/workspace/gui/src/org/kepler/gui/BasicLibraryPane.java:67: error: @param name not found<br />[create-javadoc] * @param _libraryModel</p>
<p>This means that when 'ant javadoc' completes, it returns 1, and ant indicates that there is an error:</p>
<p>[create-javadoc] 100 errors<br />[create-javadoc] 100 warnings<br />[create-javadoc] IOException: java.io.IOException: Subprocess "javadoc -d /home/hudson/jobs/kepler/workspace/javadoc -sourcepath [path removed by cxh] -tagletpath /home/hudson/jobs/kepler/workspace/ptolemy/target/classes -exclude **.test:org.ptolemy.fmi:org.ptolemy.ptango:ptdb:ptolemy.actor.lib.database:ptolemy.actor.lib.embeddedJava:ptolemy.actor.lib.excel:ptolemy.actor.lib.fmi:ptolemy.actor.lib.io.comm:ptolemy.actor.lib.jai:ptolemy.actor.lib.jmf:ptolemy.actor.lib.jni:ptolemy.actor.lib.jopio:ptolemy.actor.lib.joystick:ptolemy.actor.lib.jxta:ptolemy.actor.lib.logic.fuzzy:ptolemy.actor.lib.mail:ptolemy.actor.lib.net:ptolemy.actor.lib.opencv:ptolemy.actor.lib.openmodelica:ptolemy.actor.lib.reactable:ptolemy.actor.lib.security:ptolemy.actor.lib.vhdl:ptolemy.actor.lib.video:ptolemy.actor.lib.x10:ptolemy.actor.ptalon:ptolemy.apps:ptolemy.backtrack:ptolemy.backtrack.eclipse:ptolemy.backtrack.test:ptolemy.caltrop:ptolemy.cg:ptolemy.codegen:ptolemy.copernicus:ptolemy.data.ontologies:ptolemy.distributed:ptolemy.domains.ca:ptolemy.domains.ci:ptolemy.domains.coroutine:ptolemy.domains.csp:ptolemy.domains.curriculum:ptolemy.domains.dde:ptolemy.domains.fsm.kernel.fmv:ptolemy.domains.giotto:ptolemy.domains.gr:ptolemy.domains.gro:ptolemy.domains.hdf:ptolemy.domains.jogl:ptolemy.domains.modal.kernel.fmv:ptolemy.domains.metroII:ptolemy.domains.ontologies:ptolemy.domains.openmodelica:ptolemy.domains.petrinet:ptolemy.domains.psdf:ptolemy.domains.pthales:ptolemy.domains.ptides:ptolemy.domains.ptinyos:ptolemy.domains.rendezvous:ptolemy.domains.sequence:ptolemy.domains.space:ptolemy.domains.sr:ptolemy.domains.taskpt:ptolemy.domains.tdl:ptolemy.domains.tester:ptolemy.domains.tm:ptolemy.domains.wireless:ptolemy.homer:ptolemy.moml.jxta:ptolemy.plot.servlet:ptolemy.vergil.basic.export.itextpdf:ptolemy.vergil.basic.imprt.fmu:ptolemy.vergil.fsm.fmv:ptolemy.vergil.modal.fmv:ptolemy.vergil.ontologies:ptolemy.vergil.tdl:ptolemy.verification:ptserver -subpackages org:com:util:ptolemy -link <a class="external" href="http://download.oracle.com/javase/6/docs/api/">http://download.oracle.com/javase/6/docs/api/</a> -linksource -author -breakiterator -use -quiet -tag Pt.AcceptedRating -tag Pt.ProposedRating -tag category.name -tag UserLevelDocumentation -tag created -tag entity.description -tag status -taglet doc.doclets.RatingTaglet -J-Xmx1024m" returned 1<br />[create-javadoc] All Done</p>
<p>Oddly, Hudson reports the javadoc errors as javac warnings.</p>
<hr />
<h1><a href="https://projects.ecoinformatics.org/ecoinfo/issues/5834#change-20367">Bug #5834: Fix Kepler Javadoc warnings</a></h1>
<ul>
<li>Author: Christopher Brooks</li>
<li>Status: New</li>
<li>Priority: Normal</li>
<li>Assignee: </li>
<li>Category: documentation</li>
<li>Target version: Unspecified</li>
<li>Bugzilla-Id: 5834</li>
</ul>
<p>Running "ant javadoc" produces warnings about javadoc problems.<br />The Kepler nightly build at Berkeley now reports these warnings, see<br /><a class="external" href="http://sisyphus:8079/hudson/job/kepler/warnings31">http://sisyphus:8079/hudson/job/kepler/warnings31</a></p>
<p>It would be good to fix these warnings.</p>
<hr />
<span class="footer"><p>You have received this notification because you have either subscribed to it, or are involved in it.<br />To change your notification preferences, please click here: <a class="external" href="https://projects.ecoinformatics.org/ecoinfo/my/account">https://projects.ecoinformatics.org/ecoinfo/my/account</a></p></span>
</body>
</html>