Add documentation to enum values that won't be returned in normal operation

[tstirrat15]

E.g. UNSPECIFIED in the LookupPermissionship, and the CheckPermissionship equivalents. There's a few of these kinds of values and it would help to explicitly put in their docs that we don't return them.