perhaps mention what the boolean also returned by the function means?