added some functions
documentation