add verbose argument to some routines
update parameters section in docstrings (verbose argument etc.)