Merge pull request #3230 from Raku/star-RAKU

Star raku

Author: stoned

doc/Language/5to6-perlvar.pod6

@@ -135,10 +135,10 @@ C<OLDPWD> is missing from Raku's %ENV.
 
 =head3 $OLD_PERL_VERSION, $]
 
-The running version of Raku is kept by C<$*PERL> special variable, that is an object.
-The running version is retrieved via C<$*PERL.version>, which returns something
-like C<v6.c>; the full stringified version of the Perl interpreter is obtained
-via C<~$*PERL>, which returns something like C<Raku (6.c)>.
+The running version of Raku is kept by C<$*RAKU> special variable, that is an object.
+The running version is retrieved via C<$*RAKU.version>, which returns something
+like C<v6.d>; the full stringified version of the Raku interpreter is obtained
+via C<$*RAKU.gist>, which returns something like C<Raku (6.d)>.
 
 =head3 $SYSTEM_FD_MAX, $^F
 
@@ -264,7 +264,7 @@ seconds, with fractions.
 
 =head3 $PERL_VERSION, $^V
 
-As with C<$]> this has been replaced with C<$*PERL.version>.
+As with C<$]> this has been replaced with C<$*RAKU.version>.
 
 =head3 ${^WIN32_SLOPPY_STAT}
 

doc/Language/variables.pod6

@@ -1532,6 +1532,10 @@ It stringifies to C<Raku>:
 
     $*RAKU.put; # OUTPUT: «Raku␤»
 
+B<Note:> Before Rakudo version 2020.1, this information was only
+available through the C<$*PERL> variable. Since Rakudo version 2020.1,
+it is available through both the C<$*RAKU> and the C<$*PERL> variables.
+
 X<|$*PERL>
 =head4 C<$*PERL>
 

doc/Type/Compiler.pod6

@@ -8,9 +8,14 @@
 
 Built-in class for providing compiler related information.  Usually accessed
 through the C<compiler> attribute of the
-L«C<$*PERL>|/language/variables#Dynamic_variables» dynamic variable.
+L«C<$*RAKU>|/language/variables#Dynamic_variables» dynamic variable.
 
-    say $*PERL.compiler; # OUTPUT: «rakudo (2019.03.1.385.ga.643.b.8.be.1)␤»
+    say $*RAKU.compiler; # OUTPUT: «rakudo (2020.02.16.g.28.bd.4247.a)␤»
+
+B<Note>: Before Rakudo version 2020.1 this was only available through
+the C<compiler> attribute of the C<$*PERL> dynamic variable. Since
+Rakudo version 2020.1 this is available through both the C<$*RAKU>
+and the C<$*PERL> variables.
 
 =head1 Methods
 
@@ -31,7 +36,7 @@ It's empty, but it might contain the codename for specific releases.
 
     method build-date()
 
-Up to version 2019.03.1, it returns the date when it was built.
+Up to Rakudo version 2019.03.1, it returned the date when it was built.
 
     say $*PERL.compiler.build-date; #OUTPUT: «2018-05-05T21:49:43Z␤»
 
@@ -43,7 +48,7 @@ If C<$say> is C<True>, it prints the different items included in the
 configuration of the compiler; if it is not, returns a C<Hash> with the same
 information.
 
-    say $*PERL.compiler.verbose-config; # OUTPUT: «distro::auth=https://www.opensuse.org/␤distro::desc=2018-05-06T09:19:17.571307+02:00␤» ... And the rest of the configuration
+    say $*RAKU.compiler.verbose-config; # OUTPUT: «distro::auth=https://www.opensuse.org/␤distro::desc=2018-05-06T09:19:17.571307+02:00␤» ... And the rest of the configuration
 
 
 See Also: L<Systemic|/type/Systemic>

doc/Type/Systemic.pod6

@@ -8,7 +8,7 @@ Built-in class for providing built system related information.  Usually accessed
 through dynamic variables mixing this role such as the
 L«C<$*KERNEL>|/language/variables#Dynamic_variables»,
 L«C<$*VM>|/language/variables#Dynamic_variables», or
-L«C<$*PERL>|/language/variables#Dynamic_variables».
+L«C<$*RAKU>|/language/variables#Dynamic_variables».
 
 
 =head1 Methods
@@ -51,9 +51,9 @@ version could not be established.
 
 Instance method returning the name and version of the object.
 
-    say $*PERL.gist; # OUTPUT: «Raku (6.c)␤»
+    say $*RAKU.gist; # OUTPUT: «Raku (6.d)␤»
 
-C<$*PERL> is an object of the L<Perl|/type/Perl> type, which mixes in this role
+C<$*RAKU> is an object of the L<Raku|/type/Raku> type, which mixes in this role
 and thus implements this method.
 
 =head2 method Str
@@ -62,7 +62,7 @@ and thus implements this method.
 
 Instance method returning the name of the object.
 
-    say $*PERL.Str; # OUTPUT: «Raku␤»
+    say $*RAKU.Str; # OUTPUT: «Raku␤»
 
 =end pod
 

doc/Type/X/Syntax/Perl5Var.pod6

@@ -15,7 +15,7 @@ say $];
 dies with
 
 =for code :lang<text>
-Unsupported use of $] variable; in Raku please use $*PERL.version or $*PERL.compiler.version
+Unsupported use of $] variable; in Raku please use $*RAKU.version or $*RAKU.compiler.version
 
 For every unsupported variable (which include most C<$^'letter'> constructs,
 as well as others like C<$">, the error message will mention that the