Discussing "very unfortunate" and "bad" code examples is hardly "hair splitting".

We both are experienced enough to handle this, but many others won't.

...documentation can include sloppy wording, that's hard to avoid.

But sloppy code is not a good idea, since there is no doubt of interpretation.

I'll file a perlbug.