updated function doc strings