426869 – mark new methods with @since annotation

Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 426869 - mark new methods with @since annotation

Summary: mark new methods with @since annotation

Status:	RESOLVED FIXED

Alias:	None

Product:	SWTBot
Classification:	Technology
Component:	SWTBot (show other bugs)
Version:	unspecified
Hardware:	All All

Importance:	P3 enhancement (vote)
Target Milestone:	2.2.1
Assignee:	Project Inbox
QA Contact:

URL:
Whiteboard:
Keywords:

Depends on:
Blocks:

Reported:	2014-01-29 05:09 EST by Lorenzo Bettini
Modified:	2014-02-06 10:22 EST (History)
CC List:	1 user (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.

Description Lorenzo Bettini

2014-01-29 05:09:21 EST

It might be good to start marking new methods with @since annotation (see also this discussion http://www.eclipse.org/forums/index.php/t/640194/).

In general, it might also be good to use API Tools and API Baseline.

Comment 1 Mickael Istria

2014-01-29 05:33:17 EST

Yes, that would be a good thing. If you want to help making this happen, you should monitor incoming Gerrit patches and review them to add a note about potential missing @since annotation.

Comment 2 Lorenzo Bettini

2014-01-29 05:38:03 EST

With Eclipse API Tools and API baseline we could also start right away: we create an API baseline using 2.1.1 as the (previous) target platform and we should soon be aware of things that were added in 2.2.0.

Comment 3 Mickael Istria

2014-01-29 05:40:03 EST

(In reply to Lorenzo Bettini from comment #2)
> With Eclipse API Tools and API baseline we could also start right away: we
> create an API baseline using 2.1.1 as the (previous) target platform and we
> should soon be aware of things that were added in 2.2.0.

Right.
So I'm waiting for your patch to review and merge it ;)

Comment 4 Lorenzo Bettini

2014-01-29 07:42:39 EST

Pushed for review https://git.eclipse.org/r/21250

There's also a README.txt file, /target-platforms/api-baseline/README.txt, explaining how to export the api baseline and set it in the workspace.

I only enabled the org.eclipse.pde.api.tools.apiAnalysisNature nature on some projects as I saw fit, please check whether there are other projects to setup with API tools.

I tried to do that in the generator project but I then get lots of errors...

Comment 5 Mickael Istria

2014-02-06 10:22:37 EST

Changed merged. Thanks.