perlre could definitely be clearer. Part of the problem is very few people understand it properly, so the documentation's often done by people who don't quite get it. (As the people who do understand the regex engine well enough to notice the problems are generally too heavily medicated to do anything... :)