deprecation documentation; fixes #120