Hello Peter,
We would like to disable (or not have it all) in the Hawkular Metrics project. Hawkular
Metrics iterates at a fast pace and this would be a huge distraction due to the rapidly
changing design and implementation. At this stage we are focused on building a great
project so agile tooling and minimal requirements are paramount.
Can you please provide documentation on how to disable this at the project level?
Thank you,
Stefan
----- Original Message -----
From: "Peter Palaga" <ppalaga(a)redhat.com>
To: hawkular-dev(a)lists.jboss.org
Sent: Monday, March 30, 2015 8:37:17 AM
Subject: [Hawkular-dev] Coming to Parent: publishing JavaDoc and sources via Maven
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.
https://github.com/hawkular/hawkular-parent-pom/pull/20
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
https://github.com/hawkular/hawkular-parent-pom/pull/20
* 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]
https://github.com/hawkular/hawkular-parent-pom/commit/d54a8d03b4ef251d59...
[2]
http://docs.oracle.com/javase/8/docs/technotes/tools/unix/javac.html
_______________________________________________
hawkular-dev mailing list
hawkular-dev(a)lists.jboss.org
https://lists.jboss.org/mailman/listinfo/hawkular-dev