update the docstring with new arguments (and all the other missing ones)