Missing @since tags

Martin Buchholz martinrb at google.com
Thu Feb 7 23:23:04 UTC 2013


JDiff hasn't been updated since 2008.  I would be surprised if you could
get it to work on jdk8 vs. jdk7 without significant work.

But the key thing is to use a tool, any tool, since history has shown it is
very easy for engineers to forget to add the necessary @since tags.

On Thu, Feb 7, 2013 at 11:45 AM, Mike Duigou <mike.duigou at oracle.com> wrote:

> http://javadiff.sourceforge.net/
>
> Which is implemented as a doclet does provide missing @since detection
> functionality.
>
> Mike
>
> On Feb 7 2013, at 10:29 , Martin Buchholz wrote:
>
> > On Thu, Feb 7, 2013 at 9:49 AM, Alan Bateman <Alan.Bateman at oracle.com
> >wrote:
> >
> >> On 07/02/2013 17:40, Martin Buchholz wrote:
> >>
> >>> Alternatively, maybe this is a job for an annotation processor.
> >>
> >>
> > IIRC, we considered that 6 years ago.  It might be possible, but consider
> > that you need to diff multiple jdk implementations, and the annotation
> > processor needs to be able to grok javadoc comments.  Also, there are no
> > "annotations" being processed, so it's weird to use an annotation
> > processor.  Writing a javadoc doclet is another approach that might work.
>
>



More information about the core-libs-dev mailing list