Change behaviour of theme_update to be more like an update #1519
Per discussion in #1489, this changes
I've also added some verbiage to the documentation clarifying what these do, along with examples.
…g theme_replace that has the same behaviour as the old theme_update. Also expanded and clarified the documentation for these.