updated description of the functions