Re: [xwiki-devs] Java 8 doclint features: issue with unknown tags

2016-04-11 Thread Vincent Massol

> On 11 Apr 2016, at 14:26, Sergiu Dumitriu  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/
___
devs mailing list
devs@xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs


Re: [xwiki-devs] Java 8 doclint features: issue with unknown tags

2016-04-11 Thread Sergiu Dumitriu
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/
___
devs mailing list
devs@xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs


[xwiki-devs] Java 8 doclint features: issue with unknown tags

2016-04-11 Thread Vincent Massol
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

___
devs mailing list
devs@xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs