[v6.d REVIEW] Document :count on lines as deprecated

Author: zoffixznet

doc/Type/Str.pod6

@@ -525,7 +525,6 @@ is returned by using features which explicitly set the top-level capture.
 
 Defined as:
 
-    multi method lines(Str:D: :$count!)
     multi method lines(Str:D: $limit)
     multi method lines(Str:D:)
 
@@ -539,21 +538,20 @@ Examples:
     say "a\nb".lines.elems;    # OUTPUT: «2␤»
     say "a\n".lines.elems;     # OUTPUT: «1␤»
 
-The first multi in the definition above just counts the number of lines if
-C<count> is true.
+You can limit the
+number of lines returned by setting the C<$limit> variable to a non-zero,
+non-C<Infinity> value:
 
-    say <not there yet>.join("\n").lines( :count ); # OUTPUT: «3␤»
+    say <not there yet>.join("\n").lines( 2 ); # OUTPUT: «(not there)␤»
 
-However, this feature might be deprecated in the near future; you can always
-use:
+B«DEPRECATED as of C<6.d> language», the C<:count> argument can be used
+to return the total number of lines:
 
-say <not there yet>.join("\n").lines.elems; # OUTPUT: «3␤»
+    say <not there yet>.join("\n").lines( :count ); # OUTPUT: «3␤»
 
-You can also limit the
-number of lines returned by setting the C<$limit> variable to a non-zero,
-non-C<Infinity> value:
+Use L<elems> call on the returned L<Seq> instead:
 
-    say <not there yet>.join("\n").lines( 2 ); # OUTPUT: «(not there)␤»
+    say <not there yet>.join("\n").lines.elems; # OUTPUT: «3␤»
 
 =head2 routine words