Note performance benefit of using a statically...

typed Str|str for regex literal interpolation.

Author: MasterDuke17

doc/Language/regexes.pod6

@@ -1264,10 +1264,15 @@ There are four ways you can interpolate a string into regex as a pattern.
 That is using C«$pattern», C«$($pattern)», C«<$pattern>» or
 C«<{$pattern.method}>».
 
+If the variable to be interpolated is statically typed as a C«Str» or C«str»
+(like C«$pattern0» and C«$pattern2» are below) and only interpolated literally
+(like the first example below), than the compiler can optimize that and it runs
+much faster.
+
     my Str $text = 'camelia';
     my Str $pattern0 = 'camelia';
-    my Str $pattern1 = 'ailemac';
-    my Str $pattern2 = '\w+';
+    my     $pattern1 = 'ailemac';
+    my str $pattern2 = '\w+';
 
     say $text ~~ / $pattern0 /;                # OUTPUT: «｢camelia｣␤»
     say $text ~~ / $($pattern0) /;             # OUTPUT: «｢camelia｣␤»