in reply to Class::DBI Manpage Swindle??

Instead of calling it a swindle, call it a documentation bug and report it to the author. The best way to do that is to read the documentation and find out where the author wants bugs reported. If there isn't a place, use http://rt.cpan.org.

Remember, CPAN modules go through numerous iterations, often several releases in a week. Features change and grow, and sometimes documentation gets left behind. Unlike code, for which you can write tests, it's a lot harder to keep documentation in sync with requirements. We often depend on our users to help us find documentation errors. Remember - we know how it works, so we miss places where it's confusing or just plain wrong.

Being right, does not endow the right to be rude; politeness costs nothing.
Being unknowing, is not the same as being stupid.
Expressing a contrary opinion, whether to the individual or the group, is more often a sign of deeper thought than of cantankerous belligerence.
Do not mistake your goals as the only goals; your opinion as the only opinion; your confidence as correctness. Saying you know better is not the same as explaining you know better.

In Section Seekers of Perl Wisdom