Merge pull request #2289 from MorayJ/phasers

Phasers

Author: MorayJ

doc/Language/phasers.pod6

@@ -24,10 +24,11 @@ C<Failure> or exception in the process.
 Here is a summary:
 
 =begin code :skip-test
-  BEGIN {...} #  * at compile time, ASAP, only ever runs once
-  CHECK {...} #  * at compile time, ALAP, only ever runs once
-   INIT {...} #  * at runtime, ASAP, only ever runs once
-    END {...} #  at runtime, ALAP, only ever runs once
+  BEGIN {...} #  * at compile time, as soon as possible, only ever runs once
+  CHECK {...} #  * at compile time, as late as possible, only ever runs once
+   INIT {...} #  * at runtime, as soon as possible, only ever runs once
+    END {...} #  at runtime, as late as possible, only ever runs once
+    DOC [BEGIN|CHECK|INIT] {...} # only in documentation mode
 
   ENTER {...} #  * at every block entry time, repeats on loop blocks.
   LEAVE {...} #  at every block exit time (even stack unwinds from exceptions)
@@ -47,7 +48,7 @@ CONTROL {...} #  catch control exceptions, before LEAVE
    LAST {...} #  supply tapped by whenever-block is done, runs very last
    QUIT {...} #  catch async exceptions within a whenever-block, runs very last
 
-COMPOSE {...} #  when a role is composed into a class (NYI)
+COMPOSE {...} #  when a role is composed into a class (Not yet implemented)
   CLOSE {...} #  appears in a supply block, called when the supply is closed
 =end code
 
@@ -127,14 +128,14 @@ teardown usually want to happen in the opposite order from each other.
 Compilation begins
 
 =for code :skip-test
-      BEGIN {...} #  at compile time, ASAP, only ever runs once
-      CHECK {...} #  at compile time, ALAP, only ever runs once
-    COMPOSE {...} #  when a role is composed into a class (NYI)
+      BEGIN {...} #  at compile time, As soon as possible, only ever runs once
+      CHECK {...} #  at compile time, As late as possible, only ever runs once
+    COMPOSE {...} #  when a role is composed into a class (Not yet implemented)
 
 Execution begins
 
 =for code :skip-test
-       INIT {...} #  at runtime, ASAP, only ever runs once
+       INIT {...} #  at runtime, as soon as possible, only ever runs once
 
 Before block execution begins
 
@@ -415,16 +416,12 @@ C<warn>, C<proceed> and C<succeed>.
     # Don't take my stuff
     # 0
 
-=begin comment
 
-# NYI
-# =head1 Object phasers
-#
-# =head2 X<COMPOSE|Phasers, COMPOSE>
-#
-# Runs when a role is composed into a class.
+=head1 Object phasers
 
-=end comment
+=head2 X<COMPOSE|Phasers, COMPOSE> (Not yet implemented)
+
+Runs when a role is composed into a class.
 
 =head1 Asynchronous phasers