Option words are separated by commas (not whitespace) and follow the usual
conventions of compiler backend options. Following any options (indicated
by a leading -) come lint check arguments. Each such argument (apart from the special all and none options) is a word representing one possible lint check (turning on that
check) or is no-foo (turning off that check). Before processing the check arguments, a standard
list of checks is turned on. Later options override earlier ones. Available
This option warns on each use of any variable, subroutine or method name
that lives in a non-current package but begins with an underscore (``_'').
Warnings aren't issued for the special case of the single character name
``_'' by itself (e.g. $_ and @_).
This option warns whenever an undefined subroutine is invoked. This option
will only catch explicitly invoked subroutines such as foo() and not indirect invocations such as &$subref()
or $obj->meth(). Note that some programs or modules delay definition of subs until runtime by means of the
This option warns whenever one of the regexp variables $', $& or $' is
used. Any occurrence of any of these variables in your program can slow
your whole program down. See the perlre manpage for details.
We are painfully aware that these documents may contain incorrect links and
misformatted HTML. Such bugs lie in the automatic translation process
that automatically created the hundreds and hundreds of separate documents that you find here. Please do
not report link or formatting bugs, because we cannot fix
per-document problems. The only bug reports that will help us are those
that supply working patches to the installhtml or pod2html
programs, or to the Pod::HTML module itself, for which I and the entire
Perl community will shower you with thanks and praises.
If rather than formatting bugs, you encounter substantive content errors in these documents, such as mistakes in
the explanations or code, please use the perlbug utility included
with the Perl distribution.
--Tom Christiansen, Perl Documentation Compiler and Editor