
<html><head><meta http-equiv="Content-Type" content="text/html charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">Hi guys,<div><br></div><div>thanks for the comments!</div><div>I’ll just fix the javadoc, then.</div><div><br></div><div>best regards,</div><div>Tobias</div><div><br><div><div>On 11 Feb 2015, at 17:49, Curtis Rueden <<a href="mailto:ctrueden@wisc.edu">ctrueden@wisc.edu</a>> wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div dir="ltr">Hi Dscho,<div><br></div><div><div>> Curtis, you forgot to say that the `#getSource(long)` probably needs</div><div>> to be replaced by a `#getSource(int, int)` because the class has only</div><div>> a `getSource` method with the latter signature.</div></div><div><br></div><div>Yeah, my reply's first draft basically said "just fix the invalid javadoc". Then I actually tried compiling with Java 8 and looked at what would need to be fixed. Over 100 errors, due to things like missing @param and @return and @throws. Fixing all of those things would actually be quite involved, especially across all 200+ repositories, so I begin to see the wisdom of working around it for now.</div><div><br></div><div><div>> But I agree that Javadocs that are obviously wrong should be fixed</div><div>> rather than switching off Javadoc generation in the Maven</div><div>> configuration.</div></div><div><br></div><div>Right, we definitely do not want to switch of javadoc generation. However, there is another way: <additionalparams>-D:doclint:none</additionalparams>. But it would need to go in a Java-8-specific profile. And again, I am ambivalent about doing it because in the long term, especially after we fully switch over to Java 8 some day, I would not want those checks disabled by default.</div><div><br></div><div>Regards,</div><div>Curtis</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Feb 11, 2015 at 10:36 AM, Johannes Schindelin <span dir="ltr"><<a href="mailto:johannes.schindelin@gmx.de" target="_blank">johannes.schindelin@gmx.de</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi Curtis,<span class=""><br>

<br>

On 2015-02-11 17:31, Curtis Rueden wrote:<br>

<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

I get the following errors when running with java 8<br>

...<br>

<br>

Works fine with java 7 and java 6.<br>

<br>

Is this a known problem?<br>

</blockquote>

<br>

Java 8's javadoc tool is much more stringent than previously, due to the<br>

addition of doclint checks [1].<br>

</blockquote>

<br></span>

Curtis, you forgot to say that the `#getSource(long)` probably needs to be replaced by a `#getSource(int, int)` because the class has only a `getSource` method with the latter signature.<br>

<br>

But I agree that Javadocs that are obviously wrong should be fixed rather than switching off Javadoc generation in the Maven configuration.<br>

<br>

Ciao,<br>

Dscho<br>

</blockquote></div><br></div>

</blockquote></div><br></div></body></html>