Merge pull request #3298 from uzluisf/master

Perl 6 extensions -> Raku extensions

Author: JJ

doc/Language/modules.pod6

@@ -37,8 +37,8 @@ instance. Then,
 zef install WWW
 
 will install the module with that particular name, if it is not already
-installed. N<If it's installed, it will reinstall only if the version of
-the module is newer than the one installed>
+installed N<If it's installed, it will reinstall only if the version of
+the module is newer than the one installed>.
 
 
 =head2 Basic structure
@@ -52,9 +52,12 @@ L<synopsis S11|https://design.raku.org/S11.html#Units> says: Confusing? Yes it
 is.> , a C<t> directory for tests, and possibly a C<bin> directory for
 executable programs and scripts.
 
-Source files generally use the C<.pm6> extension, and scripts or
-executables use the C<.p6>. Test files use the C<.t> extension. Files which
-contain documentation use the C<.pod6> extension.
+Source files generally use the C<.rakumod> extension, and scripts or
+executables use the C<.raku>. Test files use the C<.rakutest> (or C<.t>)
+extension. Files which contain documentation use the C<.rakudoc> extension N«The
+old C<.p6> (or C<.pl6>), C<.pm6> (or C<.pm> which is also supported, but
+discouraged) and C<.pod6> extensions will continue to be supported for 6.e
+and marked as B<deprecated> in 6.f.».
 
 X<|compunit>
 =head1 Loading and basic importing
@@ -74,7 +77,7 @@ need MyModule;
 Any packages in the namespace defined within will also be available.
 
 =begin code :solo
-# MyModule.pm6
+# MyModule.rakumod
 unit module MyModule;
 
 class Class {}
@@ -86,7 +89,7 @@ defined that way are not automatically exported; you will need to explicitly
 export it if you want to use it by its short name:
 
 =begin code :solo
-# MyModule.pm6
+# MyModule.rakumod
 unit module MyModule;
 
 class Class is export {}
@@ -98,14 +101,13 @@ And then
 use MyModule;
 
 my $class = Class.new();
-say $class.perl;
+say $class.raku;
 =end code
 
 =head2 X<C<use>>
 
 C<use> loads and then imports from a compunit at compile time. It will look for
-files that end in C<.pm6> (C<.pm> is also supported, but discouraged). See
-L<here|/language/modules#Finding_installed_modules>
+files that end in C<.rakumod>. See L<here|/language/modules#Finding_installed_modules>
 for where the runtime will look for modules.
 
 =for code :skip-test<needs dummy module>
@@ -259,7 +261,7 @@ so that the importer can pick and choose. There are three predefined
 tags: C<ALL>, C<DEFAULT> and C<MANDATORY>.
 
     =begin code :solo
-    # lib/MyModule.pm6
+    # lib/MyModule.rakumod
     unit module MyModule;
     sub bag        is export             { ... }
     # objects with tag ':MANDATORY' are always exported
@@ -270,7 +272,7 @@ tags: C<ALL>, C<DEFAULT> and C<MANDATORY>.
     =end code
 
     =begin code :skip-test<needs dummy module>
-    # main.p6
+    # main.raku
     use lib 'lib';
     use MyModule;          # bag, pants
     use MyModule :DEFAULT; # the same
@@ -310,7 +312,7 @@ no matter whether the using program adds any tag or not.
 4. Multiple import tags may be used (separated by commas).  For example:
 
     =begin code :skip-test<needs dummy module>
-    # main.p6
+    # main.raku
     use lib 'lib';
     use MyModule :day, :night; # pants, sunglasses, torch
     =end code
@@ -356,7 +358,7 @@ packages are useful when you want to produce the exported symbols
 dynamically. For example:
 
     =begin code :solo
-    # lib/MyModule.pm6
+    # lib/MyModule.rakumod
     unit module MyModule;
 
     my package EXPORT::DEFAULT {
@@ -370,7 +372,7 @@ dynamically. For example:
     =end code
 
     =begin code :skip-test<needs dummy module>
-    # main.p6
+    # main.raku
     use MyModule;
     say sqrt-of-four; # OUTPUT: «2␤»
     say log-of-zero;  # OUTPUT: «-Inf␤»
@@ -385,7 +387,7 @@ the values are the desired values. The names should include the sigil
 (if any) for the associated type.
 
     =begin code
-    # lib/MyModule.pm6
+    # lib/MyModule.rakumod
 
     class MyModule::Class { }
 
@@ -401,7 +403,7 @@ the values are the desired values. The names should include the sigil
     =end code
 
     =begin code :skip-test<needs dummy module>
-    # main.p6
+    # main.raku
     use lib 'lib';
     use MyModule;
     say $var;          # OUTPUT: «one␤»
@@ -439,7 +441,7 @@ passing C<:DEFAULT> to C<use> along with your positional parameters.
     =end code
 
     =begin code :skip-test<needs dummy module>
-    # main.p6
+    # main.raku
     use lib 'lib';
     use MyModule 'foo';
     say foo.new(); # OUTPUT: «MyModule::Class.new␤»
@@ -453,7 +455,7 @@ effect. This example creates a C<?> postfix which will only work on
 L<Cool|/type/Cool>s.
 
     =begin code
-    # lib/MakeQuestionable.pm6
+    # lib/MakeQuestionable.rakumod
     sub EXPORT(::Questionable) {
         my multi postfix:<?>(Questionable $_) { .so };
         %(
@@ -509,11 +511,11 @@ zef --force install .
 X<|use lib>
 A user may have a collection of modules not found in the normal ecosystem,
 maintained by a module or package manager, but needed regularly.  Instead of
-using the C<use lib> pragma one can use the C<PERL6LIB> environment variable to
-point to module locations.  For example:
+using the C<use lib> pragma one can use the C<RAKULIB> environment variable to
+point to module locations. For example:
 
 =for code :lang<shell>
-export PERL6LIB=/path/to/my-modules,/path/to/more/modules
+export RAKULIB=/path/to/my-modules,/path/to/more/modules
 
 Note that the comma (',') is used as the directory separator.
 
@@ -558,7 +560,7 @@ Make your project directory look like this:
 Vortex-TotalPerspective/
 ├── lib
 │   └── Vortex
-│       └── TotalPerspective.pm6
+│       └── TotalPerspective.rakumod
 ├── LICENSE
 ├── META6.json
 ├── README.md
@@ -572,10 +574,10 @@ its job, they should go in your lib directory like so:
 =begin code :lang<text>
 lib
 └── Vortex
-    ├── TotalPerspective.pm6
+    ├── TotalPerspective.rakumod
     └── TotalPerspective
-        ├── FairyCake.pm6
-        └── Gargravarr.pm6
+        ├── FairyCake.rakumod
+        └── Gargravarr.rakumod
 =end code
 =end item
 
@@ -598,7 +600,7 @@ C<META6.json>) so that the distribution path can be provided to the program.
 {
     "name" : "Vortex::TotalPerspective",
     "provides" : {
-        "Vortex::TotalPerspective" : "lib/Vortex/TotalPerspective.pm6"
+        "Vortex::TotalPerspective" : "lib/Vortex/TotalPerspective.rakumod"
     },
     "resources": [ "templates/default-template.mustache"]
 }
@@ -684,7 +686,7 @@ Make your X<C<META6.json>|META6.json> file look something like this:
     "authors" : [ "R<Your Name>" ],
     "license" : "Artistic-2.0",
     "provides" : {
-        "Vortex::TotalPerspective" : "lib/Vortex/TotalPerspective.pm6"
+        "Vortex::TotalPerspective" : "lib/Vortex/TotalPerspective.rakumod"
     },
     "depends" : [ ],
     "build-depends" : [ ],