updated functions documentation