updated method doc block