fix comment, add param and return descriptions