Hi Jay, there is just a couple of them in Bus - see the attached
file. -- P
There is no single warning about missing JavaDoc. All the warnings are
about inconsistencies and broken syntax inside JavaDoc which indeed is
worth fixing. -- P
On 03/30/2015 04:38 PM, Jay Shaughnessy wrote:
>
> 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?
>
>
> On 3/30/2015 9:37 AM, Peter Palaga wrote:
>> 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
>>
>>
>
>
>
> _______________________________________________
> hawkular-dev mailing list
> hawkular-dev(a)lists.jboss.org
>
https://lists.jboss.org/mailman/listinfo/hawkular-dev
>
_______________________________________________
hawkular-dev mailing list
hawkular-dev(a)lists.jboss.org
https://lists.jboss.org/mailman/listinfo/hawkular-dev