17.2.7 Deprecated Function Attribute
The
deprecated (msg) attribute will trigger a
compiler warning should the attributed function be called in a program. If
the optional msg argument string is
present, that string will be printed in the warning instead of a default
message, for
example:void __attribute__ ((deprecated ("The bar function is no longer used"))) bar (void);