Deprecation

Deprecation is the discouragement of use of something human-made, such as a term, feature, design, or practice. Typically something is deprecated because it is claimed to be inferior compared to other options available.

Something may be deprecated when it cannot be controlled, such as a term. Even when it can be controlled, something may be deprecated even when it might be useful for example, to ensure compatibility and it may be removed or discontinued at some time after being deprecated.

Etymology

In general English usage, the verb "to deprecate" means "to express disapproval of (something)". It derives from the Latin deponent verb ''deprecari'', meaning "to ward off (a disaster) by prayer".

An early documented usage of "deprecate" in this sense is in Usenet posts in 1984, referring to obsolete features in 4.2BSD and the C programming language. An expanded definition of "deprecate" was cited in the Jargon File in its 1991 revision, and similar definitions are found in commercial software documentation from 2014 and 2023.

Software

While a deprecated software feature remains in the software, its use may raise warning messages recommending alternative practices. Deprecated status may also indicate the feature will be removed in the future. Features are deprecated, rather than immediately removed, to provide backward compatibility and to give programmers time to bring affected code into compliance with the new standard.

Notable reasons for deprecation include:

Other usage

A building code example is the use of ungrounded ("2-prong") electrical receptacles (UK English: "unearthed"). Over time, these older devices were widely deprecated in favor of safer grounded ("3-prong") receptacles. The older, ungrounded receptacles were still permitted in many places by " grandfathering" them in existing electrical wiring, while prohibiting them for new installations. Thus, though ungrounded receptacles may still be available for legal purchase in a location where they are obsolete, they would generally be intended only for repairs to existing older electrical installations.

In writing and editing, usage of a word may be deprecated because it is ambiguous, confusing, or offensive to some readers. For example, the words ''sanction'' and '' inflammable'' may be misinterpreted because they have auto-antonymic or self-contradictory meanings; writing style guides often recommend substituting other words that are clearly understood and unambiguous. Some word usages that have acquired different connotations over time, such as '' gay'' or ''colored'', may be deprecated as obsolete in formal writing.

In technical standards, use of a certain clause may be discouraged or superseded by new clauses. As an example, in the Ethernet standard IEEE 802.3-2012, Clause 5 (Layer Management) is "deprecated" by Clause 30 (Management), except for 5.2.4.

Deprecation may also occur when a technical term becomes obsolete, either through change or supersession. An example from paleontology is the previously deprecated term '' Brontosaurus'': before being recognized once again as a unique genus, it was considered a popular, yet deprecated, name for the genus '' Apatosaurus''. Some deprecated terms in medicine are ''consumption'' (tuberculosis), ''grippe'' ( influenza), and ''apoplexy'' (stroke). In chemical nomenclature, the international standards organization IUPAC (International Union of Pure and Applied Chemistry) has deprecated the term "methyl ethyl ketone", and now recommends using the term " ethyl methyl ketone" instead.

See also

*Abandonware
* Grandfather clause
* List of deprecated terms for diseases
*Obsolescence
* Orphaned technology

References

External links

How and When To Deprecate APIs
from the JDK 5.0 Documentation

{{Use dmy dates, date=March 2017

Backward compatibility