Adds example for |, refs #1889

doc/Language/operators.pod6

@@ -923,12 +923,23 @@ Coerces the argument to L<Str> by calling the L<Str|/type/List#method_Str> metho
 
 =head2 prefix C«|»
 
-Flattens objects of type L<Capture>, L<Pair>, L<List>, L<Map> and L<Hash>
-into an argument list.
-
-Outside of argument lists, it returns a L<Slip|/type/Slip>, which makes it
-flatten into the outer list. Inside L<argument list|/language/list#Argument_List_(Capture)_Context> L<C<Positional>s|/type/Positional> are turned
-into positional arguments and L<C<Associative>s|/type/Associative> are turned into named arguments.
+Flattens objects of type L<Capture>, L<Pair>, L<List>, L<Map> and
+L<Hash> into an argument list.
+
+    sub foo( *@args ) {
+        say @args.perl
+    };
+    foo( |  <2 3 4>, 'a' | ' b', \( 3, 33) )
+    # OUTPUT: «[IntStr.new(2, "2"), IntStr.new(3, "3"),\
+    IntStr.new(4, "4"),any("a", " b"), \(3, 33)]␤»
+
+
+Outside of argument lists, it returns a L<Slip|/type/Slip>, which makes
+it flatten into the outer list. Inside L<argument
+list|/language/list#Argument_List_(Capture)_Context>
+L<C<Positional>s|/type/Positional> are turned into positional arguments
+and L<C<Associative>s|/type/Associative> are turned into named
+arguments.
 
 =head2 prefix C«||»