[xwiki-devs] Java 8 doclint features: issue with unknown tags
Hi devs, FYI, I was correcting the java 8 doclint errors over the weekend and I’ve noticed an issue: doclint fails the compilation when there’s an “unknown” javadoc tag. For example on the XAR Maven Plugin, the @parameter javadoc tag was making it fail. I’ve fixed it by converting the plugin to use annotation but still this is potentially a problem for other places. I haven’t found any option to turn this off specifically. We can turn off some group of features but apparently it’s not possible to turn off only this feature. See http://docs.oracle.com/javase/8/docs/technotes/tools/unix/javadoc.html I’m mentioning this FYI and also in case someone knows of a solution (ofc finding the corresponding doclint group and turning it off for the failing module is an option albeit not a perfect one). Thanks -Vincent
See https://github.com/phenotips/build-tools/tree/master/taglets and https://github.com/phenotips/phenotips/blob/master/pom.xml#L920-L949 On 04/11/2016 03:24 AM, Vincent Massol wrote:
Hi devs,
FYI, I was correcting the java 8 doclint errors over the weekend and I’ve noticed an issue: doclint fails the compilation when there’s an “unknown” javadoc tag. For example on the XAR Maven Plugin, the @parameter javadoc tag was making it fail. I’ve fixed it by converting the plugin to use annotation but still this is potentially a problem for other places.
I haven’t found any option to turn this off specifically. We can turn off some group of features but apparently it’s not possible to turn off only this feature.
See http://docs.oracle.com/javase/8/docs/technotes/tools/unix/javadoc.html
I’m mentioning this FYI and also in case someone knows of a solution (ofc finding the corresponding doclint group and turning it off for the failing module is an option albeit not a perfect one).
Thanks -Vincent
-- Sergiu Dumitriu http://purl.org/net/sergiu/
On 11 Apr 2016, at 14:26, Sergiu Dumitriu <[email protected]> wrote:
See https://github.com/phenotips/build-tools/tree/master/taglets and https://github.com/phenotips/phenotips/blob/master/pom.xml#L920-L949
ok thanks for sharing this, nice (albeit complex just to make doclint ignore some javadoc tags ;)). -Vincent
On 04/11/2016 03:24 AM, Vincent Massol wrote:
Hi devs,
FYI, I was correcting the java 8 doclint errors over the weekend and I’ve noticed an issue: doclint fails the compilation when there’s an “unknown” javadoc tag. For example on the XAR Maven Plugin, the @parameter javadoc tag was making it fail. I’ve fixed it by converting the plugin to use annotation but still this is potentially a problem for other places.
I haven’t found any option to turn this off specifically. We can turn off some group of features but apparently it’s not possible to turn off only this feature.
See http://docs.oracle.com/javase/8/docs/technotes/tools/unix/javadoc.html
I’m mentioning this FYI and also in case someone knows of a solution (ofc finding the corresponding doclint group and turning it off for the failing module is an option albeit not a perfect one).
Thanks -Vincent
-- Sergiu Dumitriu http://purl.org/net/sergiu/
participants (2)
-
Sergiu Dumitriu -
Vincent Massol