add some doc for new arguments (not finished)