minor updates and deprecation notice