Merge pull request #758 from perl6/molecules-patch-2

This is better (note on $*SCHEDULER and threads)

Author: AlexDaniel

doc/Language/variables.pod6

@@ -1175,14 +1175,19 @@ X<|$*SPEC>X<|$*TMPDIR>X<|$*THREAD>X<|$*SCHEDULER>
     $*THREAD          | A L<Thread> object representing the currently executing thread.
     ------------------+--------------------------------------------
     $*SCHEDULER       | A L<ThreadPoolScheduler> object representing the current default
-                      | scheduler.
-                      | Note on usage: For the current Rakudo, by default this imposes a
-                      | maximum of 16 threads on the methods C<.hyper> and C<.race>. To change
-                      | the maximum number of threads, either set the environment variable
-                      | RAKUDO_MAX_THREADS before running perl6 or create a scoped copy
-                      | with the default changed before using C<.hyper> or C<.race>:
-                      | my $*SCHEDULER = ThreadPoolScheduler.new( max_threads => 64 );
-                      | This behavior is not tested in the spec tests and is subject to change.
+                      | scheduler. (see note below)
     ------------------+--------------------------------------------
 =end table
+
+Note on usage of $*SCHEDULER:
+
+For the current Rakudo, by default this imposes a maximum of 16 threads on the methods
+C<.hyper> and C<.race>. To change the maximum number of threads, either set the 
+environment variable RAKUDO_MAX_THREADS before running perl6 or create a scoped copy
+with the default changed before using C<.hyper> or C<.race>:
+
+    my $*SCHEDULER = ThreadPoolScheduler.new( max_threads => 64 );
+
+This behavior is not tested in the spec tests and is subject to change.
+
 =end pod