<html>
<head>
<meta content="text/html; charset=windows-1252"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<br>
<font face="Calibri">Hi Peter, to get an idea of the type and volume
of issues this will report, can you list the current bus warnings
you're seeing?<br>
<br>
</font><br>
<div class="moz-cite-prefix">On 3/30/2015 9:37 AM, Peter Palaga
wrote:<br>
</div>
<blockquote cite="mid:5519518D.7030308@redhat.com" type="cite">
<pre wrap="">Hi *, there is a question about handling JavaDoc checks violations at
the bottom.
I have added maven-javadoc-plugin and maven-source-plugin to the new
"release" profile in Hawkular Parent.
<a class="moz-txt-link-freetext" href="https://github.com/hawkular/hawkular-parent-pom/pull/20">https://github.com/hawkular/hawkular-parent-pom/pull/20</a>
I have tested the above only with Hawkular Bus. Therefore, please test
the setup with your Hawkular component:
* Make whatever is appropriate to make your component use the pom from
<a class="moz-txt-link-freetext" href="https://github.com/hawkular/hawkular-parent-pom/pull/20">https://github.com/hawkular/hawkular-parent-pom/pull/20</a>
* Invoke
mvn clean install -Prelease
* Figure out, how many "[WARNING] Javadoc Warnings" are there.
* Look into target folders if *-javadoc.jar and *-sources.jar files were
generated
== Handling JavaDoc checks violations
The present setup turns all javadoc violations into warnings using
-Xdoclint:none [1]. I can only say that there *are* violations in Bus.
I think that we should aim at having no violations at all - i.e. that
the components should be given a week or two to fix and that we should
switch to -Xdoclint:all after that. WDYT?
More about -Xdoclint can be found in [2].
Thanks,
Peter
[1]
<a class="moz-txt-link-freetext" href="https://github.com/hawkular/hawkular-parent-pom/commit/d54a8d03b4ef251d594f1cc4ff3fadfa4a1d4dd3#diff-600376dffeb79835ede4a0b285078036R110">https://github.com/hawkular/hawkular-parent-pom/commit/d54a8d03b4ef251d594f1cc4ff3fadfa4a1d4dd3#diff-600376dffeb79835ede4a0b285078036R110</a>
[2] <a class="moz-txt-link-freetext" href="http://docs.oracle.com/javase/8/docs/technotes/tools/unix/javac.html">http://docs.oracle.com/javase/8/docs/technotes/tools/unix/javac.html</a>
_______________________________________________
hawkular-dev mailing list
<a class="moz-txt-link-abbreviated" href="mailto:hawkular-dev@lists.jboss.org">hawkular-dev@lists.jboss.org</a>
<a class="moz-txt-link-freetext" href="https://lists.jboss.org/mailman/listinfo/hawkular-dev">https://lists.jboss.org/mailman/listinfo/hawkular-dev</a>
</pre>
</blockquote>
<br>
</body>
</html>