perlfunc: clarify that "do $file" isn't really like "eval `cat $file`"
authorAaron Crane <arc@cpan.org>
Tue, 19 Feb 2013 14:17:59 +0000 (14:17 +0000)
committerAaron Crane <arc@cpan.org>
Thu, 21 Feb 2013 19:50:56 +0000 (19:50 +0000)
Closes RT#116713.

pod/perlfunc.pod

index 0541bfd..8f71880 100644 (file)
@@ -1558,11 +1558,12 @@ file as a Perl script.
 
     do 'stat.pl';
 
-is just like
+is largely like
 
     eval `cat stat.pl`;
 
-except that it's more efficient and concise, keeps track of the current
+except that it's more concise, runs no external processes, keeps track of
+the current
 filename for error messages, searches the C<@INC> directories, and updates
 C<%INC> if the file is found.  See L<perlvar/@INC> and L<perlvar/%INC> for
 these variables.  It also differs in that code evaluated with C<do FILENAME>