updated docstring with new functionality
updated usage
updated version
implemented the new api