It seems like every time I try to use it, it's grayed out. It would be extremely useful for porting code from an old API to a new one.

Have you tried

@Deprecated + @ReplaceWith

annotations? They might be really helpful in this situation