improved comments on deprecated classes and methods