added some comments
added deprecated note
reverse patch
updated test