Introduction

This document lists changes made to the Common Annotations API.

Index of APIs

Common Annotations API

Incompatible changes by date

Fuller descriptions of all changes can be found below (follow links).

Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work.

All changes by date

(Apr 1 '21) Exposing necessary javax.annotation elements
(Feb 1 '13) Added justification attribute to SuppressWarnings
(Nov 28 '11) Added StaticResource
(Jan 22 '09) Initial version released

Changes by version

These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line:

OpenIDE-Module-Module-Dependencies: org.netbeans.api.annotations.common > 1.20

(1.40) Exposing necessary javax.annotation elements
(1.19) Added justification attribute to SuppressWarnings
(1.13) Added StaticResource
(1.0) Initial version released

Changes by affected class

`org.netbeans.api.annotations.common.StaticResource`

(Nov 28 '11) Added StaticResource

`org.netbeans.api.annotations.common.SuppressWarnings`

(Feb 1 '13) Added justification attribute to SuppressWarnings

Details of all changes by API and date

Common Annotations API

Exposing necessary javax.annotation elements

Apr 1 '21; API spec. version: 1.40; made by: jtulach

In order to enable -Werror to treat warnings as errors, we need to get rid of annotation errors caused by missing When constants as PR-2835 explains. This is done by exposing transitively needed, but previously missing javax.annotation elements. Javadoc for the javax isn't generated and they aren't recommended to be used directly.