Subject: | The docs refer to "true" when they really mean "1" |
I'm not sure how many states this applies to, but for is_authorized the
docs say "Returning anything other than true will result ...". But this
isn't right.
Only a return value of 1 is treated as true. Any other true value must
either be a valid status code (as a scalar ref) *or* it will be treated
as a failure.
Only allowing 1 as true seems to be an issue in a few other spots.
I'm happy to work on fixing this, but we should figure out the right
behavior first. Is this just a doc fix, or does it merit an API change?