perl 5.003_01: pod/perlop.pod
Perl 5 Porters [Mon, 17 Jun 1996 06:21:12 +0000 (06:21 +0000)]
Correct typos and pod formatting
Correct documentation for s///: return value with no substitutions,
  use of backticks as delimiters

pod/perlop.pod

index 483a686..91cee46 100644 (file)
@@ -749,7 +749,7 @@ Some frequently seen examples:
 
 Searches a string for a pattern, and if found, replaces that pattern
 with the replacement text and returns the number of substitutions
-made.  Otherwise it returns false (0).
+made.  Otherwise it returns false (specifically, the empty string).
 
 If no string is specified via the C<=~> or C<!~> operator, the C<$_>
 variable is searched and modified.  (The string specified with C<=~> must
@@ -777,9 +777,9 @@ Options are:
 
 Any non-alphanumeric, non-whitespace delimiter may replace the
 slashes.  If single quotes are used, no interpretation is done on the
-replacement string (the C</e> modifier overrides this, however).  If
-backquotes are used, the replacement string is a command to execute
-whose output will be used as the actual replacement text.  If the
+replacement string (the C</e> modifier overrides this, however).  Unlike
+Perl 4, Perl 5 treats backticks as normal delimiters; the replacement
+text is not evaluated as a command.  If the
 PATTERN is delimited by bracketing quotes, the REPLACEMENT has its own
 pair of quotes, which may or may not be bracketing quotes, e.g.
 C<s(foo)(bar)> or C<sE<lt>fooE<gt>/bar/>.  A C</e> will cause the
@@ -1073,7 +1073,7 @@ returning FALSE.
 
 It you're trying to do variable interpolation, it's definitely better
 to use the glob() function, because the older notation can cause people
-to become confused with the indirect filehandle notatin.
+to become confused with the indirect filehandle notation.
 
     @files = glob("$dir/*.[ch]");
     @files = glob($files[$i]);