update docs and usage of _DeprecatedFunction_ to make gcc happier