corrected docs about returning additional info