Document Str's .starts-with and .ends-with ignorecase/ignoremark

Refs #3229

Author: stoned

doc/Type/Str.pod6

@@ -627,22 +627,54 @@ Examples:
 
 =head2 method starts-with
 
-    multi method starts-with(Str:D: Str(Cool) $needle --> Bool:D)
+    multi method starts-with(Str:D: Str(Cool) $needle, :i(:$ignorecase), :m(:$ignoremark) --> Bool:D)
 
 Returns C<True> if the invocant is identical to or starts with C<$needle>.
 
     say "Hello, World".starts-with("Hello");     # OUTPUT: «True␤»
     say "https://raku.org/".starts-with('ftp');  # OUTPUT: «False␤»
 
+Since Rakudo version 2020.02, if the optional named parameter
+C<:ignorecase>, or C<:i>, is specified, the comparison of the invocant
+and C<$needle> ignores the distinction between upper case, lower case
+and title case letters.
+
+    say "Hello, World".starts-with("hello");              # OUTPUT: «False␤»
+    say "Hello, World".starts-with("hello", :ignorecase); # OUTPUT: «True␤»
+
+Since Rakudo 2020.02, if the optional named parameter C<:ignoremark>,
+or C<:m>, is specified, the comparison of the invocant and C<$needle>
+only considers base characters, and ignores additional marks such as
+combining accents.
+
+    say "abc".starts-with("ä");              # OUTPUT: «False␤»
+    say "abc".starts-with("ä", :ignoremark); # OUTPUT: «True␤»
+
 =head2 method ends-with
 
-    multi method ends-with(Str:D: Str(Cool) $needle --> Bool:D)
+    multi method ends-with(Str:D: Str(Cool) $needle, :i(:$ignorecase), :m(:$ignoremark) --> Bool:D)
 
 Returns C<True> if the invocant is identical to or ends with C<$needle>.
 
     say "Hello, World".ends-with('Hello');      # OUTPUT: «False␤»
     say "Hello, World".ends-with('ld');         # OUTPUT: «True␤»
 
+Since Rakudo version 2020.02, if the optional named parameter
+C<:ignorecase>, or C<:i>, is specified, the comparison of the invocant
+and C<$needle> ignores the distinction between upper case, lower case
+and title case letters.
+
+    say "Hello, World".ends-with("world");              # OUTPUT: «False␤»
+    say "Hello, World".ends-with("world", :ignorecase); # OUTPUT: «True␤»
+
+Since Rakudo 2020.02, if the optional named parameter C<:ignoremark>,
+or C<:m>, is specified, the comparison of the invocant and C<$needle>
+only considers base characters, and ignores additional marks such as
+combining accents.
+
+    say "abc".ends-with("ç");              # OUTPUT: «False␤»
+    say "abc".ends-with("ç", :ignoremark); # OUTPUT: «True␤»
+
 =head2 method subst
 
     multi method subst(Str:D: $matcher, $replacement = "", *%options)