I'd go with the comment, but we need a standard form so we can find it. Maybe just  `deprecate` with the version of introduction, `new in ...` or some such and in indication of how to do it. Maybe some commented out code?