| Subject: | $s = $s->new() or die $s->errstr; |
The documentation includes the following twice:
$s = $s->new() or die $s->errstr;
That's not right.
If it's possible for $s->new to return something false, the call to errstr will fail (possibly with the error C<< Can't call method "errstr" on an undefined value >>).
If it's not possible for $s->new to return something false, the C<< die $s->errstr >> will never get executed.