title: Are there best/recommended practices to follow when renaming functions in a new version of a package?
body: <p>I'm updating an old package and shortening a bunch of really long function names. How do I let a user know the the old function has been deprecated? I document everything with <code>roxygen2</code> so  I'm wondering if <code>#' @alias</code> is what I should use? Thoughts?</p>