Notice: We have migrated to GitLab launching 2024-05-01 see here:

Version 2 (modified by Gedare Bloom, on 03/10/15 at 15:55:47) (diff)

Write new advice for deprecating features.

Deprecating Public Application Programming Interfaces

Table of Contents

    Error: Page Developer/DeprecatingInterfaces does not exist

This page documents the procedures for deprecating a public-facing interface in RTEMS.

Use the deprecate attribute

Add the RTEMS_COMPILER_DEPRECATED_ATTRIBUTE, which for gcc wraps the deprecated attribute, to functions, structures, and global symbols exported by the deprecated interface. Update the doxygen for each of these with the @deprecated command, for example,

 * @brief RTEMS Feature
 * @deprecated Feature is deprecated and will be removed.

Add a warning for configured features in confdefs.h

For features that are enabled or configured through confdefs.h, the feature should be disabled by default and a compile-time warning message should be printed, something along the lines of

 #warning "CONFIGURE_FEATURE_XXX\n\t\t\t**** Deprecated and will be removed. ****"

Update documentation

Find references to the deprecated feature in the user manuals (doc) and wiki, and make a note that the features are deprecated and may be removed.

Add a release note

Add the feature to a list of deprecated interfaces in the release notes.