I'm unsure. Since deprecation warns by default now (AFAIK), and that a comment is almost as good as useless, isn't better to straight up mark as deprecated? It's the actual removal of the function that can prove problematic.

But I could be mistaken.