added new fuction, added docs