DISCUSSION: add `deprecated` flag for function

Consider adding a DEPRECATED flag for functions. This will mark functions as assigned for removal and display a warning when used.