summaryrefslogtreecommitdiff
path: root/pod/perlrun.pod
diff options
context:
space:
mode:
Diffstat (limited to 'pod/perlrun.pod')
-rw-r--r--pod/perlrun.pod8
1 files changed, 8 insertions, 0 deletions
diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index fe8a154c39..7169515c54 100644
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -260,11 +260,19 @@ C<-M>I<module> executes C<use> I<module> C<;> before executing your
script. You can use quotes to add extra code after the module name,
e.g., C<-M'module qw(foo bar)'>.
+If the first character after the C<-M> or C<-m> is a dash (C<->)
+then the 'use' is replaced with 'no'.
+
A little built-in syntactic sugar means you can also say
C<-mmodule=foo> or C<-Mmodule=foo> as a shortcut for
C<-M'module qw(foo)'>. Note that using the C<=> form
removes the distinction between C<-m> and C<-M>.
+To avoid the need to use quotes when importing more that one symbol
+with the C<=> form, the text following the C<=> is split into a list
+on commas (C<,>) rather than whitespace. The actual code generated
+by C<-Mmodule=foo,bar> is C<use module split(/,/,q{foo,bar})>.
+
=item B<-n>
causes Perl to assume the following loop around your script, which