replace deprecation warnings with proper doccomments for IDE autocompletion