added @return values and example