2012/5/10 Jesse Glick <jesse.gl...@oracle.com>:
> On 05/09/2012 12:56 PM, Olivier Lamy wrote:
>>
>> we still need to do some javadoc parsing for @deprecated
>
>
> Just look for @Deprecated - the real annotation - instead. (Note that javac
> will warn you if you have the Javadoc tag without the annotation.)
>
>
>> @since and comments for class/field description. So if annotations comes
>> from
>> reactor module (easy to scan sources) but if comes from a dependency I
>> try to get the sources from the artifact with try to resolve the same
>> artifact with classifier sources.
>
>
> Would be simpler to define true annotations (marked @Documented) for the
> things you use, e.g. @Since or @Description. Then there is no need to look
> for sources of binary dependencies, and no need to parse them. You are also
> insulated against Java language changes, and can interoperate properly with
> other JVM languages compatible with JSR 175.
I have this idea first too using only annotations but I don't have
text in this anno @Deprecated("because bla bla")
Agree on @Since,
@Description looks nice but I found a bit ugly something like
@Description("
The role names of mojo extractors to use. If not set, all mojo
extractors will be used. If set to an empty extractor name, no mojo
extractors will be used. Example:
<!-- Use all mojo extractors -->
<extractors/>
<!-- Use no mojo extractors -->
<extractors>
<extractor/>
</extractors>
<!-- Use only bsh mojo extractor -->
<extractors>
<extractor>bsh</extractor>
</extractors>
")
And furthermore published javadoc won't as nice as today :-)
Others ?
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
> For additional commands, e-mail: dev-h...@maven.apache.org
>
--
Olivier Lamy
Talend: http://coders.talend.com
http://twitter.com/olamy | http://linkedin.com/in/olamy
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org
