Updates to March 22th

Author: JJ

js/search.js

@@ -1,4 +1,4 @@
-//DO NOT EDIT generated by /home/jmerelo/Code/raku/raku-doc-generated/site#sources/677E0B857640AD7C699D43EAFA5F9550AE91E0B5 (Documentable::DocPage::Factory):138
+//DO NOT EDIT generated by /home/jmerelo/Code/raku/my-raku-examples/site#sources/677E0B857640AD7C699D43EAFA5F9550AE91E0B5 (Documentable::DocPage::Factory):138
 var current_search = "";
 
 $(function(){

language/modules-core.html

@@ -69,12 +69,12 @@ <h1 class="title">Core modules</h1>
    <tr class="toc-level-2"><td class="toc-number">0.1</td><td class="toc-text"><a href="#CompUnit::*_modules_and_roles"><code class="pod-code-inline">CompUnit::*</code> modules and roles </a></td></tr>
       <tr class="toc-level-2"><td class="toc-number">0.2</td><td class="toc-text"><a href="#NativeCall_modules"><code class="pod-code-inline">NativeCall</code> modules</a></td></tr>
               <tr class="toc-level-2"><td class="toc-number">0.3</td><td class="toc-text"><a href="#Other_modules">Other modules</a></td></tr>
-        
+           
 </table>
 </nav>
 
         <div class="pod-body ">
-            <p>The Rakudo implementation has a few modules included you may want to use. The following is a list of them, along with links to their source code.</p>
+            <p>The Rakudo implementation has a few modules included you may want to use; please note that the implementation is not part of the Raku specification and thus might be subject to change without prior notice. The following is a list of them, along with links to their source code.</p>
 <h2 id="CompUnit::*_modules_and_roles"><a class="u" href="#___top" title="go to top of document"><code>CompUnit::*</code> modules and roles <a name="index-entry-CompUnit_(Rakudo_classes)"></a></a></h2>
 <p>These modules are mostly used by distribution build tools, and are not intended to be used (at least until version 6.c) by the final user.</p>
 <ul><li><p><a href="https://github.com/rakudo/rakudo/blob/master/lib/CompUnit/Repository/Staging.rakumod"><code>CompUnit::Repository::Staging</code></a>.</p>
@@ -95,9 +95,10 @@ <h2 id="NativeCall_modules"><a class="u" href="#___top" title="go to top of docu
 <h2 id="Other_modules"><a class="u" href="#___top" title="go to top of document">Other modules</a></h2>
 <ul><li><p><a href="https://github.com/rakudo/rakudo/blob/master/lib/Pod/To/Text.rakumod"><code>Pod::To::Text</code></a> Used by several external modules</p>
 </li>
-<li><p><a href="https://github.com/rakudo/rakudo/blob/master/lib/Test.rakumod"><code>Test</code></a> Test routines (<a href="/language/testing">docs</a>)</p>
+<li><p><a href="/type/Test"><code>Test</code></a> Test routines (see <a href="/language/testing">tutorial</a>)</p>
 </li>
-<li><p><a href="https://github.com/rakudo/rakudo/blob/master/lib/experimental.rakumod"><code>experimental</code></a></p>
+<li><p><a href="https://github
+.com/rakudo/rakudo/blob/master/lib/experimental.rakumod"><code>experimental</code></a> (<a href="/language/pragmas#index-entry-experimental__pragma">documentation</a>)</p>
 </li>
 <li><p><a href="https://github.com/rakudo/rakudo/blob/master/lib/newline.rakumod"><code>newline</code></a></p>
 </li>

language/subscripts.html

@@ -85,7 +85,7 @@ <h1 id="class_Lock::Async"><a class="u" href="#___top" title="go to top of docum
 <p>From <a href="/type/Lock::Async#method_with-lock-hidden-from-recursion-check">Lock::Async</a></p>
 <h2 id="(Lock::Async)_method_with-lock-hidden-from-recursion-check"><a href="/type/Lock::Async#method_with-lock-hidden-from-recursion-check">(Lock::Async) method with-lock-hidden-from-recursion-check</a></h2>
 <p>Defined as:</p>
-<pre class="editor editor-colors"><div class="line"><span class="source raku"><span class="storage type declarator type raku"><span>method</span></span><span>&nbsp;</span><span class="entity name function raku"><span>with-lock-hidden-from-recursion-check</span></span><span>(</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>&amp;</span></span><span class="variable other identifier raku"><span>code</span></span></span><span>)</span></span></div></pre><p>Temporarily resets the Lock::Async recursion list so that it no longer includes the lock this method is called on and runs the given <code>&amp;code</code> immediately if the call to the method occurred in a caller chain where <a href="/type/Lock::Async/#method_protect-or-queue-on-recursion">protect-or-queue-on-recursion</a> has already been called and the lock has been placed on the recursion list.</p>
+<pre class="editor editor-colors"><div class="line"><span class="source raku"><span class="storage type declarator type raku"><span>method</span></span><span>&nbsp;</span><span class="entity name function raku"><span>with-lock-hidden-from-recursion-check</span></span><span>(</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>&amp;</span></span><span class="variable other identifier raku"><span>code</span></span></span><span>)</span></span></div></pre><p>Temporarily resets the Lock::Async recursion list so that it no longer includes the lock this method is called on and runs the given <code>&amp;code</code> immediately if the call to the method occurred in a caller chain where <a href="/type/Lock::Async#method_protect-or-queue-on-recursion">protect-or-queue-on-recursion</a> has already been called and the lock has been placed on the recursion list.</p>
 <pre class="editor editor-colors"><div class="line"><span class="source raku"><span class="storage modifier declarator raku"><span>my</span></span><span>&nbsp;</span><span class="support type raku"><span>Lock</span></span><span>::</span><span class="routine name raku"><span>Async</span></span><span>&nbsp;</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>$</span></span><span class="variable other identifier raku"><span>lock</span></span></span><span>&nbsp;</span><span class="storage modifier assignment raku"><span>.=</span></span><span>&nbsp;</span><span class="support function raku"><span>new</span></span><span>;</span></span></div><div class="line"><span class="source raku"><span class="storage modifier declarator raku"><span>my</span></span><span>&nbsp;</span><span class="support type raku"><span>Int</span></span><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>$</span></span><span class="variable other identifier raku"><span>count</span></span></span><span>&nbsp;</span><span class="storage modifier assignment raku"><span>=</span></span><span>&nbsp;</span><span class="constant numeric raku"><span>0</span></span><span>;</span></span></div><div class="line"><span class="source raku"><span>&nbsp;</span></span></div><div class="line"><span class="source raku"><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>$</span></span><span class="variable other identifier raku"><span>lock</span></span></span><span class="keyword operator generic raku"><span>.</span></span><span class="routine name raku"><span>protect-or-queue-on-recursion</span></span><span>(</span><span class="meta block raku"><span class="punctuation definition block raku"><span>{</span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="storage modifier declarator raku"><span>my</span></span><span>&nbsp;</span><span class="support type raku"><span>Int</span></span><span>&nbsp;</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>$</span></span><span class="variable other identifier raku"><span>count</span></span></span><span>&nbsp;</span><span class="storage modifier assignment raku"><span>=</span></span><span>&nbsp;</span><span class="constant numeric raku"><span>0</span></span><span>;</span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span>&nbsp;</span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span class="punctuation whitespace comment leading raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;</span></span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;Runs&nbsp;instantly.</span><span>&nbsp;</span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>$</span></span><span class="variable other identifier raku"><span>lock</span></span></span><span class="keyword operator generic raku"><span>.</span></span><span class="routine name raku"><span>with-lock-hidden-from-recursion-check</span></span><span>(</span><span class="meta block raku"><span class="punctuation definition block raku"><span>{</span></span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span class="meta block raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>$</span></span><span class="variable other identifier raku"><span>count</span></span></span><span class="keyword operator multi-symbol raku"><span>++</span></span><span>;</span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span class="meta block raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="punctuation definition block raku"><span>}</span></span></span><span>);</span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span>&nbsp;</span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span class="punctuation whitespace comment leading raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;</span></span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;Runs&nbsp;after&nbsp;the&nbsp;outer&nbsp;caller&#39;s&nbsp;protect-or-queue-on-recursion&nbsp;call&nbsp;has</span><span>&nbsp;</span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span class="punctuation whitespace comment leading raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;</span></span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;finished&nbsp;running.</span><span>&nbsp;</span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>$</span></span><span class="variable other identifier raku"><span>lock</span></span></span><span class="keyword operator generic raku"><span>.</span></span><span class="routine name raku"><span>protect-or-queue-on-recursion</span></span><span>(</span><span class="meta block raku"><span class="punctuation definition block raku"><span>{</span></span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span class="meta block raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>$</span></span><span class="variable other identifier raku"><span>count</span></span></span><span class="keyword operator multi-symbol raku"><span>++</span></span><span>;</span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span class="meta block raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="punctuation definition block raku"><span>}</span></span></span><span>)</span><span class="keyword operator generic raku"><span>.</span></span><span class="routine name raku"><span>then</span></span><span>(</span><span class="meta block raku"><span class="punctuation definition block raku"><span>{</span></span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span class="meta block raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="support function raku"><span>say</span></span><span>&nbsp;</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>$</span></span><span class="variable other identifier raku"><span>count</span></span></span><span>;&nbsp;</span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;OUTPUT:&nbsp;2</span><span>&nbsp;</span></span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span class="meta block raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="punctuation definition block raku"><span>}</span></span></span><span>);</span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span>&nbsp;</span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span>&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="support function raku"><span>say</span></span><span>&nbsp;</span><span class="meta variable container raku"><span class="variable other identifier sigil raku"><span>$</span></span><span class="variable other identifier raku"><span>count</span></span></span><span>;&nbsp;</span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;OUTPUT:&nbsp;1</span><span>&nbsp;</span></span></span></span></div><div class="line"><span class="source raku"><span class="meta block raku"><span class="punctuation definition block raku"><span>}</span></span></span><span>);</span></span></div></pre>
         </div>
     </div>

routine/STORE.html

@@ -71,7 +71,7 @@ <h1 class="title">class Lock</h1>
         <nav class="indexgroup">
 <table id="TOC">
 <caption><h2 id="TOC_Title">Table of Contents</h2></caption>
-                                                           <tr class="toc-level-1"><td class="toc-number">1</td><td class="toc-text"><a href="#Methods">Methods</a></td></tr>
+                                                                 <tr class="toc-level-1"><td class="toc-number">1</td><td class="toc-text"><a href="#Methods">Methods</a></td></tr>
  <tr class="toc-level-2"><td class="toc-number">1.1</td><td class="toc-text"><a href="#method_protect">method protect</a></td></tr>
                       <tr class="toc-level-2"><td class="toc-number">1.2</td><td class="toc-text"><a href="#method_lock">method lock</a></td></tr>
                        <tr class="toc-level-2"><td class="toc-number">1.3</td><td class="toc-text"><a href="#method_unlock">method unlock</a></td></tr>
@@ -89,7 +89,7 @@ <h1 class="title">class Lock</h1>
 <p>It&#39;s important to understand that there is no direct connection between a <code>Lock</code> and any particular piece of data; it is up to the programmer to ensure that the <code>Lock</code> is held during all operations that involve the data in question. The <code>OO::Monitors</code> module, while not a complete solution to this problem, does provide a way to avoid dealing with the lock explicitly and encourage a more structured approach.</p>
 <p>The <code>Lock</code> class is backed by operating-system provided constructs, and so a thread that is waiting to acquire a lock is, from the point of view of the operating system, blocked.</p>
 <p>Code using high-level Raku concurrency constructs should avoid using <code>Lock</code>. Waiting to acquire a <code>Lock</code> blocks a real <code>Thread</code>, meaning that the thread pool (used by numerous higher-level Raku concurrency mechanisms) cannot use that thread in the meantime for anything else.</p>
-<p>Any <code>await</code> performed while a <code>Lock</code> is held will behave in a blocking manner; the standard non-blocking behavior of <code>await</code> relies on the code following the `await` resuming on a different <code>Thread</code> from the pool, which is incompatible with the requirement that a <code>Lock</code> be unlocked by the same thread that locked it. See <a href="/type/Lock::Async">Lock::Async</a> for an alternative mechanism that does not have this shortcoming.</p>
+<p>Any <code>await</code> performed while a <code>Lock</code> is held will behave in a blocking manner; the standard non-blocking behavior of <code>await</code> relies on the code following the `await` resuming on a different <code>Thread</code> from the pool, which is incompatible with the requirement that a <code>Lock</code> be unlocked by the same thread that locked it. See <a href="/type/Lock::Async">Lock::Async</a> for an alternative mechanism that does not have this shortcoming. Other than that, the main difference is that <code>Lock</code> mainly maps to operating system mechanisms, while <code>Lock::Async</code> uses Raku primitives to achieve similar effects. If you&#39;re doing low-level stuff (native bindings) and/or actually want to block real OS threads, use <code>Lock</code>. However, if you want a non-blocking mutual exclusion and don&#39;t need recursion and are running code on the Raku thread pool, use Lock::Async.</p>
 <p>By their nature, <code>Lock</code>s are not composable, and it is possible to end up with hangs should circular dependencies on locks occur. Prefer to structure concurrent programs such that they communicate results rather than modify shared data structures, using mechanisms like <a href="/type/Promise">Promise</a>, <a href="/type/Channel">Channel</a> and <a href="/type/Supply">Supply</a>.</p>
 <h1 id="Methods"><a class="u" href="#___top" title="go to top of document">Methods</a></h1>
 <h2 id="method_protect"><a class="u" href="#___top" title="go to top of document">method protect</a></h2>