Las herramientas de API proporcionan soporte para la gestión de códigos @since Javadoc en nuevos elementos que han añadido a la API (tipos, métodos, campos, etc).
Los nuevos elementos de API podrían ser un nuevo tipo añadido a un paquete de API, un nuevo tipo añadido a un tipo de API, un nuevo método añadido a un tipo de API, o un nuevo campo añadido a un tipo de API.
La adición de métodos es un caso especial, donde una adición de método podría estar añadiendo un método a un tipo, alterando temporalmente un método de clase padre, implementando un método de interfaz padre o cambiando la signatura de un método existente.
Nota: La información del código @since no se propaga mediante implementación o subclases. Se espera que cada elemento que se añade a la API tenga su propio código @since e información de versión.
Las herramientas proporcionan la siguiente validación para los códigos @since:
Las preferencias para la gestión de códigos @since pueden cambiarse en la página de preferencias
Desarrollo
de plug-ins > Errores/Avisos de API.
Las herramientas comprobarán cada nuevo elemento de API detectado para asegurar que tiene un código @since.
Si el nuevo elemento no tiene un código @since, se marcará como que necesita una, y se propondrá una versión para el código.
La versión propuesta para el nuevo código será la versión actual del paquete compuesto, excepto en el caso de un cambio de ruptura de API donde también deba actualizarse la versión del paquete compuesto. Si también es necesario actualizar la versión del paquete compuesto, la versión propuesta para el código @since faltante será la versión propuesta del paquete compuesto.
Tome en consideración el siguiente ejemplo: tenemos un paquete compuesto A con la versión 1.0.0 y tenemos una clase C que se añadió en la versión 1.1.0 de A que contiene el método m1().
@since faltante en m2() y sugerirán que se coloque un nuevo código de @since 1.1 en m2().@since faltante en m2() y sugerirán que se coloque un nuevo código de @since 2.0 en m2(). Donde 2.0.0
es la nueva versión propuesta de paquete compuesto.
Puede comprobarse la coherencia de los códigos @since de los elementos nuevos para asegurar que se han formulado correctamente. Las herramientas de API comprueban que todos los códigos @since siguen el formato general de:
[@since] [pre-amble] [2 part version] [post-amble]
Tome en consideración los siguientes ejemplos de códigos @since:
@since A 1 added m2(): se marcaría como malformado porque falta el segundo segmento en la versión@since: se marcaría como malformado porque no hay información de versión@since A: se marcaría porque no hay información de versión@since 1.0.0: se marcaría porque la versión tiene demasiados segmentos@since A 1.0 added m2(): no se marcaría
También puede comprobarse la validez de los códigos @since de los elementos nuevos. Se considera que un código @since es válido si la información de versión en el código coincide con la versión del paquete.
Observe el siguiente ejemplo, donde hemos añadido un nuevo método m2() a una clase de API en el paquete A cuya versión es 1.0.0:
@since A 1.0 added method m2(): se considera válido@since A 2.0 added method m2(): no es válido porque la versión del paquete A es 1.0.0@since A 0.1 added method m2(): no es válido porque la versión del paquete A es 1.0.0

Preferencias de líneas base de API
Preferencias de errores y avisos de API