summaryrefslogtreecommitdiff
path: root/pod/perlre.pod
diff options
context:
space:
mode:
authorJames E Keenan <jkeenan@cpan.org>2013-08-05 21:12:55 -0400
committerJames E Keenan <jkeenan@cpan.org>2013-08-07 21:04:40 -0400
commit171e73191c72028adf3c184a3ef5a0abaee34a73 (patch)
tree7136efe5ee88cdb0e214ff2772c02961fb9e4805 /pod/perlre.pod
parentcc42383380dce0d2e3c98f9f467a21c936902a8d (diff)
downloadperl-171e73191c72028adf3c184a3ef5a0abaee34a73.tar.gz
Document non-destructive substitution: the '/r' modifier.
Per bug report filed by Jacinta Richardson++. For: RT #119151
Diffstat (limited to 'pod/perlre.pod')
-rw-r--r--pod/perlre.pod9
1 files changed, 9 insertions, 0 deletions
diff --git a/pod/perlre.pod b/pod/perlre.pod
index 3b3f7276f8..404fc31109 100644
--- a/pod/perlre.pod
+++ b/pod/perlre.pod
@@ -111,6 +111,15 @@ These modifiers, all new in 5.14, affect which character-set semantics
(Unicode, etc.) are used, as described below in
L</Character set modifiers>.
+=item r
+X</r>
+
+Non-destructive substitution. Unlike regular substitution, the entity to
+which the substitution is bound is B<not> modified in place. Rather, the
+B<result> of the substitution is returned as a plain string. See
+L<perlop/"s/PATTERN/REPLACEMENT/msixpodualgcer"> for further explanation of
+the C</r> modifier.
+
=back
Regular expression modifiers are usually written in documentation