How and When to Deprecate APIs" and the @Deprecated annotation

Oracle. How and When to Deprecate APIs" and the `@Deprecated` annotation. Java Platform SE Documentation.

Type

Web resource

Intellectual base

Web

Link

https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/deprecation/deprecation.html

Cited from

education_pedagogy

Cited by

1 citation across 1 artifact.

Each citation links to the sentence it supports in the citing article.

Primes

• Retired Term
  • In software and programming languages, deprecated functions, classes, and endpoints still compile or respond, typically with a warning and a documented successor, before any eventual removal.

    This sourceSpecifies that deprecated program elements still compile and run, emit a warning, and (via `@deprecated`) document a successor before any eventual removal.

    SupportedVerified against the work's full text

    Oracle's guide says deprecated Java elements keep working, trigger compiler warnings, name a replacement, and may be removed in future.

    “Existing calls to the old API continue to work, but the annotation causes the compiler to issue a warning when it finds references to deprecated program elements. The Javadoc tag and associated comments warn users against using the deprecated item and tell them what to use instead.”

    Read by an automated reader; not a human review. How support was checked

Verification

Does it exist? Not checked yet. This entry carries no identifier to resolve. It was extracted from the citation as written in the article, normalized, and deduplicated against the rest of the registry.

Does it back the claim? Read against the text for 1 of 1 citation: 1 supported. Each verdict is shown under its citation below, with what in the work backs the sentence.

Support is checked per citation rather than per work — the same source can be cited soundly in one article and wrongly in another. Per-citation recording began recently, so a citation with no recorded check is a gap in the record rather than evidence it went unchecked.

See how references were verified.

Registry ID ref:f8212b582d30 · see in the full table