From 286f584ab7c58e3769088aa5b01f152848311dbc Mon Sep 17 00:00:00 2001
From: Rafael Garcia-Suarez <rgarciasuarez@gmail.com>
Date: Thu, 26 Oct 2006 16:11:26 +0000
Subject: [PATCH] Document the new (?FAIL) assertion (Yves Orton)

p4raw-id: //depot/perl@29119
---
 pod/perlre.pod | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/pod/perlre.pod b/pod/perlre.pod
index 1a95297..b46b381 100644
--- a/pod/perlre.pod
+++ b/pod/perlre.pod
@@ -933,6 +933,15 @@ the same name, then it recurses to the leftmost.
 It is an error to refer to a name that is not declared somewhere in the
 pattern.
 
+=item C<(?FAIL)> C<(?F)>
+X<(?FAIL)> X<(?F)>
+
+This pattern matches nothing and always fails. It can be used to force the
+engine to backtrack. It is equivalent to C<(?!)>, but easier to read. In
+fact, C<(?!)> gets optimised into C<(?FAIL)> internally.
+
+It is probably useful only when combined with C<(?{})> or C<(??{})>.
+
 =item C<< (?>pattern) >>
 X<backtrack> X<backtracking> X<atomic> X<possessive>
 
-- 
2.7.4