fixed deprecation tests and tweaked documentation