doc/example for return values