Integrate change #14062 from macperl;

[p5sagit/p5-mst-13.2.git] / pod / perllexwarn.pod

diff --git a/pod/perllexwarn.pod b/pod/perllexwarn.pod
index 3dd3ba9..cd76f3a 100644 (file)
--- a/pod/perllexwarn.pod
+++ b/pod/perllexwarn.pod
@@ -207,8 +207,6 @@ The current hierarchy is:
 
   all -+
        |
-       +- chmod
-       |
        +- closure
        |
        +- exiting
@@ -285,8 +283,6 @@ The current hierarchy is:
        |
        +- taint
        |
-       +- umask
-       |
        +- uninitialized
        |
        +- unpack
@@ -325,16 +321,16 @@ and C<join> can all produce a C<"Useless use of xxx in void context">
 warning.
 
     use warnings ;
- 
+
     time ;
- 
+
     {
         use warnings FATAL => qw(void) ;
         length "abc" ;
     }
- 
+
     join "", 1,2,3 ;
- 
+
     print "done\n" ;     
 
 When run it produces this output
@@ -346,6 +342,12 @@ The scope where C<length> is used has escalated the C<void> warnings
 category into a fatal error, so the program terminates immediately it
 encounters the warning.
 
+To explicitly disable a "FATAL" warning you just disable the warning it is
+associated with.  So, for example, to disable the "void" warning in the
+example above, either of these will do the trick:
+
+    no warnings qw(void);
+    no warnings FATAL => qw(void);
 
 =head2 Reporting Warnings from a Module
 
@@ -468,7 +470,7 @@ Consider this example:
         bless [], $class ;
     }
 
-   
+
     1 ;
 
 The code below makes use of both modules, but it only enables warnings from