documenting new return value