Interface Stability Classification

The programming interfaces and data structures are classified with a stability class. These classifications help developers understand which interfaces may change in future releases and may need to be wrapped within their applications.

When the classification is applied to an API, it applies to the complete function signature. When applied to a data structure or typedef, it applies to the structure name and not the internal structure fields. All structure fields are regarded as internal unless explicitly stated otherwise.

The version numbering for Embedthis products follows the scheme MAJOR.MINOR.PATCH. For example 2.1.3 is major version 2, minor version 1 and patch version 3.

Classification	Description
Mature	Must be interoperable across at least two consecutive major releases so that applications are not required to change. These APIs must be Deprecated before change or removal.
Stable	Will not change between minor releases (e.g. 2.0 to 2.1). May change between major releases.
Evolving	May change between major or minor releases. May not change between patch releases (e.g. 2.0.0 to 2.0.1) release.
Prototype	May change between any major, minor or patch releases.
Deprecated	For use by legacy applications only. Customers are advised that these interfaces may be removed in the next major or minor release.
Internal	Internal API or data structure and may change at any time. Customers are strongly advised not to use these APIs.