document the return value