If you need it just for developer's documentation, leaving a comment would be enough. If you need to also issue a warning in run time, just add a warning-issuing expression to the effect/event handler as the very first line. If you need tooling support (e.g. showing all deprecated functions without running full text search manually), you can extract handler functions into proper vars and attach that metadata to them.

thanks!