changed design of functions in documentation