adding the filtering methods and removing deprecated method from documentation