Functions and other definitions can be marked as deprecated using the @deprecated attribute.

If a deprecated function is reference the compiler will emit a warning, letting the programmer know they ought to update their code.

The deprecation atribute takes a message and this will be displayed to the user in the warning. In the message explain to the user the new approach or replacement function, or direct them on documentation on how to upgrade.