docu added
new function parameters added to docu