Update May 2021

Author: JJ

js/search.js

@@ -1,4 +1,4 @@
-//DO NOT EDIT generated by /home/jmerelo/Code/raku/my-raku-examples/site#sources/677E0B857640AD7C699D43EAFA5F9550AE91E0B5 (Documentable::DocPage::Factory):138
+//DO NOT EDIT generated by /home/jmerelo/Code/raku/raku-doc-generated/site#sources/677E0B857640AD7C699D43EAFA5F9550AE91E0B5 (Documentable::DocPage::Factory):138
 var current_search = "";
 
 $(function(){
@@ -927,7 +927,9 @@ $(function(){
 ,
 { category: "programs", value: "Debugging", url: "/programs/01-debugging" }
 ,
-{ category: "programs", value: "Running Rakudo", url: "/programs/03-environment-variables" }
+{ category: "programs", value: "Running Raku", url: "/programs/04-running-raku" }
+,
+{ category: "programs", value: "Environment variables used by the raku command line", url: "/programs/03-environment-variables" }
 ,
 { category: "programs", value: "Reading the docs", url: "/programs/02-reading-docs" }
 ,
@@ -6127,6 +6129,8 @@ $(function(){
 ,
 { category: "Reference", value: "Signal", url: "/type/Supply#index-entry-Signal" }
 ,
+{ category: "Reference", value: "sub_run", url: "/type/Proc#index-entry-sub__run-run" }
+,
 { category: "Reference", value: "* literal", url: "/type/Whatever#index-entry-*_literal" }
 ,
 { category: "Reference", value: "Whatever literal", url: "/type/Whatever#index-entry-Whatever_literal" }

language/about.html

@@ -80,7 +80,7 @@ <h1 class="title">About the docs</h1>
 <p>The official source for this documentation is located at <a href="https://github.com/Raku/doc">raku/doc on GitHub</a>.</p>
 <p>This particular document is a quick overview of the process described in more detail in <a href="https://github.com/Raku/doc/blob/master/CONTRIBUTING.md">CONTRIBUTING on GitHub</a>. This document also provides a short introduction to writing Raku Pod files, which can be rendered into HTML and other formats.</p>
 <h1 id="Structure"><a class="u" href="#___top" title="go to top of document">Structure</a></h1>
-<p>All of the documentation is written in Raku Pod and kept in the <code>doc/</code> directory, and the <code>doc/Language/</code> and <code>doc/Type/</code> sub-directories. These files are processed as collections of definitions or &quot;documentables&quot;, which are then post-processed and linked together.</p>
+<p>All of the documentation is written in Raku Pod and kept in the <code>doc/</code> directory, and the <code>doc/Language/</code> and <code>doc/Type/</code> subdirectories. These files are processed as collections of definitions or &quot;documentables&quot;, which are then post-processed and linked together.</p>
 <h1 id="Generating_HTML_from_Pod"><a class="u" href="#___top" title="go to top of document">Generating HTML from Pod</a></h1>
 <p>To generate HTML from the Pod files, you&#39;ll need:</p>
 <ul><li><p>A recent version of the Rakudo Raku compiler</p>

language/independent-routines.html

@@ -105,7 +105,7 @@ <h1 id="Types_with_native_representation_and_size"><a class="u" href="#___top" t
 </tbody>
 </table><p>These types have a fixed size representation which is independent of the platform, and thus can be used safely for those native calls. Nothing prevents us from using them in any other environment, if we so wish. In the same way as the types above, this size will have to be taken into account when assigning values to variables of this type:</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="routine name raku"><span>byte</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>intillo</span></span></span><span>&nbsp;</span><span class="storage modifier assignment raku"><span>=</span></span><span>&nbsp;</span><span class="constant numeric raku"><span>257</span></span><span>;</span></span></div><div class="line"><span class="source raku"><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>intillo</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></span></div></pre><p>Since <code>byte</code> is able to hold only 8 bits, it will <em>wrap over</em> and assign the result of the original value modulo 256, which is what is shown.</p>
-<p>The main difference between types with declared native size and those without is the use of <a name="index-entry-is_nativesize"><span class="index-entry">is nativesize</span></a> in their declaration. For instance, <code>int8</code> is declared in this way:</p>
+<p>The main difference between types with declared native size and those without is the use of <a name="index-entry-is_nativesize"><span class="index-entry"><code>is nativesize</code></span></a> in their declaration. For instance, <code>int8</code> is declared in this way:</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="routine name raku"><span>native</span></span><span>&nbsp;</span><span class="support type raku"><span>int8</span></span><span>&nbsp;</span><span class="storage modifier type constraints raku"><span>is</span></span><span>&nbsp;</span><span class="routine name raku"><span>repr</span></span><span>(</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>P6int</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>)&nbsp;</span><span class="storage modifier type constraints raku"><span>is</span></span><span>&nbsp;</span><span class="support type raku"><span>Int</span></span><span>&nbsp;</span><span class="storage modifier type constraints raku"><span>is</span></span><span>&nbsp;</span><span class="routine name raku"><span>nativesize</span></span><span>(</span><span class="constant numeric raku"><span>8</span></span><span>)&nbsp;</span><span class="meta block raku"><span class="punctuation definition block raku"><span>{</span></span><span>&nbsp;</span><span class="punctuation definition block raku"><span>}</span></span></span></span></div></pre><p>Indicating that it will use, besides an integer representation (<code>P6int</code>), a native size of only 8 bits. This trait, however, is not intended to be used in your programs since it is not part of the Raku specification.</p>
 <p><a name="index-entry-void_type_(NativeCall)"></a></p>
 <h1 id="The_void_type"><a class="u" href="#___top" title="go to top of document">The <code>void</code> type</a></h1>

language/nativetypes.html

@@ -682,7 +682,7 @@ <h2 id="infix_cmp"><a class="u" href="#___top" title="go to top of document">inf
 <h2 id="infix_unicmp"><a class="u" href="#___top" title="go to top of document">infix <code>unicmp</code></a></h2>
 <p>Defined as:</p>
 <pre class="editor editor-colors"><div class="line"><span class="source raku"><span class="storage type declarator multi raku"><span>multi</span></span><span>&nbsp;</span><span class="storage type declarator type raku"><span>sub</span></span><span>&nbsp;</span><span class="entity name function raku"><span>infix</span></span><span class="punctuation definition function adverb raku"><span>:</span></span><span class="span keyword operator array words raku"><span>&lt;</span></span><span class="string array words raku"><span>unicmp</span></span><span class="span keyword operator array words raku"><span>&gt;</span></span><span>(</span><span class="support type raku"><span>Str</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>&nbsp;\</span><span class="routine name raku"><span>a</span></span><span>,&nbsp;</span><span class="support type raku"><span>Str</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>&nbsp;\</span><span class="routine name raku"><span>b</span></span><span>&nbsp;</span><span class="keyword operator multi-symbol raku"><span>--&gt;</span></span><span>&nbsp;</span><span class="support type raku"><span>Order</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>)</span></span></div><div class="line"><span class="source raku"><span class="storage type declarator multi raku"><span>multi</span></span><span>&nbsp;</span><span class="storage type declarator type raku"><span>sub</span></span><span>&nbsp;</span><span class="entity name function raku"><span>infix</span></span><span class="punctuation definition function adverb raku"><span>:</span></span><span class="span keyword operator array words raku"><span>&lt;</span></span><span class="string array words raku"><span>unicmp</span></span><span class="span keyword operator array words raku"><span>&gt;</span></span><span>(</span><span class="support type raku"><span>Pair</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>&nbsp;\</span><span class="routine name raku"><span>a</span></span><span>,&nbsp;</span><span class="support type raku"><span>Pair</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>&nbsp;\</span><span class="routine name raku"><span>b</span></span><span>&nbsp;</span><span class="keyword operator multi-symbol raku"><span>--&gt;</span></span><span>&nbsp;</span><span class="support type raku"><span>Order</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>)</span></span></div><div class="line"><span class="source raku"><span class="storage type declarator multi raku"><span>multi</span></span><span>&nbsp;</span><span class="storage type declarator type raku"><span>sub</span></span><span>&nbsp;</span><span class="entity name function raku"><span>infix</span></span><span class="punctuation definition function adverb raku"><span>:</span></span><span class="span keyword operator array words raku"><span>&lt;</span></span><span class="string array words raku"><span>coll</span></span><span class="span keyword operator array words raku"><span>&gt;</span></span><span>(</span><span class="support type raku"><span>Pair</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>&nbsp;\</span><span class="routine name raku"><span>a</span></span><span>,&nbsp;</span><span class="support type raku"><span>Pair</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>&nbsp;\</span><span class="routine name raku"><span>b</span></span><span>&nbsp;</span><span class="keyword operator multi-symbol raku"><span>--&gt;</span></span><span>&nbsp;</span><span class="support type raku"><span>Order</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>)</span></span></div></pre><p>Unlike the cmp operator which sorts according to codepoint, <code>unicmp</code> and <code>coll</code> sort according to how most users would expect, that is, disregarding aspects of the particular character like capitalization.</p>
-<pre class="editor editor-colors"><div class="line"><span class="source raku"><span class="support function raku"><span>say</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>a</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>&nbsp;</span><span class="routine name raku"><span>unicmp</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>Z</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>;&nbsp;</span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;Less</span><span>&nbsp;</span></span></span></div><div class="line"><span class="source raku"><span class="support function raku"><span>say</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>a</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>&nbsp;</span><span class="routine name raku"><span>coll</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>Z</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>;&nbsp;&nbsp;&nbsp;</span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;Less</span><span>&nbsp;</span></span></span></div><div class="line"><span class="source raku"><span class="support function raku"><span>say</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>a</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>&nbsp;</span><span class="keyword operator word raku"><span>cmp</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>Z</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;More</span></span></span></div></pre><p>The main difference between <code>coll</code> and <code>unicmp</code> is that the behavior of the former can be changed by the <a href="/type/Any#index-entry-%24*COLLATION"><code>$*COLLATION</code></a> dynamic variable.</p>
+<pre class="editor editor-colors"><div class="line"><span class="source raku"><span class="support function raku"><span>say</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>a</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>&nbsp;</span><span class="routine name raku"><span>unicmp</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>Z</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>;&nbsp;</span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;Less</span><span>&nbsp;</span></span></span></div><div class="line"><span class="source raku"><span class="support function raku"><span>say</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>a</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>&nbsp;</span><span class="routine name raku"><span>coll</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>Z</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>;&nbsp;&nbsp;&nbsp;</span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;Less</span><span>&nbsp;</span></span></span></div><div class="line"><span class="source raku"><span class="support function raku"><span>say</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>a</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>&nbsp;</span><span class="keyword operator word raku"><span>cmp</span></span><span>&nbsp;</span><span class="string quoted single single raku"><span class="punctuation definition string begin raku"><span>&#39;</span></span><span>Z</span><span class="punctuation definition string end raku"><span>&#39;</span></span></span><span>;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="comment line number-sign raku"><span class="punctuation definition comment raku"><span>#</span></span><span>&nbsp;More</span></span></span></div></pre><p>The main difference between <code>coll</code> and <code>unicmp</code> is that the behavior of the former can be changed by the <a href="/type/variables#index-entry-%24*COLLATION"><code>$*COLLATION</code></a> dynamic variable.</p>
 <p><strong>NOTE:</strong> These are not yet implemented in the JVM.</p>
 <h2 id="infix_leg"><a class="u" href="#___top" title="go to top of document">infix <code>leg</code></a></h2>
 <pre class="editor editor-colors"><div class="line"><span class="source raku"><span class="storage type declarator multi raku"><span>multi</span></span><span>&nbsp;</span><span class="storage type declarator type raku"><span>sub</span></span><span>&nbsp;</span><span class="entity name function raku"><span>infix</span></span><span class="punctuation definition function adverb raku"><span>:</span></span><span class="span keyword operator array words raku"><span>&lt;</span></span><span class="string array words raku"><span>leg</span></span><span class="span keyword operator array words raku"><span>&gt;</span></span><span>(</span><span class="support type raku"><span>Any</span></span><span>,&nbsp;&nbsp;&nbsp;</span><span class="support type raku"><span>Any</span></span><span>)</span></span></div><div class="line"><span class="source raku"><span class="storage type declarator multi raku"><span>multi</span></span><span>&nbsp;</span><span class="storage type declarator type raku"><span>sub</span></span><span>&nbsp;</span><span class="entity name function raku"><span>infix</span></span><span class="punctuation definition function adverb raku"><span>:</span></span><span class="span keyword operator array words raku"><span>&lt;</span></span><span class="string array words raku"><span>leg</span></span><span class="span keyword operator array words raku"><span>&gt;</span></span><span>(</span><span class="support type raku"><span>Str</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>,&nbsp;</span><span class="support type raku"><span>Str</span></span><span class="meta adverb definedness raku"><span class="keyword operator adverb raku"><span>:</span></span><span class="keyword other special-method definedness raku"><span>D</span></span></span><span>)</span></span></div></pre><p><a name="index-entry-String_three-way_comparator"><span class="index-entry">String three-way comparator</span></a>. Short for <em>less, equal or greater?</em>.</p>