Merge branch 'master' of github.com:perl6/doc

Author: fluca1978

doc/Language/unicode.pod6

@@ -86,11 +86,10 @@ can combine numeric and named styles as well:
     say "\c[482,PENGUIN]"; # OUTPUT: «Ǣ🐧␤»
 
 In addition to using C<\c[]> inside interpolated strings, you can also use
-the L<parse-names routine|/type/Str#routine_parse-names>
-or the parse-names method.
+the L<uniparse>:
 
-    say "DIGIT ONE".parse-names;  # OUTPUT: «1␤»
-    say parse-names("DIGIT ONE"); # OUTPUT: «1␤»
+    say "DIGIT ONE".uniparse;  # OUTPUT: «1␤»
+    say uniparse("DIGIT ONE"); # OUTPUT: «1␤»
 
 =head2 Name Aliases
 

doc/Type/Cool.pod6

@@ -905,8 +905,8 @@ Defined as:
 
 Interprets the invocant / first argument as a L<Str|/type/Str>, and returns the
 Unicode codepoint name of the first codepoint of the first character. See
-L<uninames|#routine_uninames> for a routine that works with multiple codepoints, and
-L<parse-names|/type/Str#method_parse-names> for the opposite direction.
+L<uninames|#routine_uninames> for a routine that works with multiple
+codepoints, and L<uniparse> for the opposite direction.
 
     # Camelia in Unicode
     say ‘»ö«’.uniname;
@@ -936,7 +936,7 @@ codepoints in that character.
     say "Ḍ̇'oh".comb>>.uninames.perl;
     # OUTPUT: «(("LATIN CAPITAL LETTER D WITH DOT BELOW", "COMBINING DOT ABOVE").Seq, ("APOSTROPHE",).Seq, ("LATIN SMALL LETTER O",).Seq, ("LATIN SMALL LETTER H",).Seq)␤»
 
-See L<parse-names|/type/Str#method_parse-names> for the opposite direction.
+See L<uniparse> for the opposite direction.
 
 =head2 method unimatch
 

doc/Type/DateTime.pod6

@@ -281,8 +281,13 @@ unit may be passed.
     say $d.later(days => 2).later(:1month);  # OUTPUT: «2015-04-01T00:00:00Z␤»
     say $d.later(days => 2).later(:month);   # same, as +True === 1
 
-Negative offsets are allowed, though L<#method earlier> is more idiomatic for
-that.
+If the resultant time has value C<60> for seconds, yet no leap second
+actually exists for that time, seconds will be set to C<59>:
+
+    say DateTime.new('2008-12-31T23:59:60Z').later: :1day;
+    # OUTPUT: «2009-01-01T23:59:59Z␤»
+
+Negative offsets are allowed, though L<earlier> is more idiomatic for that.
 
 =head2 method earlier
 
@@ -296,6 +301,14 @@ towards the past applied. See L<#method later> for usage.
     my $d = DateTime.new(date => Date.new('2015-02-27'));
     say $d.earlier(month => 1).earlier(:2days);  # OUTPUT: «2015-01-25T00:00:00Z␤»
 
+If the resultant time has value C<60> for seconds, yet no leap second
+actually exists for that time, seconds will be set to C<59>:
+
+    say DateTime.new('2008-12-31T23:59:60Z').earlier: :1day;
+    # OUTPUT: «2008-12-30T23:59:59Z␤»
+
+Negative offsets are allowed, though L<later> is more idiomatic for that.
+
 =head2 method truncated-to
 
 Defined as:

doc/Type/Str.pod6

@@ -296,13 +296,29 @@ See also: L«:16<FF> syntax for number literals|/syntax/Number%20literals»
     sub    parse-names(Str:D $names  --> Str:D)
     method parse-names(Str:D $names: --> Str:D)
 
+B<DEPRECATED>. Existed only in pre-release proposal version of 6.d language and
+was eventually renamed to L<uniparse>. In Rakudo implementation,
+issues deprecation warnings in 6.d language and will be removed entirely in 6.e.
+
+=head2 routine uniparse
+
+    sub    uniparse(Str:D $names  --> Str:D)
+    method uniparse(Str:D $names: --> Str:D)
+
 Takes string with comma-separated Unicode names of characters and
 returns a string composed of those characters. Will L«C<fail>|/routine/fail»
 if any of the characters' names are empty or not recognized. Whitespace
 around character names is ignored.
 
-    say "I {parse-names 'TWO HEARTS'} Perl"; # OUTPUT: «I 💕 Perl␤»
-    'TWO HEARTS, BUTTERFLY'.parse-names.say; # OUTPUT: «💕🦋␤»
+    say "I {uniparse 'TWO HEARTS'} Perl"; # OUTPUT: «I 💕 Perl␤»
+    'TWO HEARTS, BUTTERFLY'.uniparse.say; # OUTPUT: «💕🦋␤»
+
+Note that unlike C<\c[...]> construct available in string interpolation,
+C<uniparse> does not accept decimal numerical values. Use L<chr> routine to
+covert those:
+
+    say "\c[1337]"; # OUTPUT: «Թ␤»
+    say '1337'.chr; # OUTPUT: «Թ␤»
 
 =head2 routine split