I API-verktygen finns funktioner för hantering av Javadoc-märkordet @since för nya API-element (typer, metoder, fält osv.).
Ett nytt API-element kan vara en ny typ som har lagts till ett API-paket eller API-typ, en ny metod för en API-typ eller ett nytt fält för en API-typ.
Metodtillägg kan vara att lägga till en metod till en typ, åsidosätta en metod för en överordnad klass, implementera en metod för ett överordnat gränssnitt eller ändra en metodsignatur.
Anm. @since-märkordsinformation sprids inte via implementering eller subklassificering. Varje element som läggs till ett API förväntas ha ett eget @since-märkord och versionsinformation.
Verktygen innehåller följande valideringsfunktioner för @since-märkord:
@since-märkord som saknas@since-märkord som har fel format@since-märkordsversioner som är ogiltigaInställningarna för hantering av @since-märkord kan ändras på sidan
Utveckling av insticksprogram > API-fel/-varningar.
Alla nya API-element som upptäcks kontrolleras så via verktyget så att det innehåller ett @since-märkord.
Om elementet inte har ett @since-märkord flaggas det med ett förslag på märkordsversion.
Föreslagen version är den aktuella versionen av samlingspaketet förutom om det gäller en API-ändring där samlingspaketets version också behöver uppdateras. Om samlingspaketets version också behöver uppdateras föreslås den versionen för det @since-märkord som saknas.
Exempel: Vi har samlingspaketet A med version 1.0.0 och klassen C som lades till i version 1.1.0 av A som innehåller metoden m1().
@since-märkord för m2() och ett nytt märkord, @since 1.1 föreslås för m2().@since-märkord för m2() och föreslår att märkordet @since 2.0 för m2(). 2.0.0
är den nya föreslagna samlingspaketversionen.
Det går att kontrollera konsekvensen för nya elements @since-märkord så att de får rätt format. Med API-verktygen kontrolleras att alla @since-märkord följer det allmänna formatet
[@since] [pre-amble] [2 part version] [post-amble]
Exempel på @since-märkord:
@since A 1 added m2(): flaggas för fel format eftersom det andra segmentet för versionen saknas@since: flaggas för fel format eftersom versionsinformationen saknas@since A: flaggas eftersom versionsinformationen saknas@since 1.0.0: flaggas eftersom versionen innehåller för många segment@since A 1.0 added m2(): flaggas inte
Det går också att kontrollera giltigheten hos nya elements @since-märkord. Ett @since-märkord betraktas som giltigt om versionsinformationen i märkordet stämmer med samlingspaketversionen.
I följande exempel har vi lagt till en ny metod m2() till en API-klass i samlingspaket A med version 1.0.0:
@since A 1.0 added method m2(): är giltigt@since A 2.0 added method m2(): är ogiltigt eftersom versionen på samlingspaket A är 1.0.0@since A 0.1 added method m2(): är ogiltigt eftersom versionen på samlingspaket A är 1.0.0

Inställningar för API-basnivåer
Inställningar för API-fel och -varningar