Re: [Hawkular-dev] Coming to Parent: publishing JavaDoc and sources via Maven

On 03/30/2015 09:34 PM, Peter Palaga wrote: > 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 > _______________________________________________ hawkular-dev mailing list hawkular-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/hawkular-dev