The poor and distributed¹ documentation is the problem

And the way perldocs are often handled as witty prose resulting from group dynamics instead of being based on evidence (i.e. test cases).

I don't think it's ever appropriate to flag a feature "buggy"

• if there are unexpected side-effects a "warning" should be explained in a footnote.
• if they are really "buggy", they should be disabled.

¹) perlop has far more than perlre and perlretut has only a "\o ... beyond the scope of this introduction" ...