The Perl pragma
use warnings is a major nuisance. But it is still part of
the boilerplate code of many Perl module authors who are not aware to which
extent they are harrassing their users and their users' users by forcing them
to become involuntary beta testers.
Wait a second! Isn't it an established good practice in C to turn on all but the esoteric warnings? Why should it be bad practice in Perl?
There is a difference. C is a compiled language, C warnings are compiler warnings, they are compile-time warnings. Perl is an interpreted language, and although it distinguishes between compile-time and run-time warnings, this distinction is completely artificial and incomprehensible for users. Compile-time and run-time warnings look the same to them. They look like run-time warnings. And they are a nuisance, an evidence of developer ignorance like unsolicited stack traces in Java or one of the languages following Java's bad example.
The intended audience of automatically generated warnings is the author of the code. Users of the code, leave alone users of the users of the code should normally be left alone with such stuff. They can turn warnings on, when they feel the need for it.
But don't they miss important information then? Especially other programmers
using a library? No. I have written at least one million lines of Perl code
and I have never ever found a problem in a third-party module because of
warnings turned on inside of it. And, honestly, most warnings produced by Perl
are pretty useless (think of
Wide character in ... or similar nonsense).
But, hey, my fantastic module is free. The least that my users can do is to help out finding problems in the code. Well, then rather sell your software! Free software is about freedom not about free beer. If you want help from your users, ask first or pay for it.
But I must be ultimately wrong because
perldoc warnings explicitly states
use warnings is favorable over the
-w command-line switch because
its scope is the enclosing block and it does not leak across file boundaries.
So what? It is true but they forgot to mention that there is no easy way for users
of the software to shut up these warnings.
Exactly for these reasons you as the module author in your development
environment should run your own software with the
-w command-line switch
or if you are developing a web application set the environment variable
-w in your web server configuration. Package maintainers
should probably do the same, end users only if they want to.
Warnings will be turned on globally then, and they are only visible for their intended audience, that is the author of the software, other professionals or interested users. It is their task then to set apart important warnings from sheer noise. The users will be thankful for not having their log files scattered with unsolicited debugging information for other people's code.
blog comments powered by Disqus