perldiag.pod: Clarify non-suffix form regex modifiers
authorKarl Williamson <public@khwilliamson.com>
Thu, 17 Feb 2011 22:05:20 +0000 (15:05 -0700)
committerKarl Williamson <public@khwilliamson.com>
Thu, 17 Feb 2011 22:41:54 +0000 (15:41 -0700)
It currently is planned to not have the new regex modifiers be available
in suffix form in 5.14.  This likely will lead to confusion given the
existing message.  This adds text to clarify.

pod/perldiag.pod

index ee1b694..df57e50 100644 (file)
@@ -1996,7 +1996,11 @@ Further error messages would likely be uninformative.
 (D syntax)
 
 You had a word that isn't a regex modifier immediately following a pattern
-without an intervening space.  For example, the two constructs:
+without an intervening space or you used one of the regex modifiers
+("a", "d", "l", and "u") that in 5.14 are disallowed as suffixes.
+In that case, use the infix form, like C</(?a:...)/>.  In the other case,
+add between the pattern and following word.  As an example of the
+latter, the two constructs:
 
  $a =~ m/$foo/sand $bar
  $a =~ m/$foo/s and $bar