diff options
| -rw-r--r-- | pod/perldata.pod | 13 |
1 files changed, 7 insertions, 6 deletions
diff --git a/pod/perldata.pod b/pod/perldata.pod index 16ceb41048..4322af9013 100644 --- a/pod/perldata.pod +++ b/pod/perldata.pod @@ -416,12 +416,13 @@ end of file. Any following text is ignored. Text after __DATA__ may be read via the filehandle C<PACKNAME::DATA>, where C<PACKNAME> is the package that was current when the __DATA__ token was encountered. The filehandle is left open pointing to the -line after __DATA__. It is the program's responsibility to -C<close DATA> when it is done reading from it. For compatibility with -older scripts written before __DATA__ was introduced, __END__ behaves -like __DATA__ in the top level script (but not in files loaded with -C<require> or C<do>) and leaves the remaining contents of the -file accessible via C<main::DATA>. +line after __DATA__. The program should C<close DATA> when it is done +reading from it. (Leaving it open leaks filehandles if the module is +reloaded for any reason, so it's a safer practice to close it.) For +compatibility with older scripts written before __DATA__ was +introduced, __END__ behaves like __DATA__ in the top level script (but +not in files loaded with C<require> or C<do>) and leaves the remaining +contents of the file accessible via C<main::DATA>. See L<SelfLoader> for more description of __DATA__, and an example of its use. Note that you cannot read from the DATA |