15.2.8 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);