doc nextcallee

Author: gfldex

doc/Language/functions.pod6

@@ -781,6 +781,19 @@ sub run-it-again-and-again($x) {
 say power-it(5);    # 625
 =end code
 
+X<|nextcallee>
+Redispatch may be required to call a block that is not the current scope what
+provides C<nextsame> and friends with the problem to referring to the wrong
+scope. Use C<nextcallee> to capture the right candidate and call it at the
+desired time.
+
+    my \IOL = Lock.new;
+    &say.wrap( -> |c {
+        my &wrappee = nextcallee;
+        IOL.protect: { &wrappee(|c) }
+    });
+    for ^100 { say "oops" }
+
 =head1 Coercion Types
 
 Coercion types can help you to have a specific type inside a routine, but