API dox: for deprecated tell since and what to use instead
yes, deprecated since 4.0 (sic), ideally would have been dropped for 5.0