diff --git a/_config.yml b/_config.yml
index dba4f2daf..f93f5becd 100644
--- a/_config.yml
+++ b/_config.yml
@@ -1,6 +1,6 @@
 theme: jekyll-theme-cayman
 title: Clink
 github:
-  version: v1.6.0
-  download_url: https://github.com/chrisant996/clink/releases/download/v1.6.0/clink.1.6.0.3e6b73.zip
-  install_url:  https://github.com/chrisant996/clink/releases/download/v1.6.0/clink.1.6.0.3e6b73_setup.exe
+  version: v1.6.1
+  download_url: https://github.com/chrisant996/clink/releases/download/v1.6.1/clink.1.6.1.c7c448.zip
+  install_url:  https://github.com/chrisant996/clink/releases/download/v1.6.1/clink.1.6.1.c7c448_setup.exe
diff --git a/clink.html b/clink.html
index 613643db8..df911e5d3 100644
--- a/clink.html
+++ b/clink.html
@@ -3,7 +3,7 @@
 
 <!-- ----------------------------------------------------- -->
 <head>
-<title>Clink v1.6.0</title>
+<title>Clink v1.6.1</title>
 <style>
 @import url('https://fonts.googleapis.com/css2?family=Rambla:wght@400;700&family=Roboto&family=Fira+Mono&display=swap');
 html {
@@ -57,6 +57,20 @@
     text-decoration: none;
 }
 
+.uplinks {
+    opacity: 0%;
+    font-size: 0.80rem;
+    font-weight: normal;
+    -webkit-user-select: none;
+    user-select: none;
+    margin-left: 0.15rem;
+    margin-right: 0.15rem;
+}
+
+.uplinks a {
+    margin-right: 0.15rem;
+}
+
 .wfix {
     visibility: hidden;
     display: inline-block;
@@ -66,10 +80,14 @@
 }
 
 h1:hover .wlink, h2:hover .wlink, h3:hover .wlink, h4:hover .wlink, h5:hover .wlink, h6:hover .wlink, td:hover .wlink { opacity: 100%; }
-h1:focus .wlink, h2:focus .wlink, h3:focus .wlink, h4:focus .wlink, h5:focus .wlink, h6:focus .wlink, td:focus .wlink { opacity: 100%; }
+h1:focus-within .wlink, h2:focus-within .wlink, h3:focus-within .wlink, h4:focus-within .wlink, h5:focus-within .wlink, h6:focus-within .wlink, td:focus-within .wlink { opacity: 100%; }
+h1:hover .uplinks, h2:hover .uplinks, h3:hover .uplinks, h4:hover .uplinks, h5:hover .uplinks, h6:hover .uplinks { opacity: 100%; }
+h1:focus-within .uplinks, h2:focus-within .uplinks, h3:focus-within .uplinks, h4:focus-within .uplinks, h5:focus-within .uplinks, h6:focus-within .uplinks { opacity: 100%; }
 
 .wlink:hover { opacity: 100%; text-decoration: underline; }
-.wlink:focus { opacity: 100%; text-decoration: underline; }
+.wlink:focus-within { opacity: 100%; text-decoration: underline; }
+.uplinks:hover { opacity: 100% }
+.uplinks:focus-within { opacity: 100% }
 
 h1, h2, h3, h4, h5, h6, dt { font-family: Rambla,Roboto,Calibri,Arial,Helvetica,sans-serif }
 
@@ -286,15 +304,15 @@
     background-color: #fff;
 }
 
-#content table:not(.linkmenu,.console) td {
+#content table:not(.linkmenu,.console,.grouplist) td {
     border: 1px solid #ddd;
 }
 
-#content table:not(.linkmenu,.console) tr:nth-child(odd) {
+#content table:not(.linkmenu,.console,.grouplist) tr:nth-child(odd) {
     background-color: #fbfbfb;
 }
 
-#content table:not(.linkmenu,.console) tr:nth-child(even) {
+#content table:not(.linkmenu,.console,.grouplist) tr:nth-child(even) {
     background-color: #fff;
 }
 
@@ -343,24 +361,46 @@
     margin-bottom: 1rem;
 }
 
+#content #api .grouplist {
+    margin-left: 5rem;
+    margin-bottom: 2rem;
+}
+
+#content #api .grouplist td {
+    border: none;
+    border-spacing: 0px;
+    padding: 0px;
+    padding-right: 2rem;
+}
+
 #content #api .body {
     margin-left: 3rem;
     margin-top: -0.5rem;
 }
 
+#content #api .header {
+    display: flex;
+    justify-content: space-between;
+}
+
 #content #api .header .name {
     font-weight: bold;
-    float: left;
-    width: 40%;
     position: relative;
+    vertical-align: top;
+    padding-right: 1rem;
 }
 
-#content #api .header .name:hover .wlink {
+#content #api .header:hover .wlink {
+    opacity: 100%;
+}
+
+#content #api .header:hover .uplinks {
     opacity: 100%;
 }
 
 #content #api .header .signature {
     text-align: right;
+    vertical-align: top;
 }
 
 #content #api .group_name {
@@ -902,7 +942,7 @@
         </td>
         <td style="text-align:right">
             <div id="header">
-                <div id="title">Clink v1.6.0</div>
+                <div id="title">Clink v1.6.1</div>
                 <div id="url">
                     <a href="https://github.com/chrisant996/clink">
                         https://github.com/chrisant996/clink
@@ -919,10 +959,10 @@
     </tr></table>
     <div id="content">
         <div class="section" id="documentation">
-<h1 id="what-is-clink"><a class="wlink" href="#what-is-clink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>What is Clink?</h1>
+<h1 id="what-is-clink"><a class="wlink" href="#what-is-clink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>What is Clink? <span class="uplinks"><a href="#toc">top</a></span></h1>
 <p>Clink combines the native Windows shell cmd.exe with the powerful command line editing features of the GNU Readline library, which provides rich completion, history, and line-editing capabilities. Readline is best known for its use in the Unix shell Bash, the standard shell for Mac OS X and many Linux distributions.</p>
 <p><a name="features"></a></p>
-<h3 id="feature-highlights"><a class="wlink" href="#features"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Feature Highlights</h3>
+<h3 id="feature-highlights"><a class="wlink" href="#features"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Feature Highlights <span class="uplinks"><a href="#what-is-clink">up</a> <a href="#toc">top</a></span></h3>
 <div class="promo_box">
 <div class="promo_box">
 <div class="promo_block">
@@ -997,13 +1037,13 @@ <h3 id="feature-highlights"><a class="wlink" href="#features"><svg width=16 heig
 </div>
 </div>
 
-<h1 id="usage"><a class="wlink" href="#usage"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Usage</h1>
-<h3 id="installation"><a class="wlink" href="#installation"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Installation</h3>
+<h1 id="usage"><a class="wlink" href="#usage"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Usage <span class="uplinks"><a href="#toc">top</a></span></h1>
+<h3 id="installation"><a class="wlink" href="#installation"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Installation <span class="uplinks"><a href="#usage">up</a> <a href="#toc">top</a></span></h3>
 <p>You can install Clink by running the setup EXE file from the <a href="https://github.com/chrisant996/clink/releases">releases page</a>.</p>
 <p>Or by using <a href="https://learn.microsoft.com/en-us/windows/package-manager/winget/">winget</a> and running <code>winget install clink</code>.</p>
 <p>Or by using <a href="https://scoop.sh/">scoop</a> and running <code>scoop install clink</code>.</p>
 <p>Or by downloading the ZIP file from <a href="https://github.com/chrisant996/clink/releases">releases page</a>, and extracting the files to a directory of your choosing.</p>
-<h3 id="using-clink"><a class="wlink" href="#using-clink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Using Clink</h3>
+<h3 id="using-clink"><a class="wlink" href="#using-clink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Using Clink <span class="uplinks"><a href="#usage">up</a> <a href="#toc">top</a></span></h3>
 <p>Once installed, there are several ways to start Clink.</p>
 <ol>
 <li>If Clink is configured for autorun, just start <code>cmd.exe</code> and Clink is automatically injected and ready to use.</li>
@@ -1019,7 +1059,7 @@ <h3 id="using-clink"><a class="wlink" href="#using-clink"><svg width=16 height=1
 <p>If the Clink install directory isn&#39;t in the PATH, then use <code><span class="arg">install_dir</span>\clink</code> in place of <code>clink</code> to run Clink commands.  Once Clink is injected into a <code>cmd.exe</code> process, then it automatically sets an alias so that you can simply use <code>clink</code>.</p>
 </blockquote>
 <p>Starting Clink injects it into a <code>cmd.exe</code> process, where it intercepts a handful of Windows API functions so that it can replace the prompt and input line editing with its own Readline-powered enhancements.</p>
-<h1 id="getting-started"><a class="wlink" href="#getting-started"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Getting Started</h1>
+<h1 id="getting-started"><a class="wlink" href="#getting-started"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Getting Started <span class="uplinks"><a href="#toc">top</a></span></h1>
 <p>You can use Clink right away without configuring anything:</p>
 <ul>
 <li>Searchable <a href="#saved-command-history">command history</a> will be saved between sessions.</li>
@@ -1030,9 +1070,9 @@ <h1 id="getting-started"><a class="wlink" href="#getting-started"><svg width=16
 </ul>
 <p>There are three main ways of customizing Clink to your preferences:  the <a href="#init-file">Readline init file</a> (the <code>.inputrc</code> file), the <a href="#clink-settings">Clink settings</a> (the <code>clink set</code> command), and <a href="#extending-clink-with-lua">Lua</a> scripts.</p>
 <p><a name="how-completion-works"></a></p>
-<h2 id="how-completion-works"><a class="wlink" href="#how-completion-works"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>How Completion Works</h2>
-<p>&quot;Completion&quot; is for the word at the cursor; Clink can complete it for you when you press <kbd>Tab</kbd>.</p>
-<p>&quot;Suggestions&quot; are for the whole command line; Clink offers <a href="#gettingstarted_autosuggest">automatic suggestions</a> for the whole input line, which you can accept by pressing <kbd>Right</kbd> or <kbd>End</kbd>.</p>
+<h2 id="how-completion-works"><a class="wlink" href="#how-completion-works"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>How Completion Works <span class="uplinks"><a href="#getting-started">up</a> <a href="#toc">top</a></span></h2>
+<p>&quot;Completion&quot; is for the word at the cursor; when you press <kbd>Tab</kbd> Clink tries to complete the word from a list of possible completions.  Press <kbd>Alt</kbd>-<kbd>=</kbd> to see the list of possible completions.</p>
+<p>&quot;Suggestions&quot; are for the whole command line; Clink offers an <a href="#gettingstarted_autosuggest">automatic suggestion</a> for the whole input line, which you can accept by pressing <kbd>Right</kbd> or <kbd>End</kbd>.  There is never more than one automatic suggestion at a time.</p>
 <p>Some examples of what completions can offer:</p>
 <ul>
 <li>File names,</li>
@@ -1042,7 +1082,7 @@ <h2 id="how-completion-works"><a class="wlink" href="#how-completion-works"><svg
 <li>Command <a href="#argument-completion">arguments and flags</a>,</li>
 <li>You can provide custom completion generators using Lua scripts that execute inside Clink (see <a href="#extending-clink-with-lua">Extending Clink With Lua</a> and <a href="#popular-scripts">Popular Scripts</a>).</li>
 </ul>
-<h3 id="completion-keys"><a class="wlink" href="#completion-keys"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Completion Keys</h3>
+<h3 id="completion-keys"><a class="wlink" href="#completion-keys"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Completion Keys <span class="uplinks"><a href="#how-completion-works">up</a> <a href="#toc">top</a></span></h3>
 <p><kbd>Tab</kbd> completes the word at the cursor:</p>
 <ul>
 <li>If you installed Clink with &quot;Use enhanced defaults&quot; or if you set <a href="#clink_default_bindings"><code>clink.default_bindings</code></a> to use &quot;windows&quot; defaults, then <kbd>Tab</kbd> cycles through the possible completions, replacing the word with the next possible completion each time.</li>
@@ -1055,10 +1095,10 @@ <h3 id="completion-keys"><a class="wlink" href="#completion-keys"><svg width=16
 <li>Pressing <kbd>Space</kbd> in the list inserts the selected completion and makes sure a space follows it to allow typing a next argument.</li>
 </ul>
 <p>See <a href="#completion-commands">Completion Commands</a> and <a href="#clink-commands">Clink Commands</a> for more available completion commands.</p>
-<h3 id="executable-completion"><a class="wlink" href="#executable-completion"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Executable Completion</h3>
+<h3 id="executable-completion"><a class="wlink" href="#executable-completion"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Executable Completion <span class="uplinks"><a href="#how-completion-works">up</a> <a href="#toc">top</a></span></h3>
 <p>By default, Clink completes the first word of each command based on all executable programs on the system PATH and the current directory, but not non-executable files.</p>
 <p>You can turn off the &quot;executable completion&quot; behavior by running <code>clink set <a href="#exec_enable">exec.enable</a> false</code>, or you can adjust its behavior by changing the various <a href="#exec_aliases"><code>exec.*</code></a> settings.</p>
-<h2 id="common-configuration"><a class="wlink" href="#common-configuration"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Common Configuration</h2>
+<h2 id="common-configuration"><a class="wlink" href="#common-configuration"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Common Configuration <span class="uplinks"><a href="#getting-started">up</a> <a href="#toc">top</a></span></h2>
 <p>The following sections describe some ways to begin customizing Clink to your taste.</p>
 <table class="linkmenu">
 <tr><td><a href="#gettingstarted_enhanceddefaults">Enhanced default settings</a></td><td>Optionally use enhanced default settings.</td></tr>
@@ -1074,7 +1114,7 @@ <h2 id="common-configuration"><a class="wlink" href="#common-configuration"><svg
 </table>
 
 <p><a name="gettingstarted_enhanceddefaults"></a></p>
-<h3 id="enhanced-default-settings"><a class="wlink" href="#gettingstarted_enhanceddefaults"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Enhanced default settings</h3>
+<h3 id="enhanced-default-settings"><a class="wlink" href="#gettingstarted_enhanceddefaults"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Enhanced default settings <span class="uplinks"><a href="#common-configuration">up</a> <a href="#toc">top</a></span></h3>
 <p>Clink can be installed with plain defaults, or it can be installed with enhanced default settings that enable more of Clink&#39;s enhancements by default.</p>
 <p>If you install Clink with the setup program and &quot;Use enhanced default settings&quot; is checked, then the enhanced defaults are activated, and then in some places where this documentation refers to default settings the stated default may have been overridden.</p>
 <p>If you install Clink from the .zip file then enhanced default settings are activated when the <code>default_settings</code> and <code>default_inputrc</code> files are present in the binaries directory or in the profile directory.  The .zip file comes with the files, but their names have a <code>_</code> prefix so that enhanced defaults won&#39;t automatically take effect.  You can activate the enhanced default settings by renaming the files to remove the <code>_</code> prefix.</p>
@@ -1089,7 +1129,7 @@ <h3 id="enhanced-default-settings"><a class="wlink" href="#gettingstarted_enhanc
 <li>History saves and shows time stamps.</li>
 </ul>
 <p><a name="gettingstarted_inputrc"></a></p>
-<h3 id="create-a-inputrc-file"><a class="wlink" href="#gettingstarted_inputrc"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Create a .inputrc file</h3>
+<h3 id="create-a-inputrc-file"><a class="wlink" href="#gettingstarted_inputrc"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Create a .inputrc file <span class="uplinks"><a href="#common-configuration">up</a> <a href="#toc">top</a></span></h3>
 <p>First you&#39;ll want to create a <code>.inputrc</code> file, and a good place is in your Windows user profile directory.</p>
 <p>This file is used for some configuration, such as key bindings and colored completions.</p>
 <p>Create the file by running this command at a CMD prompt:</p>
@@ -1112,7 +1152,7 @@ <h3 id="create-a-inputrc-file"><a class="wlink" href="#gettingstarted_inputrc"><
 </code></pre>
 <p>See <a href="#init-file">Init File</a> for more information on Readline init files.</p>
 <p><a name="gettingstarted_defaultbindings"></a></p>
-<h3 id="bash-vs-windows"><a class="wlink" href="#gettingstarted_defaultbindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Bash vs Windows</h3>
+<h3 id="bash-vs-windows"><a class="wlink" href="#gettingstarted_defaultbindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Bash vs Windows <span class="uplinks"><a href="#common-configuration">up</a> <a href="#toc">top</a></span></h3>
 <p>The default Clink key bindings are the same as in the &quot;bash&quot; shell for Unix/Linux.  That makes some keys like <kbd>Ctrl</kbd>-<kbd>A</kbd>, <kbd>Ctrl</kbd>-<kbd>F</kbd>, and <kbd>Ctrl</kbd>-<kbd>M</kbd> behave differently than you might be used to in CMD.</p>
 <p>To instead use the familiar <a href="#default_bindings">Windows default key bindings</a> you can run <code>clink set <a href="#clink_default_bindings">clink.default_bindings</a> windows</code>.</p>
 <p>Or, if you use the setup program with &quot;Use enhanced default settings&quot; checked then &quot;windows&quot; key bindings are the default, and you can run <code>clink set <a href="#clink_default_bindings">clink.default_bindings</a> bash</code> to use the bash default key bindings.</p>
@@ -1168,8 +1208,8 @@ <h3 id="bash-vs-windows"><a class="wlink" href="#gettingstarted_defaultbindings"
 </tr>
 </tbody></table>
 <p><a name="gettingstarted_autosuggest"></a></p>
-<h3 id="auto-suggest"><a class="wlink" href="#gettingstarted_autosuggest"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Auto-suggest</h3>
-<p>Clink can suggest commands as you type, based on command history and completions.</p>
+<h3 id="auto-suggest"><a class="wlink" href="#gettingstarted_autosuggest"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Auto-suggest <span class="uplinks"><a href="#common-configuration">up</a> <a href="#toc">top</a></span></h3>
+<p>Clink can suggest command lines as you type, based on command history and completions.</p>
 <p>You can turn off automatic suggestions with <code>clink set <a href="#autosuggest_enable">autosuggest.enable</a> false</code>, or turn them on with <code>clink set autosuggest.enable true</code>.</p>
 <p>When automatic suggestions are enabled and the cursor is at the end of the input line, a suggestion may appear in a muted color.  If the suggestion isn&#39;t what you want, just ignore it.  Or you can accept the whole suggestion with the <kbd>Right</kbd> arrow or <kbd>End</kbd> key, accept the next word of the suggestion with <kbd>Ctrl</kbd>-<kbd>Right</kbd>, or accept the next full word of the suggestion up to a space with <kbd>Shift</kbd>-<kbd>Right</kbd>.</p>
 <p>Here&#39;s an example of how auto-suggestion works.  Suppose you ran a command, so now it&#39;s in your command history:</p>
@@ -1181,18 +1221,18 @@ <h3 id="auto-suggest"><a class="wlink" href="#gettingstarted_autosuggest"><svg w
 </code></pre>
 
 <p>The muted text shows a suggestion that might be what you intend to type.  You can accept the muted text into the input line by pressing the <kbd>Right</kbd> key.</p>
-<p>If you press <kbd>Tab</kbd> then that invokes <a href="#how-completion-works">completion</a> instead.  Completion is something you manually invoke to offer possible completions for a word or argument position.  Auto-suggestion automatically offers suggestions for a whole input line, and the suggestions can come from the saved command history or from the list of possible completions.</p>
+<p>If you press <kbd>Tab</kbd> then that invokes <a href="#how-completion-works">completion</a> instead.  Completion is something you manually invoke to offer possible completions for a word or argument position.  Auto-suggestion automatically offers a suggestion for a whole input line, and the suggestion can come from the saved command history or from the list of possible completions.  There can be many possible completions available, but there is never more than one auto-suggestion available.</p>
 <p>The <a href="#autosuggest_hint"><code>autosuggest.hint</code></a> setting controls whether to show the <code>[Right]=Accept Suggestion</code> usage hint when a suggestion is available.</p>
 <p>The <a href="#autosuggest_strategy"><code>autosuggest.strategy</code></a> setting determines how suggestions are chosen.</p>
 <p><a name="gettingstarted_colors"></a></p>
-<h3 id="colors"><a class="wlink" href="#gettingstarted_colors"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Colors</h3>
+<h3 id="colors"><a class="wlink" href="#gettingstarted_colors"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Colors <span class="uplinks"><a href="#common-configuration">up</a> <a href="#toc">top</a></span></h3>
 <p>Clink has many configurable colors for match completions, input line coloring, popup lists, and more.</p>
 <p>If you use the setup program with &quot;Use enhanced default settings&quot; checked then many of the color settings have more colorful default values.</p>
-<h4 id="for-completion"><a class="wlink" href="#for-completion"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>For completion</h4>
+<h4 id="for-completion"><a class="wlink" href="#for-completion"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>For completion <span class="uplinks"><a href="#gettingstarted_colors">up</a> <a href="#toc">top</a></span></h4>
 <p>When performing completion (e.g. <kbd>Tab</kbd> or <kbd>Ctrl</kbd>-<kbd>Space</kbd>) Clink can add color to the possible completions.</p>
 <p>To turn on colored completions, put a line <code>set <a href="configcoloredstats">colored-stats</a> on</code> in the <a href="#gettingstarted_inputrc">.inputrc file</a> (if you copy/pasted the sample text, it&#39;s already there).</p>
 <p>See the <a href="#completion-colors">Completion Colors</a> section for how to configure the colors for match completions.</p>
-<h4 id="other-colors"><a class="wlink" href="#other-colors"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Other colors</h4>
+<h4 id="other-colors"><a class="wlink" href="#other-colors"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Other colors <span class="uplinks"><a href="#gettingstarted_colors">up</a> <a href="#toc">top</a></span></h4>
 <p>Clink adds color to the input line by highlighting arguments, flags, doskey macros, and more.  If you don&#39;t want input line colors, you can turn it off by running <code>clink set <a href="#clink_colorize_input">clink.colorize_input</a> false</code>.</p>
 <p>Here are examples, using the colors from the <a href="#gettingstarted_enhanceddefaults">Use enhanced defaults</a> installation option:</p>
 <pre style="border-radius:initial;border:initial;background-color:black"><code class="plaintext" style="background-color:black"><table class="console" cellpadding=0 cellspacing=0>
@@ -1207,7 +1247,7 @@ <h4 id="other-colors"><a class="wlink" href="#other-colors"><svg width=16 height
 <p>To configure a color, run <code>clink set <span class="arg">colorname</span> <span class="arg">colorvalue</span></code>.  Match completions make it easy to change Clink settings:  type <code>clink set color.</code> and then use completion (e.g. <kbd>Tab</kbd> or <kbd>Ctrl</kbd>-<kbd>Space</kbd>) to see the available color settings, and to fill in a color value.</p>
 <p>See the <a href="#classifywords">Coloring the Input Text</a> and <a href="#color-settings">Color Settings</a> sections for more information on Clink color settings.</p>
 <p><a name="gettingstarted_keybindings"></a></p>
-<h3 id="key-bindings"><a class="wlink" href="#gettingstarted_keybindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Key Bindings</h3>
+<h3 id="key-bindings"><a class="wlink" href="#gettingstarted_keybindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Key Bindings <span class="uplinks"><a href="#common-configuration">up</a> <a href="#toc">top</a></span></h3>
 <p>You can customize your key bindings (keyboard shortcuts) by assigning key bindings in the <a href="#gettingstarted_inputrc">.inputrc file</a>.  See <a href="#keybindings">Customizing Key Bindings</a> for more information.</p>
 <p>Clink comes with many pre-configured key bindings that invoke named commands.  Here are a few that you might find especially handy:</p>
 <table>
@@ -1225,7 +1265,7 @@ <h3 id="key-bindings"><a class="wlink" href="#gettingstarted_keybindings"><svg w
 
 <p>For a full list of commands available for key bindings, see <a href="#bindable-commands">Bindable Commands</a>.</p>
 <p><a name="gettingstarted_mouseinput"></a></p>
-<h3 id="mouse-input"><a class="wlink" href="#gettingstarted_mouseinput"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Mouse Input</h3>
+<h3 id="mouse-input"><a class="wlink" href="#gettingstarted_mouseinput"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Mouse Input <span class="uplinks"><a href="#common-configuration">up</a> <a href="#toc">top</a></span></h3>
 <p>Clink can optionally respond to mouse input, instead of letting the terminal respond to mouse input (e.g. to select text on the screen).  When mouse input is enabled in Clink, you can click in the input line or in popup lists, and the mouse wheel scrolls popup lists.</p>
 <p>Use <code>clink set <a href="#terminal_mouse_input">terminal.mouse_input</a> <span class="arg">mode</span></code> with one of the following modes to control whether Clink responds to mouse input:</p>
 <table>
@@ -1258,15 +1298,15 @@ <h3 id="mouse-input"><a class="wlink" href="#gettingstarted_mouseinput"><svg wid
 <li>In the default Conhost terminal when Quick Edit mode is turned off then Clink will also respond to mouse input when no modifier keys are held.</li>
 </ul>
 <p><a name="gettingstarted_startupcmdscript"></a></p>
-<h3 id="startup-cmd-script"><a class="wlink" href="#gettingstarted_startupcmdscript"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Startup Cmd Script</h3>
+<h3 id="startup-cmd-script"><a class="wlink" href="#gettingstarted_startupcmdscript"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Startup Cmd Script <span class="uplinks"><a href="#common-configuration">up</a> <a href="#toc">top</a></span></h3>
 <p>When Clink is injected, it looks for a <code>clink_start.cmd</code> script in the binaries directory and <a href="#filelocations">profile directory</a>.  Clink automatically runs the script(s), if present, when the first CMD prompt is shown after Clink is injected and before any Lua scripts run.  You can set the <code><a href="#clink_autostart">clink.autostart</a></code> setting to run a different command, or set it to &quot;nul&quot; to run no command at all.</p>
 <p><a name="gettingstarted_customprompt"></a></p>
-<h3 id="custom-prompt"><a class="wlink" href="#gettingstarted_customprompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Custom Prompt</h3>
+<h3 id="custom-prompt"><a class="wlink" href="#gettingstarted_customprompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Custom Prompt <span class="uplinks"><a href="#common-configuration">up</a> <a href="#toc">top</a></span></h3>
 <p>If you want a customizable prompt with a bunch of styles and an easy-to-use configuration wizard, check out <a href="https://github.com/chrisant996/clink-flex-prompt">clink-flex-prompt</a>.  Also, if you&#39;ve been disappointed by git making the prompt slow in other shells, try this prompt -- it makes the prompt appear instantly by running git commands in the background and refreshing the prompt once the background commands complete.</p>
 <p>Other popular configurable prompts are <a href="#oh-my-posh">oh-my-posh</a> and <a href="#starship">starship</a>.</p>
 <p>See <a href="#customisingtheprompt">Customizing the Prompt</a> for information on how to use Lua to customize the prompt.</p>
 <p><a name="upgradefrom049"></a></p>
-<h2 id="upgrading-from-clink-v049"><a class="wlink" href="#upgradefrom049"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Upgrading from Clink v0.4.9</h2>
+<h2 id="upgrading-from-clink-v049"><a class="wlink" href="#upgradefrom049"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Upgrading from Clink v0.4.9 <span class="uplinks"><a href="#getting-started">up</a> <a href="#toc">top</a></span></h2>
 <p>The new Clink tries to be as backward compatible with Clink v0.4.9 as possible. However, in some cases upgrading may require a little bit of configuration work.</p>
 <ul>
 <li>Some key binding sequences have changed; see <a href="#keybindings">Customizing Key Bindings</a> for more information.</li>
@@ -1276,7 +1316,7 @@ <h2 id="upgrading-from-clink-v049"><a class="wlink" href="#upgradefrom049"><svg
 <li>Some match generator scripts might need adjustments to become fully compatible with the <a href="#autosuggest_enable"><code>autosuggest.enable</code></a> setting.</li>
 <li>Some settings have changed slightly, and there are many new settings.  See <a href="#configclink">Configuring Clink</a> for more information.</li>
 </ul>
-<h3 id="migrating-between-different-profile-directories"><a class="wlink" href="#migrating-between-different-profile-directories"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Migrating between different profile directories</h3>
+<h3 id="migrating-between-different-profile-directories"><a class="wlink" href="#migrating-between-different-profile-directories"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Migrating between different profile directories <span class="uplinks"><a href="#upgradefrom049">up</a> <a href="#toc">top</a></span></h3>
 <p>All versions of Clink use the same default profile directory location.  If you haven&#39;t overridden the profile directory, then your settings and history will automatically migrate when upgrading to newer versions of Clink.</p>
 <p>If you choose to use a different profile directory, then you can still make migration happen by copying certain files:</p>
 <ol>
@@ -1287,7 +1327,7 @@ <h3 id="migrating-between-different-profile-directories"><a class="wlink" href="
 <li>Close the Clink session(s) and open new ones.</li>
 </ol>
 <p><a name="configclink"></a></p>
-<h1 id="configuring-clink"><a class="wlink" href="#configclink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Configuring Clink</h1>
+<h1 id="configuring-clink"><a class="wlink" href="#configclink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Configuring Clink <span class="uplinks"><a href="#toc">top</a></span></h1>
 <p>Clink has two configuration systems, which is a result of using the Readline library to provide command history and key bindings.</p>
 <p>The following sections describe how to configure Clink itself.  To learn about the Readline configuration and key bindings, instead see <a href="#configreadline">Configuring Readline</a>.</p>
 <table class="linkmenu">
@@ -1299,7 +1339,7 @@ <h1 id="configuring-clink"><a class="wlink" href="#configclink"><svg width=16 he
 </table>
 
 <p><a name="clinksettings"></a></p>
-<h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Clink Settings</h2>
+<h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Clink Settings <span class="uplinks"><a href="#configclink">up</a> <a href="#toc">top</a></span></h2>
 <p>The easiest way to configure Clink is to use the <code>clink set</code> command to list, query, and set Clink&#39;s settings.</p>
 <p>Run <code>clink set --help</code> from a Clink-installed cmd.exe process to learn more.</p>
 <p>The following table describes the available Clink settings:</p>
@@ -1447,6 +1487,11 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 <td>The color for the comment row.  During <a href="#rlcmd-clink-select-complete"><code>clink-select-complete</code></a> the comment row shows the &quot;and <em>N</em> more matches&quot; or &quot;rows <em>X</em> to <em>Y</em> of <em>Z</em>&quot; messages.  It can also show how history expansion will be applied at the cursor.</td>
 </tr>
 <tr>
+<td align="center"><a class="wlink" href="#color_common_match_prefix"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="color_common_match_prefix"></a><code>color.common_match_prefix</code></td>
+<td align="center"></td>
+<td>Used when displaying a prefix that all match completions have in common.  This can be superseded by <a href="#completioncolors">Completion Colors</a>.</td>
+</tr>
+<tr>
 <td align="center"><a class="wlink" href="#color_description"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="color_description"></a><code>color.description</code></td>
 <td align="center"><code>bright cyan</code> <a href="#alternatedefault">*</a></td>
 <td>Used when displaying descriptions for match completions.</td>
@@ -1707,6 +1752,11 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 <td>Prints stack trace on Lua errors.</td>
 </tr>
 <tr>
+<td align="center"><a class="wlink" href="#match_coloring_rules"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="match_coloring_rules"></a><code>match.coloring_rules</code></td>
+<td align="center"></td>
+<td>Provides a series of color definitions used when displaying match completions.  See <a href="#completioncolors">Completion Colors</a> for details.</td>
+</tr>
+<tr>
 <td align="center"><a class="wlink" href="#match_expand_abbrev"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="match_expand_abbrev"></a><code>match.expand_abbrev</code></td>
 <td align="center">True</td>
 <td>Expands an abbreviated path before performing completion.  In an abbreviated path, directory names may be shortened to the minimum number of characters to unambiguously refer to a directory.  For example, &quot;c:\Users\chris\Documents&quot; could be abbreviated as &quot;c:\U\c\Do&quot;, depending on what directories exist in the file system.</td>
@@ -1772,6 +1822,11 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 <td>Enables <a href="#asyncpromptfiltering">asynchronous prompt refresh</a>.  Turn this off if prompt filter refreshes are annoying or cause problems.</td>
 </tr>
 <tr>
+<td align="center"><a class="wlink" href="#prompt_spacing"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="prompt_spacing"></a><code>prompt.spacing</code></td>
+<td align="center"><code>normal</code></td>
+<td>The default is <code>normal</code> which never removes or adds blank lines.  Set to <code>compact</code> to remove blank lines before the prompt, or set to <code>sparse</code> to remove blank lines and then add one blank line.</td>
+</tr>
+<tr>
 <td align="center"><a class="wlink" href="#prompt-transient"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="prompt-transient"></a><code>prompt.transient</code></td>
 <td align="center"><code>off</code></td>
 <td>Controls when past prompts are collapsed (<a href="#transientprompts">transient prompts</a>).  <code>off</code> = never collapse past prompts, <code>always</code> = always collapse past prompts, <code>same_dir</code> = only collapse past prompts when the current working directory hasn&#39;t changed since the last prompt.</td>
@@ -1844,10 +1899,10 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 </ul>
 </blockquote>
 <p><a name="colorsettings"></a></p>
-<h2 id="color-settings"><a class="wlink" href="#colorsettings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Color Settings</h2>
+<h2 id="color-settings"><a class="wlink" href="#colorsettings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Color Settings <span class="uplinks"><a href="#configclink">up</a> <a href="#toc">top</a></span></h2>
 <p>This section describes how to set a color.</p>
 <p>For information on what color settings are available and how they&#39;re used, see the <a href="#classifywords">Coloring the Input Text</a> section and the <a href="#color_arg">color.*</a> settings.</p>
-<h3 id="friendly-color-names"><a class="wlink" href="#friendly-color-names"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Friendly Color Names</h3>
+<h3 id="friendly-color-names"><a class="wlink" href="#friendly-color-names"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Friendly Color Names <span class="uplinks"><a href="#colorsettings">up</a> <a href="#toc">top</a></span></h3>
 <p>The Clink color <a href="#clinksettings">settings</a> are the ones whose names begin with <code>color.</code>.  Color settings use the following syntax:</p>
 <p><code>[<span class="arg">attributes</span>] [<span class="arg">foreground_color</span>] [on [<span class="arg">background_color</span>]]</code></p>
 <p>Optional attributes (can be abbreviated to 3 letters):</p>
@@ -1868,11 +1923,11 @@ <h3 id="friendly-color-names"><a class="wlink" href="#friendly-color-names"><svg
 <li><code>underline bright black on white</code> for dark gray (bright black) foreground on light gray (white) background.</li>
 <li><code>default on blue</code> for default foreground color on blue background.</li>
 </ul>
-<h3 id="alternative-sgr-syntax"><a class="wlink" href="#alternative-sgr-syntax"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Alternative SGR Syntax</h3>
+<h3 id="alternative-sgr-syntax"><a class="wlink" href="#alternative-sgr-syntax"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Alternative SGR Syntax <span class="uplinks"><a href="#colorsettings">up</a> <a href="#toc">top</a></span></h3>
 <p>It&#39;s also possible to set any ANSI <a href="https://en.wikipedia.org/wiki/ANSI_escape_code#SGR">SGR escape code</a> using <code>sgr <span class="arg">SGR_parameters</span></code> (for example <code>sgr 7</code> is the code for reverse video, which swaps the foreground and background colors).</p>
 <p>Be careful, since some escape code sequences might behave strangely.</p>
 <p><a name="filelocations"></a></p>
-<h2 id="file-locations"><a class="wlink" href="#filelocations"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>File Locations</h2>
+<h2 id="file-locations"><a class="wlink" href="#filelocations"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>File Locations <span class="uplinks"><a href="#configclink">up</a> <a href="#toc">top</a></span></h2>
 <p>Settings and history are persisted to disk from session to session. By default Clink uses the current user&#39;s non-roaming application data directory. This user directory is usually found in one of the following locations;</p>
 <ul>
 <li>Windows XP: <code>c:\Documents and Settings\<span class="arg">username</span>\Local Settings\Application Data\clink</code></li>
@@ -1887,12 +1942,12 @@ <h2 id="file-locations"><a class="wlink" href="#filelocations"><svg width=16 hei
 <li>The <code>--profile</code> flag has a quirk for backward compatibility with older versions of Clink: <code>~\</code> in <code>--profile</code> is expanded to <code>%LOCALAPPDATA%</code> instead.</li>
 </ul>
 </blockquote>
-<h4 id="overriding-the-profile-directory-when-installed-for-autorun"><a class="wlink" href="#overriding-the-profile-directory-when-installed-for-autorun"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Overriding the profile directory when installed for Autorun</h4>
+<h4 id="overriding-the-profile-directory-when-installed-for-autorun"><a class="wlink" href="#overriding-the-profile-directory-when-installed-for-autorun"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Overriding the profile directory when installed for Autorun <span class="uplinks"><a href="#filelocations">up</a> <a href="#toc">top</a></span></h4>
 <p>If you&#39;ve installed Clink using the setup program with the &quot;Autorun when cmd.exe starts&quot; box checked, then the profile directory has been explicitly set to <code>%LOCALAPPDATA%\clink</code>.  That will take precedence over any other stored configuration.</p>
 <p>You can override it via <code>set CLINK_PROFILE=<span class="arg">path</span></code> after starting cmd.exe.</p>
 <p>Or you can use <code>clink autorun install -- --profile <span class="arg">path</span></code> to change which profile directory is specified (see <code>clink autorun --help</code> and <code>clink autorun show</code>).</p>
 <p>Or if you want to use Autorun but also override the profile directory any of the usual ways, then run <code>clink autorun uninstall</code> and then <code>clink autorun install</code>.  That will remove the explicit profile directory specification that was applied by the setup program.</p>
-<h3 id="files"><a class="wlink" href="#files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Files</h3>
+<h3 id="files"><a class="wlink" href="#files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Files <span class="uplinks"><a href="#filelocations">up</a> <a href="#toc">top</a></span></h3>
 <p>
 <dt>.inputrc</dt>
 <dd>
@@ -1937,7 +1992,7 @@ <h3 id="files"><a class="wlink" href="#files"><svg width=16 height=16><use href=
 <p>The <code>default_inputrc</code> file can be useful for portable installations or when sharing your favorite Clink configuration with friends.</p>
 </dd></p>
 
-<h2 id="command-line-options"><a class="wlink" href="#command-line-options"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Command Line Options</h2>
+<h2 id="command-line-options"><a class="wlink" href="#command-line-options"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Command Line Options <span class="uplinks"><a href="#configclink">up</a> <a href="#toc">top</a></span></h2>
 <p>
 <dt>clink</dt>
 <dd>
@@ -2015,7 +2070,7 @@ <h2 id="command-line-options"><a class="wlink" href="#command-line-options"><svg
 Checks for an updated version of Clink.  If one is available, it is downloaded and will be installed the next time Clink is injected.</dd>
 </p>
 
-<h2 id="automatic-updates"><a class="wlink" href="#automatic-updates"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Automatic Updates</h2>
+<h2 id="automatic-updates"><a class="wlink" href="#automatic-updates"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Automatic Updates <span class="uplinks"><a href="#configclink">up</a> <a href="#toc">top</a></span></h2>
 <p>By default, Clink periodically and automatically checks for new versions.  When an update is available, Clink prints a message on startup.  To apply an update, run <code>clink update</code> when convenient to do so.</p>
 <p>You can control the frequency of update checks with <code>clink set <a href="#clink_update_interval">clink.update_interval</a> <span class="arg">days</span></code>, where <span class="arg">days</span> is the minimum number of days between checking for updates.</p>
 <p>You can control what happens when an update is available by using <code>clink set <a href="#clink_autoupdate">clink.autoupdate</a> <span class="arg">mode</span></code>, where <span class="arg">mode</span> is one of these:</p>
@@ -2052,7 +2107,7 @@ <h2 id="automatic-updates"><a class="wlink" href="#automatic-updates"><svg width
 <li>Clink v1.5.5 added <code>check</code>, <code>prompt</code>, and <code>auto</code>.  Before that, only <code>false</code> and <code>true</code> were available (and <code>true</code> behaved the same as <code>check</code>).</li>
 </ul>
 </blockquote>
-<h2 id="portable-configuration"><a class="wlink" href="#portable-configuration"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Portable Configuration</h2>
+<h2 id="portable-configuration"><a class="wlink" href="#portable-configuration"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Portable Configuration <span class="uplinks"><a href="#configclink">up</a> <a href="#toc">top</a></span></h2>
 <p>Sometimes it&#39;s useful to run Clink from a flash drive or from a network share, especially if you want to use Clink on someone else&#39;s computer.</p>
 <p>Here&#39;s how you can set up a portable configuration for Clink:</p>
 <ol>
@@ -2065,13 +2120,13 @@ <h2 id="portable-configuration"><a class="wlink" href="#portable-configuration">
 <li>In any cmd.exe window on any computer, you can then run the <code>portable.bat</code> script to inject Clink and have all your favorite settings and key bindings work.</li>
 </ol>
 <p>Here are some sample scripts:</p>
-<h3 id="portablebat-on-a-flash-drive"><a class="wlink" href="#portablebat-on-a-flash-drive"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>portable.bat (on a flash drive)</h3>
+<h3 id="portablebat-on-a-flash-drive"><a class="wlink" href="#portablebat-on-a-flash-drive"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>portable.bat (on a flash drive) <span class="uplinks"><a href="#portable-configuration">up</a> <a href="#toc">top</a></span></h3>
 <p>This sample script assumes the portable.bat script is in the Clink directory, and it uses a <code>clink_portable</code> profile directory under the Clink directory.</p>
 <pre><code class="language-cmd">@echo off
 rem -- Do any other desired configuration here, such as loading a doskey macro file.
 call &quot;%~dp0clink.bat&quot; inject --profile &quot;%~dp0clink_portable&quot; %1 %2 %3 %4 %5 %6 %7 %8 %9
 </code></pre>
-<h3 id="portablebat-on-a-network-share"><a class="wlink" href="#portablebat-on-a-network-share"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>portable.bat (on a network share)</h3>
+<h3 id="portablebat-on-a-network-share"><a class="wlink" href="#portablebat-on-a-network-share"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>portable.bat (on a network share) <span class="uplinks"><a href="#portable-configuration">up</a> <a href="#toc">top</a></span></h3>
 <p>This sample script assumes the portable.bat script is in the Clink directory, and that there is a file <code>portable_clink_settings</code> with the settings you want to copy to the local profile directory.</p>
 <pre><code class="language-cmd">@echo off
 if not exist &quot;%TEMP%\clink_portable&quot; md &quot;%TEMP%\clink_portable&quot; &gt;nul
@@ -2080,7 +2135,7 @@ <h3 id="portablebat-on-a-network-share"><a class="wlink" href="#portablebat-on-a
 call &quot;%~dp0clink.bat&quot; inject --profile &quot;%TEMP%\clink_portable&quot; %1 %2 %3 %4 %5 %6 %7 %8 %9
 </code></pre>
 <p><a name="configreadline"></a></p>
-<h1 id="configuring-readline"><a class="wlink" href="#configreadline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Configuring Readline</h1>
+<h1 id="configuring-readline"><a class="wlink" href="#configreadline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Configuring Readline <span class="uplinks"><a href="#toc">top</a></span></h1>
 <p>Clink uses the <a href="https://tiswww.case.edu/php/chet/readline/rltop.html">GNU Readline library</a> to provide line editing functionality, which can be configured to add custom keybindings and macros by creating a Readline init file. The Clink documentation includes an updated and tailored copy of the Readline documentation, below.</p>
 <table class="linkmenu">
 <tr><td><a href="#the-basics">The Basics</a></td><td>The basics of using the Readline input editor in Clink.</td></tr>
@@ -2090,8 +2145,8 @@ <h1 id="configuring-readline"><a class="wlink" href="#configreadline"><svg width
 <tr><td><a href="#popupwindow">Popup Windows</a></td><td>Using the popup windows.</td></tr>
 </table>
 
-<h2 id="the-basics"><a class="wlink" href="#the-basics"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The Basics</h2>
-<h3 id="bare-essentials"><a class="wlink" href="#bare-essentials"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Bare Essentials</h3>
+<h2 id="the-basics"><a class="wlink" href="#the-basics"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The Basics <span class="uplinks"><a href="#configreadline">up</a> <a href="#toc">top</a></span></h2>
+<h3 id="bare-essentials"><a class="wlink" href="#bare-essentials"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Bare Essentials <span class="uplinks"><a href="#the-basics">up</a> <a href="#toc">top</a></span></h3>
 <p>To enter characters into the line, simply type them. The typed character appears where the cursor was, and then the cursor moves one space to the right. If you mistype a character, you can use <kbd>Backspace</kbd> to back up and delete the mistyped character.</p>
 <p>Sometimes you may mistype a character, and not notice the error until you have typed several other characters. In that case, you can type <kbd>Left</kbd> (the left arrow key) to move the cursor to the left, and then correct your mistake. Afterwards, you can move the cursor to the right with <kbd>Right</kbd> (the right arrow key).</p>
 <p>When you add text in the middle of a line, you will notice that characters to the right of the cursor are &quot;pushed over&quot; to make room for the text that you have inserted. Likewise, when you delete text behind the cursor, characters to the right of the cursor are &quot;pulled back&quot; to fill in the blank space created by the removal of the text. A list of the bare essentials for editing the text of an input line follows.</p>
@@ -2143,7 +2198,7 @@ <h3 id="bare-essentials"><a class="wlink" href="#bare-essentials"><svg width=16
 <td>Move forward a word.</td>
 </tr>
 </tbody></table>
-<h3 id="killing-and-yanking"><a class="wlink" href="#killing-and-yanking"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Killing and Yanking</h3>
+<h3 id="killing-and-yanking"><a class="wlink" href="#killing-and-yanking"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Killing and Yanking <span class="uplinks"><a href="#the-basics">up</a> <a href="#toc">top</a></span></h3>
 <p><em>Killing</em> text means to delete the text from the line, but to save it away for later use, usually by <em>yanking</em> (re-inserting) it back into the line. (&quot;Cut&quot; and &quot;paste&quot; are more recent jargon for &quot;kill&quot; and &quot;yank&quot;, but killing and yanking do not affect the system&#39;s clipboard.)</p>
 <p>If the description for a command says that it &quot;kills&quot; text, then you can be sure that you can get the text back in a different (or the same) place later.</p>
 <p>When you use a kill command, the text is saved in a <em>kill-ring</em>. Any number of consecutive kills save all of the killed text together, so that when you yank it back, you get it all. The kill ring is not line specific; the text that you killed on a previously typed line is available to be yanked back later, when you are typing another line.</p>
@@ -2189,11 +2244,11 @@ <h3 id="killing-and-yanking"><a class="wlink" href="#killing-and-yanking"><svg w
 <td>Rotate the kill-ring, and yank the new top. You can only do this if the prior command is <kbd>Ctrl</kbd>-<kbd>y</kbd> or <kbd>Alt</kbd>-<kbd>y</kbd>.</td>
 </tr>
 </tbody></table>
-<h3 id="readline-arguments"><a class="wlink" href="#readline-arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Readline Arguments</h3>
+<h3 id="readline-arguments"><a class="wlink" href="#readline-arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Readline Arguments <span class="uplinks"><a href="#the-basics">up</a> <a href="#toc">top</a></span></h3>
 <p>You can pass numeric arguments to Readline commands. Sometimes the argument acts as a repeat count, other times it is the <em>sign</em> of the argument that is significant. If you pass a negative argument to a command which normally acts in a forward direction, that command will act in a backward direction. For example, to kill text back to the start of the line, you might type <kbd>Alt</kbd>-<kbd>-</kbd> <kbd>Ctrl</kbd>-<kbd>k</kbd>.</p>
 <p>The general way to pass numeric arguments to a command is to type meta digits before the command. If the first &quot;digit&quot; typed is a minus sign (<code>-</code>), then the sign of the argument will be negative. Once you have typed one meta digit to get the argument started, you can type the remainder of the digits, and then the command. For example, to give the <kbd>Del</kbd> command an argument of 10, you could type <kbd>Alt</kbd>-<kbd>1</kbd> <kbd>0</kbd> <kbd>Del</kbd>, which will delete the next ten characters on the input line.</p>
 <p><a name="rlsearchinhistory"></a></p>
-<h3 id="searching-for-commands-in-the-history"><a class="wlink" href="#rlsearchinhistory"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Searching for Commands in the History</h3>
+<h3 id="searching-for-commands-in-the-history"><a class="wlink" href="#rlsearchinhistory"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Searching for Commands in the History <span class="uplinks"><a href="#the-basics">up</a> <a href="#toc">top</a></span></h3>
 <p>Readline provides commands for searching through the command history for lines containing a specified string. There are two search modes: <em>incremental</em> and <em>non-incremental</em>.</p>
 <p>Incremental searches begin before the user has finished typing the search string. As each character of the search string is typed, Readline displays the next entry from the history matching the string typed so far. An incremental search requires only as many characters as needed to find the desired history entry. To search backward in the history for a particular string, type <kbd>Ctrl</kbd>-<kbd>r</kbd>. Typing <kbd>Ctrl</kbd>-<kbd>s</kbd> searches forward through the history. The characters present in the value of the <a href="#configisearchterminators"><code>isearch-terminators</code></a> variable are used to terminate an incremental search. If that variable has not been assigned a value, then <kbd>Esc</kbd> or <kbd>Ctrl</kbd>-<kbd>j</kbd> will terminate an incremental search. <kbd>Ctrl</kbd>-<kbd>g</kbd> will abort an incremental search and restore the original line. When the search is terminated, the history entry containing the search string becomes the current line.</p>
 <p>To find other matching entries in the history list, type <kbd>Ctrl</kbd>-<kbd>r</kbd> or <kbd>Ctrl</kbd>-<kbd>s</kbd> as appropriate. This will search backward or forward in the history for the next entry matching the search string typed so far. Any other key sequence bound to a Readline command will terminate the search and execute that command. For instance, <kbd>Enter</kbd> will terminate the search and accept the line, thereby executing the command from the history list. A movement command will terminate the search, make the last line found the current line, and begin editing.</p>
@@ -2201,10 +2256,10 @@ <h3 id="searching-for-commands-in-the-history"><a class="wlink" href="#rlsearchi
 <p>Non-incremental searches read the entire search string before starting to search for matching history lines. The search string may be typed by the user or be part of the contents of the current line. Type <kbd>Alt</kbd>-<kbd>p</kbd> or <kbd>Alt</kbd>-<kbd>n</kbd> to start a non-incremental search backwards or forwards.</p>
 <p>To search backward in the history for a line starting with the text before the cursor, type <kbd>PgUp</kbd>. Or search forward by typing <kbd>PgDn</kbd>.</p>
 <p>See <a href="#saved-command-history">Saved Command History</a> for more information on how history works.</p>
-<h2 id="init-file"><a class="wlink" href="#init-file"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Init File</h2>
+<h2 id="init-file"><a class="wlink" href="#init-file"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Init File <span class="uplinks"><a href="#configreadline">up</a> <a href="#toc">top</a></span></h2>
 <p>You can customize key bindings and configuration variables by using an init file.</p>
 <p>&quot;<a href="#readline-configuration-variables">Configuration variables</a>&quot; are customized in the init file, but &quot;<a href="#clink-settings">Clink settings</a>&quot; are customized with the <code>clink set</code> command.</p>
-<h3 id="init-file-location"><a class="wlink" href="#init-file-location"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Init File Location</h3>
+<h3 id="init-file-location"><a class="wlink" href="#init-file-location"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Init File Location <span class="uplinks"><a href="#init-file">up</a> <a href="#toc">top</a></span></h3>
 <p>The Readline init file is named <code>.inputrc</code> or <code>_inputrc</code>.  Clink searches the directories referenced by the following environment variables in the order listed here, and loads the first <code>.inputrc</code> or <code>_inputrc</code> file it finds:</p>
 <ul>
 <li><code>%CLINK_INPUTRC%</code></li>
@@ -2224,7 +2279,7 @@ <h3 id="init-file-location"><a class="wlink" href="#init-file-location"><svg wid
 <li>Clink v1.0.0a0 through Clink v1.2.27 accidentally loaded up to one Readline init file from each of the searched directories. That was incorrect behavior for loading Readline init files and has been fixed. If similar behavior is still desired, consider using the <code>$include</code> directive in the Readline init file, to load additional files.</li>
 </ul>
 </blockquote>
-<h3 id="init-file-syntax"><a class="wlink" href="#init-file-syntax"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Init File Syntax</h3>
+<h3 id="init-file-syntax"><a class="wlink" href="#init-file-syntax"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Init File Syntax <span class="uplinks"><a href="#init-file">up</a> <a href="#toc">top</a></span></h3>
 <p>There are only a few basic constructs allowed in the Readline init file:</p>
 <ul>
 <li>Blank lines are ignored.</li>
@@ -2232,7 +2287,7 @@ <h3 id="init-file-syntax"><a class="wlink" href="#init-file-syntax"><svg width=1
 <li>Lines beginning with a <code>$</code> indicate <a href="#conditional-init-constructs">conditional init constructs</a>.</li>
 <li>Other lines denote <a href="#readline-configuration-variables">Readline configuration variables</a> and <a href="#readline-key-bindings">Readline key bindings</a>.</li>
 </ul>
-<h4 id="readline-configuration-variables"><a class="wlink" href="#readline-configuration-variables"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Readline configuration variables</h4>
+<h4 id="readline-configuration-variables"><a class="wlink" href="#readline-configuration-variables"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Readline configuration variables <span class="uplinks"><a href="#init-file-syntax">up</a> <a href="#toc">top</a></span></h4>
 <p>You can modify the behavior of Readline by altering the values of configuration variables in Readline using the <code>set</code> command within the init file. The syntax is simple:</p>
 <pre><code class="plaintext">set <span class="arg">variable</span> <span class="arg">value</span></code></pre>
 
@@ -2270,7 +2325,7 @@ <h4 id="readline-configuration-variables"><a class="wlink" href="#readline-confi
 </tr>
 <tr>
 <td><a class="wlink" href="#configcoloredstats"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="configcoloredstats"></a><code>colored-stats</code></td>
-<td>If set to &quot;on&quot;, Readline displays possible completions using different colors to indicate their file type. The color definitions are taken from the value of the <a href="#completioncolors"><code>%LS_COLORS%</code></a> environment variable. The default is &quot;off&quot;.</td>
+<td>If set to &quot;on&quot;, Readline displays possible completions using different colors to indicate their file type. The color definitions are determined as described in <a href="#completioncolors">Completion Colors</a>. The default is &quot;off&quot;, but is automatically overridden by the <a href="#match_coloring_rules"><code>match.coloring_rules</code></a> setting or the <code>%CLINK_MATCH_COLORS</code> environment variable.</td>
 </tr>
 <tr>
 <td><a class="wlink" href="#configcommentbegin"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="configcommentbegin"></a><code>comment-begin</code></td>
@@ -2309,10 +2364,6 @@ <h4 id="readline-configuration-variables"><a class="wlink" href="#readline-confi
 <td>The <em>point</em> is the current cursor position, and <em>mark</em> refers to a saved cursor position (see <a href="#commands-for-moving">Commands For Moving</a> and <a href="#some-miscellaneous-commands">Some Miscellaneous Commands</a>).  The text between the point and mark is referred to as the <em>region</em>.  When this variable is set to &quot;on&quot;, Readline allows certain commands to designate the region as <em>active</em>.  When the region is active, Readline highlights the text in the region using the value of the <code>active-region-start-color</code>, which defaults to reverse video (&quot;\e[0;7m&quot;).  The active region shows the text inserted by bracketed-paste and any matching text found by incremental and non-incremental history searches.  The default is &quot;on&quot;.</td>
 </tr>
 <tr>
-<td><a class="wlink" href="#configenablebracketedpaste"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="configenablebracketedpaste"></a><code>enable-bracketed-paste</code></td>
-<td>When set to &quot;on&quot;, Readline will configure the terminal in a way that will enable it to insert each paste into the editing buffer as a single string of characters, instead of treating each character as if it had been read from the keyboard. This can prevent pasted characters from being interpreted as editing commands. The default is &quot;on&quot;.</td>
-</tr>
-<tr>
 <td><a class="wlink" href="#configexpandtilde"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="configexpandtilde"></a><code>expand-tilde</code></td>
 <td>If set to &quot;on&quot;, tilde expansion is performed when Readline attempts word completion. The default is &quot;off&quot;.</td>
 </tr>
@@ -2439,6 +2490,10 @@ <h4 id="readline-configuration-variables"><a class="wlink" href="#readline-confi
 <td>If set to &quot;on&quot;, Readline will inhibit word completion. Completion characters will be inserted into the line as if they had been mapped to <a href="#rlcmd-self-insert"><code>self-insert</code></a>. The default is &quot;off&quot;.</td>
 </tr>
 <tr>
+<td><a class="wlink" href="#configenablebracketedpaste"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="configenablebracketedpaste"></a><code>enable-bracketed-paste</code></td>
+<td>Clink doesn&#39;t support this. Instead use the [`clink-paste``](#rlcmd-clink-paste) command to perform the equivalent of a bracketed paste.</td>
+</tr>
+<tr>
 <td><a class="wlink" href="#configenablemetakey"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="configenablemetakey"></a><code>enable-meta-key</code></td>
 <td>Clink requires this to be &quot;on&quot;, and sets it to &quot;on&quot;.</td>
 </tr>
@@ -2463,7 +2518,7 @@ <h4 id="readline-configuration-variables"><a class="wlink" href="#readline-confi
 <td>Clink always reverts all in-memory changes to history lines each time a new input prompt starts.</td>
 </tr>
 </tbody></table>
-<h4 id="readline-key-bindings"><a class="wlink" href="#readline-key-bindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Readline key bindings</h4>
+<h4 id="readline-key-bindings"><a class="wlink" href="#readline-key-bindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Readline key bindings <span class="uplinks"><a href="#init-file-syntax">up</a> <a href="#toc">top</a></span></h4>
 <p>The syntax for controlling key bindings in the init file is simple. First you need to find the name of the command that you want to change. The following sections contain tables of the command name, the default keybinding, if any, and a short description of what the command does (see <a href="#bindable-commands">Bindable Commands</a>).</p>
 <p>Once you know the name of the command, simply place on a line in the init file the name of the key you wish to bind the command to, a colon, and then the name of the command. There can be no space between the key name and the colon (any space will be interpreted as part of the key name). The name of the key can be expressed in different ways, depending on what you find most comfortable.</p>
 <p>In addition to command names, Readline allows keys to be bound to a string that is inserted when the key is pressed (a <em>macro</em>).</p>
@@ -2626,7 +2681,7 @@ <h4 id="readline-key-bindings"><a class="wlink" href="#readline-key-bindings"><s
 </p>
 
 <p>See <a href="#keybindings">Customizing Key Bindings</a> for more information about binding keys in Clink.</p>
-<h4 id="conditional-init-constructs"><a class="wlink" href="#conditional-init-constructs"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Conditional init constructs</h4>
+<h4 id="conditional-init-constructs"><a class="wlink" href="#conditional-init-constructs"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Conditional init constructs <span class="uplinks"><a href="#init-file-syntax">up</a> <a href="#toc">top</a></span></h4>
 <p>Readline implements a facility similar in spirit to the conditional compilation features of the C preprocessor which allows key bindings and variable settings to be performed as the result of tests. There are four parser directives used.</p>
 <p><dt class="toppadding">$if</dt></p><dd>
 <dd>
@@ -2643,12 +2698,18 @@ <h4 id="conditional-init-constructs"><a class="wlink" href="#conditional-init-co
 set show-mode-in-prompt on
 $endif
 </code></pre>
-<p>The <code>$if application</code> construct is used to include application-specific settings. Each program using the Readline library sets the <em>application name</em>, and you can test for a particular value. This could be used to bind key sequences to functions useful for a specific program. For instance, the following command adds a key sequence that quotes the current or previous word, but only in Clink:</p>
+<p>The <code>$if clink</code> construct is used to include Clink-specific settings. For instance, the following command adds a key sequence that quotes the current or previous word, but only in Clink:</p>
 <pre><code class="language-inputrc">$if clink
 # Quote the current or previous word
 &quot;\C-xq&quot;: &quot;\eb\&quot;\ef\&quot;&quot;
 $endif
 </code></pre>
+<p>The <code>$if clink_version</code> test may be used to perform comparisons against specific Clink versions. The <code>clink_version</code> expands to the current Clink version. The set of comparison operators includes <code>=</code> (and <code>==</code>), <code>!=</code>, <code>&lt;=</code>, <code>&gt;=</code>, <code>&lt;</code>, and <code>&gt;</code>. The version number supplied on the right side of the operator consists of a major version number, an optional decimal point and minor version, and an optional decimal point and patch version (e.g., &quot;1.6&quot; or &quot;1.6.2&quot;). If the minor or patch versions are omitted, they are assumed to be &quot;0&quot;. The operator may be separated from the string <code>clink_version</code> and from the version number argument by whitespace. In other applications that use Readline (such as <code>bash</code>) or in versions of Clink before v1.6.1, the test is always false.  The following example sets a key binding if the Clink version being used is 1.6.1 or newer:</p>
+<pre><code class="language-inputrc">$if clink_version &gt;= 1.6.1
+&quot;\C-x\C-f&quot;: clink-dump-functions    # This function doesn&#39;t exist before Clink 1.6.1,
+                                    # and would print an error in older versions.
+$endif
+</code></pre>
 <p>The <code>$if variable</code> construct provides simple equality tests for Readline variables and values. The permitted comparison operators are <code>=</code>, <code>==</code>, and <code>!=</code>. The variable name must be separated from the comparison operator by whitespace; the operator may be separated from the value on the right hand side by whitespace. Both string and boolean variables may be tested. Boolean variables must be tested against the values <em>on</em> and <em>off</em>. The following example is equivalent to the <code>mode=emacs</code> test described above:</p>
 <pre><code class="language-inputrc">$if editing-mode == emacs
 set show-mode-in-prompt on
@@ -2673,7 +2734,7 @@ <h4 id="conditional-init-constructs"><a class="wlink" href="#conditional-init-co
 </code></pre>
 </dd>
 
-<h4 id="sample-inputrc-file"><a class="wlink" href="#sample-inputrc-file"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Sample .inputrc file</h4>
+<h4 id="sample-inputrc-file"><a class="wlink" href="#sample-inputrc-file"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Sample .inputrc file <span class="uplinks"><a href="#init-file-syntax">up</a> <a href="#toc">top</a></span></h4>
 <p>Here is a sample <code>.inputrc</code> file with some of the variables and key bindings that I use:</p>
 <pre><code class="language-inputrc">$if clink           # begin clink-only section
 
@@ -2725,8 +2786,22 @@ <h4 id="sample-inputrc-file"><a class="wlink" href="#sample-inputrc-file"><svg w
 
 $endif              # end clink-only section
 </code></pre>
-<h2 id="bindable-commands"><a class="wlink" href="#bindable-commands"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Bindable Commands</h2>
-<h3 id="commands-for-moving"><a class="wlink" href="#commands-for-moving"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Commands For Moving</h3>
+<h2 id="bindable-commands"><a class="wlink" href="#bindable-commands"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Bindable Commands <span class="uplinks"><a href="#configreadline">up</a> <a href="#toc">top</a></span></h2>
+<table class="linkmenu">
+<tr><td><a href="#commands-for-moving">Commands For Moving</a></td><td>Common commands for moving the cursor in the command line.</td></tr>
+<tr><td><a href="#commands-for-manipulating-the-history">Commands For Manipulating The History</a></td><td>Common commands for using the command history list.</td></tr>
+<tr><td><a href="#commands-for-changing-text">Commands For Changing Text</a></td><td>Common commands for deleting and inserting text.</td></tr>
+<tr><td><a href="#killing-and-yanking-1">Killing And Yanking</a></td><td>Commands for using the "<a href="#killing-and-yanking">kill ring</a>" (Readline's version of a clipboard).</td></tr>
+<tr><td><a href="#specifying-numeric-arguments">Specifying Numeric Arguments</a></td><td>Commands for inputing numeric arguments to other Readline commands.</td></tr>
+<tr><td><a href="#completion-commands">Completion Commands</a></td><td>Common completion commands.</td></tr>
+<tr><td><a href="#keyboard-macros">Keyboard Macros</a></td><td>Commands for using keyboard macros.</td></tr>
+<tr><td><a href="#some-miscellaneous-commands">Some Miscellaneous Commands</a></td><td>Some commands that aren't commonly used.</td></tr>
+<tr><td><a href="#readline-vi-mode">Readline vi Mode</a></td><td>Commands for toggling vi mode.</td></tr>
+<tr><td><a href="#other-readline-commands">Other Readline Commands</a></td><td>Commands that exist only for .inputrc compatibility with the bash shell.</td></tr>
+<tr><td><a href="#clink-commands"><strong>Clink Commands</strong></a></td><td><strong>Clink adds many new and enhanced commands beyond the basic Readline commands.</strong></td></tr>
+</table>
+
+<h3 id="commands-for-moving"><a class="wlink" href="#commands-for-moving"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Commands For Moving <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <table>
 <thead>
 <tr>
@@ -2785,13 +2860,8 @@ <h3 id="commands-for-moving"><a class="wlink" href="#commands-for-moving"><svg w
 <td align="center"><kbd>Ctrl</kbd>-<kbd>l</kbd></td>
 <td>Clear the terminal screen, then redraw the current line, leaving the current line at the top of the screen.</td>
 </tr>
-<tr>
-<td><a class="wlink" href="#rlcmd-redraw-current-line"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-redraw-current-line"></a><code>redraw-current-line</code></td>
-<td align="center"></td>
-<td>Refresh the current line.</td>
-</tr>
 </tbody></table>
-<h3 id="commands-for-manipulating-the-history"><a class="wlink" href="#commands-for-manipulating-the-history"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Commands For Manipulating The History</h3>
+<h3 id="commands-for-manipulating-the-history"><a class="wlink" href="#commands-for-manipulating-the-history"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Commands For Manipulating The History <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <table>
 <thead>
 <tr>
@@ -2868,7 +2938,7 @@ <h3 id="commands-for-manipulating-the-history"><a class="wlink" href="#commands-
 <tr>
 <td><a class="wlink" href="#rlcmd-yank-nth-arg"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-yank-nth-arg"></a><code>yank-nth-arg</code></td>
 <td align="center"><kbd>Alt</kbd>-<kbd>Ctrl</kbd>-<kbd>y</kbd></td>
-<td>Insert the first argument to the previous command (usually the second word on the previous line) at point. With an argument <em>n</em>, insert the <em>n</em>th word from the previous command (the words in the previous command begin with word 0). A negative argument inserts the <em>n</em>th word from the end of the previous command. Once the argument <em>n</em> is computed, the argument is extracted as if the &quot;!n&quot; history expansion had been specified.</td>
+<td>Insert the first argument to the previous command (usually the second word on the previous line) at point. With an argument <em>n</em>, insert the <em>n</em>-th word from the previous command (the words in the previous command begin with word 0). A negative argument inserts the <em>n</em>-th word from the end of the previous command. Once the argument <em>n</em> is computed, the argument is extracted as if the &quot;!n&quot; history expansion had been specified.</td>
 </tr>
 <tr>
 <td><a class="wlink" href="#rlcmd-yank-last-arg"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-yank-last-arg"></a><code>yank-last-arg</code></td>
@@ -2886,7 +2956,7 @@ <h3 id="commands-for-manipulating-the-history"><a class="wlink" href="#commands-
 <td>With a numeric argument, fetch that entry from the history list and make it the current line.  Without an argument, move back to the first entry in the history list.</td>
 </tr>
 </tbody></table>
-<h3 id="commands-for-changing-text"><a class="wlink" href="#commands-for-changing-text"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Commands For Changing Text</h3>
+<h3 id="commands-for-changing-text"><a class="wlink" href="#commands-for-changing-text"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Commands For Changing Text <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <table>
 <thead>
 <tr>
@@ -2921,11 +2991,6 @@ <h3 id="commands-for-changing-text"><a class="wlink" href="#commands-for-changin
 <td>Insert the key itself.</td>
 </tr>
 <tr>
-<td><a class="wlink" href="#rlcmd-bracketed-paste-begin"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-bracketed-paste-begin"></a><code>bracketed-paste-begin</code></td>
-<td align="center"></td>
-<td>This function is intended to be bound to the &quot;bracketed paste&quot; escape sequence sent by some terminals, and such a binding is assigned by default. It allows Readline to insert the pasted text as a single unit without treating each character as if it had been read from the keyboard. The characters are inserted as if each one was bound to <a href="#rlcmd-self-insert"><code>self-insert</code></a> instead of executing any editing commands.<br/>Bracketed paste sets the region (the characters between point and the mark) to the inserted text. It uses the concept of an active mark: when the mark is active, Readline redisplay uses the terminal&#39;s standout mode to denote the region.</td>
-</tr>
-<tr>
 <td><a class="wlink" href="#rlcmd-transpose-chars"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-transpose-chars"></a><code>transpose-chars</code></td>
 <td align="center"><kbd>Ctrl</kbd>-<kbd>t</kbd></td>
 <td>Drag the character before the cursor forward over the character at the cursor, moving the cursor forward as well. If the insertion point is at the end of the line, then this transposes the last two characters of the line. Negative arguments have no effect.</td>
@@ -2956,7 +3021,7 @@ <h3 id="commands-for-changing-text"><a class="wlink" href="#commands-for-changin
 <td>Toggle overwrite mode. With an explicit positive numeric argument, switches to overwrite mode. With an explicit non-positive numeric argument, switches to insert mode. This command affects only emacs mode; vi mode does overwrite differently. Each new command line prompt starts in insert mode.<br/>In overwrite mode, characters bound to <a href="#rlcmd-self-insert"><code>self-insert</code></a> replace the text at point rather than pushing the text to the right. Characters bound to <a href="#rlcmd-backward-delete-char"><code>backward-delete-char</code></a> replace the character before point with a space.</td>
 </tr>
 </tbody></table>
-<h3 id="killing-and-yanking-1"><a class="wlink" href="#killing-and-yanking-1"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Killing And Yanking</h3>
+<h3 id="killing-and-yanking-1"><a class="wlink" href="#killing-and-yanking-1"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Killing And Yanking <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <table>
 <thead>
 <tr>
@@ -3041,7 +3106,7 @@ <h3 id="killing-and-yanking-1"><a class="wlink" href="#killing-and-yanking-1"><s
 <td>Rotate the kill-ring and yank the new top; but only if the prior command is <a href="#rlcmd-yank"><code>yank</code></a> or <code>yank-pop</code>.</td>
 </tr>
 </tbody></table>
-<h3 id="specifying-numeric-arguments"><a class="wlink" href="#specifying-numeric-arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Specifying Numeric Arguments</h3>
+<h3 id="specifying-numeric-arguments"><a class="wlink" href="#specifying-numeric-arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Specifying Numeric Arguments <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <table>
 <thead>
 <tr>
@@ -3061,7 +3126,7 @@ <h3 id="specifying-numeric-arguments"><a class="wlink" href="#specifying-numeric
 <td>This is another way to specify an argument. If this command is followed by one or more digits, optionally with a leading minus sign, those digits define the argument. If the command is followed by digits, executing <code>universal-argument</code> again ends the numeric argument, but is otherwise ignored. As a special case, if this command is immediately followed by a character that is neither a digit nor minus sign, the argument count for the next command is multiplied by four. The argument count is initially one, so executing this function the first time makes the argument count four, a second time makes the argument count sixteen, and so on. By default, this is not bound to a key.</td>
 </tr>
 </tbody></table>
-<h3 id="completion-commands"><a class="wlink" href="#completion-commands"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Completion Commands</h3>
+<h3 id="completion-commands"><a class="wlink" href="#completion-commands"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Completion Commands <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <table>
 <thead>
 <tr>
@@ -3106,7 +3171,7 @@ <h3 id="completion-commands"><a class="wlink" href="#completion-commands"><svg w
 <td>Deletes the character under the cursor if not at the beginning or end of the line (like <a href="#rlcmd-delete-char"><code>delete-char</code></a>). If at the end of the line, behaves identically to <a href="#rlcmd-possible-completions"><code>possible-completions</code></a>.</td>
 </tr>
 </tbody></table>
-<h3 id="keyboard-macros"><a class="wlink" href="#keyboard-macros"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Keyboard Macros</h3>
+<h3 id="keyboard-macros"><a class="wlink" href="#keyboard-macros"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Keyboard Macros <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <table>
 <thead>
 <tr>
@@ -3136,7 +3201,7 @@ <h3 id="keyboard-macros"><a class="wlink" href="#keyboard-macros"><svg width=16
 <td>Print the last keboard macro defined in a format suitable for the inputrc file.</td>
 </tr>
 </tbody></table>
-<h3 id="some-miscellaneous-commands"><a class="wlink" href="#some-miscellaneous-commands"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Some Miscellaneous Commands</h3>
+<h3 id="some-miscellaneous-commands"><a class="wlink" href="#some-miscellaneous-commands"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Some Miscellaneous Commands <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <table>
 <thead>
 <tr>
@@ -3201,6 +3266,11 @@ <h3 id="some-miscellaneous-commands"><a class="wlink" href="#some-miscellaneous-
 <td>Without a numeric argument, the value of the <a href="#configcommentbegin"><code>comment-begin</code></a> variable is inserted at the beginning of the current line. If a numeric argument is supplied, this command acts as a toggle: if the characters at the beginning of the line do not match the value of <code>comment-begin</code>, the value is inserted, otherwise the characters in <code>comment-begin</code> are deleted from the beginning of the line. In either case, the line is accepted as if a newline had been typed.</td>
 </tr>
 <tr>
+<td><a class="wlink" href="#rlcmd-redraw-current-line"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-redraw-current-line"></a><code>redraw-current-line</code></td>
+<td align="center"></td>
+<td>Refresh the current line.</td>
+</tr>
+<tr>
 <td><a class="wlink" href="#rlcmd-dump-functions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-dump-functions"></a><code>dump-functions</code></td>
 <td align="center"></td>
 <td>Print all of the functions and their key bindings to the Readline output stream. If a numeric argument is supplied, the output is formatted in such a way that it can be made part of an inputrc file.</td>
@@ -3216,7 +3286,7 @@ <h3 id="some-miscellaneous-commands"><a class="wlink" href="#some-miscellaneous-
 <td>Print all of the Readline key sequences bound to macros and the strings they output. If a numeric argument is supplied, the output is formatted in such a way that it can be made part of an inputrc file.</td>
 </tr>
 </tbody></table>
-<h3 id="readline-vi-mode"><a class="wlink" href="#readline-vi-mode"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Readline vi Mode</h3>
+<h3 id="readline-vi-mode"><a class="wlink" href="#readline-vi-mode"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Readline vi Mode <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <p>While the Readline library does not have a full set of vi editing functions, it does contain enough to allow simple editing of the line. The Readline vi mode behaves as specified in the POSIX standard.</p>
 <p>In order to switch interactively between emacs and vi editing modes, use the command <kbd>Alt</kbd>-<kbd>Ctrl</kbd>-<kbd>j</kbd> (bound to <a href="#rlcmd-emacs-editing-mode"><code>emacs-editing-mode</code></a> when in vi mode and to <a href="#rlcmd-vi-editing-mode"><code>vi-editing-mode</code></a> in emacs mode). The Readline default is emacs mode.</p>
 <p>When you enter a line in vi mode, you are already placed in &quot;insertion&quot; mode, as if you had typed an &quot;i&quot;. Pressing <kbd>Esc</kbd> switches you into &quot;command&quot; mode, where you can edit the text of the line with the standard vi movement keys, move to previous history lines with &quot;k&quot; and subsequent lines with &quot;j&quot;, and so forth.</p>
@@ -3239,7 +3309,7 @@ <h3 id="readline-vi-mode"><a class="wlink" href="#readline-vi-mode"><svg width=1
 <td>When in emacs editing mode, this causes a switch to vi editing mode.</td>
 </tr>
 </tbody></table>
-<h3 id="other-readline-commands"><a class="wlink" href="#other-readline-commands"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Other Readline Commands</h3>
+<h3 id="other-readline-commands"><a class="wlink" href="#other-readline-commands"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Other Readline Commands <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <p>These other commands are not very useful in Clink, but exist nevertheless.</p>
 <table>
 <thead>
@@ -3252,7 +3322,7 @@ <h3 id="other-readline-commands"><a class="wlink" href="#other-readline-commands
 <tbody><tr>
 <td><a class="wlink" href="#rlcmd-tab-insert"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-tab-insert"></a><code>tab-insert</code></td>
 <td align="center"><kbd>Alt</kbd>-<kbd>Ctrl</kbd>-<kbd>i</kbd></td>
-<td>Insert a tab character.<br/>Note: this command exists for compatibility with bash, but it isn&#39;t useful in Clink because CMD doesn&#39;t support entering a tab character in the input line.</td>
+<td>Insert a tab character.<br/><strong>Note:</strong> this command exists for compatibility with bash, but it isn&#39;t useful in Clink because CMD doesn&#39;t support entering a tab character in the input line.</td>
 </tr>
 <tr>
 <td><a class="wlink" href="#rlcmd-prefix-meta"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-prefix-meta"></a><code>prefix-meta</code></td>
@@ -3264,8 +3334,13 @@ <h3 id="other-readline-commands"><a class="wlink" href="#other-readline-commands
 <td align="center"></td>
 <td>This has no effect unless the <a href="#terminal_raw_esc"><code>terminal.raw_esc</code></a> Clink setting is enabled. Reads enough characters to consume a multi-key sequence such as those defined for keys like <kbd>Home</kbd> and <kbd>End</kbd>. Such sequences begin with a Control Sequence Indicator (CSI), which is <code>ESC</code> <code>[</code>. If this sequence is bound to &quot;\e[&quot;, keys producing such sequences will have no effect unless explicitly bound to a readline command, instead of inserting stray characters into the editing buffer.</td>
 </tr>
+<tr>
+<td><a class="wlink" href="#rlcmd-bracketed-paste-begin"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-bracketed-paste-begin"></a><code>bracketed-paste-begin</code></td>
+<td align="center"></td>
+<td>This function is intended to be bound to the &quot;bracketed paste&quot; escape sequence sent by some terminals, and such a binding is assigned by default. It allows Readline to insert the pasted text as a single unit without treating each character as if it had been read from the keyboard. The characters are inserted as if each one was bound to <a href="#rlcmd-self-insert"><code>self-insert</code></a> instead of executing any editing commands.<br/>Bracketed paste sets the region (the characters between point and the mark) to the inserted text. It uses the concept of an active mark: when the mark is active, Readline redisplay uses the terminal&#39;s standout mode to denote the region.<br/><strong>Note:</strong> this command exists for compatibility with bash, but Clink doesn&#39;t support bracketed paste. Instead use the <a href="#rlcmd-clink-paste"><code>clink-paste</code></a> command to perform the equivalent of a bracketed paste.</td>
+</tr>
 </tbody></table>
-<h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Clink Commands</h3>
+<h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Clink Commands <span class="uplinks"><a href="#bindable-commands">up</a> <a href="#toc">top</a></span></h3>
 <p>Clink also adds some new commands, beyond what&#39;s normally provided by Readline.</p>
 <table>
 <thead>
@@ -3291,6 +3366,11 @@ <h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 he
 <td>If there is a suggestion, insert the suggestion and accept the input line (like <a href="#rlcmd-accept-line"><code>accept-line</code></a>).</td>
 </tr>
 <tr>
+<td><a class="wlink" href="#rlcmd-clink-backward-bigword"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-backward-bigword"></a><code>clink-backward-bigword</code></td>
+<td align="center"></td>
+<td>Move back to the start of the current or previous space delimited word.</td>
+</tr>
+<tr>
 <td><a class="wlink" href="#rlcmd-clink-complete-numbers"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-complete-numbers"></a><code>clink-complete-numbers</code></td>
 <td align="center"></td>
 <td>Like <a href="#rlcmd-complete"><code>complete</code></a>, but for numbers from the console screen (3 digits or more, up to hexadecimal).</td>
@@ -3308,7 +3388,7 @@ <h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 he
 <tr>
 <td><a class="wlink" href="#rlcmd-clink-copy-word"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-copy-word"></a><code>clink-copy-word</code></td>
 <td align="center"><kbd>Alt</kbd>-<kbd>Ctrl</kbd>-<kbd>w</kbd></td>
-<td>Copies the word at the cursor point to the clipboard, or copies the <em>n</em>th word if a numeric argument is provided via the <a href="#rlcmd-digit-argument"><code>digit-argument</code></a> keys.</td>
+<td>Copies the word at the cursor point to the clipboard, or copies the <em>n</em>-th word if a numeric argument is provided via the <a href="#rlcmd-digit-argument"><code>digit-argument</code></a> keys.</td>
 </tr>
 <tr>
 <td><a class="wlink" href="#rlcmd-clink-ctrl-c"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-ctrl-c"></a><code>clink-ctrl-c</code></td>
@@ -3321,6 +3401,16 @@ <h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 he
 <td>Show internal diagnostic information.</td>
 </tr>
 <tr>
+<td><a class="wlink" href="#rlcmd-clink-dump-functions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-dump-functions"></a><code>clink-dump-functions</code></td>
+<td align="center"></td>
+<td>Print all of the functions and their key bindings.  If a numeric argument is supplied, formats the output so that it can be made part of an INPUTRC file.  Unlike <a href="#rlcmd-dump-functions"><code>dump-functions</code></a>, this uses friendly key names and includes <code>luafunc:</code> macros.</td>
+</tr>
+<tr>
+<td><a class="wlink" href="#rlcmd-clink-dump-macros"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-dump-macros"></a><code>clink-dump-macros</code></td>
+<td align="center"></td>
+<td>Print all of the key names bound to macros and the strings they output.  If a numeric argument is supplied, formats the output so that it can be made part of an INPUTRC file.  Unlike <a href="#rlcmd-dump-macros"><code>dump-macros</code></a>, this uses friendly key names and omits <code>luafunc:</code> macros.</td>
+</tr>
+<tr>
 <td><a class="wlink" href="#rlcmd-clink-exit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-exit"></a><code>clink-exit</code></td>
 <td align="center"><kbd>Alt</kbd>-<kbd>F4</kbd></td>
 <td>Replaces the input line with <code>exit</code> and executes it (exits the CMD instance).</td>
@@ -3356,6 +3446,11 @@ <h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 he
 <td>Activates the &quot;Find&quot; dialog when running in a standard console window (hosted by the OS conhost).  This is equivalent to picking &quot;Find...&quot; from the console window&#39;s system menu. When <a href="#clink_default_bindings"><code>clink.default_bindings</code></a> is enabled, this is bound to <kbd>Ctrl</kbd>-<kbd>f</kbd>.</td>
 </tr>
 <tr>
+<td><a class="wlink" href="#rlcmd-clink-forward-bigword"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-forward-bigword"></a><code>clink-forward-bigword</code></td>
+<td align="center"></td>
+<td>Move forward to the beginning of the next space delimited word, or insert the next full suggested word up to a space.</td>
+</tr>
+<tr>
 <td><a class="wlink" href="#rlcmd-clink-insert-dot-dot"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-insert-dot-dot"></a><code>clink-insert-dot-dot</code></td>
 <td align="center"><kbd>Alt</kbd>-<kbd>a</kbd></td>
 <td>Inserts <code>..\</code> at the cursor point.</td>
@@ -3433,7 +3528,7 @@ <h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 he
 <tr>
 <td><a class="wlink" href="#rlcmd-clink-popup-show-help"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-popup-show-help"></a><code>clink-popup-show-help</code></td>
 <td align="center"><kbd>Alt</kbd>-<kbd>Ctrl</kbd>-<kbd>H</kbd></td>
-<td>Show all key bindings in a searchable <a href="#popupwindow">popup list</a>.  In the popup, use <kbd>Enter</kbd> to invoke the selected key binding.</td>
+<td>Show all key bindings in a searchable <a href="#popupwindow">popup list</a>.  In the popup, use <kbd>Enter</kbd> to invoke the selected key binding.  If a numeric argument of 4 is supplied, it includes unbound commands.</td>
 </tr>
 <tr>
 <td><a class="wlink" href="#rlcmd-clink-reload"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-reload"></a><code>clink-reload</code></td>
@@ -3493,12 +3588,12 @@ <h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 he
 <tr>
 <td><a class="wlink" href="#rlcmd-clink-show-help"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-show-help"></a><code>clink-show-help</code></td>
 <td align="center"><kbd>Alt</kbd>-<kbd>h</kbd></td>
-<td>Show all key bindings.  A numeric argument affects showing categories and descriptions:  0 for neither, 1 for categories, 2 for descriptions, 3 for categories and descriptions (the default), 4 for all commands (even if not bound to a key).</td>
+<td>Show all key bindings.  A numeric argument affects showing categories and descriptions:  0 for neither, 1 for categories, 2 for descriptions, 3 for categories and descriptions (the default).  Add 4 to include unbound commands.</td>
 </tr>
 <tr>
 <td><a class="wlink" href="#rlcmd-clink-show-help-raw"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-show-help-raw"></a><code>clink-show-help-raw</code></td>
 <td align="center"></td>
-<td>Show raw key sequence strings for all key bindings.  A numeric argument affects showing categories and descriptions:  0 for neither, 1 for categories, 2 for descriptions, 3 for categories and descriptions (the default), 4 for all commands (even if not bound to a key).</td>
+<td>Show raw key sequence strings for all key bindings.  A numeric argument affects showing categories and descriptions:  0 for neither, 1 for categories, 2 for descriptions, 3 for categories and descriptions (the default).  Add 4 to include unbound commands.</td>
 </tr>
 <tr>
 <td><a class="wlink" href="#rlcmd-clink-up-directory"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-clink-up-directory"></a><code>clink-up-directory</code></td>
@@ -3511,6 +3606,11 @@ <h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 he
 <td>Show the key binding for the next key sequence input.  If a numeric argument is supplied, the raw key sequence string is shown instead of the friendly key name.</td>
 </tr>
 <tr>
+<td><a class="wlink" href="#rlcmd-cua-backward-bigword"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-cua-backward-bigword"></a><code>cua-backward-bigword</code></td>
+<td align="center"></td>
+<td>Extend the selection backward one space delimited word.</td>
+</tr>
+<tr>
 <td><a class="wlink" href="#rlcmd-cua-backward-char"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-cua-backward-char"></a><code>cua-backward-char</code></td>
 <td align="center"><kbd>Shift</kbd>-<kbd>Left</kbd></td>
 <td>Extend the selection backward one character.</td>
@@ -3541,6 +3641,11 @@ <h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 he
 <td>Extend the selection to the end of the line.</td>
 </tr>
 <tr>
+<td><a class="wlink" href="#rlcmd-cua-forward-bigword"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-cua-forward-bigword"></a><code>cua-forward-bigword</code></td>
+<td align="center"></td>
+<td>Extend the selection forward one space delimited word, or insert the next full suggested word up to a space.</td>
+</tr>
+<tr>
 <td><a class="wlink" href="#rlcmd-cua-forward-char"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rlcmd-cua-forward-char"></a><code>cua-forward-char</code></td>
 <td align="center"><kbd>Shift</kbd>-<kbd>Right</kbd></td>
 <td>Extend the selection forward one character, or insert the next full suggested word up to a space.</td>
@@ -3664,10 +3769,97 @@ <h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 he
 <p><a name="alternatedefaultcommand"></a></p>
 <p><strong>&ast;</strong> Some commands have alternative default key bindings when Clink is installed with &quot;Use enhanced default settings&quot; checked in the setup program or when <a href="#clink_default_bindings"><code>clink.default_bindings</code></a> is set to <code>windows</code>.</p>
 <p><a name="completioncolors"></a></p>
-<h2 id="completion-colors"><a class="wlink" href="#completioncolors"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Completion Colors</h2>
-<p>The <code>%LS_COLORS%</code> environment variable provides color definitions as a series of color definitions separated by colons (<code>:</code>).  Each definition is a either a two character type id or a file extension, followed by an equals sign and then the <a href="https://en.wikipedia.org/wiki/ANSI_escape_code#SGR">SGR parameters</a> for an ANSI escape code.  The two character type ids are listed below.</p>
-<p>When the <a href="#configcoloredcompletionprefix"><code>colored-completion-prefix</code></a> <a href="#configreadline">Readline setting</a> is configured to <code>on</code>, then the &quot;so&quot; color from <code>%LS_COLORS%</code> is used to color the common prefix when displaying possible completions.  The default for &quot;so&quot; is magenta, but for example <code>set LS_COLORS=so=90</code> sets the color to bright black (which shows up as a dark gray).</p>
-<p>When <a href="#configcoloredstats"><code>colored-stats</code></a> is configured to <code>on</code>, then the color definitions from <code>%LS_COLORS%</code> are used to color file completions according to their file type or extension.    Multiple definitions are separated by colons.  Also, since <code>%LS_COLORS%</code> doesn&#39;t cover readonly files, hidden files, doskey aliases, or shell commands the <a href="#color_readonly">color.readonly</a>, <a href="#color_hidden">color.hidden</a>, <a href="#color_doskey">color.doskey</a>, and <a href="#color_cmd">color.cmd</a> Clink settings exist to cover those.</p>
+<h2 id="completion-colors"><a class="wlink" href="#completioncolors"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Completion Colors <span class="uplinks"><a href="#configreadline">up</a> <a href="#toc">top</a></span></h2>
+<p>The <a href="#match_coloring_rules"><code>match.coloring_rules</code></a> setting provides a string that determines how match completions are displayed.</p>
+<p>The string can contain a series of one or more rules separated by colons (<code>:</code>).  If an environment variable <code>%CLINK_MATCH_COLORS%</code> exists, its value supersedes this setting.</p>
+<p>Each rule is a series of one or more conditions separated by spaces, followed by an equals sign and then the <a href="https://en.wikipedia.org/wiki/ANSI_escape_code#SGR">SGR parameters</a> for an ANSI escape code.  All of the conditions must be true for the rule to match (in other words, a space is like an AND operator).</p>
+<p>Each condition can be any of the following:</p>
+<ul>
+<li>A pattern, for example <code>*.zip</code> (for zip files).  This is an fnmatch pattern (like .gitignore globbing patterns).  The pattern is compared only to the filename portion after stripping the path.  For example, <code>*.zip</code>.</li>
+<li>A type, for example <code>di</code> (for directories).  The available types are listed below.</li>
+<li>A <code>not</code> operator, which negates the next condition.  For example, <code>not di</code> applies to anything that isn&#39;t a directory, or <code>not *.zip</code> applies to any name that doesn&#39;t match <code>*.zip</code>.</li>
+</ul>
+<p>Any quoted string is assumed to be a pattern, so <code>&quot;hi&quot;</code> is a pattern instead of the Hidden type, and etc.</p>
+<p>Rules are evaluated in the order listed, with one exception:  Rules with exactly one type and no patterns are evaluated last; this makes it easier to list the rules -- you can put the simple defaults first, followed by specializations.</p>
+<table>
+<thead>
+<tr>
+<th>Type</th>
+<th>Description</th>
+<th>Default</th>
+</tr>
+</thead>
+<tbody><tr>
+<td><code>di</code></td>
+<td>Directory.</td>
+<td><code>01;34</code> (bright blue)</td>
+</tr>
+<tr>
+<td><code>ex</code></td>
+<td>Executable file.</td>
+<td><code>01;32</code> (bright green)</td>
+</tr>
+<tr>
+<td><code>fi</code></td>
+<td>Normal file.</td>
+<td></td>
+</tr>
+<tr>
+<td><code>ro</code></td>
+<td>Readonly file or directory.</td>
+<td>The <a href="#color_readonly">color.readonly</a> setting.</td>
+</tr>
+<tr>
+<td><code>hi</code></td>
+<td>Hidden file or directory.</td>
+<td>The <a href="#color_hidden">color.hidden</a> setting.</td>
+</tr>
+<tr>
+<td><code>mi</code></td>
+<td>Missing file or directory.</td>
+<td></td>
+</tr>
+<tr>
+<td><code>ln</code></td>
+<td>Symlinks.  When <code>ln=target</code> then symlinks are colored according to the target of the symlink.</td>
+<td><code>target</code></td>
+</tr>
+<tr>
+<td><code>or</code></td>
+<td>Orphaned symlink (the target of the symlink is missing).</td>
+<td></td>
+</tr>
+<tr>
+<td><code>no</code></td>
+<td>Normal color; covers anything not covered by any other types.</td>
+<td></td>
+</tr>
+<tr>
+<td><code>any</code></td>
+<td>This clears all types in the rule so far, including the implicit default <code>fi</code> type when no type is given.  For example, <code>any history*</code> applies to directories as well as to files (any directory or file whose name begins with &quot;history&quot;).</td>
+<td></td>
+</tr>
+</tbody></table>
+<p>For backward compatibility with <a href="#LS_COLORS"><code>%LS_COLORS%</code></a>, either <code>so</code> or <code>*.readline-colored-completion-prefix</code> may be used to override the<a href="#color_common_match_prefix"><code>color.common_match_prefix</code></a> setting.</p>
+<p>Here is an example that defines colors for various types.</p>
+<pre><code class="language-plaintext">clink set match.coloring_rules  di=93:ro ex=1;32:ex=1:ro=32:di *.tmp=90
+</code></pre>
+<ul>
+<li><code>di=93</code> uses bright yellow for directories.</li>
+<li><code>ro ex=1;32</code> uses bright green for readonly executable files.</li>
+<li><code>ex=1</code> uses bold for executable files (depending on the terminal&#39;s color theme, bold by itself usually ends up being bright white).</li>
+<li><code>ro=32</code> uses dark green for readonly files.</li>
+<li><code>di *.tmp=90</code> uses bright magenta for directory names ending in <code>.tmp</code>.</li>
+</ul>
+<blockquote>
+<p><strong>Note:</strong> The <code>match.coloring_rules</code> setting was added in Clink v1.6.1.  It works similar to how the <a href="#LS_COLORS"><code>%LS_COLORS%</code></a> environment variable works, except it adds &quot;hi&quot;, &quot;ro&quot;, &quot;any&quot;, and &quot;not&quot;, and patterns can be fnmatch patterns instead of just &quot;*.ext&quot; patterns.</p>
+</blockquote>
+<p><a name="LS_COLORS"></a></p>
+<h3 id="ls_colors-for-backward-compatibility"><a class="wlink" href="#LS_COLORS"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>LS_COLORS (for backward compatibility) <span class="uplinks"><a href="#completioncolors">up</a> <a href="#toc">top</a></span></h3>
+<p>The <code>%LS_COLORS%</code> environment variable is supported for backwards compatibility with Readline.  It can provide color definitions as a series of color definitions separated by colons (<code>:</code>).  Each definition is a either a two character type id or a file extension, followed by an equals sign and then the <a href="https://en.wikipedia.org/wiki/ANSI_escape_code#SGR">SGR parameters</a> for an ANSI escape code.  The two character type ids are listed below.</p>
+<p>If either <a href="#match_coloring_rules"><code>match.coloring_rules</code></a> or <code>%CLINK_MATCH_COLORS</code> are set, then they take precedence and <code>%LS_COLORS%</code> is ignored.</p>
+<p>When <a href="#configcoloredstats"><code>colored-stats</code></a> is configured to <code>on</code>, then file completions are colored according to their file type or extension from <code>%LS_COLORS%</code>.  Also, since <code>%LS_COLORS%</code> doesn&#39;t cover readonly files, hidden files, doskey aliases, or shell commands the <a href="#color_readonly">color.readonly</a>, <a href="#color_hidden">color.hidden</a>, <a href="#color_doskey">color.doskey</a>, and <a href="#color_cmd">color.cmd</a> Clink settings exist to cover those.</p>
+<p>When <a href="#configcoloredcompletionprefix"><code>colored-completion-prefix</code></a> is configured to <code>on</code>, then the &quot;so&quot; color from <code>%LS_COLORS%</code> is used to color the common prefix when displaying possible completions.  The default for &quot;so&quot; is bright magenta, but for example <code>set LS_COLORS=so=90</code> sets the color to bright black (which shows up as a dark gray).</p>
 <table>
 <thead>
 <tr>
@@ -3743,7 +3935,7 @@ <h2 id="completion-colors"><a class="wlink" href="#completioncolors"><svg width=
 <li><code>*.md=4</code> uses underline for .md files.</li>
 </ul>
 <p><a name="popupwindow"></a></p>
-<h2 id="popup-windows"><a class="wlink" href="#popupwindow"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Popup Windows</h2>
+<h2 id="popup-windows"><a class="wlink" href="#popupwindow"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Popup Windows <span class="uplinks"><a href="#configreadline">up</a> <a href="#toc">top</a></span></h2>
 <p>Some commands show a searchable popup window that lists the available completions, directory history, or command history.</p>
 <p>For example, <a href="#rlcmd-win-history-list"><code>win-history-list</code></a> (<kbd>F7</kbd>) and <a href="#rlcmd-clink-popup-directories"><code>clink-popup-directories</code></a> (<kbd>Ctrl</kbd>-<kbd>Alt</kbd>-<kbd>PgUp</kbd>) show popup windows.</p>
 <p>Here&#39;s how the popup windows work:</p>
@@ -3819,7 +4011,7 @@ <h2 id="popup-windows"><a class="wlink" href="#popupwindow"><svg width=16 height
 <p>The <a href="#rlcmd-win-history-list"><code>win-history-list</code></a> command has a different search feature.  Typing digits <code>0</code>-<code>9</code> jumps to the numbered history entry, or typing a letter jumps to the preceding history entry that begins with the typed letter.  <kbd>Left</kbd>/<kbd>Right</kbd> inserts the highlighted command history entry without executing it.  These are for compatibility with the <kbd>F7</kbd> behavior built into Windows console prompts.</p>
 <p>Use the <a href="#rlcmd-clink-popup-history"><code>clink-popup-history</code></a> command instead if you prefer for typing to do an incremental search.</p>
 <p><a name="extending-clink"></a></p>
-<h1 id="extending-clink-with-lua"><a class="wlink" href="#extending-clink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Extending Clink With Lua</h1>
+<h1 id="extending-clink-with-lua"><a class="wlink" href="#extending-clink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Extending Clink With Lua <span class="uplinks"><a href="#toc">top</a></span></h1>
 <p>Clink can be extended with <a href="https://www.lua.org/docs.html">Lua</a> scripts to customize startup actions, create completion matches, customize the prompt, and more.  The following sections describe these in more detail and show some examples.</p>
 <table class="linkmenu">
 <tr><td><a href="#lua-scripts-location">Location of Lua Scripts</a></td><td>Locations from which scripts are loaded.</td></tr>
@@ -3832,7 +4024,7 @@ <h1 id="extending-clink-with-lua"><a class="wlink" href="#extending-clink"><svg
 </table>
 
 <p><a name="lua-scripts-location"></a></p>
-<h2 id="location-of-lua-scripts"><a class="wlink" href="#lua-scripts-location"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Location of Lua Scripts</h2>
+<h2 id="location-of-lua-scripts"><a class="wlink" href="#lua-scripts-location"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Location of Lua Scripts <span class="uplinks"><a href="#extending-clink">up</a> <a href="#toc">top</a></span></h2>
 <p>Clink loads all Lua scripts it finds in these directories:</p>
 <ol>
 <li>All directories listed in the <a href="#clink_dot_path"><code>clink.path</code></a> setting, separated by semicolons.</li>
@@ -3849,7 +4041,7 @@ <h2 id="location-of-lua-scripts"><a class="wlink" href="#lua-scripts-location"><
 <li>Clink performs tilde expansion on the Lua script directory names.  If the path begins with <code>~\</code> then it is replaced with the current user&#39;s home directory (<code>%HOME%</code> or <code>%HOMEDRIVE%%HOMEPATH%</code> or <code>%USERPROFILE%</code>).</li>
 </ul>
 </blockquote>
-<h3 id="completion-directories"><a class="wlink" href="#completion-directories"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Completion directories</h3>
+<h3 id="completion-directories"><a class="wlink" href="#completion-directories"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Completion directories <span class="uplinks"><a href="#lua-scripts-location">up</a> <a href="#toc">top</a></span></h3>
 <p>You may optionally put Lua completion scripts in a <code>completions\</code> directory when using Clink v1.3.23 and higher.  That prevents them from being loaded when Clink starts, and instead they are only loaded when needed.  That can make Clink load faster if you have a large quantity of Lua scripts that define argmatchers.</p>
 <p>When a command name is typed, if a corresponding argmatcher is not already loaded then the completions directories are searched for a Lua script by the same name.  If found, then the Lua script is loaded.  This is similar to how completion scripts work in shells like bash, zsh, and fish.</p>
 <p>For example, if you type <code>xyz</code> and an argmatcher for <code>xyz</code> is not yet loaded, then if <code>xyz.lua</code> exists in one of the completions directories it will be loaded.</p>
@@ -3865,7 +4057,7 @@ <h3 id="completion-directories"><a class="wlink" href="#completion-directories">
 <p>For example, the scripts from the <a href="https://github.com/vladimir-kotikov/clink-completions">clink-completions</a> project belong in a normal script directory, because they have other functionality besides just completions, and they won&#39;t work correctly in a &quot;completions&quot; directory.</p>
 </blockquote>
 <p><a name="tips-for-starting-to-write-lua-scripts"></a></p>
-<h2 id="writing-lua-scripts"><a class="wlink" href="#tips-for-starting-to-write-lua-scripts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Writing Lua Scripts</h2>
+<h2 id="writing-lua-scripts"><a class="wlink" href="#tips-for-starting-to-write-lua-scripts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Writing Lua Scripts <span class="uplinks"><a href="#extending-clink">up</a> <a href="#toc">top</a></span></h2>
 <p>Lua is a versatile and lightweight language.  It&#39;s very approachable and easy to learn for beginners, but it also has powerful capabilities available if you need them.</p>
 <p>Here are some tips for getting started writing Lua scripts:</p>
 <ul>
@@ -3884,7 +4076,7 @@ <h2 id="writing-lua-scripts"><a class="wlink" href="#tips-for-starting-to-write-
 <li>Clink extends the Lua language by adding many new <a href="#lua-api">APIs and features</a> for use within Clink.</li>
 </ul>
 <p><a name="argumentcompletion"></a></p>
-<h2 id="argument-completion"><a class="wlink" href="#argumentcompletion"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Argument Completion</h2>
+<h2 id="argument-completion"><a class="wlink" href="#argumentcompletion"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Argument Completion <span class="uplinks"><a href="#extending-clink">up</a> <a href="#toc">top</a></span></h2>
 <p>Clink provides a framework for writing complex argument match generators in Lua.  It works by creating a parser object that describes a command&#39;s arguments and flags and associating the parser with one or more commands.  When Clink detects a parser is associated with the command being edited, it uses the parser to generate matches and apply <a href="#classifywords">input line coloring</a>.</p>
 <table class="linkmenu">
 <tr><td><a href="#argmatcher_basics">The Basics</a></td><td>A quick example to show the basics.</td></tr>
@@ -3904,7 +4096,7 @@ <h2 id="argument-completion"><a class="wlink" href="#argumentcompletion"><svg wi
 </table>
 
 <p><a name="argmatcher_basics"></a></p>
-<h3 id="the-basics-1"><a class="wlink" href="#argmatcher_basics"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The Basics</h3>
+<h3 id="the-basics-1"><a class="wlink" href="#argmatcher_basics"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The Basics <span class="uplinks"><a href="#argumentcompletion">up</a> <a href="#toc">top</a></span></h3>
 <p>Here is an example of a simple parser for the command <code>foobar</code>;</p>
 <pre><code class="language-lua">clink.argmatcher(&quot;foobar&quot;)
 :addarg({ &quot;hello&quot;, &quot;hi&quot; })               -- Completions for arg #1.
@@ -3930,7 +4122,7 @@ <h3 id="the-basics-1"><a class="wlink" href="#argmatcher_basics"><svg width=16 h
 <p>If a command doesn&#39;t have an argmatcher but is a doskey macro, Clink automatically expands the doskey macro and looks for an argmatcher for the expanded command.  A macro like <code>gco=git checkout $*</code> automatically reuses a <code>git</code> argmatcher and produces completions for its <code>checkout</code> argument.  However, it only expands the doskey macro up to the first <code>$</code>, so complex aliases like <code>foo=app 2$gnul text $*</code> or <code>foo=$2 $1</code> might behave strangely.</p>
 <p>Also see <a href="#clink.argmatcher">clink.argmatcher()</a>, <a href="#_argmatcher:addflags">:addflags()</a> and <a href="#_argmatcher:addarg">:addarg()</a>.</p>
 <p><a name="argmatcher_autofiles"></a></p>
-<h3 id="automatic-filename-completion"><a class="wlink" href="#argmatcher_autofiles"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Automatic Filename Completion</h3>
+<h3 id="automatic-filename-completion"><a class="wlink" href="#argmatcher_autofiles"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Automatic Filename Completion <span class="uplinks"><a href="#argumentcompletion">up</a> <a href="#toc">top</a></span></h3>
 <p>A fresh, empty argmatcher provides no completions.</p>
 <pre><code class="language-lua">clink.argmatcher(&quot;foobar&quot;)               -- The &quot;foobar&quot; command provides no completions.
 </code></pre>
@@ -3954,7 +4146,7 @@ <h3 id="automatic-filename-completion"><a class="wlink" href="#argmatcher_autofi
 :nofiles()                               -- Using :nofiles() prevents further completions.
 </code></pre>
 <p><a name="argmatcher_descriptions"></a></p>
-<h3 id="descriptions-for-flags-and-arguments"><a class="wlink" href="#argmatcher_descriptions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Descriptions for Flags and Arguments</h3>
+<h3 id="descriptions-for-flags-and-arguments"><a class="wlink" href="#argmatcher_descriptions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Descriptions for Flags and Arguments <span class="uplinks"><a href="#argumentcompletion">up</a> <a href="#toc">top</a></span></h3>
 <p>Flags and arguments may optionally have descriptions associated with them.  The descriptions, if any, are displayed when listing possible completions.</p>
 <p>Use <a href="#_argmatcher:adddescriptions">_argmatcher:adddescriptions()</a> to add descriptions for flags and/or arguments.  Refer to its documentation for further details about how to use it, including how to also show arguments that a flag accepts.</p>
 <p>For example, with the following matcher, typing <code>foo -</code><kbd>Alt</kbd>-<kbd>=</kbd> will list all of the flags, plus descriptions for each.</p>
@@ -3971,9 +4163,9 @@ <h3 id="descriptions-for-flags-and-arguments"><a class="wlink" href="#argmatcher
     { &quot;delete&quot;,             description = &quot;Delete the specified file&quot; },
 )
 </code></pre>
-<h3 id="more-advanced-stuff"><a class="wlink" href="#more-advanced-stuff"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>More Advanced Stuff</h3>
+<h3 id="more-advanced-stuff"><a class="wlink" href="#more-advanced-stuff"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>More Advanced Stuff <span class="uplinks"><a href="#argumentcompletion">up</a> <a href="#toc">top</a></span></h3>
 <p><a name="argmatcher_linking"></a></p>
-<h4 id="linking-parsers"><a class="wlink" href="#argmatcher_linking"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Linking Parsers</h4>
+<h4 id="linking-parsers"><a class="wlink" href="#argmatcher_linking"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Linking Parsers <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
 <p>There are often situations where the parsing of a command&#39;s arguments is dependent on the previous words (<code>git merge ...</code> compared to <code>git log ...</code> for example). For these scenarios Clink allows you to link parsers to arguments&#39; words using Lua&#39;s concatenation operator.</p>
 <pre><code class="language-lua">local a_parser = clink.argmatcher():addarg({ &quot;foo&quot;, &quot;bar&quot; })
 local b_parser = clink.argmatcher():addarg({ &quot;abc&quot;, &quot;123&quot; })
@@ -3983,7 +4175,7 @@ <h4 id="linking-parsers"><a class="wlink" href="#argmatcher_linking"><svg width=
 </code></pre>
 <p>As the example above shows, it is also possible to use a parser without concatenating it to a word.</p>
 <p>When Clink follows a link to a parser it will only return to the previous parser when the linked parser runs out of arguments.  Using <code>:nofiles()</code> prevents returning to the previous parser.</p>
-<h5 id="flags-with-arguments"><a class="wlink" href="#flags-with-arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Flags With Arguments</h5>
+<h5 id="flags-with-arguments"><a class="wlink" href="#flags-with-arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Flags With Arguments <span class="uplinks"><a href="#argmatcher_linking">up</a> <a href="#toc">top</a></span></h5>
 <p>Parsers can be concatenated with flags, too.</p>
 <p>Here&#39;s an example of a flag that takes an argument:</p>
 <pre><code class="language-lua">clink.argmatcher(&quot;git&quot;)
@@ -4011,7 +4203,7 @@ <h5 id="flags-with-arguments"><a class="wlink" href="#flags-with-arguments"><svg
 })
 </code></pre>
 <p><a name="argmatcher_functions"></a></p>
-<h4 id="functions-as-argument-options"><a class="wlink" href="#argmatcher_functions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Functions As Argument Options</h4>
+<h4 id="functions-as-argument-options"><a class="wlink" href="#argmatcher_functions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Functions As Argument Options <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
 <p>Argument options are not limited solely to strings. Clink also accepts functions too so more context-aware argument options can be used.</p>
 <p>The function is called each time matches are generated for the argument position.</p>
 <pre><code class="language-lua">local function rainbow_function(word)
@@ -4057,25 +4249,25 @@ <h4 id="functions-as-argument-options"><a class="wlink" href="#argmatcher_functi
 </tr>
 </tbody></table>
 <p><a name="addarg_fromhistory"></a></p>
-<h4 id="generate-matches-from-history"><a class="wlink" href="#addarg_fromhistory"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Generate Matches From History</h4>
+<h4 id="generate-matches-from-history"><a class="wlink" href="#addarg_fromhistory"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Generate Matches From History <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
 <p>An argument position can collect matches from the history file.  When an argument table contains <code>fromhistory=true</code> then additional matches are generated by parsing the history file to find values for that argument slot from commands in the history file.</p>
 <p>This example generates matches for arguments to a <code>--host</code> flag by parsing the history file for host names used in the past, and also includes the current computer name.</p>
 <pre><code class="language-lua">local host_parser = clink.argmatcher():addarg({ fromhistory=true, os.getenv(&quot;COMPUTERNAME&quot;) })
 clink.argmatcher(&quot;program&quot;):addflags({ &quot;--host&quot;..host_parser })
 </code></pre>
 <p><a name="addarg_nosort"></a></p>
-<h4 id="disable-sorting-matches"><a class="wlink" href="#addarg_nosort"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Disable Sorting Matches</h4>
+<h4 id="disable-sorting-matches"><a class="wlink" href="#addarg_nosort"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Disable Sorting Matches <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
 <p>Match completions are normally listed in sorted order.  In some cases it may be desirable to disable sorting and list match completions in a specific order.  To disable sorting, include <code>nosort=true</code> in the argument table.  When sorting is disabled, matches are listed in the order they were added.</p>
 <pre><code class="language-lua">local the_parser = clink.argmatcher()
 the_parser:addarg({ nosort=true, &quot;red&quot;, &quot;orange&quot;, &quot;yellow&quot;, &quot;green&quot;, &quot;blue&quot;, &quot;indigo&quot;, &quot;violet&quot; })
 </code></pre>
 <p><a name="argmatcher_fullyqualified"></a></p>
-<h4 id="fully-qualified-pathnames"><a class="wlink" href="#argmatcher_fullyqualified"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Fully Qualified Pathnames</h4>
+<h4 id="fully-qualified-pathnames"><a class="wlink" href="#argmatcher_fullyqualified"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Fully Qualified Pathnames <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
 <p>Sometimes there may be more than one program installed with the same name.  For example, there might be multiple versions of <code>grep</code> installed.</p>
 <p>In Clink v1.3.38 and higher, you can define argmatchers using fully qualified pathnames.  For example, this makes it possible to define one argmatcher for <code>c:\EmployerTools\grep.exe</code> and another for <code>d:\PersonalTools\grep.exe</code>, and the corresponding argmatcher will be used when appropriate.</p>
 <p>In the example above, you could define an argmatcher for <code>c:\EmployerTools\grep.exe</code>, and also define an argmatcher for <code>grep</code> (or have a <code>grep.lua</code> file in a <code>completions\</code> directory).  The plain <code>grep</code> one would be used whenever the typed <code>grep</code> doesn&#39;t resolve to the EmployerTools copy.</p>
 <p><a name="addarg_loopchars"></a></p>
-<h4 id="delimited-arguments"><a class="wlink" href="#addarg_loopchars"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Delimited Arguments</h4>
+<h4 id="delimited-arguments"><a class="wlink" href="#addarg_loopchars"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Delimited Arguments <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
 <p>In some cases an argument for programs may accept a list of values separated by <code>;</code> or <code>+</code> or etc.  Normally <code>;</code> or <code>+</code> are argument separators (like space), and advance the argmatcher to the next argument slot.</p>
 <p>In Clink v1.3.37 and higher, you can make them stay on the current argument slot by including <code>loopchars=&quot;;&quot;</code> (or set <code>loopchars=</code> a list of value delimiters).</p>
 <pre><code class="language-lua">-- This argmatcher accepts syntax like &quot;foo color filename&quot;.
@@ -4093,7 +4285,7 @@ <h4 id="delimited-arguments"><a class="wlink" href="#addarg_loopchars"><svg widt
 :addarg(clink.filematches)
 </code></pre>
 <p><a name="addarg_nowordbreakchars"></a></p>
-<h4 id="overcoming-word-breaks"><a class="wlink" href="#addarg_nowordbreakchars"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Overcoming Word Breaks</h4>
+<h4 id="overcoming-word-breaks"><a class="wlink" href="#addarg_nowordbreakchars"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Overcoming Word Breaks <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
 <p>Clink and parses the input line into a <a href="#line_state"><code>line_state</code></a> by ending a word whenever one of the following characters is encountered (except when inside quotes).  These are the same word break characters as CMD.exe uses.</p>
 <ul>
 <li>Whitespace characters SPACE, TAB, and NEWLINE.</li>
@@ -4119,11 +4311,11 @@ <h4 id="overcoming-word-breaks"><a class="wlink" href="#addarg_nowordbreakchars"
 :addarg(clink.filematches)
 </code></pre>
 <p><a name="argmatcher_adaptive"></a></p>
-<h4 id="adaptive-argmatchers"><a class="wlink" href="#argmatcher_adaptive"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Adaptive Argmatchers</h4>
+<h4 id="adaptive-argmatchers"><a class="wlink" href="#argmatcher_adaptive"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Adaptive Argmatchers <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
 <p>Some argmatchers may need to adapt on the fly.  For example, a program may have different features available depending on the current directory, or may want to define its arguments and flags by parsing the <code>--help</code> text from running a program.</p>
 <p>An argmatcher can define a &quot;delayed initialization&quot; callback function that gets calls when the argmatcher gets used, allowing it to defer potentially expensive initialization work until it&#39;s actually needed.  An argmatcher can also define a separate &quot;delayed initialization&quot; function for each argument position.</p>
 <p><a name="argmatcher_setdelayinit"></a></p>
-<h5 id="delayed-initialization-for-the-argmatcher"><a class="wlink" href="#argmatcher_setdelayinit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Delayed initialization for the argmatcher</h5>
+<h5 id="delayed-initialization-for-the-argmatcher"><a class="wlink" href="#argmatcher_setdelayinit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Delayed initialization for the argmatcher <span class="uplinks"><a href="#argmatcher_adaptive">up</a> <a href="#toc">top</a></span></h5>
 <p>You can use <a href="#_argmatcher:setdelayinit">_argmatcher:setdelayinit()</a> to set a function that performs delayed initialization for the argmatcher.  The function receives up to two parameters:</p>
 <ul>
 <li><code>argmatcher</code> is the argmatcher to be initialized.</li>
@@ -4162,7 +4354,7 @@ <h5 id="delayed-initialization-for-the-argmatcher"><a class="wlink" href="#argma
 end
 </code></pre>
 <p><a name="addarg_delayinit"></a></p>
-<h5 id="delayed-initialization-for-an-argument-position"><a class="wlink" href="#addarg_delayinit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Delayed initialization for an argument position</h5>
+<h5 id="delayed-initialization-for-an-argument-position"><a class="wlink" href="#addarg_delayinit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Delayed initialization for an argument position <span class="uplinks"><a href="#argmatcher_adaptive">up</a> <a href="#toc">top</a></span></h5>
 <p>If the overall flags and meaning of the argument positions don&#39;t need to be updated, and only the possible values need to be updated within certain argument positions, then you can include <code>delayinit=<span class="arg">function</span></code> in the argument table.</p>
 <p>The <span class="arg">function</span> should return a table of matches which will be added to the values for the argument position.  The table of matches supports the same syntax as <a href="#_argmatcher:addarg">_argmatcher:addarg()</a>.  The function receives two parameters:</p>
 <ul>
@@ -4203,7 +4395,7 @@ <h5 id="delayed-initialization-for-an-argument-position"><a class="wlink" href="
 m:setflagprefix(&quot;-&quot;)
 </code></pre>
 <p><a name="responsive-argmatchers"></a></p>
-<h4 id="responding-to-arguments-in-argmatchers"><a class="wlink" href="#responsive-argmatchers"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Responding to Arguments in Argmatchers</h4>
+<h4 id="responding-to-arguments-in-argmatchers"><a class="wlink" href="#responsive-argmatchers"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Responding to Arguments in Argmatchers <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
 <p>Argmatchers can be more involved in parsing the command line, if they wish.</p>
 <p>An argmatcher can supply &quot;on advance&quot; or &quot;on arg&quot; functions to be called when the argmatcher parses an argument position.  The functions can influence parsing the rest of the input line.  For example, the presence of a flag <code>--only-dirs</code> might change what match completions should be provided somewhere else in the input line.</p>
 <ul>
@@ -4215,7 +4407,7 @@ <h4 id="responding-to-arguments-in-argmatchers"><a class="wlink" href="#responsi
 <blockquote>
 <p><strong>Note:</strong> These callback functions are called very often, so they need to be very fast or they can cause responsiveness problems while typing.</p>
 </blockquote>
-<h5 id="the-on-advance-function"><a class="wlink" href="#the-on-advance-function"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The &quot;on advance&quot; function</h5>
+<h5 id="the-on-advance-function"><a class="wlink" href="#the-on-advance-function"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The &quot;on advance&quot; function <span class="uplinks"><a href="#responsive-argmatchers">up</a> <a href="#toc">top</a></span></h5>
 <p>Supply an &quot;on advance&quot; function by including <code>onadvance=<span class="arg">function</span></code> in the argument table with <a href="#_argmatcher:addarg">_argmatcher:addarg()</a>.  The function can return an integer to choose how to advance through the argument positions.</p>
 <p>To use this, Clink v1.5.14 or higher is required.</p>
 <p>The function receives five arguments:</p>
@@ -4229,7 +4421,7 @@ <h5 id="the-on-advance-function"><a class="wlink" href="#the-on-advance-function
 <p>The function may return any of the following values:</p>
 <ul>
 <li>Return <code>1</code> to advance to the next argument position <em>before</em> parsing the word (normally the parser advances <em>after</em> parsing a word).  Multiple advances are possible for the same word:  if the &quot;on advance&quot; functions for argument positions 2, 3, and 4 all return <code>1</code>, then argument position 5 will parse the word.</li>
-<li>Return <code>0</code> to repeat using same argument position to parse both the current word and the next word.  Multiple repititions are possible for the same argument position:  if the &quot;on advance&quot; function for argument position 3 returns <code>0</code> for three words in a row, then all three of the words are parsed using argument position 3.</li>
+<li>Return <code>0</code> to repeat using same argument position to parse both the current word and the next word.  Multiple repetitions are possible for the same argument position:  if the &quot;on advance&quot; function for argument position 3 returns <code>0</code> for three words in a row, then all three of the words are parsed using argument position 3.</li>
 <li>Return <code>-1</code> to behave as though <a href="#_argmatcher:chaincommand">:chaincommand()</a> were used, and start parsing a new command line beginning at <code>word_index</code>.  To start at the <em>next</em> word index, see the &quot;<a href="#chainnextexample">chain next</a>&quot; example below.</li>
 <li>Return <code>nil</code> (either <code>return nil</code> or just <code>return</code>) to advance to the next argument position <em>after</em> parsing the word (this is the default behavior).</li>
 </ul>
@@ -4255,12 +4447,11 @@ <h5 id="the-on-advance-function"><a class="wlink" href="#the-on-advance-function
 })
 :chaincommand()
 </code></pre>
-<a name="chainnextexample"/>
-
+<p><a name="chainnextexample"></a></p>
 <p>This example demonstrates how to chain on the next word, or also on the current word:</p>
 <ul>
 <li><code>foo chain bar</code> chains starting at word 3 (&quot;bar&quot;).</li>
-<li><code>foo whatever.exe</code> chains starting at word w (&quot;whatever.exe&quot;).</li>
+<li><code>foo whatever.exe</code> chains starting at word 2 (&quot;whatever.exe&quot;).</li>
 </ul>
 <pre><code class="language-lua">local function chain_on_word(arg_index, word, word_index, line_state, user_data)
     if user_data.do_chain then
@@ -4280,7 +4471,7 @@ <h5 id="the-on-advance-function"><a class="wlink" href="#the-on-advance-function
 })
 :nofiles()
 </code></pre>
-<h5 id="the-on-arg-function"><a class="wlink" href="#the-on-arg-function"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The &quot;on arg&quot; function</h5>
+<h5 id="the-on-arg-function"><a class="wlink" href="#chainnextexample"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The &quot;on arg&quot; function <span class="uplinks"><a href="#responsive-argmatchers">up</a> <a href="#toc">top</a></span></h5>
 <p>Supply an &quot;on arg&quot; function by including <code>onarg=<span class="arg">function</span></code> in the argument table with <a href="#_argmatcher:addarg">_argmatcher:addarg()</a>.  The function can examine the word and do custom processing.</p>
 <p>To use this, Clink v1.3.3 or higher is required.</p>
 <p>The function receives five arguments:</p>
@@ -4307,7 +4498,7 @@ <h5 id="the-on-arg-function"><a class="wlink" href="#the-on-arg-function"><svg w
 })
 :nofiles()
 </code></pre>
-<h5 id="the-on-link-function"><a class="wlink" href="#the-on-link-function"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The &quot;on link&quot; function</h5>
+<h5 id="the-on-link-function"><a class="wlink" href="#the-on-link-function"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The &quot;on link&quot; function <span class="uplinks"><a href="#responsive-argmatchers">up</a> <a href="#toc">top</a></span></h5>
 <p>Supply an &quot;on link&quot; function by including <code>onlink=<span class="arg">function</span></code> in the argument table with <a href="#_argmatcher:addarg">_argmatcher:addarg()</a>.  The function can return an argmatcher to override when to link to another parser, and which parser to link to.</p>
 <p>To use this, Clink v1.5.14 or higher is required.</p>
 <p>The function receives six arguments:</p>
@@ -4352,7 +4543,7 @@ <h5 id="the-on-link-function"><a class="wlink" href="#the-on-link-function"><svg
 :nofiles()
 </code></pre>
 <p><a name="argmatcher_shorthand"></a></p>
-<h4 id="shorthand"><a class="wlink" href="#argmatcher_shorthand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Shorthand</h4>
+<h4 id="shorthand"><a class="wlink" href="#argmatcher_shorthand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Shorthand <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
 <p>It is also possible to omit the <code>addarg</code> and <code>addflags</code> function calls and use a more declarative shorthand form:</p>
 <pre><code class="language-lua">-- Shorthand form; requires tables.
 clink.argmatcher()
@@ -4368,7 +4559,7 @@ <h4 id="shorthand"><a class="wlink" href="#argmatcher_shorthand"><svg width=16 h
 </code></pre>
 <p>With the shorthand form flags are implied rather than declared.  When a shorthand table&#39;s first value is a string starting with <code>-</code> or <code>/</code> then the table is interpreted as flags.  Note that it&#39;s still possible with shorthand form to mix flag prefixes, and even add additional flag prefixes, such as <code>{ <span class="hljs-string">'-a'</span>, <span class="hljs-string">'/b'</span>, <span class="hljs-string">'=c'</span> }</code>.</p>
 <p><a name="matchgenerators"></a></p>
-<h2 id="match-generators"><a class="wlink" href="#matchgenerators"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Match Generators</h2>
+<h2 id="match-generators"><a class="wlink" href="#matchgenerators"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Match Generators <span class="uplinks"><a href="#extending-clink">up</a> <a href="#toc">top</a></span></h2>
 <p>These are Lua functions that are called as part of Readline&#39;s completion process (for example when pressing <kbd>Tab</kbd>).</p>
 <p>Using a match generator enables lets you do custom parsing for the input line, or provide completions for the first word in the input line.  Otherwise, using an <a href="#argumentcompletion">argmatcher</a> will probably be both easier and more powerful.</p>
 <table class="linkmenu">
@@ -4379,12 +4570,12 @@ <h2 id="match-generators"><a class="wlink" href="#matchgenerators"><svg width=16
 </table>
 
 <p><a name="generator_basics"></a></p>
-<h3 id="the-basics-2"><a class="wlink" href="#generator_basics"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The Basics</h3>
+<h3 id="the-basics-2"><a class="wlink" href="#generator_basics"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The Basics <span class="uplinks"><a href="#matchgenerators">up</a> <a href="#toc">top</a></span></h3>
 <p>First create a match generator object:</p>
 <pre><code class="language-lua">local my_generator = clink.generator(priority)
 </code></pre>
 <p>The <span class="arg">priority</span> argument is a number that influences when the generator gets called, with lower numbers going before higher numbers.</p>
-<h4 id="the-generate-function"><a class="wlink" href="#the-generate-function"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The :generate() Function</h4>
+<h4 id="the-generate-function"><a class="wlink" href="#the-generate-function"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The :generate() Function <span class="uplinks"><a href="#generator_basics">up</a> <a href="#toc">top</a></span></h4>
 <p>Next define a match generator function on the object, taking the following form:</p>
 <pre><code class="language-lua">function my_generator:generate(line_state, match_builder)
     -- Use the line_state object to examine the current line and create matches.
@@ -4442,7 +4633,7 @@ <h4 id="the-generate-function"><a class="wlink" href="#the-generate-function"><s
     return matchCount &gt; 0
 end
 </code></pre>
-<h4 id="the-getwordbreakinfo-function"><a class="wlink" href="#the-getwordbreakinfo-function"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The :getwordbreakinfo() Function</h4>
+<h4 id="the-getwordbreakinfo-function"><a class="wlink" href="#the-getwordbreakinfo-function"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The :getwordbreakinfo() Function <span class="uplinks"><a href="#generator_basics">up</a> <a href="#toc">top</a></span></h4>
 <p>If needed, a generator can optionally influence word breaking for the end word by defining a <code>:getwordbreakinfo()</code> function.</p>
 <p>The function takes a <span class="arg">line_state</span> <a href="#line_state">line_state</a> object that has information about the current line.  If it returns nil or 0, the end word is truncated to 0 length.  This is the normal behavior, which allows Clink to collect and cache all matches and then filter them based on typing.  Or it can return two numbers:  word break length and an optional end word length.  The end word is split at the word break length:  one word contains the first word break length characters from the end word (if 0 length then it&#39;s discarded), and the next word contains the rest of the end word truncated to the optional word length (0 if omitted).</p>
 <p>A good example to look at is Clink&#39;s own built-in environment variable match generator.  It has a <code>:getwordbreakinfo()</code> function that understands the <code>%</code> syntax of environment variables and produces word break info accordingly.</p>
@@ -4495,9 +4686,9 @@ <h4 id="the-getwordbreakinfo-function"><a class="wlink" href="#the-getwordbreaki
     end
 end
 </code></pre>
-<h3 id="more-advanced-stuff-1"><a class="wlink" href="#more-advanced-stuff-1"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>More Advanced Stuff</h3>
+<h3 id="more-advanced-stuff-1"><a class="wlink" href="#more-advanced-stuff-1"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>More Advanced Stuff <span class="uplinks"><a href="#matchgenerators">up</a> <a href="#toc">top</a></span></h3>
 <p><a name="filteringmatchcompletions"></a></p>
-<h4 id="filtering-match-completions"><a class="wlink" href="#filteringmatchcompletions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Filtering Match Completions</h4>
+<h4 id="filtering-match-completions"><a class="wlink" href="#filteringmatchcompletions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Filtering Match Completions <span class="uplinks"><a href="#more-advanced-stuff-1">up</a> <a href="#toc">top</a></span></h4>
 <p>A <a href="#matchgenerators">match generator</a> or <a href="#argumentcompletion">argmatcher</a> or <a href="#luakeybindings">luafunc: key binding</a> can use <a href="#clink.onfiltermatches">clink.onfiltermatches()</a> to register a function that will be called after matches are generated but before they are displayed or inserted (this is reset every time match generation is invoked).</p>
 <p>The function receives a table argument containing the matches to be displayed, a string argument indicating the completion type, and a boolean argument indicating whether filename completion is desired. The table argument has a <code>match</code> string field and a <code>type</code> string field; these are the same as in <a href="#builder:addmatch">builder:addmatch()</a>.</p>
 <p>The possible completion types are:</p>
@@ -4619,7 +4810,7 @@ <h4 id="filtering-match-completions"><a class="wlink" href="#filteringmatchcompl
 <p><strong>Note:</strong> A much more complete fzf integration script is available at <a href="https://github.com/chrisant996/clink-gizmos">clink-gizmos</a> or <a href="https://github.com/chrisant996/clink-fzf">clink-fzf</a>.</p>
 </blockquote>
 <p><a name="filteringthematchdisplay"></a></p>
-<h4 id="filtering-the-match-display"><a class="wlink" href="#filteringthematchdisplay"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Filtering the Match Display</h4>
+<h4 id="filtering-the-match-display"><a class="wlink" href="#filteringthematchdisplay"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Filtering the Match Display <span class="uplinks"><a href="#more-advanced-stuff-1">up</a> <a href="#toc">top</a></span></h4>
 <p>In some instances it may be preferable to display different text when listing potential matches versus when inserting a match in the input line, or to display a description next to a match.  For example, it might be desirable to display a <code>*</code> next to some matches, or to show additional information about some matches.</p>
 <p>The simplest way to do that is just include the <code>display</code> and/or <code>description</code> fields when using <a href="#builder:addmatch">builder:addmatch()</a>.  Refer to that function&#39;s documentation for usage details.</p>
 <p>However, older versions of Clink don&#39;t support those fields.  And in some cases it may be desirable to display a list of possible completions that includes extra matches, or omits some matches (but that&#39;s discouraged because it can be confusing to users).</p>
@@ -4659,7 +4850,7 @@ <h4 id="filtering-the-match-display"><a class="wlink" href="#filteringthematchdi
 </ul>
 </blockquote>
 <p><a name="classifywords"></a></p>
-<h2 id="coloring-the-input-text"><a class="wlink" href="#classifywords"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Coloring the Input Text</h2>
+<h2 id="coloring-the-input-text"><a class="wlink" href="#classifywords"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Coloring the Input Text <span class="uplinks"><a href="#extending-clink">up</a> <a href="#toc">top</a></span></h2>
 <p>When the <code><a href="#clink_colorize_input">clink.colorize_input</a></code> setting is enabled, then <a href="#argumentcompletion">argmatchers</a> automatically apply colors to the input text as they parse it.  When the setting is disabled, then the entire input line is colored by the <code><a href="#color_input">color.input</a></code> setting.</p>
 <table class="linkmenu">
 <tr><td><a href="#inputcolor_command">Coloring the Command Word</a></td><td>How the command word is colored.</td></tr>
@@ -4671,7 +4862,7 @@ <h2 id="coloring-the-input-text"><a class="wlink" href="#classifywords"><svg wid
 </table>
 
 <p><a name="inputcolor_command"></a></p>
-<h3 id="coloring-the-command-word"><a class="wlink" href="#inputcolor_command"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Coloring the Command Word</h3>
+<h3 id="coloring-the-command-word"><a class="wlink" href="#inputcolor_command"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Coloring the Command Word <span class="uplinks"><a href="#classifywords">up</a> <a href="#toc">top</a></span></h3>
 <p>The command word is colored based on the command type, in priority order:</p>
 <ol>
 <li>Commands that have an argmatcher defined use <code><a href="#color_argmatcher">color.argmatcher</a></code>.</li>
@@ -4692,7 +4883,7 @@ <h3 id="coloring-the-command-word"><a class="wlink" href="#inputcolor_command"><
 </table></code></pre>
 
 <p><a name="inputcolor_redir"></a></p>
-<h3 id="coloring-command-separators-and-redirection"><a class="wlink" href="#inputcolor_redir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Coloring Command Separators and Redirection</h3>
+<h3 id="coloring-command-separators-and-redirection"><a class="wlink" href="#inputcolor_redir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Coloring Command Separators and Redirection <span class="uplinks"><a href="#classifywords">up</a> <a href="#toc">top</a></span></h3>
 <p>Command separators and redirection are colored accordingly:</p>
 <ul>
 <li>Command separators use <code><a href="#color_cmdsep">color.cmdsep</a></code>.</li>
@@ -4706,7 +4897,7 @@ <h3 id="coloring-command-separators-and-redirection"><a class="wlink" href="#inp
 </table></code></pre>
 
 <p><a name="inputcolor_other"></a></p>
-<h3 id="coloring-other-input-text"><a class="wlink" href="#inputcolor_other"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Coloring Other Input Text</h3>
+<h3 id="coloring-other-input-text"><a class="wlink" href="#inputcolor_other"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Coloring Other Input Text <span class="uplinks"><a href="#classifywords">up</a> <a href="#toc">top</a></span></h3>
 <p>Other input words are colored based on how argmatchers parse the input text.</p>
 <ul>
 <li>If an argmatcher isn&#39;t defined for a command, then the input text is colored using <code><a href="#color_input">color.input</a></code>.</li>
@@ -4725,9 +4916,9 @@ <h3 id="coloring-other-input-text"><a class="wlink" href="#inputcolor_other"><sv
 <tr><td class="color_default">c:\dir><span class="color_executable">findstr</span> <span class="color_input">/s</span><span class="cursor">_</span><span class="color_suggestion">needle haystack\*</span></td><td class="right_gray">press RIGHT to accept an auto-suggestion</td></tr>
 </table></code></pre>
 
-<h3 id="more-advanced-stuff-2"><a class="wlink" href="#more-advanced-stuff-2"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>More Advanced Stuff</h3>
+<h3 id="more-advanced-stuff-2"><a class="wlink" href="#more-advanced-stuff-2"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>More Advanced Stuff <span class="uplinks"><a href="#classifywords">up</a> <a href="#toc">top</a></span></h3>
 <p><a name="classifier_override_arguments"></a></p>
-<h4 id="setting-a-classifier-function-in-an-argmatcher"><a class="wlink" href="#classifier_override_arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Setting a classifier function in an argmatcher</h4>
+<h4 id="setting-a-classifier-function-in-an-argmatcher"><a class="wlink" href="#classifier_override_arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Setting a classifier function in an argmatcher <span class="uplinks"><a href="#more-advanced-stuff-2">up</a> <a href="#toc">top</a></span></h4>
 <p>In cases where an <a href="#argumentcompletion">argmatcher</a> isn&#39;t able to color the input text in the desired manner, it&#39;s possible to supply a classifier function that overrides how the argmatcher colors the input text.  An argmatcher&#39;s classifier function is called once for each word the argmatcher parses, but it can classify any words (not just the word it was called for).  Each argmatcher can have its own classifier function, so when there are linked argmatchers more than one function may be invoked.</p>
 <p>The classifier function is passed up to six arguments:</p>
 <ul>
@@ -4777,7 +4968,7 @@ <h4 id="setting-a-classifier-function-in-an-argmatcher"><a class="wlink" href="#
 :setclassifier(classify_handler)
 </code></pre>
 <p><a name="classifier_override_line"></a></p>
-<h4 id="setting-a-classifier-function-for-the-whole-input-line"><a class="wlink" href="#classifier_override_line"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Setting a classifier function for the whole input line</h4>
+<h4 id="setting-a-classifier-function-for-the-whole-input-line"><a class="wlink" href="#classifier_override_line"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Setting a classifier function for the whole input line <span class="uplinks"><a href="#more-advanced-stuff-2">up</a> <a href="#toc">top</a></span></h4>
 <p>In some cases it may be desireable to use a custom classifier to apply coloring in an input line.</p>
 <p>First create a classifier object:</p>
 <pre><code class="language-lua">local my_classifier = clink.classifier(priority)
@@ -4854,7 +5045,7 @@ <h4 id="setting-a-classifier-function-for-the-whole-input-line"><a class="wlink"
 end
 </code></pre>
 <p><a name="customisingtheprompt"></a></p>
-<h2 id="customizing-the-prompt"><a class="wlink" href="#customisingtheprompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Customizing the Prompt</h2>
+<h2 id="customizing-the-prompt"><a class="wlink" href="#customisingtheprompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Customizing the Prompt <span class="uplinks"><a href="#extending-clink">up</a> <a href="#toc">top</a></span></h2>
 <p>Before Clink displays the prompt it filters the prompt through <a href="#extending-clink">Lua</a> so that the prompt can be customized. This happens each and every time that the prompt is shown which allows for context sensitive customizations (such as showing the current branch of a git repository).</p>
 <table class="linkmenu">
 <tr><td><a href="#promptfilter_basics">The Basics</a></td><td>A quick example to show the basics.</td></tr>
@@ -4866,7 +5057,7 @@ <h2 id="customizing-the-prompt"><a class="wlink" href="#customisingtheprompt"><s
 </table>
 
 <p><a name="promptfilter_basics"></a></p>
-<h3 id="the-basics-3"><a class="wlink" href="#promptfilter_basics"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The Basics</h3>
+<h3 id="the-basics-3"><a class="wlink" href="#promptfilter_basics"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The Basics <span class="uplinks"><a href="#customisingtheprompt">up</a> <a href="#toc">top</a></span></h3>
 <p>Writing a prompt filter is straightforward:</p>
 <ol>
 <li>Create a new prompt filter by calling <a href="#clink.promptfilter">clink.promptfilter()</a> along with a priority id which dictates the order in which filters are called. Lower priority ids are called first.</li>
@@ -4939,16 +5130,16 @@ <h3 id="the-basics-3"><a class="wlink" href="#promptfilter_basics"><svg width=16
 <p/>
 
 <p><a name="escapecodes"></a></p>
-<h3 id="ansi-escape-codes-in-the-prompt-string"><a class="wlink" href="#escapecodes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>ANSI escape codes in the prompt string</h3>
+<h3 id="ansi-escape-codes-in-the-prompt-string"><a class="wlink" href="#escapecodes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>ANSI escape codes in the prompt string <span class="uplinks"><a href="#customisingtheprompt">up</a> <a href="#toc">top</a></span></h3>
 <p>Readline needs to be told which characters in the prompt are unprintable or invisible.  To help with that, Clink automatically detects most standard ANSI escape codes (and most of ConEmu&#39;s non-standard escape codes) and the BEL character (^G, audible bell) and surrounds them with <code>\001</code> (^A) and <code>\002</code> (^B) characters.  For any other unprintable characters, the <code>\001</code> and <code>\002</code> characters need to be added manually.  Otherwise Readline misinterprets the length of the prompt and can display the prompt and input line incorrectly in some cases (especially if the input line wraps onto a second line).</p>
 <p>Here are a couple of links with more information about ANSI escape codes:</p>
 <ul>
 <li><a href="https://en.wikipedia.org/wiki/ANSI_escape_code">Wikipedia - ANSI Escape Code</a></li>
 <li><a href="https://docs.microsoft.com/en-us/windows/console/console-virtual-terminal-sequences">Console Virtual Terminal Sequences</a></li>
 </ul>
-<h3 id="more-advanced-stuff-3"><a class="wlink" href="#more-advanced-stuff-3"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>More Advanced Stuff</h3>
+<h3 id="more-advanced-stuff-3"><a class="wlink" href="#more-advanced-stuff-3"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>More Advanced Stuff <span class="uplinks"><a href="#customisingtheprompt">up</a> <a href="#toc">top</a></span></h3>
 <p><a name="rightprompt"></a></p>
-<h4 id="right-side-prompt"><a class="wlink" href="#rightprompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Right Side Prompt</h4>
+<h4 id="right-side-prompt"><a class="wlink" href="#rightprompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Right Side Prompt <span class="uplinks"><a href="#more-advanced-stuff-3">up</a> <a href="#toc">top</a></span></h4>
 <p>In addition to the normal prompt filtering, Clink can also show a prompt on the right side of the first line of input.  The right side prompt defaults to the value of the <code>%CLINK_RPROMPT%</code> environment variable, if set, otherwise it is blank.  This right side prompt is automatically hidden if the input line text reaches it.</p>
 <p>Clink expands CMD prompt <code>$</code> codes in <code>%CLINK_RPROMPT%</code>, with a few exceptions:  <code>$+</code> is not supported, <code>$_</code> ends the prompt string (it can&#39;t be more than one line), and <code>$V</code> is not supported.  Additionally, if <code>%CLINK_RPROMPT%</code> ends with <code>$M</code> then trailing spaces are trimmed from the expanded string, to maintain right alignment since <code>$M</code> includes a space if the current drive is a network drive (so e.g. <code>$t $d $m</code> is right-aligned regardless whether the current drive has a remote name).</p>
 <p>The right side prompt can be filtered through <a href="#extending-clink">Lua</a> just like the normal prompt can be.  Simply define a <code>:rightfilter()</code> function on the prompt filter returned by a call to <a href="#clink.promptfilter">clink.promptfilter()</a>.  A prompt filter can define both <code>:filter()</code> and <code>:rightfilter()</code>, or can define only <code>:filter()</code>.</p>
@@ -4975,7 +5166,7 @@ <h4 id="right-side-prompt"><a class="wlink" href="#rightprompt"><svg width=16 he
 </ul>
 </blockquote>
 <p><a name="asyncpromptfiltering"></a></p>
-<h4 id="asynchronous-prompt-filtering"><a class="wlink" href="#asyncpromptfiltering"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Asynchronous Prompt Filtering</h4>
+<h4 id="asynchronous-prompt-filtering"><a class="wlink" href="#asyncpromptfiltering"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Asynchronous Prompt Filtering <span class="uplinks"><a href="#more-advanced-stuff-3">up</a> <a href="#toc">top</a></span></h4>
 <p>Prompt filtering needs to be fast, or it can interfere with using the shell (e.g. <code>git status</code> can be slow in a large repo).</p>
 <p>Clink provides a way for prompt filters to do some initial work and set the prompt, continue doing work in the background, and then refresh the prompt again when the background work is finished.  This is accomplished by using <a href="https://www.lua.org/manual/5.2/manual.html#2.6">Lua coroutines</a>, but Clink simplifies and streamlines the process.</p>
 <p>A prompt filter can call <a href="#clink.promptcoroutine">clink.promptcoroutine(my_func)</a> to run <code>my_func()</code> inside a coroutine.  Clink will automatically resume the coroutine repeatedly while input line editing is idle.  When <code>my_func()</code> completes, Clink will automatically refresh the prompt by triggering prompt filtering again.</p>
@@ -5100,7 +5291,7 @@ <h4 id="asynchronous-prompt-filtering"><a class="wlink" href="#asyncpromptfilter
 end
 </code></pre>
 <p><a name="transientprompts"></a></p>
-<h4 id="transient-prompt"><a class="wlink" href="#transientprompts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Transient Prompt</h4>
+<h4 id="transient-prompt"><a class="wlink" href="#transientprompts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Transient Prompt <span class="uplinks"><a href="#more-advanced-stuff-3">up</a> <a href="#toc">top</a></span></h4>
 <p>Clink can replace a past prompt with a differently formatted &quot;transient&quot; prompt.  For example, if your normal prompt contains many bits of information that don&#39;t need to be seen later, then it may be desirable to replace past prompts with a simpler prompt.  Or it may be useful to update the timestamp in a prompt to indicate when the prompt was completed, rather than when it was first shown.</p>
 <p>The <code>%CLINK_TRANSIENT_PROMPT%</code> environment variable provides the initial prompt string for the transient prompt.</p>
 <p>Turn on the transient prompt with <code>clink set <a href="#prompt_transient">prompt.transient</a> always</code>.  Or use <code>same_dir</code> instead of <code>always</code> to only use a transient prompt when the current directory is the same as the previous prompt.</p>
@@ -5112,6 +5303,9 @@ <h4 id="transient-prompt"><a class="wlink" href="#transientprompts"><svg width=1
 <p>The transient filter function takes a string argument that contains the filtered prompt so far.  If the filter function returns nil, it has no effect.  If the filter function returns a string, that string is used as the new filtered prompt (and may be further modified by other prompt filters with higher priority ids).  If the filter function returns a string and a boolean, then if the boolean is false the prompt filtering is done and no further filter functions are called.</p>
 <p>A transient right side prompt is also possible (similar to the usual <a href="#rightprompt">right side prompt</a>).  The <code>%CLINK_TRANSIENT_RPROMPT%</code> environment variable (note the <code>R</code> in <code>_RPROMPT</code>) provides the initial prompt string for the transient right side prompt, which can be customized by a <code>:transientrightfilter()</code> function on a prompt filter.</p>
 <p>A prompt filter must have a <code>:filter()</code> function defined on it, and may in addition have any combination of <code>:rightfilter()</code>, <code>:transientfilter()</code>, and <code>:transientrightfilter()</code> functions defined on it.</p>
+<blockquote>
+<p><strong>Related:</strong>  The <a href="#prompt_spacing">prompt.spacing</a> setting can optionally remove blank lines before the prompt, and can optionally insert one blank line before the normal (non-transient) prompt.</p>
+</blockquote>
 <p>The next example shows how to make a prompt that shows:</p>
 <ol>
 <li>The current directory and <code>&gt;</code> on the left, and the date and time on the right.</li>
@@ -5159,7 +5353,7 @@ <h4 id="transient-prompt"><a class="wlink" href="#transientprompts"><svg width=1
 <p><strong>Note:</strong>  In v1.4.25 and higher, the <code>:transientfilter()</code> or <code>:transientrightfilter()</code> functions can suppress the transient prompt on a case by case basis by returning <code>nil, false</code>.</p>
 </blockquote>
 <p><a name="pfxsfxesccodes"></a></p>
-<h4 id="prefix-and-suffix-escape-codes"><a class="wlink" href="#pfxsfxesccodes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Prefix and Suffix Escape Codes</h4>
+<h4 id="prefix-and-suffix-escape-codes"><a class="wlink" href="#pfxsfxesccodes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Prefix and Suffix Escape Codes <span class="uplinks"><a href="#more-advanced-stuff-3">up</a> <a href="#toc">top</a></span></h4>
 <p>In some cases the prompt and/or right side prompt might need to be surrounded with special escape codes.  For example, some file editors with integrated terminals want to receive additional escape codes surrounding the prompt strings.</p>
 <p>After all prompt filters have finished, the last line of the final prompt string is automatically surrounded with the values of the <code>%CLINK_PROMPT_PREFIX%</code> and <code>%CLINK_PROMPT_SUFFIX%</code> environment variables, and the final right side prompt is automatically surrounded with the values of the <code>%CLINK_RPROMPT_PREFIX%</code> and <code>%CLINK_RPROMPT_SUFFIX%</code> environment variables.</p>
 <p>The prompt prefix and suffix strings expand CMD prompt <code>$</code> codes (run <code>prompt /?</code> for more info).  So, for example, <code>$p</code> could be combined with escape codes to set the terminal window title to the current working directory.  Consult documentation for your terminal program for information about what escape codes may be available.</p>
@@ -5188,7 +5382,7 @@ <h4 id="prefix-and-suffix-escape-codes"><a class="wlink" href="#pfxsfxesccodes">
 </ul>
 </blockquote>
 <p><a name="customisingsuggestions"></a></p>
-<h2 id="customizing-suggestions"><a class="wlink" href="#customisingsuggestions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Customizing Suggestions</h2>
+<h2 id="customizing-suggestions"><a class="wlink" href="#customisingsuggestions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Customizing Suggestions <span class="uplinks"><a href="#extending-clink">up</a> <a href="#toc">top</a></span></h2>
 <p>Clink can offer suggestions how to complete a command as you type, and you can select how it generates suggestions.</p>
 <p>Turn on <a href="#autosuggest_enable">automatic suggestions</a> with <code>clink set <a href="#autosuggest_enable">autosuggest.enable</a> true</code>.  Once enabled, Clink will show suggestions in a <a href="#color.suggestion">muted color</a> after the end of the typed command.  Accept the whole suggestion with the <kbd>Right</kbd> arrow or <kbd>End</kbd> key, accept the next word of the suggestion with <kbd>Ctrl</kbd>-<kbd>Right</kbd>, or accept the next full word of the suggestion up to a space with <kbd>Shift</kbd>-<kbd>Right</kbd>.  You can ignore the suggestion if it isn&#39;t what you want; suggestions have no effect unless you accept them first.</p>
 <p>Scripts can provide custom suggestion generators, in addition to the built-in options:</p>
@@ -5218,7 +5412,7 @@ <h2 id="customizing-suggestions"><a class="wlink" href="#customisingsuggestions"
     return prefix, info.offset
 end
 </code></pre>
-<h1 id="miscellaneous"><a class="wlink" href="#miscellaneous"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Miscellaneous</h1>
+<h1 id="miscellaneous"><a class="wlink" href="#miscellaneous"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Miscellaneous <span class="uplinks"><a href="#toc">top</a></span></h1>
 <p>These sections provide more information about various aspects of Clink:</p>
 <table class="linkmenu">
 <tr><td><a href="#keybindings">Customizing Key Bindings</a></td><td>How to customize key bindings.</td></tr>
@@ -5233,7 +5427,7 @@ <h1 id="miscellaneous"><a class="wlink" href="#miscellaneous"><svg width=16 heig
 </table>
 
 <p><a name="keybindings"></a></p>
-<h2 id="customizing-key-bindings"><a class="wlink" href="#keybindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Customizing Key Bindings</h2>
+<h2 id="customizing-key-bindings"><a class="wlink" href="#keybindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Customizing Key Bindings <span class="uplinks"><a href="#miscellaneous">up</a> <a href="#toc">top</a></span></h2>
 <p>Key bindings are defined in .inputrc files.</p>
 <p>The <a href="#rlcmd-clink-show-help"><code>clink-show-help</code></a> command is bound to <kbd>Alt</kbd>-<kbd>H</kbd> and lists all currently active key bindings.  The list displays &quot;friendly&quot; key names, and these names are generally not suitable for use in .inputrc files.  For example &quot;Up&quot; is the friendly name for <code>&quot;\e[A&quot;</code>, and &quot;A-C-F2&quot; is the friendly name for <code>&quot;\e\e[1;5Q&quot;</code>.  To see key sequence strings suitable for use in .inputrc files use <code>clink echo</code> as described below.</p>
 <table class="linkmenu">
@@ -5244,13 +5438,13 @@ <h2 id="customizing-key-bindings"><a class="wlink" href="#keybindings"><svg widt
 <tr><td><a href="#nometakey">I do not have a Meta or <kbd>Alt</kbd> key</a></td><td>What to do if your keyboard doesn't have any <kbd>Alt</kbd> or Meta keys.</td></tr>
 </table>
 
-<h3 id="the-inputrc-file"><a class="wlink" href="#the-inputrc-file"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The .inputrc file</h3>
+<h3 id="the-inputrc-file"><a class="wlink" href="#the-inputrc-file"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The .inputrc file <span class="uplinks"><a href="#keybindings">up</a> <a href="#toc">top</a></span></h3>
 <p>You can use <code>clink info</code> to find the directories and configuration files for the current Clink session, including where the .inputrc file is located, or can be located.  See the <a href="#init-file">Readline Init File</a> section for detailed information about .inputrc files.</p>
 <blockquote>
 <p><strong>Note:</strong> Third party console hosts such as ConEmu may have their own key bindings that supersede Clink.  They usually have documentation for how to change or disable their key bindings to allow console programs to handle the keys instead.</p>
 </blockquote>
 <p><a name="discoverkeysequences"></a></p>
-<h3 id="discovering-clink-key-sequences"><a class="wlink" href="#discoverkeysequences"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Discovering Clink key sequences</h3>
+<h3 id="discovering-clink-key-sequences"><a class="wlink" href="#discoverkeysequences"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Discovering Clink key sequences <span class="uplinks"><a href="#keybindings">up</a> <a href="#toc">top</a></span></h3>
 <p>Clink provides an easy way to find the key sequence for any key combination that Clink supports. Run <code>clink echo</code> and then press key combinations; the associated key binding sequence is printed to the console output and can be used for a key binding in the inputrc file.</p>
 <p>A chord can be formed by concatenating multiple key binding sequences. For example, <code>&quot;\C-X&quot;</code> and <code>&quot;\e[H&quot;</code> can be concatenated to form <code>&quot;\C-X\e[H&quot;</code> representing the chord <kbd>Ctrl</kbd>-<kbd>X</kbd>,<kbd>Home</kbd>.</p>
 <p>When finished, press <kbd>Ctrl</kbd>-<kbd>C</kbd> to exit from <code>clink echo</code>.</p>
@@ -5258,7 +5452,7 @@ <h3 id="discovering-clink-key-sequences"><a class="wlink" href="#discoverkeysequ
 <p><strong>Note:</strong> With non-US keyboard layouts, <code>clink echo</code> is not able to ignore dead key input (accent keys, for example).  It prints the key sequence for the dead key itself, which is not useful.  You can ignore that and press the next key, and then it prints the correct key sequence to use in key bindings.</p>
 </blockquote>
 <p><a name="specialkeys"></a></p>
-<h3 id="binding-special-keys"><a class="wlink" href="#specialkeys"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Binding special keys</h3>
+<h3 id="binding-special-keys"><a class="wlink" href="#specialkeys"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Binding special keys <span class="uplinks"><a href="#keybindings">up</a> <a href="#toc">top</a></span></h3>
 <p>Here is a table of the key binding sequences for the special keys.  Clink primarily uses VT220 emulation for keyboard input, but also uses some Xterm extended key sequences.</p>
 <table>
 <thead>
@@ -5624,7 +5818,7 @@ <h3 id="binding-special-keys"><a class="wlink" href="#specialkeys"><svg width=16
 </tr>
 </tbody></table>
 <p><a name="luakeybindings"></a></p>
-<h3 id="lua-key-bindings"><a class="wlink" href="#luakeybindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Lua key bindings</h3>
+<h3 id="lua-key-bindings"><a class="wlink" href="#luakeybindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Lua key bindings <span class="uplinks"><a href="#keybindings">up</a> <a href="#toc">top</a></span></h3>
 <p>You can bind a key to a <a href="#extending-clink">Lua</a> function by <a href="#keybindings">binding</a> it to a macro that begins with &quot;luafunc:&quot;.  Clink will invoke the named Lua function when the key binding is input.  Function names can include periods (such as <code>foo.bar</code>) but cannot include any other punctuation.</p>
 <p>The Lua function receives two arguments:</p>
 <p><span class="arg"><a href="#rl_buffer">rl_buffer</a></span> gives it access to the input buffer.</p>
@@ -5640,7 +5834,7 @@ <h3 id="lua-key-bindings"><a class="wlink" href="#luakeybindings"><svg width=16
 </li>
 </ul>
 </blockquote>
-<h4 id="basic-example"><a class="wlink" href="#basic-example"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Basic example</h4>
+<h4 id="basic-example"><a class="wlink" href="#basic-example"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Basic example <span class="uplinks"><a href="#luakeybindings">up</a> <a href="#toc">top</a></span></h4>
 <p>Example of a Lua function key binding in a .inputrc file:</p>
 <pre><code class="plaintext">M-C-y:          <span class="hljs-string">"luafunc:insert_date"</span>
 M-C-z:          <span class="hljs-string">"luafunc:print_date"</span>
@@ -5656,7 +5850,7 @@ <h4 id="basic-example"><a class="wlink" href="#basic-example"><svg width=16 heig
     print(os.date(&quot;%A %B %d, %Y   %I:%M %p&quot;))
 end
 </code></pre>
-<h4 id="example-to-change-how-auto-suggested-text-is-inserted"><a class="wlink" href="#example-to-change-how-auto-suggested-text-is-inserted"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Example to change how auto-suggested text is inserted</h4>
+<h4 id="example-to-change-how-auto-suggested-text-is-inserted"><a class="wlink" href="#example-to-change-how-auto-suggested-text-is-inserted"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Example to change how auto-suggested text is inserted <span class="uplinks"><a href="#luakeybindings">up</a> <a href="#toc">top</a></span></h4>
 <p>This example creates new commands that change <kbd>Right</kbd> and <kbd>Shift</kbd>-<kbd>Right</kbd> to swap how they behave when auto-suggested text is present.  It also uses Lua to add descriptions for the new commands, and to set key bindings.</p>
 <pre><code class="language-lua">function cursor_forward_or_insert_full_word(rl_buffer)
     local at_end = (rl_buffer:getcursor() &gt; rl_buffer:getlength())
@@ -5674,7 +5868,7 @@ <h4 id="example-to-change-how-auto-suggested-text-is-inserted"><a class="wlink"
 rl.describemacro([[&quot;luafunc:cua_forward_char_or_insert_line&quot;]], &quot;Extend the selection forward one character, or insert the suggested line&quot;)
 rl.setbinding([[&quot;\e[1;2C&quot;]], [[&quot;luafunc:cua_forward_char_or_insert_line&quot;]])
 </code></pre>
-<h4 id="advanced-example"><a class="wlink" href="#advanced-example"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Advanced example</h4>
+<h4 id="advanced-example"><a class="wlink" href="#advanced-example"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Advanced example <span class="uplinks"><a href="#luakeybindings">up</a> <a href="#toc">top</a></span></h4>
 <p><a name="findlineexample"></a></p>
 <p>Here is an example that makes <kbd>F7</kbd>/<kbd>F8</kbd> jump to the previous/next screen line containing &quot;error&quot; or &quot;warn&quot; colored red or yellow, and makes <kbd>Shift</kbd>-<kbd>F7</kbd>/<kbd>Shift</kbd>-<kbd>F8</kbd> jump to the previous/next prompt line.</p>
 <p>One way to use these is when reviewing compiler errors after building a project at the command line.  Press <kbd>Shift</kbd>-<kbd>F7</kbd> to jump to the previous prompt line, and then use <kbd>F8</kbd> repeatedly to jump to each next compiler warning or error listed on the screen.</p>
@@ -5890,12 +6084,12 @@ <h4 id="advanced-example"><a class="wlink" href="#advanced-example"><svg width=1
 end
 </code></pre>
 <p><a name="nometakey"></a></p>
-<h3 id="i-do-not-have-a-meta-or-alt-key"><a class="wlink" href="#nometakey"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>I do not have a Meta or <kbd>Alt</kbd> key</h3>
+<h3 id="i-do-not-have-a-meta-or-alt-key"><a class="wlink" href="#nometakey"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>I do not have a Meta or <kbd>Alt</kbd> key <span class="uplinks"><a href="#keybindings">up</a> <a href="#toc">top</a></span></h3>
 <p>If you do not have a Meta or <kbd>Alt</kbd> key, or another key working as a Meta key, there is another way to generate &quot;metafied&quot; keystrokes such as <kbd>M-k</kbd>.</p>
 <p>You can configure <code>clink set <a href="#terminal_raw_esc">terminal.raw_esc</a> true</code> to make the <kbd>Esc</kbd> work as it does in Unix and Linux, and then you can type <kbd>Esc</kbd> followed by <kbd>k</kbd>. This is known as &quot;metafying&quot; the <kbd>k</kbd> key.</p>
 <p>Clink is a Windows program, and so by default it makes the <kbd>Esc</kbd> key reset the input state, since that&#39;s how <kbd>Esc</kbd> generally works on Windows. When you enable the <a href="#terminal_raw_esc"><code>terminal.raw_esc</code></a> Clink setting, the <kbd>Esc</kbd> key changes its behavior, and pressing unbound special keys can land you in all of the same strange &quot;stuck input&quot; situations as in Unix and Linux.</p>
 <p>But it might be more convenient to acquire a keyboard that has an <kbd>Alt</kbd> key.</p>
-<h2 id="saved-command-history"><a class="wlink" href="#saved-command-history"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Saved Command History</h2>
+<h2 id="saved-command-history"><a class="wlink" href="#saved-command-history"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Saved Command History <span class="uplinks"><a href="#miscellaneous">up</a> <a href="#toc">top</a></span></h2>
 <p>Clink has a list of commands from the current session, and it can be saved and loaded across sessions.</p>
 <p>By prefixing the command you can control whether it&#39;s added to history and whether a doskey alias may be expanded.</p>
 <table>
@@ -5923,21 +6117,21 @@ <h2 id="saved-command-history"><a class="wlink" href="#saved-command-history"><s
 <blockquote>
 <p><strong>Note:</strong> If the first word in the line matches one of the words in the <a href="#history_dont_add_to_history_cmds"><code>history.dont_add_to_history_cmds</code></a> setting then the command is not added to history.  By default, <code>history</code> and <code>exit</code> are not added to history.</p>
 </blockquote>
-<h3 id="list-the-history"><a class="wlink" href="#list-the-history"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>List the history</h3>
+<h3 id="list-the-history"><a class="wlink" href="#list-the-history"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>List the history <span class="uplinks"><a href="#saved-command-history">up</a> <a href="#toc">top</a></span></h3>
 <p>Press <kbd>F7</kbd> for a popup list of selectable history entries.</p>
 <p>You can also list the saved history by running <code>clink history</code> or the <code>history</code> doskey alias that Clink automatically defines.  Use <code>history --help</code> for usage info.</p>
-<h3 id="the-master-history-file"><a class="wlink" href="#the-master-history-file"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The master history file</h3>
+<h3 id="the-master-history-file"><a class="wlink" href="#the-master-history-file"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The master history file <span class="uplinks"><a href="#saved-command-history">up</a> <a href="#toc">top</a></span></h3>
 <p>When the <a href="#history_save"><code>history.save</code></a> setting is enabled, then the command history is loaded and saved as follows (or when the setting is disabled, then it isn&#39;t saved between sessions).</p>
 <p>Every time a new input line starts, Clink reloads the master history list and prunes it not to exceed the <a href="#history_max_lines"><code>history.max_lines</code></a> setting.</p>
 <p>For performance reasons, deleting a history line marks the line as deleted without rewriting the history file.  When the number of deleted lines gets too large (exceeding the max lines or 200, whichever is larger) then the history file is compacted:  the file is rewritten with the deleted lines removed.</p>
 <p>You can force the history file to be compacted regardless of the number of deleted lines by running <code>history compact</code>.</p>
-<h3 id="shared-command-history"><a class="wlink" href="#shared-command-history"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Shared command history</h3>
+<h3 id="shared-command-history"><a class="wlink" href="#shared-command-history"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Shared command history <span class="uplinks"><a href="#saved-command-history">up</a> <a href="#toc">top</a></span></h3>
 <p>When the <a href="#history_shared"><code>history.shared</code></a> setting is enabled, then all instances of Clink update the master history file and reload it every time a new input line starts.  This gives the effect that all instances of Clink share the same history -- a command entered in one instance will appear in other instances&#39; history the next time they start an input line.</p>
 <p>When the setting is disabled, then each instance of Clink loads the master file but doesn&#39;t append its own history back to the master file until after it exits, giving the effect that once an instance starts its history is isolated from other instances&#39; history.</p>
-<h3 id="multiple-master-history-files"><a class="wlink" href="#multiple-master-history-files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Multiple master history files</h3>
+<h3 id="multiple-master-history-files"><a class="wlink" href="#multiple-master-history-files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Multiple master history files <span class="uplinks"><a href="#saved-command-history">up</a> <a href="#toc">top</a></span></h3>
 <p>Normally Clink saves a single saved master history list.  All instances of Clink load and save the same master history list.</p>
 <p>It&#39;s also possible to make one or more instances of Clink use a different saved master history list by setting the <code>%CLINK_HISTORY_LABEL%</code> environment variable.  This can be up to 32 alphanumeric characters, and is appended to the master history file name.  Changing the <code>%CLINK_HISTORY_LABEL%</code> environment variable takes effect at the next input line.</p>
-<h3 id="history-timestamps"><a class="wlink" href="#history-timestamps"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>History timestamps</h3>
+<h3 id="history-timestamps"><a class="wlink" href="#history-timestamps"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>History timestamps <span class="uplinks"><a href="#saved-command-history">up</a> <a href="#toc">top</a></span></h3>
 <p>History items can optionally save the timestamp when they were added, and the timestamps can be shown in the <code>history</code> command.</p>
 <p>Use <code>clink set <a href="#history_time_stamp">history.time_stamp</a> off</code> to not save or show timestamps for history items (this is the default).  Turning off timestamps doesn&#39;t remove existing timestamps.</p>
 <p>Use <code>clink set history.time_stamp save</code> to save timestamps for each history item but only show them in the <code>history</code> command when the <code>--show-time</code> flag is used.  They may also be shown when a <code>clink-popup-history</code> or <code>win-history-list</code> key binding is pressed, if a non-zero <a href="#readline-arguments">numeric argument</a> is supplied.</p>
@@ -6029,7 +6223,7 @@ <h3 id="history-timestamps"><a class="wlink" href="#history-timestamps"><svg wid
 <td>A <code>%</code> sign.</td>
 </tr>
 </tbody></table>
-<h2 id="using-history-expansion"><a class="wlink" href="#using-history-expansion"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Using History Expansion</h2>
+<h2 id="using-history-expansion"><a class="wlink" href="#using-history-expansion"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Using History Expansion <span class="uplinks"><a href="#miscellaneous">up</a> <a href="#toc">top</a></span></h2>
 <p>Clink uses Readline&#39;s <a href="https://tiswww.cwru.edu/php/chet/readline/history.html">History library</a> to
 add history expansion capabilities.  If these are undesirable, they can be turned off by running
 <code>clink set <a href="#history_auto_expand">history.auto_expand</a> off</code> or
@@ -6075,7 +6269,7 @@ <h2 id="using-history-expansion"><a class="wlink" href="#using-history-expansion
 <tr><td><a href="#modifiers">Modifiers</a></td><td>Modifying the results of substitution.</td></tr>
 </table>
 
-<h3 id="event-designators"><a class="wlink" href="#event-designators"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Event Designators</h3>
+<h3 id="event-designators"><a class="wlink" href="#event-designators"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Event Designators <span class="uplinks"><a href="#using-history-expansion">up</a> <a href="#toc">top</a></span></h3>
 <p>An event designator is a reference to a command line entry in the
 history list.  Unless the reference is absolute, events are relative to
 the current position in the history list.</p>
@@ -6136,7 +6330,7 @@ <h3 id="event-designators"><a class="wlink" href="#event-designators"><svg width
 </td></tr>
 </table>
 
-<h3 id="word-designators"><a class="wlink" href="#word-designators"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Word Designators</h3>
+<h3 id="word-designators"><a class="wlink" href="#word-designators"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Word Designators <span class="uplinks"><a href="#using-history-expansion">up</a> <a href="#toc">top</a></span></h3>
 <p>Word designators are used to select desired words from the event.  A <code>:</code>
 separates the event specification from the word designator.  It may be
 omitted if the word designator begins with a <code>^</code>, <code>$</code>, <code>*</code>, <code>-</code>, or <code>%</code>.
@@ -6178,7 +6372,7 @@ <h3 id="word-designators"><a class="wlink" href="#word-designators"><svg width=1
 <tr><td>
 <code><em>n</em></code>
 </td><td>
-    The <em>n</em>th word.
+    The <em>n</em>-th word.
 </td></tr>
 
 <tr><td>
@@ -6230,7 +6424,7 @@ <h3 id="word-designators"><a class="wlink" href="#word-designators"><svg width=1
 
 <p>If a word designator is supplied without an event specification, the
 previous command is used as the event.</p>
-<h3 id="modifiers"><a class="wlink" href="#modifiers"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Modifiers</h3>
+<h3 id="modifiers"><a class="wlink" href="#modifiers"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Modifiers <span class="uplinks"><a href="#using-history-expansion">up</a> <a href="#toc">top</a></span></h3>
 <p>After the optional word designator, you can add a sequence of one or
 more of the following modifiers, each preceded by a <code>:</code>.  These modify,
 or edit, the word or words selected from the history event.</p>
@@ -6307,7 +6501,7 @@ <h3 id="modifiers"><a class="wlink" href="#modifiers"><svg width=16 height=16><u
 </td></tr>
 </table>
 
-<h2 id="directory-shortcuts"><a class="wlink" href="#directory-shortcuts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Directory Shortcuts</h2>
+<h2 id="directory-shortcuts"><a class="wlink" href="#directory-shortcuts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Directory Shortcuts <span class="uplinks"><a href="#miscellaneous">up</a> <a href="#toc">top</a></span></h2>
 <p>Clink provides some typing savers for changing the current directory.</p>
 <ul>
 <li>Typing a directory name followed by a path separator is a shortcut for <code>cd /d</code> to that directory.</li>
@@ -6316,7 +6510,7 @@ <h2 id="directory-shortcuts"><a class="wlink" href="#directory-shortcuts"><svg w
 </ul>
 <p>These shortcuts only work in the interactive command line; they do not work in batch scripts.</p>
 <p><a name="sample-scripts"></a></p>
-<h2 id="enhanced-doskey-expansion"><a class="wlink" href="#sample-scripts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Enhanced Doskey Expansion</h2>
+<h2 id="enhanced-doskey-expansion"><a class="wlink" href="#sample-scripts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Enhanced Doskey Expansion <span class="uplinks"><a href="#miscellaneous">up</a> <a href="#toc">top</a></span></h2>
 <p>Enhanced Doskey expansion is enabled by default.  You can turn it off by running <code>clink set <a href="#doskey_enhanced">doskey.enhanced</a> off</code>.</p>
 <p>When enabled, this adds two behaviors:</p>
 <ul>
@@ -6327,16 +6521,16 @@ <h2 id="enhanced-doskey-expansion"><a class="wlink" href="#sample-scripts"><svg
 <blockquote>
 <p><strong>Note:</strong> Some Doskey macros might be incompatible with the enhanced Doskey expansion feature, especially if they use special or complicated syntax.  If you encounter problems, you might need to turn off enhanced Doskey expansion or adjust the problematic macros.</p>
 </blockquote>
-<h2 id="popular-scripts"><a class="wlink" href="#popular-scripts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Popular Scripts</h2>
+<h2 id="popular-scripts"><a class="wlink" href="#popular-scripts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Popular Scripts <span class="uplinks"><a href="#miscellaneous">up</a> <a href="#toc">top</a></span></h2>
 <p>Here are some popular scripts that show off what can be done with Clink.</p>
-<h3 id="clink-completions"><a class="wlink" href="#clink-completions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>clink-completions</h3>
+<h3 id="clink-completions"><a class="wlink" href="#clink-completions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>clink-completions <span class="uplinks"><a href="#popular-scripts">up</a> <a href="#toc">top</a></span></h3>
 <p>The <a href="https://github.com/vladimir-kotikov/clink-completions">clink-completions</a> collection of scripts has a bunch of argument matchers and completion generators for things like git, mercurial, npm, and more.</p>
-<h3 id="clink-flex-prompt"><a class="wlink" href="#clink-flex-prompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>clink-flex-prompt</h3>
+<h3 id="clink-flex-prompt"><a class="wlink" href="#clink-flex-prompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>clink-flex-prompt <span class="uplinks"><a href="#popular-scripts">up</a> <a href="#toc">top</a></span></h3>
 <p>The <a href="https://github.com/chrisant996/clink-flex-prompt">clink-flex-prompt</a> script is similar to the zsh powerlevel10k theme.  It gives Clink a very customizable prompt, with many style options.  It&#39;s extensible so you can add your own segments.</p>
 <p>It also takes advantage of Clink&#39;s <a href="#asyncpromptfiltering">asynchronous prompt refresh</a> to make prompts show up instantly, even in large git repos, for example.</p>
-<h3 id="clink-fzf"><a class="wlink" href="#clink-fzf"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>clink-fzf</h3>
+<h3 id="clink-fzf"><a class="wlink" href="#clink-fzf"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>clink-fzf <span class="uplinks"><a href="#popular-scripts">up</a> <a href="#toc">top</a></span></h3>
 <p>The <a href="https://github.com/chrisant996/clink-fzf">clink-fzf</a> script integrates the popular <a href="https://github.com/junegunn/fzf">fzf</a> &quot;fuzzy finder&quot; tool with Clink.</p>
-<h3 id="clink-gizmos"><a class="wlink" href="#clink-gizmos"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>clink-gizmos</h3>
+<h3 id="clink-gizmos"><a class="wlink" href="#clink-gizmos"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>clink-gizmos <span class="uplinks"><a href="#popular-scripts">up</a> <a href="#toc">top</a></span></h3>
 <p>The <a href="https://github.com/chrisant996/clink-gizmos">clink-gizmos</a> collection of scripts has several handy scripts such as:</p>
 <ul>
 <li>Argmatchers for <code>msbuild</code>, <code>findstr</code>, <code>robocopy</code>, <code>xcopy</code>, <code>doskey</code>, <code>premake5</code>, and more.</li>
@@ -6347,21 +6541,21 @@ <h3 id="clink-gizmos"><a class="wlink" href="#clink-gizmos"><svg width=16 height
 <li>The <code>luaexec.lua</code> script which has various features handy for Clink Lua script authors.</li>
 <li>And more.</li>
 </ul>
-<h3 id="oh-my-posh"><a class="wlink" href="#oh-my-posh"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>oh-my-posh</h3>
+<h3 id="oh-my-posh"><a class="wlink" href="#oh-my-posh"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>oh-my-posh <span class="uplinks"><a href="#popular-scripts">up</a> <a href="#toc">top</a></span></h3>
 <p>The <a href="https://github.com/JanDeDobbeleer/oh-my-posh">oh-my-posh</a> program can generate fancy prompts. Refer to its <a href="https://ohmyposh.dev">documentation</a> for how to configure it, and for sample themes.</p>
 <p>Integrating oh-my-posh with Clink is easy: just save the following text to an <code>oh-my-posh.lua</code> file in your Clink scripts directory (run <code>clink info</code> to find that), and make sure the <code>oh-my-posh.exe</code> program is in a directory listed in the <code>%PATH%</code> environment variable (or edit the script below to provide a fully qualified path to the oh-my-posh.exe program). Replace the config with your own configuration and you&#39;re good to go.</p>
 <pre><code class="language-lua">-- oh-my-posh.lua
 load(io.popen(&#39;oh-my-posh.exe --config=&quot;C:/Users/me/jandedobbeleer.omp.json&quot; --init --shell cmd&#39;):read(&quot;*a&quot;))()
 </code></pre>
-<h3 id="starship"><a class="wlink" href="#starship"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>starship</h3>
+<h3 id="starship"><a class="wlink" href="#starship"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>starship <span class="uplinks"><a href="#popular-scripts">up</a> <a href="#toc">top</a></span></h3>
 <p>The <a href="https://github.com/starship/starship">starship</a> program can also generate fancy prompts. Refer to its <a href="https://starship.rs">documentation</a> for how to configure it.</p>
 <p>Integrating starship with Clink is just as easy: save the following text to a <code>starship.lua</code> file in your Clink scripts directory (run <code>clink info</code> to find that), and make sure the <code>starship.exe</code> program is in a directory listed in the <code>%PATH%</code> environment variable (or edit the script below to provide a fully qualified path to the starship.exe program). The config file for starship is located at <code>C:\Users\<span class="arg">username</span>.config\starship.toml</code>.</p>
 <pre><code class="language-lua">-- starship.lua
 load(io.popen(&#39;starship.exe init cmd&#39;):read(&quot;*a&quot;))()
 </code></pre>
-<h3 id="zlua"><a class="wlink" href="#zlua"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>z.lua</h3>
+<h3 id="zlua"><a class="wlink" href="#zlua"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>z.lua <span class="uplinks"><a href="#popular-scripts">up</a> <a href="#toc">top</a></span></h3>
 <p>The <a href="https://github.com/skywind3000/z.lua">z.lua</a> tool is a faster way to navigate directories, and it integrates with Clink.</p>
-<h2 id="terminal-support"><a class="wlink" href="#terminal-support"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Terminal Support</h2>
+<h2 id="terminal-support"><a class="wlink" href="#terminal-support"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Terminal Support <span class="uplinks"><a href="#miscellaneous">up</a> <a href="#toc">top</a></span></h2>
 <p>Windows programs generally don&#39;t need to worry about terminal support.  But the Readline library used by Clink comes from Unix, where there are many different kinds of terminals, and the library requires certain kinds of terminal support.</p>
 <p>Clink&#39;s keyboard driver generally produces VT220 style key sequences, but it also includes many extensions from Xterm and other sources.  Use <code>clink echo</code> to find key sequences for specific inputs.</p>
 <p>Clink&#39;s terminal output driver is designed for use with Windows and its console subsystem.  Clink can optionally handle output itself instead, and emulate terminal output support when the <a href="#terminal_emulation"><code>terminal.emulation</code></a> setting is <code>emulate</code>, or when <code>auto</code> and Clink is running on an older version of Windows that doesn&#39;t support ANSI escape codes.  In emulation mode, 8 bit and 24 bit color escape codes are mapped to the nearest 4 bit colors.</p>
@@ -6384,7 +6578,7 @@ <h2 id="terminal-support"><a class="wlink" href="#terminal-support"><svg width=1
 <pre><code class="language-cmd">set CLINK_TERM_VE=\e[?12h
 set CLINK_TERM_VS=\e[?12l
 </code></pre>
-<h2 id="troubleshooting-tips"><a class="wlink" href="#troubleshooting-tips"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Troubleshooting Tips</h2>
+<h2 id="troubleshooting-tips"><a class="wlink" href="#troubleshooting-tips"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Troubleshooting Tips <span class="uplinks"><a href="#miscellaneous">up</a> <a href="#toc">top</a></span></h2>
 <p>If something seems to malfunction, here are some things to try that often help track down what&#39;s going wrong:</p>
 <ul>
 <li>Check if anti-malware software blocked Clink from injecting.<ul>
@@ -6406,18 +6600,25 @@ <h2 id="troubleshooting-tips"><a class="wlink" href="#troubleshooting-tips"><svg
 <li>Please include the <code>clink.log</code> file (the location is reported by <code>clink info</code>).</li>
 </ul>
 <p><a name="privacy"></a></p>
-<h2 id="privacy"><a class="wlink" href="#privacy"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Privacy</h2>
+<h2 id="privacy"><a class="wlink" href="#privacy"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Privacy <span class="uplinks"><a href="#miscellaneous">up</a> <a href="#toc">top</a></span></h2>
 <p>Clink does not collect user data.  Clink writes diagnostic information to its local log file, and does not transmit the log file off the local computer.  For the location of the log file, refer to <a href="#filelocations">File Locations</a> or run <code>clink info</code>.</p>
         </div>
-        <h1 id="lua-api"><a class="wlink" href="#lua-api"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Lua API Reference</h1>
-        This section describes the Clink Lua API extensions.
-        Also see <a href="https://www.lua.org/docs.html">Lua Documentation</a> and the <a href="https://www.lua.org/manual/5.2/">Lua 5.2 Manual</a> for more information about the Lua programming language.
         <div class="section" id="api">
-<h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>API groups</h3><svg style="display:none" xmlns="http://www.w3.org/2000/svg"><defs><symbol id="wicon" viewBox="0 0 16 16" fill="currentColor"><path d="M4.715 6.542 3.343 7.914a3 3 0 1 0 4.243 4.243l1.828-1.829A3 3 0 0 0 8.586 5.5L8 6.086a1.002 1.002 0 0 0-.154.199 2 2 0 0 1 .861 3.337L6.88 11.45a2 2 0 1 1-2.83-2.83l.793-.792a4.018 4.018 0 0 1-.128-1.287z"/><path d="M6.586 4.672A3 3 0 0 0 7.414 9.5l.775-.776a2 2 0 0 1-.896-3.346L9.12 3.55a2 2 0 1 1 2.83 2.83l-.793.792c.112.42.155.855.128 1.287l1.372-1.372a3 3 0 1 0-4.243-4.243L6.586 4.672z"/></symbol></defs></svg><p/><div class="toc"><div class="H1"><a href="#_argmatcher">_argmatcher</a></div><div class="H1"><a href="#builder">builder</a></div><div class="H1"><a href="#clink">clink</a></div><div class="H1"><a href="#console">console</a></div><div class="H1"><a href="#io">io</a></div><div class="H1"><a href="#line_state">line_state</a></div><div class="H1"><a href="#log">log</a></div><div class="H1"><a href="#matches">matches</a></div><div class="H1"><a href="#os">os</a></div><div class="H1"><a href="#path">path</a></div><div class="H1"><a href="#rl">rl</a></div><div class="H1"><a href="#rl_buffer">rl_buffer</a></div><div class="H1"><a href="#settings">settings</a></div><div class="H1"><a href="#string">string</a></div><div class="H1"><a href="#unicode">unicode</a></div><div class="H1"><a href="#word_classifications">word_classifications</a></div><div class="H1"><a href="#[other]">[other]</a></div><p/><div class="H1"><a href="#Deprecated"><em>Deprecated</em></a></div></div><div class="group"><h5 class="group_name"><a class="wlink" href="#_argmatcher"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher">_argmatcher</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:addarg"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:addarg">_argmatcher:addarg</a></div> <div class="signature">( <span class="arg_name">choices...</span>:string|table ) : self<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">This adds a new argument position with the matches given by <span class="arg">choices</span>.  Arguments can be a string, a string linked to another parser by the concatenation operator, a table of arguments, or a function that returns a table of arguments.  See <a href="#argumentcompletion">Argument Completion</a> for more information.</p><pre class="language-lua"><code>local my_parser = clink.argmatcher("make_color_shape")
+
+<h1 id="lua-api"><a class="wlink" href="#lua-api"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Lua API Reference <span class="uplinks"><a href="#toc">top</a></span></h1>
+<p>This section describes the Clink Lua API extensions.</p>
+<p>Also see <a href="https://www.lua.org/docs.html">Lua Documentation</a> and the <a href="https://www.lua.org/manual/5.2/">Lua 5.2 Manual</a> for more information about the Lua programming language.</p>
+<h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>API groups <span class="uplinks"><a href="#lua-api">up</a> <a href="#toc">top</a></span></h3>
+<svg style="display:none" xmlns="http://www.w3.org/2000/svg"><defs><symbol id="wicon" viewBox="0 0 16 16" fill="currentColor"><path d="M4.715 6.542 3.343 7.914a3 3 0 1 0 4.243 4.243l1.828-1.829A3 3 0 0 0 8.586 5.5L8 6.086a1.002 1.002 0 0 0-.154.199 2 2 0 0 1 .861 3.337L6.88 11.45a2 2 0 1 1-2.83-2.83l.793-.792a4.018 4.018 0 0 1-.128-1.287z"/><path d="M6.586 4.672A3 3 0 0 0 7.414 9.5l.775-.776a2 2 0 0 1-.896-3.346L9.12 3.55a2 2 0 1 1 2.83 2.83l-.793.792c.112.42.155.855.128 1.287l1.372-1.372a3 3 0 1 0-4.243-4.243L6.586 4.672z"/></symbol></defs></svg><p/><div class="toc"><div class="H1"><a href="#_argmatcher">_argmatcher</a></div><div class="H1"><a href="#builder">builder</a></div><div class="H1"><a href="#clink">clink</a></div><div class="H1"><a href="#console">console</a></div><div class="H1"><a href="#io">io</a></div><div class="H1"><a href="#line_state">line_state</a></div><div class="H1"><a href="#log">log</a></div><div class="H1"><a href="#matches">matches</a></div><div class="H1"><a href="#os">os</a></div><div class="H1"><a href="#path">path</a></div><div class="H1"><a href="#rl">rl</a></div><div class="H1"><a href="#rl_buffer">rl_buffer</a></div><div class="H1"><a href="#settings">settings</a></div><div class="H1"><a href="#string">string</a></div><div class="H1"><a href="#unicode">unicode</a></div><div class="H1"><a href="#word_classifications">word_classifications</a></div><div class="H1"><a href="#[other]">[other]</a></div><p/><div class="H1"><a href="#Deprecated"><em>Deprecated</em></a></div></div><div class="group">
+<h5 id="_argmatcher" class="group_name"><a class="wlink" href="#_argmatcher"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>_argmatcher: <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#_argmatcher:addarg">addarg</a></td><td><a href="#_argmatcher:chaincommand">chaincommand</a></td><td><a href="#_argmatcher:setclassifier">setclassifier</a></td></tr><tr><td><a href="#_argmatcher:addargunsorted">addargunsorted</a></td><td><a href="#_argmatcher:hideflags">hideflags</a></td><td><a href="#_argmatcher:setdelayinit">setdelayinit</a></td></tr><tr><td><a href="#_argmatcher:adddescriptions">adddescriptions</a></td><td><a href="#_argmatcher:loop">loop</a></td><td><a href="#_argmatcher:setendofflags">setendofflags</a></td></tr><tr><td><a href="#_argmatcher:addflags">addflags</a></td><td><a href="#_argmatcher:nofiles">nofiles</a></td><td><a href="#_argmatcher:setflagprefix">setflagprefix</a></td></tr><tr><td><a href="#_argmatcher:addflagsunsorted">addflagsunsorted</a></td><td><a href="#_argmatcher:reset">reset</a></td><td><a href="#_argmatcher:setflagsanywhere">setflagsanywhere</a></td></tr></table>
+<div class="function"><div class="header"> <div id="_argmatcher:addarg" class="name"><a class="wlink" href="#_argmatcher:addarg"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:addarg</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">choices...</span>:string|table ) : self<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">This adds a new argument position with the matches given by <span class="arg">choices</span>.  Arguments can be a string, a string linked to another parser by the concatenation operator, a table of arguments, or a function that returns a table of arguments.  See <a href="#argumentcompletion">Argument Completion</a> for more information.</p><pre class="language-lua"><code>local my_parser = clink.argmatcher("make_color_shape")
 :addarg("red", "green", "blue")             -- 1st argument is a color
 :addarg("circle", "square", "triangle")     -- 2nd argument is a shape</code></pre><p class="desc">When providing a table of arguments, the table can contain some special entries: <p><table> <tr><th>Entry</th><th>More Info</th><th>Version</th></tr> <tr><td><code>delayinit=<span class="arg">function</span></code></td><td>See <a href="#addarg_delayinit">Delayed initialization for an argument position</a>.</td><td class="version">v1.3.10 and newer</td></tr> <tr><td><code>fromhistory=true</code></td><td>See <a href="#addarg_fromhistory">Generate Matches From History</a>.</td><td class="version">v1.3.9 and newer</td></tr> <tr><td><code>loopchars="<span class="arg">characters</span>"</code></td><td>See <a href="#addarg_loopchars">Delimited Arguments</a>.</td><td class="version">v1.3.37 and newer</td></tr> <tr><td><code>nosort=true</code></td><td>See <a href="#addarg_nosort">Disable Sorting Matches</a>.</td><td class="version">v1.3.3 and newer</td></tr> <tr><td><code>onarg=<span class="arg">function</span></code></td><td>See <a href="#responsive-argmatchers">Responding to Arguments in Argmatchers</a>.</td><td class="version">v1.3.13 and newer</td></tr> </table></p> <strong>Note:</strong>  Arguments are positional in an argmatcher.  Using <code>:addarg()</code> multiple times adds multiple argument positions, in the order they are specified.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:addargunsorted"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:addargunsorted">_argmatcher:addargunsorted</a></div> <div class="signature">( <span class="arg_name">choices...</span>:string|table ) : self<br/><div class="version">v1.3.3 and newer</div></div></div><div class="body"><p class="desc">This is the same as <a href="#_argmatcher:addarg">_argmatcher:addarg</a> except that this disables sorting the matches.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:adddescriptions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:adddescriptions">_argmatcher:adddescriptions</a></div> <div class="signature">( [<span class="arg_name">descriptions...</span>:table] ) : self<br/><div class="version">v1.2.38 and newer</div></div></div><div class="body"><p class="desc">Adds descriptions for arg matches and/or flag matches.  Descriptions are displayed for their associated args or flags whenever possible completions are listed, for example by the <code><a href="#rlcmd-complete">complete</a></code> or <code><a href="#rlcmd-clink-select-complete">clink-select-complete</a></code> or <code><a href="#rlcmd-possible-completions">possible-completions</a></code> commands.</p><p class="desc"> Any number of descriptions tables may be passed to the function, and each table must use one of the following schemes: <ul> <li>One or more string values that are args or flags, and a <code>description</code> field that is the associated description string. <li>Key/value pairs where each key is an arg or flag, and its value is either a description string or a table containing an optional argument info string and a description string.  If an argument info string is provided, it is appended to the arg or flag string when listing possible completions. For example, <code>["--user"] = { " name", "Specify username"}</code> gets printed as:</p><p class="desc"> <pre style="border-radius:initial;border:initial;background-color:black"><code class="plaintext" style="background-color:black"> <span class="color_default">--user</span> <span class="color_arginfo">name</span>&nbsp;&nbsp;&nbsp;&nbsp;<span class="color_description">Specify username</span> </code></pre> </ul></p><p class="desc"></p><pre class="language-lua"><code>local foo = clink.argmatcher("foo")
+
+<div class="function"><div class="header"> <div id="_argmatcher:addargunsorted" class="name"><a class="wlink" href="#_argmatcher:addargunsorted"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:addargunsorted</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">choices...</span>:string|table ) : self<br/><div class="version">v1.3.3 and newer</div></div></div><div class="body"><p class="desc">This is the same as <a href="#_argmatcher:addarg">_argmatcher:addarg</a> except that this disables sorting the matches.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:adddescriptions" class="name"><a class="wlink" href="#_argmatcher:adddescriptions"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:adddescriptions</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">descriptions...</span>:table] ) : self<br/><div class="version">v1.2.38 and newer</div></div></div><div class="body"><p class="desc">Adds descriptions for arg matches and/or flag matches.  Descriptions are displayed for their associated args or flags whenever possible completions are listed, for example by the <code><a href="#rlcmd-complete">complete</a></code> or <code><a href="#rlcmd-clink-select-complete">clink-select-complete</a></code> or <code><a href="#rlcmd-possible-completions">possible-completions</a></code> commands.</p><p class="desc"> Any number of descriptions tables may be passed to the function, and each table must use one of the following schemes: <ul> <li>One or more string values that are args or flags, and a <code>description</code> field that is the associated description string. <li>Key/value pairs where each key is an arg or flag, and its value is either a description string or a table containing an optional argument info string and a description string.  If an argument info string is provided, it is appended to the arg or flag string when listing possible completions. For example, <code>["--user"] = { " name", "Specify username"}</code> gets printed as:</p><p class="desc"> <pre style="border-radius:initial;border:initial;background-color:black"><code class="plaintext" style="background-color:black"> <span class="color_default">--user</span> <span class="color_arginfo">name</span>&nbsp;&nbsp;&nbsp;&nbsp;<span class="color_description">Specify username</span> </code></pre> </ul></p><p class="desc"></p><pre class="language-lua"><code>local foo = clink.argmatcher("foo")
 foo:addflags("-h", "--help", "--user")
 foo:addarg("info", "set")
 -- Example using first scheme and one table per description:
@@ -6447,11 +6648,14 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;   ["-h"] = "Show help",
 &nbsp;   -- etc
 })</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:addflags"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:addflags">_argmatcher:addflags</a></div> <div class="signature">( <span class="arg_name">flags...</span>:string ) : self<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">This adds flag matches.  Flags are separate from arguments:  When listing possible completions for an empty word, only arguments are listed.  But when the word being completed starts with the first character of any of the flags, then only flags are listed.  See <a href="#argumentcompletion">Argument Completion</a> for more information.</p><pre class="language-lua"><code>local my_parser = clink.argmatcher("git")
+
+<div class="function"><div class="header"> <div id="_argmatcher:addflags" class="name"><a class="wlink" href="#_argmatcher:addflags"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:addflags</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">flags...</span>:string ) : self<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">This adds flag matches.  Flags are separate from arguments:  When listing possible completions for an empty word, only arguments are listed.  But when the word being completed starts with the first character of any of the flags, then only flags are listed.  See <a href="#argumentcompletion">Argument Completion</a> for more information.</p><pre class="language-lua"><code>local my_parser = clink.argmatcher("git")
 :addarg({ "add", "status", "commit", "checkout" })
 :addflags("-a", "-g", "-p", "--help")</code></pre><p class="desc">When providing a table of flags, the table can contain some special entries: <p><table> <tr><th>Entry</th><th>More Info</th><th>Version</th></tr> <tr><td><code>delayinit=<span class="arg">function</span></code></td><td>See <a href="#addarg_delayinit">Delayed initialization for an argument position</a>.</td><td class="version">v1.3.10 and newer</td></tr> <tr><td><code>fromhistory=true</code></td><td>See <a href="#addarg_fromhistory">Generate Matches From History</a>.</td><td class="version">v1.3.9 and newer</td></tr> <tr><td><code>nosort=true</code></td><td>See <a href="#addarg_nosort">Disable Sorting Matches</a>.</td><td class="version">v1.3.3 and newer</td></tr> <tr><td><code>onarg=<span class="arg">function</span></code></td><td>See <a href="#responsive-argmatchers">Responding to Arguments in Argmatchers</a>.</td><td class="version">v1.3.13 and newer</td></tr> </table></p> <strong>Note:</strong>  Flags are not positional in an argmatcher.  Using <code>:addarg()</code> multiple times with different flags is the same as using <code>:addarg()</code> once with all of the flags.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:addflagsunsorted"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:addflagsunsorted">_argmatcher:addflagsunsorted</a></div> <div class="signature">( <span class="arg_name">flags...</span>:string ) : self<br/><div class="version">v1.3.3 and newer</div></div></div><div class="body"><p class="desc">This is the same as <a href="#_argmatcher:addflags">_argmatcher:addflags</a> except that this also disables sorting for flags.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:chaincommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:chaincommand">_argmatcher:chaincommand</a></div> <div class="signature">() : self<br/><div class="version">v1.3.13 and newer</div></div></div><div class="body"><p class="desc">This makes the rest of the line be parsed as a separate command, after the argmatcher reaches the end of its defined argument positions.  You can use it to "chain" from one parser to another.</p><p class="desc"> For example, <code>cmd.exe program arg</code> is example of a line where one command can have another command within it.  <code>:chaincommand()</code> enables <code>program arg</code> to be parsed separately.  If <code>program</code> has an argmatcher, then it takes over and parses the rest of the input line.</p><p class="desc"> An example that chains in a linked argmatcher:</p><pre class="language-lua"><code>clink.argmatcher("program"):addflags("/x", "/y")
+
+<div class="function"><div class="header"> <div id="_argmatcher:addflagsunsorted" class="name"><a class="wlink" href="#_argmatcher:addflagsunsorted"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:addflagsunsorted</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">flags...</span>:string ) : self<br/><div class="version">v1.3.3 and newer</div></div></div><div class="body"><p class="desc">This is the same as <a href="#_argmatcher:addflags">_argmatcher:addflags</a> except that this also disables sorting for flags.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:chaincommand" class="name"><a class="wlink" href="#_argmatcher:chaincommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:chaincommand</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : self<br/><div class="version">v1.3.13 and newer</div></div></div><div class="body"><p class="desc">This makes the rest of the line be parsed as a separate command, after the argmatcher reaches the end of its defined argument positions.  You can use it to "chain" from one parser to another.</p><p class="desc"> For example, <code>cmd.exe program arg</code> is example of a line where one command can have another command within it.  <code>:chaincommand()</code> enables <code>program arg</code> to be parsed separately.  If <code>program</code> has an argmatcher, then it takes over and parses the rest of the input line.</p><p class="desc"> An example that chains in a linked argmatcher:</p><pre class="language-lua"><code>clink.argmatcher("program"):addflags("/x", "/y")
 clink.argmatcher("cmd"):addflags(
 &nbsp;   "/c" .. clink.argmatcher():chaincommand(),
 &nbsp;   "/k" .. clink.argmatcher():chaincommand()
@@ -6475,31 +6679,44 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 -- "profile1" is colored as an argument (for "exec").
 -- "program" is colored as an argmatcher.
 -- "-" generates completions "-x" and "-y".</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:hideflags"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:hideflags">_argmatcher:hideflags</a></div> <div class="signature">( <span class="arg_name">flags...</span>:string ) : self<br/><div class="version">v1.3.3 and newer</div></div></div><div class="body"><p class="desc">This hides the specified flags when displaying possible completions (the flags are still recognized).</p><p class="desc"> This is intended for use when there are several synonyms for a flag, so that input coloring and linked argmatchers work, without cluttering the possible completion list.</p><pre class="language-lua"><code>local dirs = clink.argmatcher():addarg(clink.dirmatches)
+
+<div class="function"><div class="header"> <div id="_argmatcher:hideflags" class="name"><a class="wlink" href="#_argmatcher:hideflags"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:hideflags</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">flags...</span>:string ) : self<br/><div class="version">v1.3.3 and newer</div></div></div><div class="body"><p class="desc">This hides the specified flags when displaying possible completions (the flags are still recognized).</p><p class="desc"> This is intended for use when there are several synonyms for a flag, so that input coloring and linked argmatchers work, without cluttering the possible completion list.</p><pre class="language-lua"><code>local dirs = clink.argmatcher():addarg(clink.dirmatches)
 local my_parser = clink.argmatcher("mycommand")
 :addflags("-a", "--a", "--al", "--all",
 &nbsp;         "-d"..dirs, "--d"..dirs, "--di"..dirs, "--dir"..dirs)
 :hideflags("--a", "--al", "--all",      -- Only "-a" is displayed.
 &nbsp;          "-d", "--d", "--di")         -- Only "--dir" is displayed.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:loop"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:loop">_argmatcher:loop</a></div> <div class="signature">( [<span class="arg_name">index</span>:integer] ) : self<br/><div class="version">v0.4.9 and newer</div></div></div><div class="body"><p class="desc">This makes the parser loop back to argument position <span class="arg">index</span> when it runs out of positional sets of arguments (if <span class="arg">index</span> is omitted it loops back to argument position 1).</p><pre class="language-lua"><code>clink.argmatcher("xyzzy")
+
+<div class="function"><div class="header"> <div id="_argmatcher:loop" class="name"><a class="wlink" href="#_argmatcher:loop"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:loop</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">index</span>:integer] ) : self<br/><div class="version">v0.4.9 and newer</div></div></div><div class="body"><p class="desc">This makes the parser loop back to argument position <span class="arg">index</span> when it runs out of positional sets of arguments (if <span class="arg">index</span> is omitted it loops back to argument position 1).</p><pre class="language-lua"><code>clink.argmatcher("xyzzy")
 :addarg("zero", "cero")     -- first arg can be zero or cero
 :addarg("one", "uno")       -- second arg can be one or uno
 :addarg("two", "dos")       -- third arg can be two or dos
 :loop(2)    -- fourth arg loops back to position 2, for one or uno, and so on</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:nofiles"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:nofiles">_argmatcher:nofiles</a></div> <div class="signature">() : self<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">This makes the parser prevent invoking <a href="#matchgenerators">match generators</a>.  You can use it to "dead end" a parser and suggest no completions.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:reset"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:reset">_argmatcher:reset</a></div> <div class="signature">() : self<br/><div class="version">v1.3.10 and newer</div></div></div><div class="body"><p class="desc">Resets the argmatcher to an empty state.  All flags, arguments, and settings are cleared and reset back to a freshly-created state.</p><p class="desc"> See <a href="#adaptive-argmatchers">Adaptive Argmatchers</a> for more information.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:setclassifier"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:setclassifier">_argmatcher:setclassifier</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : self<br/><div class="version">v1.1.18 and newer</div></div></div><div class="body"><p class="desc">This registers a function that gets called for each word the argmatcher handles, to classify the word as part of coloring the input text.  See <a href="#classifywords">Coloring the Input Text</a> for more information.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:setdelayinit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:setdelayinit">_argmatcher:setdelayinit</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : self<br/><div class="version">v1.3.10 and newer</div></div></div><div class="body"><p class="desc">This registers a function that gets called the first time the argmatcher is used in each edit line session.  See <a href="#adaptive-argmatchers">Adaptive Argmatchers</a> for more information.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:setendofflags"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:setendofflags">_argmatcher:setendofflags</a></div> <div class="signature">( [<span class="arg_name">endofflags</span>:string|boolean] ) : self<br/><div class="version">v1.3.12 and newer</div></div></div><div class="body"><p class="desc">When <span class="arg">endofflags</span> is a string, it is a special flag that signals the end of flags.  When <span class="arg">endflags</span> is true or nil, then "<code>--</code>" is used as the end of flags string. Otherwise, the end of flags string is cleared.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:setflagprefix"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:setflagprefix">_argmatcher:setflagprefix</a></div> <div class="signature">( [<span class="arg_name">prefixes...</span>:string] ) : self<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">This is almost never needed, because <code>:addflags()</code> automatically identifies flag prefix characters.</p><p class="desc"> However, any flags generated by functions can't influence the automatic flag prefix character(s) detection.  So in some cases it may be necessary to directly set the flag prefix.</p><p class="desc"> <strong>Note:</strong> <code>:setflagprefix()</code> behaves differently in different versions of Clink: <table> <tr><th>Version</th><th>Description</th></tr> <tr><td>v1.0.0 through v1.1.3</td><td>Sets the flag prefix characters.</td></tr> <tr><td>v1.1.4 through v1.2.35</td><td>Only sets flag prefix characters in an argmatcher created using the deprecated <a href="#clink.arg.register_parser">clink.arg.register_parser()</a> function.  Otherwise it has no effect.</td></tr> <tr><td>v1.2.36 through v1.3.8</td><td>Does nothing.</td></tr> <tr><td>v1.3.9 onward</td><td>Adds flag prefix characters, in addition to the ones automatically identified.</td></tr> </table></p><pre class="language-lua"><code>local function make_flags()
+
+<div class="function"><div class="header"> <div id="_argmatcher:nofiles" class="name"><a class="wlink" href="#_argmatcher:nofiles"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:nofiles</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : self<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">This makes the parser prevent invoking <a href="#matchgenerators">match generators</a>.  You can use it to "dead end" a parser and suggest no completions.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:reset" class="name"><a class="wlink" href="#_argmatcher:reset"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:reset</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : self<br/><div class="version">v1.3.10 and newer</div></div></div><div class="body"><p class="desc">Resets the argmatcher to an empty state.  All flags, arguments, and settings are cleared and reset back to a freshly-created state.</p><p class="desc"> See <a href="#adaptive-argmatchers">Adaptive Argmatchers</a> for more information.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:setclassifier" class="name"><a class="wlink" href="#_argmatcher:setclassifier"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:setclassifier</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : self<br/><div class="version">v1.1.18 and newer</div></div></div><div class="body"><p class="desc">This registers a function that gets called for each word the argmatcher handles, to classify the word as part of coloring the input text.  See <a href="#classifywords">Coloring the Input Text</a> for more information.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:setdelayinit" class="name"><a class="wlink" href="#_argmatcher:setdelayinit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:setdelayinit</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : self<br/><div class="version">v1.3.10 and newer</div></div></div><div class="body"><p class="desc">This registers a function that gets called the first time the argmatcher is used in each edit line session.  See <a href="#adaptive-argmatchers">Adaptive Argmatchers</a> for more information.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:setendofflags" class="name"><a class="wlink" href="#_argmatcher:setendofflags"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:setendofflags</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">endofflags</span>:string|boolean] ) : self<br/><div class="version">v1.3.12 and newer</div></div></div><div class="body"><p class="desc">When <span class="arg">endofflags</span> is a string, it is a special flag that signals the end of flags.  When <span class="arg">endflags</span> is true or nil, then "<code>--</code>" is used as the end of flags string. Otherwise, the end of flags string is cleared.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:setflagprefix" class="name"><a class="wlink" href="#_argmatcher:setflagprefix"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:setflagprefix</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">prefixes...</span>:string] ) : self<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">This is almost never needed, because <code>:addflags()</code> automatically identifies flag prefix characters.</p><p class="desc"> However, any flags generated by functions can't influence the automatic flag prefix character(s) detection.  So in some cases it may be necessary to directly set the flag prefix.</p><p class="desc"> <strong>Note:</strong> <code>:setflagprefix()</code> behaves differently in different versions of Clink: <table> <tr><th>Version</th><th>Description</th></tr> <tr><td>v1.0.0 through v1.1.3</td><td>Sets the flag prefix characters.</td></tr> <tr><td>v1.1.4 through v1.2.35</td><td>Only sets flag prefix characters in an argmatcher created using the deprecated <a href="#clink.arg.register_parser">clink.arg.register_parser()</a> function.  Otherwise it has no effect.</td></tr> <tr><td>v1.2.36 through v1.3.8</td><td>Does nothing.</td></tr> <tr><td>v1.3.9 onward</td><td>Adds flag prefix characters, in addition to the ones automatically identified.</td></tr> </table></p><pre class="language-lua"><code>local function make_flags()
 &nbsp;   return { '-a', '-b', '-c' }
 end
 
 clink.argmatcher('some_command')
 :addflags(make_flags)   -- Only a function is added, so flag prefix characters cannot be determined automatically.
 :setflagprefix('-')     -- Force '-' to be considered as a flag prefix character.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:setflagsanywhere"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:setflagsanywhere">_argmatcher:setflagsanywhere</a></div> <div class="signature">( <span class="arg_name">anywhere</span>:boolean ) : self<br/><div class="version">v1.3.12 and newer</div></div></div><div class="body"><p class="desc">When <span class="arg">anywhere</span> is false, flags are only recognized until an argument is encountered.  Otherwise they are recognized anywhere (which is the default).</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#builder"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder">builder</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#builder:addmatch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder:addmatch">builder:addmatch</a></div> <div class="signature">( <span class="arg_name">match</span>:string|table, [<span class="arg_name">type</span>:string] ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Adds a match.</p><p class="desc"> The <span class="arg">match</span> argument is the match string to add.</p><p class="desc"> The <span class="arg">type</span> argument is the optional match type, or "none" if omitted (see below for the possible match types).</p><p class="desc"> Alternatively, the <span class="arg">match</span> argument can be a table with the following scheme:</p><pre class="language-lua"><code>{
+
+<div class="function"><div class="header"> <div id="_argmatcher:setflagsanywhere" class="name"><a class="wlink" href="#_argmatcher:setflagsanywhere"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:setflagsanywhere</span> <span class="uplinks"><a href="#_argmatcher">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">anywhere</span>:boolean ) : self<br/><div class="version">v1.3.12 and newer</div></div></div><div class="body"><p class="desc">When <span class="arg">anywhere</span> is false, flags are only recognized until an argument is encountered.  Otherwise they are recognized anywhere (which is the default).</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="builder" class="group_name"><a class="wlink" href="#builder"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>builder: <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#builder:addmatch">addmatch</a></td><td><a href="#builder:setfullyqualify">setfullyqualify</a></td></tr><tr><td><a href="#builder:addmatches">addmatches</a></td><td><a href="#builder:setnosort">setnosort</a></td></tr><tr><td><a href="#builder:isempty">isempty</a></td><td><a href="#builder:setsuppressappend">setsuppressappend</a></td></tr><tr><td><a href="#builder:setappendcharacter">setappendcharacter</a></td><td><a href="#builder:setsuppressquoting">setsuppressquoting</a></td></tr><tr><td><a href="#builder:setforcequoting">setforcequoting</a></td><td><a href="#builder:setvolatile">setvolatile</a></td></tr></table>
+<div class="function"><div class="header"> <div id="builder:addmatch" class="name"><a class="wlink" href="#builder:addmatch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>builder:addmatch</span> <span class="uplinks"><a href="#builder">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">match</span>:string|table, [<span class="arg_name">type</span>:string] ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Adds a match.</p><p class="desc"> The <span class="arg">match</span> argument is the match string to add.</p><p class="desc"> The <span class="arg">type</span> argument is the optional match type, or "none" if omitted (see below for the possible match types).</p><p class="desc"> Alternatively, the <span class="arg">match</span> argument can be a table with the following scheme:</p><pre class="language-lua"><code>{
 &nbsp;   match           = "..."    -- [string] The match text.
 &nbsp;   display         = "..."    -- [string] OPTIONAL; alternative text to display when listing possible completions.
 &nbsp;   arginfo         = "..."    -- [string] OPTIONAL; an argument info string (requires v1.5.4 or greater).
@@ -6514,28 +6731,44 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 builder:addmatch({ match="foo.cpp", type="file" })
 builder:addmatch({ match="bar", type="dir" })
 builder:addmatch({ match=".git", type="dir,hidden" })</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#builder:addmatches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder:addmatches">builder:addmatches</a></div> <div class="signature">( <span class="arg_name">matches</span>:table, [<span class="arg_name">type</span>:string] ) : integer, boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">This is the equivalent of calling <a href="#builder:addmatch">builder:addmatch()</a> in a for-loop. Returns the number of matches added and a boolean indicating if all matches were added successfully.</p><p class="desc"> The <span class="arg">matches</span> argument can be a table of match strings, or a table of tables describing the matches.</p><p class="desc"> The <span class="arg">type</span> argument is used as the type when a match doesn't explicitly include a type, and is "none" if omitted.</p><pre class="language-lua"><code>builder:addmatches({"abc", "def"}) -- Adds two matches of type "none"
+
+<div class="function"><div class="header"> <div id="builder:addmatches" class="name"><a class="wlink" href="#builder:addmatches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>builder:addmatches</span> <span class="uplinks"><a href="#builder">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">matches</span>:table, [<span class="arg_name">type</span>:string] ) : integer, boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">This is the equivalent of calling <a href="#builder:addmatch">builder:addmatch()</a> in a for-loop. Returns the number of matches added and a boolean indicating if all matches were added successfully.</p><p class="desc"> The <span class="arg">matches</span> argument can be a table of match strings, or a table of tables describing the matches.</p><p class="desc"> The <span class="arg">type</span> argument is used as the type when a match doesn't explicitly include a type, and is "none" if omitted.</p><pre class="language-lua"><code>builder:addmatches({"abc", "def"}) -- Adds two matches of type "none"
 builder:addmatches({"abc", "def"}, "file") -- Adds two matches of type "file"
 builder:addmatches({
 &nbsp;   -- Same table scheme per entry here as in builder:addmatch()
 &nbsp;   { match="remote/origin/master", type="word" },
 &nbsp;   { match="remote/origin/topic", type="word" }
 })</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#builder:isempty"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder:isempty">builder:isempty</a></div> <div class="signature">() : boolean<br/><div class="version">v1.3.9 and newer</div></div></div><div class="body"><p class="desc">Returns whether the match builder is empty.  It is empty when no matches have been added yet.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#builder:setappendcharacter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder:setappendcharacter">builder:setappendcharacter</a></div> <div class="signature">( [<span class="arg_name">append</span>:string] ) : nil<br/><div class="version">v1.1.2 and newer</div></div></div><div class="body"><p class="desc">Sets character to append after matches.  For example the <code>set</code> match generator uses this to append "=" when completing matches, so that completing <code>set USER</code> becomes <code>set USERDOMAIN=</code> (rather than <code>set USERDOMAIN&nbsp;</code>).</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#builder:setforcequoting"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder:setforcequoting">builder:setforcequoting</a></div> <div class="signature">() : nil<br/><div class="version">v1.4.19 and newer</div></div></div><div class="body"><p class="desc">Forces quoting rules to be applied to matches even if they aren't filenames.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#builder:setfullyqualify"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder:setfullyqualify">builder:setfullyqualify</a></div> <div class="signature">( [<span class="arg_name">fullyqualify</span>:boolean] ) : nil<br/><div class="version">v1.5.3 and newer</div></div></div><div class="body"><p class="desc">Forces completions to be inserted as fully qualified paths.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#builder:setnosort"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder:setnosort">builder:setnosort</a></div> <div class="signature">() : nil<br/><div class="version">v1.3.3 and newer</div></div></div><div class="body"><p class="desc">Turns off sorting the matches.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#builder:setsuppressappend"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder:setsuppressappend">builder:setsuppressappend</a></div> <div class="signature">( [<span class="arg_name">state</span>:boolean] ) : nil<br/><div class="version">v1.1.2 and newer</div></div></div><div class="body"><p class="desc">Sets whether to suppress appending anything after the match except a possible closing quote.  For example the env var match generator uses this.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#builder:setsuppressquoting"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder:setsuppressquoting">builder:setsuppressquoting</a></div> <div class="signature">( [<span class="arg_name">state</span>:integer] ) : nil<br/><div class="version">v1.1.2 and newer</div></div></div><div class="body"><p class="desc">Sets whether to suppress quoting for the matches.  Set to 0 for normal quoting, or 1 to suppress quoting, or 2 to suppress end quotes.  For example the env var match generator sets this to 1 to overcome the quoting that would normally happen for "%" characters in filenames.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#builder:setvolatile"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="builder:setvolatile">builder:setvolatile</a></div> <div class="signature">() : nil<br/><div class="version">v1.3.37 and newer</div></div></div><div class="body"><p class="desc">Forces the generated matches to be used only once.</p><p class="desc"> Normally Clink tries to reuse the most recently generated list of matches, if possible.  It is an optimization, to avoid doing potentally expensive work multiple times in a row to generate the same list of matches when nothing has changed.  Normally the optimization is beneficial, and typing more letters in a word can simply filter the existing list of matches.</p><p class="desc"> But sometimes an argument may have special syntax.  For example, an email address argument might want to generate matches for names until the word contains a <code>@</code>, and then it might want to generate matches for domain names.  The optimization interferes with situations where parsing the word produces a completely different list of possible matches.</p><p class="desc"> Making the generated matches volatile ensures matches are generated anew each time completion is invoked.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#clink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink">clink</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.argmatcher"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.argmatcher">clink.argmatcher</a></div> <div class="signature">( [<span class="arg_name">priority</span>:integer], <span class="arg_name">commands...</span>:string ) : <a href="#_argmatcher">_argmatcher</a><br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new argument matcher parser object.  Use <a href="#_argmatcher:addarg">:addarg()</a> and etc to add arguments, flags, other parsers, and more.  See <a href="#argumentcompletion">Argument Completion</a> for more information.</p><p class="desc"> If one <span class="arg">command</span> is provided and there is already an argmatcher for it, then this returns the existing parser rather than creating a new parser.  Using :addarg() starts at arg position 1, making it possible to merge new args and etc into the existing parser.</p><p class="desc"> In Clink v1.3.38 and higher, if a <span class="arg">command</span> is a fully qualified path, then it is only used when the typed command expands to the same fully qualified path.  This makes it possible to create one argmatcher for <code>c:\general\program.exe</code> and another for <code>c:\special\program.exe</code>.  For example, aliases may be used to make both programs runnable, or the system PATH might be changed temporarily while working in a particular context.</p><p class="desc"> <strong>Note:</strong>  Merging <a href="#argmatcher_linking">linked argmatchers</a> only merges the first argument position.  The merge is simple, but should be sufficient for common simple cases.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.classifier"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.classifier">clink.classifier</a></div> <div class="signature">( [<span class="arg_name">priority</span>:integer] ) : table<br/><div class="version">v1.1.49 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new word classifier object.  Define on the object a <code>:classify()</code> function which gets called in increasing <span class="arg">priority</span> order (low values to high values) when classifying words for coloring the input.  See <a href="#classifywords">Coloring the Input Text</a> for more information.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.dirmatches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.dirmatches">clink.dirmatches</a></div> <div class="signature">( <span class="arg_name">word</span>:string ) : table<br/><div class="version">v1.1.18 and newer</div></div></div><div class="body"><p class="desc">You can use this function in an argmatcher to supply directory matches. This automatically handles Readline tilde completion.</p><pre class="language-lua"><code>-- Make "cd" generate directory matches (no files).
+
+<div class="function"><div class="header"> <div id="builder:isempty" class="name"><a class="wlink" href="#builder:isempty"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>builder:isempty</span> <span class="uplinks"><a href="#builder">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : boolean<br/><div class="version">v1.3.9 and newer</div></div></div><div class="body"><p class="desc">Returns whether the match builder is empty.  It is empty when no matches have been added yet.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="builder:setappendcharacter" class="name"><a class="wlink" href="#builder:setappendcharacter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>builder:setappendcharacter</span> <span class="uplinks"><a href="#builder">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">append</span>:string] ) : nil<br/><div class="version">v1.1.2 and newer</div></div></div><div class="body"><p class="desc">Sets character to append after matches.  For example the <code>set</code> match generator uses this to append "=" when completing matches, so that completing <code>set USER</code> becomes <code>set USERDOMAIN=</code> (rather than <code>set USERDOMAIN&nbsp;</code>).</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="builder:setforcequoting" class="name"><a class="wlink" href="#builder:setforcequoting"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>builder:setforcequoting</span> <span class="uplinks"><a href="#builder">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.4.19 and newer</div></div></div><div class="body"><p class="desc">Forces quoting rules to be applied to matches even if they aren't filenames.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="builder:setfullyqualify" class="name"><a class="wlink" href="#builder:setfullyqualify"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>builder:setfullyqualify</span> <span class="uplinks"><a href="#builder">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">fullyqualify</span>:boolean] ) : nil<br/><div class="version">v1.5.3 and newer</div></div></div><div class="body"><p class="desc">Forces completions to be inserted as fully qualified paths.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="builder:setnosort" class="name"><a class="wlink" href="#builder:setnosort"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>builder:setnosort</span> <span class="uplinks"><a href="#builder">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.3.3 and newer</div></div></div><div class="body"><p class="desc">Turns off sorting the matches.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="builder:setsuppressappend" class="name"><a class="wlink" href="#builder:setsuppressappend"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>builder:setsuppressappend</span> <span class="uplinks"><a href="#builder">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">state</span>:boolean] ) : nil<br/><div class="version">v1.1.2 and newer</div></div></div><div class="body"><p class="desc">Sets whether to suppress appending anything after the match except a possible closing quote.  For example the env var match generator uses this.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="builder:setsuppressquoting" class="name"><a class="wlink" href="#builder:setsuppressquoting"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>builder:setsuppressquoting</span> <span class="uplinks"><a href="#builder">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">state</span>:integer] ) : nil<br/><div class="version">v1.1.2 and newer</div></div></div><div class="body"><p class="desc">Sets whether to suppress quoting for the matches.  Set to 0 for normal quoting, or 1 to suppress quoting, or 2 to suppress end quotes.  For example the env var match generator sets this to 1 to overcome the quoting that would normally happen for "%" characters in filenames.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="builder:setvolatile" class="name"><a class="wlink" href="#builder:setvolatile"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>builder:setvolatile</span> <span class="uplinks"><a href="#builder">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.3.37 and newer</div></div></div><div class="body"><p class="desc">Forces the generated matches to be used only once.</p><p class="desc"> Normally Clink tries to reuse the most recently generated list of matches, if possible.  It is an optimization, to avoid doing potentally expensive work multiple times in a row to generate the same list of matches when nothing has changed.  Normally the optimization is beneficial, and typing more letters in a word can simply filter the existing list of matches.</p><p class="desc"> But sometimes an argument may have special syntax.  For example, an email address argument might want to generate matches for names until the word contains a <code>@</code>, and then it might want to generate matches for domain names.  The optimization interferes with situations where parsing the word produces a completely different list of possible matches.</p><p class="desc"> Making the generated matches volatile ensures matches are generated anew each time completion is invoked.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="clink" class="group_name"><a class="wlink" href="#clink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>clink. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#clink.argmatcher">argmatcher</a></td><td><a href="#clink.onbeginedit">onbeginedit</a></td><td><a href="#clink.popuplist">popuplist</a></td><td><a href="#clink.setcoroutineinterval">setcoroutineinterval</a></td></tr><tr><td><a href="#clink.classifier">classifier</a></td><td><a href="#clink.oncommand">oncommand</a></td><td><a href="#clink.print">print</a></td><td><a href="#clink.setcoroutinename">setcoroutinename</a></td></tr><tr><td><a href="#clink.dirmatches">dirmatches</a></td><td><a href="#clink.ondisplaymatches">ondisplaymatches</a></td><td><a href="#clink.promptcoroutine">promptcoroutine</a></td><td><a href="#clink.suggester">suggester</a></td></tr><tr><td><a href="#clink.filematches">filematches</a></td><td><a href="#clink.onendedit">onendedit</a></td><td><a href="#clink.promptfilter">promptfilter</a></td><td><a href="#clink.translateslashes">translateslashes</a></td></tr><tr><td><a href="#clink.generator">generator</a></td><td><a href="#clink.onfilterinput">onfilterinput</a></td><td><a href="#clink.reclassifyline">reclassifyline</a></td><td><a href="#clink.upper">upper</a></td></tr><tr><td><a href="#clink.getansihost">getansihost</a></td><td><a href="#clink.onfiltermatches">onfiltermatches</a></td><td><a href="#clink.recognizecommand">recognizecommand</a></td><td><a href="#clink.version_commit">version_commit</a></td></tr><tr><td><a href="#clink.getargmatcher">getargmatcher</a></td><td><a href="#clink.onhistory">onhistory</a></td><td><a href="#clink.refilterafterterminalresize">refilterafterterminalresize</a></td><td><a href="#clink.version_encoded">version_encoded</a></td></tr><tr><td><a href="#clink.getpopuplistcolors">getpopuplistcolors</a></td><td><a href="#clink.oninject">oninject</a></td><td><a href="#clink.refilterprompt">refilterprompt</a></td><td><a href="#clink.version_major">version_major</a></td></tr><tr><td><a href="#clink.getsession">getsession</a></td><td><a href="#clink.oninputlinechanged">oninputlinechanged</a></td><td><a href="#clink.reload">reload</a></td><td><a href="#clink.version_minor">version_minor</a></td></tr><tr><td><a href="#clink.lower">lower</a></td><td><a href="#clink.onprovideline">onprovideline</a></td><td><a href="#clink.runcoroutineuntilcomplete">runcoroutineuntilcomplete</a></td><td><a href="#clink.version_patch">version_patch</a></td></tr><tr><td><a href="#clink.onaftercommand">onaftercommand</a></td><td><a href="#clink.parseline">parseline</a></td><td><a href="#clink.runonmain">runonmain</a></td></tr></table>
+<div class="function"><div class="header"> <div id="clink.argmatcher" class="name"><a class="wlink" href="#clink.argmatcher"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.argmatcher</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">priority</span>:integer], <span class="arg_name">commands...</span>:string ) : <a href="#_argmatcher">_argmatcher</a><br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new argument matcher parser object.  Use <a href="#_argmatcher:addarg">:addarg()</a> and etc to add arguments, flags, other parsers, and more.  See <a href="#argumentcompletion">Argument Completion</a> for more information.</p><p class="desc"> If one <span class="arg">command</span> is provided and there is already an argmatcher for it, then this returns the existing parser rather than creating a new parser.  Using :addarg() starts at arg position 1, making it possible to merge new args and etc into the existing parser.</p><p class="desc"> In Clink v1.3.38 and higher, if a <span class="arg">command</span> is a fully qualified path, then it is only used when the typed command expands to the same fully qualified path.  This makes it possible to create one argmatcher for <code>c:\general\program.exe</code> and another for <code>c:\special\program.exe</code>.  For example, aliases may be used to make both programs runnable, or the system PATH might be changed temporarily while working in a particular context.</p><p class="desc"> <strong>Note:</strong>  Merging <a href="#argmatcher_linking">linked argmatchers</a> only merges the first argument position.  The merge is simple, but should be sufficient for common simple cases.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.classifier" class="name"><a class="wlink" href="#clink.classifier"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.classifier</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">priority</span>:integer] ) : table<br/><div class="version">v1.1.49 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new word classifier object.  Define on the object a <code>:classify()</code> function which gets called in increasing <span class="arg">priority</span> order (low values to high values) when classifying words for coloring the input.  See <a href="#classifywords">Coloring the Input Text</a> for more information.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.dirmatches" class="name"><a class="wlink" href="#clink.dirmatches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.dirmatches</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">word</span>:string ) : table<br/><div class="version">v1.1.18 and newer</div></div></div><div class="body"><p class="desc">You can use this function in an argmatcher to supply directory matches. This automatically handles Readline tilde completion.</p><pre class="language-lua"><code>-- Make "cd" generate directory matches (no files).
 clink.argmatcher("cd")
 :addflags("/d")
 :addarg({ clink.dirmatches })</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.filematches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.filematches">clink.filematches</a></div> <div class="signature">( <span class="arg_name">word</span>:string ) : table<br/><div class="version">v1.1.18 and newer</div></div></div><div class="body"><p class="desc">You can use this function in an argmatcher to supply file matches.  This automatically handles Readline tilde completion.</p><p class="desc"> Argmatchers default to matching files, so it's unusual to need this function.  However, some exceptions are when a flag needs to accept file matches but other flags and arguments don't, or when matches need to include more than files.</p><pre class="language-lua"><code>-- Make "foo --file" generate file matches, but other flags and args don't.
+
+<div class="function"><div class="header"> <div id="clink.filematches" class="name"><a class="wlink" href="#clink.filematches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.filematches</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">word</span>:string ) : table<br/><div class="version">v1.1.18 and newer</div></div></div><div class="body"><p class="desc">You can use this function in an argmatcher to supply file matches.  This automatically handles Readline tilde completion.</p><p class="desc"> Argmatchers default to matching files, so it's unusual to need this function.  However, some exceptions are when a flag needs to accept file matches but other flags and arguments don't, or when matches need to include more than files.</p><pre class="language-lua"><code>-- Make "foo --file" generate file matches, but other flags and args don't.
 -- And the third argument can be a file or $stdin or $stdout.
 clink.argmatcher("foo")
 :addflags(
@@ -6545,26 +6778,42 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 :addarg({ "one", "won" })
 :addarg({ "two", "too" })
 :addarg({ clink.filematches, "$stdin", "$stdout" })</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.generator"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.generator">clink.generator</a></div> <div class="signature">( [<span class="arg_name">priority</span>:integer] ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new match generator object.  Define on the object a <code>:generate()</code> function which gets called in increasing <span class="arg">priority</span> order (low values to high values) when generating matches for completion.  See <a href="#matchgenerators">Match Generators</a> for more information.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.getansihost"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.getansihost">clink.getansihost</a></div> <div class="signature">() : string<br/><div class="version">v1.1.48 and newer</div></div></div><div class="body"><p class="desc">Returns up to two strings indicating who Clink thinks will currently handle ANSI escape codes.</p><p class="desc"> The first returned string is the "current" handler.  This can change based on the <code><a href="#terminal_emulation">terminal.emulation</a></code> setting.</p><p class="desc"> Starting in v1.4.26 a second string can be returned which indicates the "native" handler.  This is what Clink has detected as the terminal host and is not affected by the `terminal.emulation` setting.</p><p class="desc"> The returned strings will always be <code>"unknown"</code> until the first edit prompt (see <a href="#clink.onbeginedit">clink.onbeginedit()</a>).</p><p class="desc"> These can be useful in choosing what kind of ANSI escape codes to use, but are a best guess and are not necessarily 100% reliable.</p><p class="desc"> <table> <tr><th>Return</th><th>Description</th></tr> <tr><td>"unknown"</td><td>Clink doesn't know.</td></tr> <tr><td>"clink"</td><td>Clink is emulating ANSI support.  256 color and 24 bit color escape codes are mapped to the nearest of the 16 basic colors.</td></tr> <tr><td>"conemu"</td><td>Clink thinks ANSI escape codes will be handled by ConEmu.</td></tr> <tr><td>"ansicon"</td><td>Clink thinks ANSI escape codes will be handled by ANSICON.</td></tr> <tr><td>"winterminal"</td><td>Clink thinks ANSI escape codes will be handled by Windows Terminal.</td></tr> <tr><td>"wezterm"</td><td>Clink thinks ANSI escape codes will be handled by WezTerm.</td></tr> <tr><td>"winconsole"</td><td>Clink thinks ANSI escape codes will be handled by the default console support in Windows, but Clink detected a terminal replacement that won't support 256 color or 24 bit color.</td></tr> <tr><td>"winconsolev2"</td><td>Clink thinks ANSI escape codes will be handled by the default console support in Windows, or it might be handled by a terminal replacement that Clink wasn't able to detect.</td></tr> </table></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.getargmatcher"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.getargmatcher">clink.getargmatcher</a></div> <div class="signature">( <span class="arg_name">find</span>:string|line_state ) : argmatcher|nil<br/><div class="version">v1.3.12 and newer</div></div></div><div class="body"><p class="desc">Finds the argmatcher registered to handle a command, if any.</p><p class="desc"> When <span class="arg">find</span> is a string it is interpreted as the name of a command, and this looks up the argmatcher for the named command.</p><p class="desc"> When <span class="arg">find</span> is a <a href="#line_state">line_state</a> this looks up the argmatcher for the command line.</p><p class="desc"> If no argmatcher is found, this returns nil.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.getpopuplistcolors"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.getpopuplistcolors">clink.getpopuplistcolors</a></div> <div class="signature">() : table<br/><div class="version">v1.4.0 and newer</div></div></div><div class="body"><p class="desc">Returns the default popup colors in a table with the following scheme:</p><pre class="language-lua"><code>{
+
+<div class="function"><div class="header"> <div id="clink.generator" class="name"><a class="wlink" href="#clink.generator"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.generator</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">priority</span>:integer] ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new match generator object.  Define on the object a <code>:generate()</code> function which gets called in increasing <span class="arg">priority</span> order (low values to high values) when generating matches for completion.  See <a href="#matchgenerators">Match Generators</a> for more information.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.getansihost" class="name"><a class="wlink" href="#clink.getansihost"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.getansihost</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string<br/><div class="version">v1.1.48 and newer</div></div></div><div class="body"><p class="desc">Returns up to two strings indicating who Clink thinks will currently handle ANSI escape codes.</p><p class="desc"> The first returned string is the "current" handler.  This can change based on the <code><a href="#terminal_emulation">terminal.emulation</a></code> setting.</p><p class="desc"> Starting in v1.4.26 a second string can be returned which indicates the "native" handler.  This is what Clink has detected as the terminal host and is not affected by the `terminal.emulation` setting.</p><p class="desc"> The returned strings will always be <code>"unknown"</code> until the first edit prompt (see <a href="#clink.onbeginedit">clink.onbeginedit()</a>).</p><p class="desc"> These can be useful in choosing what kind of ANSI escape codes to use, but are a best guess and are not necessarily 100% reliable.</p><p class="desc"> <table> <tr><th>Return</th><th>Description</th></tr> <tr><td>"unknown"</td><td>Clink doesn't know.</td></tr> <tr><td>"clink"</td><td>Clink is emulating ANSI support.  256 color and 24 bit color escape codes are mapped to the nearest of the 16 basic colors.</td></tr> <tr><td>"conemu"</td><td>Clink thinks ANSI escape codes will be handled by ConEmu.</td></tr> <tr><td>"ansicon"</td><td>Clink thinks ANSI escape codes will be handled by ANSICON.</td></tr> <tr><td>"winterminal"</td><td>Clink thinks ANSI escape codes will be handled by Windows Terminal.</td></tr> <tr><td>"wezterm"</td><td>Clink thinks ANSI escape codes will be handled by WezTerm.</td></tr> <tr><td>"winconsole"</td><td>Clink thinks ANSI escape codes will be handled by the default console support in Windows, but Clink detected a terminal replacement that won't support 256 color or 24 bit color.</td></tr> <tr><td>"winconsolev2"</td><td>Clink thinks ANSI escape codes will be handled by the default console support in Windows, or it might be handled by a terminal replacement that Clink wasn't able to detect.</td></tr> </table></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.getargmatcher" class="name"><a class="wlink" href="#clink.getargmatcher"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.getargmatcher</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">find</span>:string|line_state ) : argmatcher|nil<br/><div class="version">v1.3.12 and newer</div></div></div><div class="body"><p class="desc">Finds the argmatcher registered to handle a command, if any.</p><p class="desc"> When <span class="arg">find</span> is a string it is interpreted as the name of a command, and this looks up the argmatcher for the named command.</p><p class="desc"> When <span class="arg">find</span> is a <a href="#line_state">line_state</a> this looks up the argmatcher for the command line.</p><p class="desc"> If no argmatcher is found, this returns nil.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.getpopuplistcolors" class="name"><a class="wlink" href="#clink.getpopuplistcolors"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.getpopuplistcolors</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : table<br/><div class="version">v1.4.0 and newer</div></div></div><div class="body"><p class="desc">Returns the default popup colors in a table with the following scheme:</p><pre class="language-lua"><code>{
 items   = "...",    -- The SGR parameters for the items color.
 desc    = "...",    -- The SGR parameters for the description color.
 }</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.getsession"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.getsession">clink.getsession</a></div> <div class="signature">() : string<br/><div class="version">v1.1.44 and newer</div></div></div><div class="body"><p class="desc">Returns the current Clink session id.</p><p class="desc"> This is needed when using <a href="https://www.lua.org/manual/5.2/manual.html#pdf-io.popen">io.popen()</a> (or similar functions) to invoke <code>clink history</code> or <code>clink info</code> while Clink is installed for autorun.  The popen API spawns a new CMD.exe, which gets a new Clink instance injected, so the history or info command will use the new session unless explicitly directed to use the calling session.</p><pre class="language-lua"><code>local c = os.getalias("clink")
-local r = io.popen(c.." --session "..clink.getsession().." history")</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.lower"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.lower">clink.lower</a></div> <div class="signature">( <span class="arg_name">text</span>:string ) : string<br/><div class="version">v0.4.9 and newer</div></div></div><div class="body"><p class="desc">This API correctly converts UTF8 strings to lowercase, with international linguistic awareness.</p><pre class="language-lua"><code>clink.lower("Hello World") -- returns "hello world"
+
+<div class="function"><div class="header"> <div id="clink.getsession" class="name"><a class="wlink" href="#clink.getsession"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.getsession</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string<br/><div class="version">v1.1.44 and newer</div></div></div><div class="body"><p class="desc">Returns the current Clink session id.</p><p class="desc"> This is needed when using <a href="https://www.lua.org/manual/5.2/manual.html#pdf-io.popen">io.popen()</a> (or similar functions) to invoke <code>clink history</code> or <code>clink info</code> while Clink is installed for autorun.  The popen API spawns a new CMD.exe, which gets a new Clink instance injected, so the history or info command will use the new session unless explicitly directed to use the calling session.</p><pre class="language-lua"><code>local exe = string.format('"%s" --session %s', CLINK_EXE, clink.getsession())
+local r = io.popen('2>nul '..exe..' history')
+if r then
+&nbsp;   for line in r:lines() do
+&nbsp;       print(line)
+&nbsp;   end
+&nbsp;   r:close()
+end</code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.lower" class="name"><a class="wlink" href="#clink.lower"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.lower</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string ) : string<br/><div class="version">v0.4.9 and newer</div></div></div><div class="body"><p class="desc">This API correctly converts UTF8 strings to lowercase, with international linguistic awareness.</p><pre class="language-lua"><code>clink.lower("Hello World") -- returns "hello world"
 clink.lower("ÁÈÏõû")       -- returns "áèïõû"</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.onaftercommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.onaftercommand">clink.onaftercommand</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.2.50 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called after every editing command (key binding).</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.onbeginedit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.onbeginedit">clink.onbeginedit</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.1.11 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when Clink's edit prompt is activated.  The function receives no arguments and has no return values.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.oncommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.oncommand">clink.oncommand</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.3.12 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when the command word changes in the edit line.</p><p class="desc"> The function receives 2 arguments:  the <a href="#line_state">line_state</a> for the command, and a table with the following scheme:</p><pre class="language-lua"><code>{
+
+<div class="function"><div class="header"> <div id="clink.onaftercommand" class="name"><a class="wlink" href="#clink.onaftercommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.onaftercommand</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.2.50 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called after every editing command (key binding).</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.onbeginedit" class="name"><a class="wlink" href="#clink.onbeginedit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.onbeginedit</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.1.11 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when Clink's edit prompt is activated.  The function receives no arguments and has no return values.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.oncommand" class="name"><a class="wlink" href="#clink.oncommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.oncommand</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.3.12 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when the command word changes in the edit line.</p><p class="desc"> The function receives 2 arguments:  the <a href="#line_state">line_state</a> for the command, and a table with the following scheme:</p><pre class="language-lua"><code>{
 &nbsp;   command =   -- [string] The command.
 &nbsp;   quoted  =   -- [boolean] Whether the command is quoted in the command line.
 &nbsp;   type    =   -- [string] "unrecognized", "executable", or "command" (a CMD command name).
 &nbsp;   file    =   -- [string] The file that would be executed, or an empty string.
 }</code></pre><p class="desc">The function has no return values.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.ondisplaymatches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.ondisplaymatches">clink.ondisplaymatches</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.1.12 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when Clink is about to display matches.  See <a href="#filteringthematchdisplay">Filtering the Match Display</a> for more information.</p><pre class="language-lua"><code>local function my_filter(matches, popup)
+
+<div class="function"><div class="header"> <div id="clink.ondisplaymatches" class="name"><a class="wlink" href="#clink.ondisplaymatches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.ondisplaymatches</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.1.12 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when Clink is about to display matches.  See <a href="#filteringthematchdisplay">Filtering the Match Display</a> for more information.</p><pre class="language-lua"><code>local function my_filter(matches, popup)
 &nbsp;   local new_matches = {}
 &nbsp;   for _,m in ipairs(matches) do
 &nbsp;       if m.match:find("[0-9]") then
@@ -6584,12 +6833,18 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;   ...
 &nbsp;   clink.ondisplaymatches(my_filter)
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.onendedit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.onendedit">clink.onendedit</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when Clink's edit prompt ends.  The function receives a string argument containing the input text from the edit prompt.</p><p class="desc"> <strong>Breaking Change in v1.2.16:</strong>  The ability to replace the user's input has been moved to a separate <a href="#clink.onfilterinput">onfilterinput</a> event.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.onfilterinput"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.onfilterinput">clink.onfilterinput</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.2.16 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called after Clink's edit prompt ends (it is called after the <a href="#clink.onendedit">onendedit</a> event).  The function receives a string argument containing the input text from the edit prompt.  The function returns up to two values.  If the first is not nil then it's a string that replaces the edit prompt text.  If the second is not nil and is false then it stops further onfilterinput handlers from running.</p><p class="desc"> Starting in v1.3.13 <span class="arg">func</span> may return a table of strings, and each is executed as a command line.</p><p class="desc"> <strong>Note:</strong>  Be very careful if you replace the text; this has the potential to interfere with or even ruin the user's ability to enter command lines for CMD to process.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.onfiltermatches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.onfiltermatches">clink.onfiltermatches</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.1.41 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called after Clink generates matches for completion.  See <a href="#filteringmatchcompletions"> Filtering Match Completions</a> for more information.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.onhistory"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.onhistory">clink.onhistory</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.5.13 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when an input line has been accepted and is about to be added to history.  The function receives a string argument containing the input text from the edit prompt.  The function can return false to cancel adding the line to history (if it returns false then no further onhistory handlers will run for that line).</p><p class="desc"> <strong>Note:</strong>  The onhistory handler functions are not called by <code><a href="#rlcmd-add-history">add-history</a></code> or the <code>clink history</code> command.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.oninject"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.oninject">clink.oninject</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.1.21 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when Clink is injected into a CMD process.  The function is called only once per session.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.oninputlinechanged"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.oninputlinechanged">clink.oninputlinechanged</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.4.18 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called after an editing command (key binding) makes changes in the input line.</p><p class="desc"> The function receives one argument, a <span class="arg">line</span> string which contains the new contents of the input line.</p><p class="desc"> The function has no return values.</p><p class="desc"> Here is a script that demonstrates a lighthearted example of how this could be used.  Any time the input line contains "marco" it replaces the prompt with "POLO!".</p><pre class="language-lua"><code>local has_marco
+
+<div class="function"><div class="header"> <div id="clink.onendedit" class="name"><a class="wlink" href="#clink.onendedit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.onendedit</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when Clink's edit prompt ends.  The function receives a string argument containing the input text from the edit prompt.</p><p class="desc"> <strong>Breaking Change in v1.2.16:</strong>  The ability to replace the user's input has been moved to a separate <a href="#clink.onfilterinput">onfilterinput</a> event.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.onfilterinput" class="name"><a class="wlink" href="#clink.onfilterinput"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.onfilterinput</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.2.16 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called after Clink's edit prompt ends (it is called after the <a href="#clink.onendedit">onendedit</a> event).  The function receives a string argument containing the input text from the edit prompt.  The function returns up to two values.  If the first is not nil then it's a string that replaces the edit prompt text.  If the second is not nil and is false then it stops further onfilterinput handlers from running.</p><p class="desc"> Starting in v1.3.13 <span class="arg">func</span> may return a table of strings, and each is executed as a command line.</p><p class="desc"> <strong>Note:</strong>  Be very careful if you replace the text; this has the potential to interfere with or even ruin the user's ability to enter command lines for CMD to process.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.onfiltermatches" class="name"><a class="wlink" href="#clink.onfiltermatches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.onfiltermatches</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.1.41 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called after Clink generates matches for completion.  See <a href="#filteringmatchcompletions"> Filtering Match Completions</a> for more information.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.onhistory" class="name"><a class="wlink" href="#clink.onhistory"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.onhistory</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.5.13 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when an input line has been accepted and is about to be added to history.  The function receives a string argument containing the input text from the edit prompt.  The function can return false to cancel adding the line to history (if it returns false then no further onhistory handlers will run for that line).</p><p class="desc"> <strong>Note:</strong>  The onhistory handler functions are not called by <code><a href="#rlcmd-add-history">add-history</a></code> or the <code>clink history</code> command.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.oninject" class="name"><a class="wlink" href="#clink.oninject"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.oninject</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.1.21 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called when Clink is injected into a CMD process.  The function is called only once per session.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.oninputlinechanged" class="name"><a class="wlink" href="#clink.oninputlinechanged"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.oninputlinechanged</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.4.18 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called after an editing command (key binding) makes changes in the input line.</p><p class="desc"> The function receives one argument, a <span class="arg">line</span> string which contains the new contents of the input line.</p><p class="desc"> The function has no return values.</p><p class="desc"> Here is a script that demonstrates a lighthearted example of how this could be used.  Any time the input line contains "marco" it replaces the prompt with "POLO!".</p><pre class="language-lua"><code>local has_marco
 local polo = clink.promptfilter(-1)
 
 function polo:filter()
@@ -6616,11 +6871,14 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 function clink.oninputlinechanged(func)
 &nbsp;   _add_event_callback("oninputlinechanged", func)
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.onprovideline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.onprovideline">clink.onprovideline</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.3.18 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called after the <a href="#clink.onbeginedit">onbeginedit</a> event but before the input line editor starts.  If <span class="arg">func</span> returns a string, it is executed as a command line without showing a prompt.  The input line editor is skipped, and the <a href="#clink.onendedit">onendedit</a> and <a href="#clink.onfilterinput">onfilterinput</a> events happen immediately.</p><p class="desc"> <strong>Note:</strong>  Be very careful when returning a string; this can interfere with the user's ability to use CMD.  Mistakes in the command string can have potential to cause damage to the system very quickly.  It is also possible for a script to cause an infinite loop, and therefore <kbd>Ctrl</kbd>-<kbd>Break</kbd> skips the next <a href="#clink.onprovideline">onprovideline</a> event, allowing the user to regain control.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.parseline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.parseline">clink.parseline</a></div> <div class="signature">( <span class="arg_name">line</span>:string ) : table<br/><div class="version">v1.3.37 and newer</div></div></div><div class="body"><p class="desc">This parses the <span class="arg">line</span> string into a table of commands, with one <a href="#line_state">line_state</a> for each command parsed from the line string.</p><p class="desc"> The returned table of tables has the following scheme:</p><pre class="language-lua"><code>local commands = clink.parseline("echo hello & echo world")
+
+<div class="function"><div class="header"> <div id="clink.onprovideline" class="name"><a class="wlink" href="#clink.onprovideline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.onprovideline</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.3.18 and newer</div></div></div><div class="body"><p class="desc">Registers <span class="arg">func</span> to be called after the <a href="#clink.onbeginedit">onbeginedit</a> event but before the input line editor starts.  If <span class="arg">func</span> returns a string, it is executed as a command line without showing a prompt.  The input line editor is skipped, and the <a href="#clink.onendedit">onendedit</a> and <a href="#clink.onfilterinput">onfilterinput</a> events happen immediately.</p><p class="desc"> <strong>Note:</strong>  Be very careful when returning a string; this can interfere with the user's ability to use CMD.  Mistakes in the command string can have potential to cause damage to the system very quickly.  It is also possible for a script to cause an infinite loop, and therefore <kbd>Ctrl</kbd>-<kbd>Break</kbd> skips the next <a href="#clink.onprovideline">onprovideline</a> event, allowing the user to regain control.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.parseline" class="name"><a class="wlink" href="#clink.parseline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.parseline</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">line</span>:string ) : table<br/><div class="version">v1.3.37 and newer</div></div></div><div class="body"><p class="desc">This parses the <span class="arg">line</span> string into a table of commands, with one <a href="#line_state">line_state</a> for each command parsed from the line string.</p><p class="desc"> The returned table of tables has the following scheme:</p><pre class="language-lua"><code>local commands = clink.parseline("echo hello & echo world")
 -- commands[1].line_state corresponds to "echo hello".
 -- commands[2].line_state corresponds to "echo world".</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.popuplist"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.popuplist">clink.popuplist</a></div> <div class="signature">( <span class="arg_name">title</span>:string, <span class="arg_name">items</span>:table, [<span class="arg_name">index</span>:integer], [<span class="arg_name">del_callback</span>:function] ) : string, boolean, integer<br/><div class="version">v1.2.17 and newer</div></div></div><div class="body"><p class="desc">Displays a popup list and returns the selected item.  May only be used within a <a href="#luakeybindings">luafunc: key binding</a> or inside a function registered with <a href="#clink.onfiltermatches">clink.onfiltermatches()</a>.</p><p class="desc"> <span class="arg">title</span> is required and captions the popup list.</p><p class="desc"> <span class="arg">items</span> is a table of strings to display.</p><p class="desc"> <span class="arg">index</span> optionally specifies the default item (or 1 if omitted).</p><p class="desc"> <span class="arg">del_callback</span> optionally specifies a callback function to be called when <kbd>Del</kbd> is pressed.  The function receives the index of the selected item.  If the function returns true then the item is deleted from the popup list.  This requires Clink v1.3.41 or higher.</p><p class="desc"> The function returns one of the following: <ul> <li>nil if the popup is canceled or an error occurs. <li>Three values: <ul> <li>string indicating the <code>value</code> field from the selected item (or the <code>display</code> field if no value field is present). <li>boolean which is true if the item was selected with <kbd>Shift</kbd> or <kbd>Ctrl</kbd> pressed. <li>integer indicating the index of the selected item in the original <span class="arg">items</span> table. </ul> </ul></p><p class="desc"> Alternatively, the <span class="arg">items</span> argument can be a table of tables with the following scheme:</p><pre class="language-lua"><code>{
+
+<div class="function"><div class="header"> <div id="clink.popuplist" class="name"><a class="wlink" href="#clink.popuplist"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.popuplist</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">title</span>:string, <span class="arg_name">items</span>:table, [<span class="arg_name">index</span>:integer], [<span class="arg_name">del_callback</span>:function] ) : string, boolean, integer<br/><div class="version">v1.2.17 and newer</div></div></div><div class="body"><p class="desc">Displays a popup list and returns the selected item.  May only be used within a <a href="#luakeybindings">luafunc: key binding</a> or inside a function registered with <a href="#clink.onfiltermatches">clink.onfiltermatches()</a>.</p><p class="desc"> <span class="arg">title</span> is required and captions the popup list.</p><p class="desc"> <span class="arg">items</span> is a table of strings to display.</p><p class="desc"> <span class="arg">index</span> optionally specifies the default item (or 1 if omitted).</p><p class="desc"> <span class="arg">del_callback</span> optionally specifies a callback function to be called when <kbd>Del</kbd> is pressed.  The function receives the index of the selected item.  If the function returns true then the item is deleted from the popup list.  This requires Clink v1.3.41 or higher.</p><p class="desc"> The function returns one of the following: <ul> <li>nil if the popup is canceled or an error occurs. <li>Three values: <ul> <li>string indicating the <code>value</code> field from the selected item (or the <code>display</code> field if no value field is present). <li>boolean which is true if the item was selected with <kbd>Shift</kbd> or <kbd>Ctrl</kbd> pressed. <li>integer indicating the index of the selected item in the original <span class="arg">items</span> table. </ul> </ul></p><p class="desc"> Alternatively, the <span class="arg">items</span> argument can be a table of tables with the following scheme:</p><pre class="language-lua"><code>{
 &nbsp;   {
 &nbsp;       value       = "...",   -- Required; this is returned if the item is chosen.
 &nbsp;       display     = "...",   -- Optional; displayed instead of value.
@@ -6641,7 +6899,8 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;       selectdesc  = "...",    -- The selected item description color (defaults to selected item color).
 &nbsp;   }
 }</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.print"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.print">clink.print</a></div> <div class="signature">( ... ) : nil<br/><div class="version">v1.2.11 and newer</div></div></div><div class="body"><p class="desc">This works like <a href="https://www.lua.org/manual/5.2/manual.html#pdf-print">print()</a>, but this supports ANSI escape codes and Unicode.</p><p class="desc"> If the special value <code>NONL</code> is included anywhere in the argument list then the usual trailing newline is omitted.  This can sometimes be useful particularly when printing certain ANSI escape codes.</p><p class="desc"> <strong>Note:</strong>  In Clink versions before v1.2.11 the <code>clink.print()</code> API exists (undocumented) but accepts exactly one string argument and is therefore not fully compatible with normal <a href="https://www.lua.org/manual/5.2/manual.html#pdf-print">print()</a> syntax.  If you use fewer or more than 1 argument or if the argument is not a string, then first checking the Clink version (e.g. <a href="#clink.version_encoded">clink.version_encoded</a>) can avoid runtime errors.</p><pre class="language-lua"><code>clink.print("\x1b[32mgreen\x1b[m \x1b[35mmagenta\x1b[m")
+
+<div class="function"><div class="header"> <div id="clink.print" class="name"><a class="wlink" href="#clink.print"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.print</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( ... ) : nil<br/><div class="version">v1.2.11 and newer</div></div></div><div class="body"><p class="desc">This works like <a href="https://www.lua.org/manual/5.2/manual.html#pdf-print">print()</a>, but this supports ANSI escape codes and Unicode.</p><p class="desc"> If the special value <code>NONL</code> is included anywhere in the argument list then the usual trailing newline is omitted.  This can sometimes be useful particularly when printing certain ANSI escape codes.</p><p class="desc"> <strong>Note:</strong>  In Clink versions before v1.2.11 the <code>clink.print()</code> API exists (undocumented) but accepts exactly one string argument and is therefore not fully compatible with normal <a href="https://www.lua.org/manual/5.2/manual.html#pdf-print">print()</a> syntax.  If you use fewer or more than 1 argument or if the argument is not a string, then first checking the Clink version (e.g. <a href="#clink.version_encoded">clink.version_encoded</a>) can avoid runtime errors.</p><pre class="language-lua"><code>clink.print("\x1b[32mgreen\x1b[m \x1b[35mmagenta\x1b[m")
 -- Outputs "green" in green, a space, and "magenta" in magenta.
 
 local a = "hello"
@@ -6652,22 +6911,34 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 clink.print("hello", NONL)
 clink.print("world")
 -- Outputs "helloworld".</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.promptcoroutine"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.promptcoroutine">clink.promptcoroutine</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : [return value from func]<br/><div class="version">v1.2.10 and newer</div></div></div><div class="body"><p class="desc">Creates a coroutine to run the <span class="arg">func</span> function in the background.  Clink will automatically resume the coroutine repeatedly while input line editing is idle.  When the <span class="arg">func</span> function completes, Clink will automatically refresh the prompt by triggering prompt filtering again.</p><p class="desc"> A coroutine is only created the first time each prompt filter calls this API during a given input line session.  Subsequent calls reuse the already-created coroutine.  (E.g. pressing <kbd>Enter</kbd> ends an input line session.)</p><p class="desc"> The API returns nil until the <span class="arg">func</span> function has finished.  After that, the API returns whatever the <span class="arg">func</span> function returned.  The API returns one value; if multiple return values are needed, return them in a table.</p><p class="desc"> If the <code><a href="#prompt_async">prompt.async</a></code> setting is disabled, then the coroutine runs to completion immediately before returning.  Otherwise, the coroutine runs during idle while editing the input line.  The <span class="arg">func</span> function receives one argument: true if it's running in the background, or false if it's running immediately.</p><p class="desc"> See <a href="#asyncpromptfiltering">Asynchronous Prompt Filtering</a> for more information.</p><p class="desc"> <strong>Note:</strong> each prompt filter can have at most one prompt coroutine.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.promptfilter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.promptfilter">clink.promptfilter</a></div> <div class="signature">( [<span class="arg_name">priority</span>:integer] ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new promptfilter object that is applied in increasing <span class="arg">priority</span> order (low values to high values).  Define on the object a <code>:filter()</code> function that takes a string argument which contains the filtered prompt so far.  The function can return nil to have no effect, or can return a new prompt string.  It can optionally stop further prompt filtering by also returning false.  See <a href="#customisingtheprompt">Customizing the Prompt</a> for more information.</p><pre class="language-lua"><code>local foo_prompt = clink.promptfilter(80)
+
+<div class="function"><div class="header"> <div id="clink.promptcoroutine" class="name"><a class="wlink" href="#clink.promptcoroutine"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.promptcoroutine</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : [return value from func]<br/><div class="version">v1.2.10 and newer</div></div></div><div class="body"><p class="desc">Creates a coroutine to run the <span class="arg">func</span> function in the background.  Clink will automatically resume the coroutine repeatedly while input line editing is idle.  When the <span class="arg">func</span> function completes, Clink will automatically refresh the prompt by triggering prompt filtering again.</p><p class="desc"> A coroutine is only created the first time each prompt filter calls this API during a given input line session.  Subsequent calls reuse the already-created coroutine.  (E.g. pressing <kbd>Enter</kbd> ends an input line session.)</p><p class="desc"> The API returns nil until the <span class="arg">func</span> function has finished.  After that, the API returns whatever the <span class="arg">func</span> function returned.  The API returns one value; if multiple return values are needed, return them in a table.</p><p class="desc"> If the <code><a href="#prompt_async">prompt.async</a></code> setting is disabled, then the coroutine runs to completion immediately before returning.  Otherwise, the coroutine runs during idle while editing the input line.  The <span class="arg">func</span> function receives one argument: true if it's running in the background, or false if it's running immediately.</p><p class="desc"> See <a href="#asyncpromptfiltering">Asynchronous Prompt Filtering</a> for more information.</p><p class="desc"> <strong>Note:</strong> each prompt filter can have at most one prompt coroutine.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.promptfilter" class="name"><a class="wlink" href="#clink.promptfilter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.promptfilter</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">priority</span>:integer] ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new promptfilter object that is applied in increasing <span class="arg">priority</span> order (low values to high values).  Define on the object a <code>:filter()</code> function that takes a string argument which contains the filtered prompt so far.  The function can return nil to have no effect, or can return a new prompt string.  It can optionally stop further prompt filtering by also returning false.  See <a href="#customisingtheprompt">Customizing the Prompt</a> for more information.</p><pre class="language-lua"><code>local foo_prompt = clink.promptfilter(80)
 function foo_prompt:filter(prompt)
 &nbsp;   -- Insert the date at the beginning of the prompt.
 &nbsp;   return os.date("%a %H:%M").." "..prompt
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.reclassifyline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.reclassifyline">clink.reclassifyline</a></div> <div class="signature">() : nil<br/><div class="version">v1.3.9 and newer</div></div></div><div class="body"><p class="desc">Reclassify the input line text again and refresh the input line display.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.recognizecommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.recognizecommand">clink.recognizecommand</a></div> <div class="signature">( [<span class="arg_name">line</span>:string], <span class="arg_name">word</span>:string, [<span class="arg_name">quoted</span>:boolean] ) : word_class:string, ready:boolean, file:string<br/><div class="version">v1.3.38 and newer</div></div></div><div class="body"><p class="desc">This reports the input line coloring word classification to use for a command word.  The return value can be passed into <a href="#word_classifications:classifyword">word_classifications:classifyword()</a> as its <span class="arg">word_class</span> argument.</p><p class="desc"> This is intended for advanced input line coloring purposes.  For example if a script uses <a href="#clink.onfilterinput">clink.onfilterinput()</a> to modify the input text, then it can use this function inside a custom <a href="#classifier_override_line">classifier</a> to look up the color appropriate for the modified input text.</p><p class="desc"> The <span class="arg">line</span> is optional and may be an empty string or omitted.  When present, it is parsed to check if it would be processed as a <a href="#directory-shortcuts">directory shortcut</a>.</p><p class="desc"> The <span class="arg">word</span> is a string indicating the word to be analyzed.</p><p class="desc"> The <span class="arg">quoted</span> is optional.  When true, it indicates the word is quoted and any <code>^</code> characters are taken as-is, rather than treating them as the usual CMD escape character.</p><p class="desc"> The possible return values for <span class="arg">word_class</span> are:</p><p class="desc"> <table> <tr><th>Code</th><th>Classification</th><th>Clink Color Setting</th></tr> <tr><td><code>"x"</code></td><td>Executable; used for the first word when it is not a command or doskey alias, but is an executable name that exists.</td><td><code><a href="#color_executable">color.executable</a></code></td></tr> <tr><td><code>"u"</code></td><td>Unrecognized; used for the first word when it is not a command, doskey alias, or recognized executable name.</td><td><code><a href="#color_unrecognized">color.unrecognized</a></code></td></tr> <tr><td><code>"o"</code></td><td>Other; used for file names and words that don't fit any of the other classifications.</td><td><code><a href="#color_input">color.input</a></code></td></tr> </table></p><p class="desc"> The possible return values for <span class="arg">ready</span> are:</p><p class="desc"> <ul> <li>True if the analysis has completed.</li> <li>False if the analysis has not yet completed (and the returned word class may be a temporary placeholder).</li> </ul></p><p class="desc"> The return value for <span class="arg">file</span> is the fully qualified path to the found executable file, if any, or nil.</p><p class="desc"> <strong>Note:</strong>  This always returns immediately, and it uses a background thread to analyze the <span class="arg">word</span> asynchronously. When the background thread finishes analyzing the word, Clink automatically redisplays the input line, giving classifiers a chance to call this function again and get the final <span class="arg">word_class</span> result.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.refilterafterterminalresize"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.refilterafterterminalresize">clink.refilterafterterminalresize</a></div> <div class="signature">( <span class="arg_name">refilter</span>:boolean ) : boolean<br/><div class="version">v1.4.0 and newer</div></div></div><div class="body"><p class="desc">Call this with <span class="arg">refilter</span> either nil or true to make Clink automatically rerun prompt filters after the terminal is resized.  The previous value is returned.</p><p class="desc"> On Windows the terminal is resized while the console program in the terminal (such as CMD) continues to run.  If a console program writes to the terminal while the resize is happening, then the terminal display can become garbled. So Clink waits until the terminal has stayed the same size for at least 1.5 seconds, and then it reruns the prompt filters.</p><p class="desc"> <strong>Use this with caution:</strong>  if the prompt filters have not been designed efficiently, then rerunning them after resizing the terminal could cause responsiveness problems.  Also, if the terminal is resized again while the prompt filters are being rerun, then the terminal display may become garbled.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.refilterprompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.refilterprompt">clink.refilterprompt</a></div> <div class="signature">() : nil<br/><div class="version">v1.2.46 and newer</div></div></div><div class="body"><p class="desc">Invoke the prompt filters again and refresh the prompt.</p><p class="desc"> Note: this can potentially be expensive; call this only infrequently.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.reload"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.reload">clink.reload</a></div> <div class="signature">() : nil<br/><div class="version">v1.2.29 and newer</div></div></div><div class="body"><p class="desc">Reloads Lua scripts and Readline config file at the next prompt.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.runcoroutineuntilcomplete"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.runcoroutineuntilcomplete">clink.runcoroutineuntilcomplete</a></div> <div class="signature">( <span class="arg_name">coroutine</span>:coroutine ) : nil<br/><div class="version">v1.3.5 and newer</div></div></div><div class="body"><p class="desc">By default, a coroutine is canceled if it doesn't complete before an edit line ends.  In some cases it may be necessary for a coroutine to run until it completes, even if it spans multiple edit lines.</p><p class="desc"> <strong>Use this with caution:</strong>  This can potentially cause performance problems or cause prompt filtering to experience delays.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.runonmain"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.runonmain">clink.runonmain</a></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.5.21 and newer</div></div></div><div class="body"><p class="desc">Runs <span class="arg">func</span> on the main coroutine.</p><p class="desc"> If main is the current coroutine, then <span class="arg">func</span> runs immediately.</p><p class="desc"> If main is not the current coroutine, then <span class="arg">func</span> is scheduled to run when control returns to the main coroutine.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.setcoroutineinterval"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.setcoroutineinterval">clink.setcoroutineinterval</a></div> <div class="signature">( <span class="arg_name">coroutine</span>:coroutine, [<span class="arg_name">interval</span>:number] ) : nil<br/><div class="version">v1.3.1 and newer</div></div></div><div class="body"><p class="desc">Overrides the interval at which a coroutine is resumed.  All coroutines are automatically added with an interval of 0 by default, so calling this is only needed when you want to change the interval.</p><p class="desc"> Coroutines are automatically resumed while waiting for input while editing the input line.</p><p class="desc"> If a coroutine's interval is less than 5 seconds and the coroutine has been alive for more than 5 seconds, then the coroutine is throttled to run no more often than once every 5 seconds (regardless how much total time is has spent running).  Throttling is meant to prevent long-running coroutines from draining battery power, interfering with responsiveness, or other potential problems.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.setcoroutinename"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.setcoroutinename">clink.setcoroutinename</a></div> <div class="signature">( <span class="arg_name">coroutine</span>:coroutine, <span class="arg_name">name</span>:string ) : nil<br/><div class="version">v1.3.1 and newer</div></div></div><div class="body"><p class="desc">Sets a name for the coroutine.  This is purely for diagnostic purposes.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.suggester"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.suggester">clink.suggester</a></div> <div class="signature">( <span class="arg_name">name</span>:string ) : table<br/><div class="version">v1.2.47 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new suggester object.  Suggesters are consulted in the order their names are listed in the <code><a href="#autosuggest.strategy">autosuggest.strategy</a></code> setting.</p><p class="desc"> Define on the object a <code>:suggest()</code> function that takes a <a href="#line_state">line_state</a> argument which contains the input line, and a <a href="#matches">matches</a> argument which contains the possible completions.  The function can return nil to give the next suggester a chance, or can return a suggestion (or an empty string) to stop looking for suggestions.</p><p class="desc"> In Clink v1.2.51 and higher, the function may return a suggestion and an offset where the suggestion begins in the line.  This is useful if the suggester wants to be able to insert the suggestion using the original casing.  For example if you type "set varn" and a history entry is "set VARNAME" then returning <code>"set VARNAME", 1</code> or <code>"VARNAME", 5</code> can accept "set VARNAME" instead of "set varnAME".</p><p class="desc"> See <a href="#customisingsuggestions">Customizing Suggestions</a> for more information.</p><pre class="language-lua"><code>local doskeyarg = clink.suggester("doskeyarg")
+
+<div class="function"><div class="header"> <div id="clink.reclassifyline" class="name"><a class="wlink" href="#clink.reclassifyline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.reclassifyline</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.3.9 and newer</div></div></div><div class="body"><p class="desc">Reclassify the input line text again and refresh the input line display.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.recognizecommand" class="name"><a class="wlink" href="#clink.recognizecommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.recognizecommand</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">line</span>:string], <span class="arg_name">word</span>:string, [<span class="arg_name">quoted</span>:boolean] ) : word_class:string, ready:boolean, file:string<br/><div class="version">v1.3.38 and newer</div></div></div><div class="body"><p class="desc">This reports the input line coloring word classification to use for a command word.  The return value can be passed into <a href="#word_classifications:classifyword">word_classifications:classifyword()</a> as its <span class="arg">word_class</span> argument.</p><p class="desc"> This is intended for advanced input line coloring purposes.  For example if a script uses <a href="#clink.onfilterinput">clink.onfilterinput()</a> to modify the input text, then it can use this function inside a custom <a href="#classifier_override_line">classifier</a> to look up the color appropriate for the modified input text.</p><p class="desc"> The <span class="arg">line</span> is optional and may be an empty string or omitted.  When present, it is parsed to check if it would be processed as a <a href="#directory-shortcuts">directory shortcut</a>.</p><p class="desc"> The <span class="arg">word</span> is a string indicating the word to be analyzed.</p><p class="desc"> The <span class="arg">quoted</span> is optional.  When true, it indicates the word is quoted and any <code>^</code> characters are taken as-is, rather than treating them as the usual CMD escape character.</p><p class="desc"> The possible return values for <span class="arg">word_class</span> are:</p><p class="desc"> <table> <tr><th>Code</th><th>Classification</th><th>Clink Color Setting</th></tr> <tr><td><code>"x"</code></td><td>Executable; used for the first word when it is not a command or doskey alias, but is an executable name that exists.</td><td><code><a href="#color_executable">color.executable</a></code></td></tr> <tr><td><code>"u"</code></td><td>Unrecognized; used for the first word when it is not a command, doskey alias, or recognized executable name.</td><td><code><a href="#color_unrecognized">color.unrecognized</a></code></td></tr> <tr><td><code>"o"</code></td><td>Other; used for file names and words that don't fit any of the other classifications.</td><td><code><a href="#color_input">color.input</a></code></td></tr> </table></p><p class="desc"> The possible return values for <span class="arg">ready</span> are:</p><p class="desc"> <ul> <li>True if the analysis has completed.</li> <li>False if the analysis has not yet completed (and the returned word class may be a temporary placeholder).</li> </ul></p><p class="desc"> The return value for <span class="arg">file</span> is the fully qualified path to the found executable file, if any, or nil.</p><p class="desc"> <strong>Note:</strong>  This always returns immediately, and it uses a background thread to analyze the <span class="arg">word</span> asynchronously. When the background thread finishes analyzing the word, Clink automatically redisplays the input line, giving classifiers a chance to call this function again and get the final <span class="arg">word_class</span> result.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.refilterafterterminalresize" class="name"><a class="wlink" href="#clink.refilterafterterminalresize"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.refilterafterterminalresize</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">refilter</span>:boolean ) : boolean<br/><div class="version">v1.4.0 and newer</div></div></div><div class="body"><p class="desc">Call this with <span class="arg">refilter</span> either nil or true to make Clink automatically rerun prompt filters after the terminal is resized.  The previous value is returned.</p><p class="desc"> On Windows the terminal is resized while the console program in the terminal (such as CMD) continues to run.  If a console program writes to the terminal while the resize is happening, then the terminal display can become garbled. So Clink waits until the terminal has stayed the same size for at least 1.5 seconds, and then it reruns the prompt filters.</p><p class="desc"> <strong>Use this with caution:</strong>  if the prompt filters have not been designed efficiently, then rerunning them after resizing the terminal could cause responsiveness problems.  Also, if the terminal is resized again while the prompt filters are being rerun, then the terminal display may become garbled.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.refilterprompt" class="name"><a class="wlink" href="#clink.refilterprompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.refilterprompt</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.2.46 and newer</div></div></div><div class="body"><p class="desc">Invoke the prompt filters again and refresh the prompt.</p><p class="desc"> Note: this can potentially be expensive; call this only infrequently.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.reload" class="name"><a class="wlink" href="#clink.reload"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.reload</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.2.29 and newer</div></div></div><div class="body"><p class="desc">Reloads Lua scripts and Readline config file at the next prompt.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.runcoroutineuntilcomplete" class="name"><a class="wlink" href="#clink.runcoroutineuntilcomplete"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.runcoroutineuntilcomplete</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">coroutine</span>:coroutine ) : nil<br/><div class="version">v1.3.5 and newer</div></div></div><div class="body"><p class="desc">By default, a coroutine is canceled if it doesn't complete before an edit line ends.  In some cases it may be necessary for a coroutine to run until it completes, even if it spans multiple edit lines.</p><p class="desc"> <strong>Use this with caution:</strong>  This can potentially cause performance problems or cause prompt filtering to experience delays.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.runonmain" class="name"><a class="wlink" href="#clink.runonmain"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.runonmain</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function ) : nil<br/><div class="version">v1.5.21 and newer</div></div></div><div class="body"><p class="desc">Runs <span class="arg">func</span> on the main coroutine.</p><p class="desc"> If main is the current coroutine, then <span class="arg">func</span> runs immediately.</p><p class="desc"> If main is not the current coroutine, then <span class="arg">func</span> is scheduled to run when control returns to the main coroutine.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.setcoroutineinterval" class="name"><a class="wlink" href="#clink.setcoroutineinterval"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.setcoroutineinterval</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">coroutine</span>:coroutine, [<span class="arg_name">interval</span>:number] ) : nil<br/><div class="version">v1.3.1 and newer</div></div></div><div class="body"><p class="desc">Overrides the interval at which a coroutine is resumed.  All coroutines are automatically added with an interval of 0 by default, so calling this is only needed when you want to change the interval.</p><p class="desc"> Coroutines are automatically resumed while waiting for input while editing the input line.</p><p class="desc"> If a coroutine's interval is less than 5 seconds and the coroutine has been alive for more than 5 seconds, then the coroutine is throttled to run no more often than once every 5 seconds (regardless how much total time is has spent running).  Throttling is meant to prevent long-running coroutines from draining battery power, interfering with responsiveness, or other potential problems.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.setcoroutinename" class="name"><a class="wlink" href="#clink.setcoroutinename"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.setcoroutinename</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">coroutine</span>:coroutine, <span class="arg_name">name</span>:string ) : nil<br/><div class="version">v1.3.1 and newer</div></div></div><div class="body"><p class="desc">Sets a name for the coroutine.  This is purely for diagnostic purposes.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.suggester" class="name"><a class="wlink" href="#clink.suggester"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.suggester</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">name</span>:string ) : table<br/><div class="version">v1.2.47 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new suggester object.  Suggesters are consulted in the order their names are listed in the <code><a href="#autosuggest.strategy">autosuggest.strategy</a></code> setting.</p><p class="desc"> Define on the object a <code>:suggest()</code> function that takes a <a href="#line_state">line_state</a> argument which contains the input line, and a <a href="#matches">matches</a> argument which contains the possible completions.  The function can return nil to give the next suggester a chance, or can return a suggestion (or an empty string) to stop looking for suggestions.</p><p class="desc"> In Clink v1.2.51 and higher, the function may return a suggestion and an offset where the suggestion begins in the line.  This is useful if the suggester wants to be able to insert the suggestion using the original casing.  For example if you type "set varn" and a history entry is "set VARNAME" then returning <code>"set VARNAME", 1</code> or <code>"VARNAME", 5</code> can accept "set VARNAME" instead of "set varnAME".</p><p class="desc"> See <a href="#customisingsuggestions">Customizing Suggestions</a> for more information.</p><pre class="language-lua"><code>local doskeyarg = clink.suggester("doskeyarg")
 function doskeyarg:suggest(line, matches)
 &nbsp;   if line:getword(1) == "doskey" and
 &nbsp;           line:getline():match("[ \t][^ \t/][^ \t]+=") and
@@ -6681,7 +6952,8 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;       end
 &nbsp;   end
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.translateslashes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.translateslashes">clink.translateslashes</a></div> <div class="signature">( [<span class="arg_name">mode</span>:integer] ) : integer<br/><div class="version">v1.2.7 and newer</div></div></div><div class="body"><p class="desc">This overrides how Clink translates slashes in completion matches, which is normally determined by the <code><a href="#match_translate_slashes">match.translate_slashes</a></code> setting.</p><p class="desc"> This is reset every time match generation is invoked, so use a generator to set this.</p><p class="desc"> The <span class="arg">mode</span> specifies how to translate slashes when generators add matches: <table> <tr><th>Mode</th><th>Description</th></tr> <tr><td><code>0</code></td><td>No translation.</td></tr> <tr><td><code>1</code></td><td>Translate using the system path separator (backslash on Windows).</td></tr> <tr><td><code>2</code></td><td>Translate to slashes (<code>/</code>).</td></tr> <tr><td><code>3</code></td><td>Translate to backslashes (<code>\</code>).</td></tr> </table></p><p class="desc"> If <span class="arg">mode</span> is omitted, then the function returns the current slash translation mode without changing it.</p><p class="desc"> Note:  Clink always generates file matches using the system path separator (backslash on Windows), regardless what path separator may have been typed as input.  Setting this to <code>0</code> does not disable normalizing typed input paths when invoking completion; it only disables translating slashes in custom generators.</p><pre class="language-lua"><code>-- This example affects all match generators, by using priority -1 to
+
+<div class="function"><div class="header"> <div id="clink.translateslashes" class="name"><a class="wlink" href="#clink.translateslashes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.translateslashes</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">mode</span>:integer] ) : integer<br/><div class="version">v1.2.7 and newer</div></div></div><div class="body"><p class="desc">This overrides how Clink translates slashes in completion matches, which is normally determined by the <code><a href="#match_translate_slashes">match.translate_slashes</a></code> setting.</p><p class="desc"> This is reset every time match generation is invoked, so use a generator to set this.</p><p class="desc"> The <span class="arg">mode</span> specifies how to translate slashes when generators add matches: <table> <tr><th>Mode</th><th>Description</th></tr> <tr><td><code>0</code></td><td>No translation.</td></tr> <tr><td><code>1</code></td><td>Translate using the system path separator (backslash on Windows).</td></tr> <tr><td><code>2</code></td><td>Translate to slashes (<code>/</code>).</td></tr> <tr><td><code>3</code></td><td>Translate to backslashes (<code>\</code>).</td></tr> </table></p><p class="desc"> If <span class="arg">mode</span> is omitted, then the function returns the current slash translation mode without changing it.</p><p class="desc"> Note:  Clink always generates file matches using the system path separator (backslash on Windows), regardless what path separator may have been typed as input.  Setting this to <code>0</code> does not disable normalizing typed input paths when invoking completion; it only disables translating slashes in custom generators.</p><pre class="language-lua"><code>-- This example affects all match generators, by using priority -1 to
 -- run first and returning false to let generators continue.
 -- To instead affect only one generator, call clink.translateslashes()
 -- in its :generate() function and return true.
@@ -6690,41 +6962,85 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;   clink.translateslashes(2)  -- Convert to slashes.
 &nbsp;   return false               -- Allow generators to continue.
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.upper"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.upper">clink.upper</a></div> <div class="signature">( <span class="arg_name">text</span>:string ) : string<br/><div class="version">v1.1.5 and newer</div></div></div><div class="body"><p class="desc">This API correctly converts UTF8 strings to uppercase, with international linguistic awareness.</p><pre class="language-lua"><code>clink.upper("Hello World") -- returns "HELLO WORLD"
+
+<div class="function"><div class="header"> <div id="clink.upper" class="name"><a class="wlink" href="#clink.upper"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.upper</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string ) : string<br/><div class="version">v1.1.5 and newer</div></div></div><div class="body"><p class="desc">This API correctly converts UTF8 strings to uppercase, with international linguistic awareness.</p><pre class="language-lua"><code>clink.upper("Hello World") -- returns "HELLO WORLD"
 clink.lower("áèïÕÛ")       -- returns "ÁÈÏÕÛ"</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.version_commit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.version_commit">clink.version_commit</a></div> <div class="signature">string variable<br/><div class="version">v1.1.10 and newer</div></div></div><div class="body"><p class="desc">The commit part of the Clink version number. For v1.2.3.<strong>a0f14d</strong> the commit part is a0f14d.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.version_encoded"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.version_encoded">clink.version_encoded</a></div> <div class="signature">integer variable<br/><div class="version">v1.1.10 and newer</div></div></div><div class="body"><p class="desc">The Clink version number encoded as a single integer following the format <span class="arg">Mmmmpppp</span> where <span class="arg">M</span> is the major part, <span class="arg">m</span> is the minor part, and <span class="arg">p</span> is the patch part of the version number.</p><p class="desc"> For example, Clink v95.6.723 would be <code>950060723</code>.</p><p class="desc"> This format makes it easy to test for feature availability by encoding version numbers from the release notes.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.version_major"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.version_major">clink.version_major</a></div> <div class="signature">integer variable<br/><div class="version">v1.1.10 and newer</div></div></div><div class="body"><p class="desc">The major part of the Clink version number. For v<strong>1</strong>.2.3.a0f14d the major version is 1.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.version_minor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.version_minor">clink.version_minor</a></div> <div class="signature">integer variable<br/><div class="version">v1.1.10 and newer</div></div></div><div class="body"><p class="desc">The minor part of the Clink version number. For v1.<strong>2</strong>.3.a0f14d the minor version is 2.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.version_patch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.version_patch">clink.version_patch</a></div> <div class="signature">integer variable<br/><div class="version">v1.1.10 and newer</div></div></div><div class="body"><p class="desc">The patch part of the Clink version number. For v1.2.<strong>3</strong>.a0f14d the patch version is 3.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#console"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console">console</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.cellcount"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.cellcount">console.cellcount</a></div> <div class="signature">( <span class="arg_name">text</span>:string ) : integer<br/><div class="version">v1.2.5 and newer</div></div></div><div class="body"><p class="desc">Returns the count of visible character cells that would be consumed if the <span class="arg">text</span> string were output to the console, accounting for any ANSI escape codes that may be present in the text.</p><p class="desc"> Note: backspace characters and line endings are counted as visible character cells and will skew the resulting count.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.checkinput"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.checkinput">console.checkinput</a></div> <div class="signature">( [<span class="arg_name">timeout</span>:number] ) : boolean<br/><div class="version">v1.3.42 and newer</div></div></div><div class="body"><p class="desc">Checks whether input is available.</p><p class="desc"> The optional <span class="arg">timeout</span> is the number of seconds to wait for input to be available (use a floating point number for fractional seconds).  The default is 0 seconds, which returns immediately if input is not available.</p><p class="desc"> If input is available before the <span class="arg">timeout</span> is reached, the return value is true.  Use <a href="#console.readinput">console.readinput()</a> to read the available input.</p><p class="desc"> In Clink v1.6.0 and higher, when <span class="arg">timeout</span> is negative, the timeout is infinite.</p><p class="desc"> <strong>Note:</strong> Mouse input is not supported.</p><pre class="language-lua"><code>if console.checkinput() then
+
+<div class="function"><div class="header"> <div id="clink.version_commit" class="name"><a class="wlink" href="#clink.version_commit"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.version_commit</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">string variable<br/><div class="version">v1.1.10 and newer</div></div></div><div class="body"><p class="desc">The commit part of the Clink version number. For v1.2.3.<strong>a0f14d</strong> the commit part is a0f14d.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.version_encoded" class="name"><a class="wlink" href="#clink.version_encoded"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.version_encoded</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">integer variable<br/><div class="version">v1.1.10 and newer</div></div></div><div class="body"><p class="desc">The Clink version number encoded as a single integer following the format <span class="arg">Mmmmpppp</span> where <span class="arg">M</span> is the major part, <span class="arg">m</span> is the minor part, and <span class="arg">p</span> is the patch part of the version number.</p><p class="desc"> For example, Clink v95.6.723 would be <code>950060723</code>.</p><p class="desc"> This format makes it easy to test for feature availability by encoding version numbers from the release notes.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.version_major" class="name"><a class="wlink" href="#clink.version_major"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.version_major</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">integer variable<br/><div class="version">v1.1.10 and newer</div></div></div><div class="body"><p class="desc">The major part of the Clink version number. For v<strong>1</strong>.2.3.a0f14d the major version is 1.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.version_minor" class="name"><a class="wlink" href="#clink.version_minor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.version_minor</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">integer variable<br/><div class="version">v1.1.10 and newer</div></div></div><div class="body"><p class="desc">The minor part of the Clink version number. For v1.<strong>2</strong>.3.a0f14d the minor version is 2.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.version_patch" class="name"><a class="wlink" href="#clink.version_patch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.version_patch</span> <span class="uplinks"><a href="#clink">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">integer variable<br/><div class="version">v1.1.10 and newer</div></div></div><div class="body"><p class="desc">The patch part of the Clink version number. For v1.2.<strong>3</strong>.a0f14d the patch version is 3.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="console" class="group_name"><a class="wlink" href="#console"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>console. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#console.cellcount">cellcount</a></td><td><a href="#console.getcolortable">getcolortable</a></td><td><a href="#console.gettitle">gettitle</a></td><td><a href="#console.plaintext">plaintext</a></td></tr><tr><td><a href="#console.checkinput">checkinput</a></td><td><a href="#console.getcursorpos">getcursorpos</a></td><td><a href="#console.gettop">gettop</a></td><td><a href="#console.readinput">readinput</a></td></tr><tr><td><a href="#console.explodeansi">explodeansi</a></td><td><a href="#console.getheight">getheight</a></td><td><a href="#console.getwidth">getwidth</a></td><td><a href="#console.screengrab">screengrab</a></td></tr><tr><td><a href="#console.findnextline">findnextline</a></td><td><a href="#console.getlinetext">getlinetext</a></td><td><a href="#console.islinedefaultcolor">islinedefaultcolor</a></td><td><a href="#console.scroll">scroll</a></td></tr><tr><td><a href="#console.findprevline">findprevline</a></td><td><a href="#console.getnumlines">getnumlines</a></td><td><a href="#console.linehascolor">linehascolor</a></td><td><a href="#console.settitle">settitle</a></td></tr></table>
+<div class="function"><div class="header"> <div id="console.cellcount" class="name"><a class="wlink" href="#console.cellcount"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.cellcount</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string ) : integer<br/><div class="version">v1.2.5 and newer</div></div></div><div class="body"><p class="desc">Returns the count of visible character cells that would be consumed if the <span class="arg">text</span> string were output to the console, accounting for any ANSI escape codes that may be present in the text.</p><p class="desc"> Note: backspace characters and line endings are counted as visible character cells and will skew the resulting count.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.checkinput" class="name"><a class="wlink" href="#console.checkinput"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.checkinput</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">timeout</span>:number] ) : boolean<br/><div class="version">v1.3.42 and newer</div></div></div><div class="body"><p class="desc">Checks whether input is available.</p><p class="desc"> The optional <span class="arg">timeout</span> is the number of seconds to wait for input to be available (use a floating point number for fractional seconds).  The default is 0 seconds, which returns immediately if input is not available.</p><p class="desc"> If input is available before the <span class="arg">timeout</span> is reached, the return value is true.  Use <a href="#console.readinput">console.readinput()</a> to read the available input.</p><p class="desc"> In Clink v1.6.0 and higher, when <span class="arg">timeout</span> is negative, the timeout is infinite.</p><p class="desc"> <strong>Note:</strong> Mouse input is not supported.</p><pre class="language-lua"><code>if console.checkinput() then
 &nbsp;   local key = console.readinput() -- Returns immediately since input is available.
 &nbsp;   if key == "\x03" or key == "\x1b[27;27~" or key == "\x1b" then
 &nbsp;       -- Ctrl-C or ESC was pressed.
 &nbsp;   end
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.findnextline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.findnextline">console.findnextline</a></div> <div class="signature">( <span class="arg_name">starting_line</span>:integer, [<span class="arg_name">text</span>:string], [<span class="arg_name">mode</span>:string], [<span class="arg_name">attr</span>:integer | table of integers], [<span class="arg_name">mask</span>:string] ) : integer<br/><div class="version">v1.1.21 and newer</div></div></div><div class="body"><p class="desc">Searches downwards (forwards) for a line containing the specified text and/or attributes, starting at line <span class="arg">starting_line</span>. The matching line number is returned, or 0 if no matching line is found.</p><p class="desc"> This behaves the same as <a href="#console.findprevline">console.findprevline()</a> except that it searches in the opposite direction.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.findprevline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.findprevline">console.findprevline</a></div> <div class="signature">( <span class="arg_name">starting_line</span>:integer, [<span class="arg_name">text</span>:string], [<span class="arg_name">mode</span>:string], [<span class="arg_name">attr</span>:integer | table of integers], [<span class="arg_name">mask</span>:string] ) : integer<br/><div class="version">v1.1.21 and newer</div></div></div><div class="body"><p class="desc">Searches upwards (backwards) for a line containing the specified text and/or attributes, starting at line <span class="arg">starting_line</span>.  The matching line number is returned, or 0 if no matching line is found, or -1 if an invalid regular expression is provided.</p><p class="desc"> You can search for text, attributes, or both.  Include the <span class="arg">text</span> argument to search for text, and include either the <span class="arg">attr</span> or <span class="arg">attrs</span> argument to search for attributes.  If both text and attribute(s) are passed, then the attribute(s) must be found within the found text.  If only attribute(s) are passed, then they must be found anywhere in the line.  See <a href="#console.linehascolor">console.linehascolor()</a> for more information about the color codes.</p><p class="desc"> The <span class="arg">mode</span> argument selects how the search behaves. To use a regular expression, pass "regex".  To use a case insensitive search, pass "icase".  These can be combined by separating them with a comma.  The regular expression syntax is the ECMAScript syntax described <a href="https://docs.microsoft.com/en-us/cpp/standard-library/regular-expressions-cpp">here</a>.</p><p class="desc"> Any trailing whitespace is ignored when searching.  This especially affects the <code>$</code> (end of line) regex operator.</p><p class="desc"> <span class="arg">mask</span> is optional and can be "fore" or "back" to only match foreground or background colors, respectively.</p><p class="desc"> <strong>Note:</strong> Although most of the arguments are optional, the order of provided arguments is important.</p><p class="desc"> For more information, see <a href="#findlineexample">this example</a> of using this in some <a href="#luakeybindings">luafunc: macros</a>.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.getcolortable"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.getcolortable">console.getcolortable</a></div> <div class="signature">() : table<br/><div class="version">v1.5.15 and newer</div></div></div><div class="body"><p class="desc">This returns a table containing the 16 predefined colors in the console's color theme.</p><p class="desc"> Clink also tries to detect the terminal's background color.  If it's able to, then the returned table also includes either a <code>light = true</code> field or a <code>dark = true</code> field.</p><p class="desc"> The returned table also includes <code>foreground</code> and <code>background</code> fields which contain the index of the corresponding closest colors in the color table.  If unable to determine the closest colors, then either of these fields may be missing.</p><p class="desc"> **Note:**  When using Windows Terminal, ConEmu, or other ConPty-based terminals it is currently not possible to get the current color theme until <a href="https://github.com/microsoft/terminal/issues/10639">Terminal#10639</a> gets fixed.  Until that's fixed, this can only return a default color table, which includes a <code>default = true</code> field.  When using the legacy conhost terminal then this is always able to report the current color theme.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.getcursorpos"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.getcursorpos">console.getcursorpos</a></div> <div class="signature">() : integer, integer<br/><div class="version">v1.4.28 and newer</div></div></div><div class="body"><p class="desc">Returns the current cursor column and row in the console screen buffer. The row is between 1 and <a href="#console.getnumlines">console.getnumlines()</a>. The column is between 1 and <a href="#console.getwidth">console.getwidth()</a>.</p><pre class="language-lua"><code>local x, y = console.getcursorpos()</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.getheight"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.getheight">console.getheight</a></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the number of visible lines of the console screen buffer.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.getlinetext"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.getlinetext">console.getlinetext</a></div> <div class="signature">( <span class="arg_name">line</span>:integer ) : string<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the text from line number <span class="arg">line</span>, from 1 to <a href="#console.getnumlines">console.getnumlines()</a>.</p><p class="desc"> Any trailing whitespace is stripped before returning the text.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.getnumlines"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.getnumlines">console.getnumlines</a></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the total number of lines in the console screen buffer.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.gettitle"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.gettitle">console.gettitle</a></div> <div class="signature">() : string<br/><div class="version">v1.1.32 and newer</div></div></div><div class="body"><p class="desc">Returns the console title text.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.gettop"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.gettop">console.gettop</a></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the current top line (scroll position) in the console screen buffer.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.getwidth"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.getwidth">console.getwidth</a></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the width of the console screen buffer in characters.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.islinedefaultcolor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.islinedefaultcolor">console.islinedefaultcolor</a></div> <div class="signature">( <span class="arg_name">line</span>:integer ) : boolean<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns whether line number <span class="arg">line</span> uses only the default text color.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.linehascolor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.linehascolor">console.linehascolor</a></div> <div class="signature">( <span class="arg_name">line</span>:integer, [<span class="arg_name">attr</span>:integer], [<span class="arg_name">attrs</span>:table of integers], [<span class="arg_name">mask</span>:string] ) : boolean<br/><div class="version">v1.1.21 and newer</div></div></div><div class="body"><p class="desc">Returns whether line number <span class="arg">line</span> contains the DOS color code <span class="arg">attr</span>, or any of the DOS color codes in <span class="arg">attrs</span> (either an integer or a table of integers must be provided, but not both).  <span class="arg">mask</span> is optional and can be "fore" or "back" to only match foreground or background colors, respectively.</p><p class="desc"> The low 4 bits of the color code are the foreground color, and the high 4 bits of the color code are the background color.  This refers to the default 16 color palette used by console windows.  When 256 color or 24-bit color ANSI escape codes have been used, the closest of the 16 colors is used.</p><p class="desc"> To build a color code, add the corresponding Foreground color and the Background color values from this table:</p><p class="desc"> <table><tr><th align="center">Foreground</th><th align="center">Background</th><th>Color</th></tr> <tr><td align="center">0</td><td align="center">0</td><td><div class="colorsample" style="background-color:#000000">&nbsp;</div> Black</td></tr> <tr><td align="center">1</td><td align="center">16</td><td><div class="colorsample" style="background-color:#000080">&nbsp;</div> Dark Blue</td></tr> <tr><td align="center">2</td><td align="center">32</td><td><div class="colorsample" style="background-color:#008000">&nbsp;</div> Dark Green</td></tr> <tr><td align="center">3</td><td align="center">48</td><td><div class="colorsample" style="background-color:#008080">&nbsp;</div> Dark Cyan</td></tr> <tr><td align="center">4</td><td align="center">64</td><td><div class="colorsample" style="background-color:#800000">&nbsp;</div> Dark Red</td></tr> <tr><td align="center">5</td><td align="center">80</td><td><div class="colorsample" style="background-color:#800080">&nbsp;</div> Dark Magenta</td></tr> <tr><td align="center">6</td><td align="center">96</td><td><div class="colorsample" style="background-color:#808000">&nbsp;</div> Dark Yellow</td></tr> <tr><td align="center">7</td><td align="center">112</td><td><div class="colorsample" style="background-color:#c0c0c0">&nbsp;</div> Gray</td></tr> <tr><td align="center">8</td><td align="center">128</td><td><div class="colorsample" style="background-color:#808080">&nbsp;</div> Dark Gray</td></tr> <tr><td align="center">9</td><td align="center">144</td><td><div class="colorsample" style="background-color:#0000ff">&nbsp;</div> Bright Blue</td></tr> <tr><td align="center">10</td><td align="center">160</td><td><div class="colorsample" style="background-color:#00ff00">&nbsp;</div> Bright Green</td></tr> <tr><td align="center">11</td><td align="center">176</td><td><div class="colorsample" style="background-color:#00ffff">&nbsp;</div> Bright Cyan</td></tr> <tr><td align="center">12</td><td align="center">192</td><td><div class="colorsample" style="background-color:#ff0000">&nbsp;</div> Bright Red</td></tr> <tr><td align="center">13</td><td align="center">208</td><td><div class="colorsample" style="background-color:#ff00ff">&nbsp;</div> Bright Magenta</td></tr> <tr><td align="center">14</td><td align="center">224</td><td><div class="colorsample" style="background-color:#ffff00">&nbsp;</div> Bright Yellow</td></tr> <tr><td align="center">15</td><td align="center">240</td><td><div class="colorsample" style="background-color:#ffffff">&nbsp;</div> White</td></tr> </table></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.plaintext"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.plaintext">console.plaintext</a></div> <div class="signature">( <span class="arg_name">text</span>:string ) : string, integer<br/><div class="version">v1.2.5 and newer</div></div></div><div class="body"><p class="desc">Returns the input <span class="arg">text</span> with ANSI escape codes removed, and the count of visible character cells that would be consumed if the text were output to the console.</p><p class="desc"> Note: backspace characters and line endings are counted as visible character cells and will skew the resulting count.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.readinput"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.readinput">console.readinput</a></div> <div class="signature">( <span class="arg_name">no_cursor</span>:boolean ) : string | nil<br/><div class="version">v1.2.29 and newer</div></div></div><div class="body"><p class="desc">Reads one key sequence from the console input.  If no input is available, it waits until input becomes available.</p><p class="desc"> This returns the full key sequence string for the pressed key. For example, <kbd>A</kbd> is <code>"A"</code> and <kbd>Home</kbd> is <code>"\027[A"</code>, etc.  Nil is returned when an interrupt occurs by pressing <kbd>Ctrl</kbd>-<kbd>Break</kbd>.</p><p class="desc"> See <a href="#discoverkeysequences">Discovering Key Sequences</a> for information on how to find the key sequence for a key.</p><p class="desc"> In Clink v1.3.42 and higher, passing true for <span class="arg">no_cursor</span> avoids modifying the cursor visibility or position.</p><p class="desc"> <strong>Note:</strong> Mouse input is not supported.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.screengrab"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.screengrab">console.screengrab</a></div> <div class="signature">( <span class="arg_name">candidate_pattern</span>:string, <span class="arg_name">accept_pattern</span>:string ) : table<br/><div class="version">v1.1.40 and newer</div></div></div><div class="body"><p class="desc">Uses the provided Lua string patterns to collect text from the current console screen and returns a table of matching text snippets.  The snippets are ordered by distance from the input line.</p><p class="desc"> For example <span class="arg">candidate_pattern</span> could specify a pattern that identifies words, and <span class="arg">accept_pattern</span> could specify a pattern that matches words composed of hexadecimal digits.</p><pre class="language-lua"><code>local matches = console.screengrab(
+
+<div class="function"><div class="header"> <div id="console.explodeansi" class="name"><a class="wlink" href="#console.explodeansi"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.explodeansi</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string ) : table<br/><div class="version">v1.6.1 and newer</div></div></div><div class="body"><p class="desc">Splits <span class="arg">text</span> on ANSI escape code boundaries and returns a table containing the substrings.</p><pre class="language-lua"><code>console.explodeansi("\x1b[7mReverse\x1b[0;1mBold\x1b[m\x1b[K")
+-- returns the following table:
+--  {
+--      "\x1b[7m",
+--      "Reverse",
+--      "\x1b[0;1m",
+--      "Bold",
+--      "\x1b[m",
+--      "\x1b[K",
+--  }</code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.findnextline" class="name"><a class="wlink" href="#console.findnextline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.findnextline</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">starting_line</span>:integer, [<span class="arg_name">text</span>:string], [<span class="arg_name">mode</span>:string], [<span class="arg_name">attr</span>:integer | table of integers], [<span class="arg_name">mask</span>:string] ) : integer<br/><div class="version">v1.1.21 and newer</div></div></div><div class="body"><p class="desc">Searches downwards (forwards) for a line containing the specified text and/or attributes, starting at line <span class="arg">starting_line</span>. The matching line number is returned, or 0 if no matching line is found.</p><p class="desc"> This behaves the same as <a href="#console.findprevline">console.findprevline()</a> except that it searches in the opposite direction.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.findprevline" class="name"><a class="wlink" href="#console.findprevline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.findprevline</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">starting_line</span>:integer, [<span class="arg_name">text</span>:string], [<span class="arg_name">mode</span>:string], [<span class="arg_name">attr</span>:integer | table of integers], [<span class="arg_name">mask</span>:string] ) : integer<br/><div class="version">v1.1.21 and newer</div></div></div><div class="body"><p class="desc">Searches upwards (backwards) for a line containing the specified text and/or attributes, starting at line <span class="arg">starting_line</span>.  The matching line number is returned, or 0 if no matching line is found, or -1 if an invalid regular expression is provided.</p><p class="desc"> You can search for text, attributes, or both.  Include the <span class="arg">text</span> argument to search for text, and include either the <span class="arg">attr</span> or <span class="arg">attrs</span> argument to search for attributes.  If both text and attribute(s) are passed, then the attribute(s) must be found within the found text.  If only attribute(s) are passed, then they must be found anywhere in the line.  See <a href="#console.linehascolor">console.linehascolor()</a> for more information about the color codes.</p><p class="desc"> The <span class="arg">mode</span> argument selects how the search behaves. To use a regular expression, pass "regex".  To use a case insensitive search, pass "icase".  These can be combined by separating them with a comma.  The regular expression syntax is the ECMAScript syntax described <a href="https://docs.microsoft.com/en-us/cpp/standard-library/regular-expressions-cpp">here</a>.</p><p class="desc"> Any trailing whitespace is ignored when searching.  This especially affects the <code>$</code> (end of line) regex operator.</p><p class="desc"> <span class="arg">mask</span> is optional and can be "fore" or "back" to only match foreground or background colors, respectively.</p><p class="desc"> <strong>Note:</strong> Although most of the arguments are optional, the order of provided arguments is important.</p><p class="desc"> For more information, see <a href="#findlineexample">this example</a> of using this in some <a href="#luakeybindings">luafunc: macros</a>.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.getcolortable" class="name"><a class="wlink" href="#console.getcolortable"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.getcolortable</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : table<br/><div class="version">v1.5.15 and newer</div></div></div><div class="body"><p class="desc">This returns a table containing the 16 predefined colors in the console's color theme.</p><p class="desc"> Clink also tries to detect the terminal's background color.  If it's able to, then the returned table also includes either a <code>light = true</code> field or a <code>dark = true</code> field.</p><p class="desc"> The returned table also includes <code>foreground</code> and <code>background</code> fields which contain the index of the corresponding closest colors in the color table.  If unable to determine the closest colors, then either of these fields may be missing.</p><p class="desc"> **Note:**  When using Windows Terminal, ConEmu, or other ConPty-based terminals it is currently not possible to get the current color theme until <a href="https://github.com/microsoft/terminal/issues/10639">Terminal#10639</a> gets fixed.  Until that's fixed, this can only return a default color table, which includes a <code>default = true</code> field.  When using the legacy conhost terminal then this is always able to report the current color theme.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.getcursorpos" class="name"><a class="wlink" href="#console.getcursorpos"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.getcursorpos</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer, integer<br/><div class="version">v1.4.28 and newer</div></div></div><div class="body"><p class="desc">Returns the current cursor column and row in the console screen buffer. The row is between 1 and <a href="#console.getnumlines">console.getnumlines()</a>. The column is between 1 and <a href="#console.getwidth">console.getwidth()</a>.</p><pre class="language-lua"><code>local x, y = console.getcursorpos()</code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.getheight" class="name"><a class="wlink" href="#console.getheight"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.getheight</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the number of visible lines of the console screen buffer.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.getlinetext" class="name"><a class="wlink" href="#console.getlinetext"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.getlinetext</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">line</span>:integer ) : string<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the text from line number <span class="arg">line</span>, from 1 to <a href="#console.getnumlines">console.getnumlines()</a>.</p><p class="desc"> Any trailing whitespace is stripped before returning the text.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.getnumlines" class="name"><a class="wlink" href="#console.getnumlines"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.getnumlines</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the total number of lines in the console screen buffer.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.gettitle" class="name"><a class="wlink" href="#console.gettitle"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.gettitle</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string<br/><div class="version">v1.1.32 and newer</div></div></div><div class="body"><p class="desc">Returns the console title text.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.gettop" class="name"><a class="wlink" href="#console.gettop"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.gettop</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the current top line (scroll position) in the console screen buffer.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.getwidth" class="name"><a class="wlink" href="#console.getwidth"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.getwidth</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the width of the console screen buffer in characters.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.islinedefaultcolor" class="name"><a class="wlink" href="#console.islinedefaultcolor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.islinedefaultcolor</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">line</span>:integer ) : boolean<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns whether line number <span class="arg">line</span> uses only the default text color.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.linehascolor" class="name"><a class="wlink" href="#console.linehascolor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.linehascolor</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">line</span>:integer, [<span class="arg_name">attr</span>:integer], [<span class="arg_name">attrs</span>:table of integers], [<span class="arg_name">mask</span>:string] ) : boolean<br/><div class="version">v1.1.21 and newer</div></div></div><div class="body"><p class="desc">Returns whether line number <span class="arg">line</span> contains the DOS color code <span class="arg">attr</span>, or any of the DOS color codes in <span class="arg">attrs</span> (either an integer or a table of integers must be provided, but not both).  <span class="arg">mask</span> is optional and can be "fore" or "back" to only match foreground or background colors, respectively.</p><p class="desc"> The low 4 bits of the color code are the foreground color, and the high 4 bits of the color code are the background color.  This refers to the default 16 color palette used by console windows.  When 256 color or 24-bit color ANSI escape codes have been used, the closest of the 16 colors is used.</p><p class="desc"> To build a color code, add the corresponding Foreground color and the Background color values from this table:</p><p class="desc"> <table><tr><th align="center">Foreground</th><th align="center">Background</th><th>Color</th></tr> <tr><td align="center">0</td><td align="center">0</td><td><div class="colorsample" style="background-color:#000000">&nbsp;</div> Black</td></tr> <tr><td align="center">1</td><td align="center">16</td><td><div class="colorsample" style="background-color:#000080">&nbsp;</div> Dark Blue</td></tr> <tr><td align="center">2</td><td align="center">32</td><td><div class="colorsample" style="background-color:#008000">&nbsp;</div> Dark Green</td></tr> <tr><td align="center">3</td><td align="center">48</td><td><div class="colorsample" style="background-color:#008080">&nbsp;</div> Dark Cyan</td></tr> <tr><td align="center">4</td><td align="center">64</td><td><div class="colorsample" style="background-color:#800000">&nbsp;</div> Dark Red</td></tr> <tr><td align="center">5</td><td align="center">80</td><td><div class="colorsample" style="background-color:#800080">&nbsp;</div> Dark Magenta</td></tr> <tr><td align="center">6</td><td align="center">96</td><td><div class="colorsample" style="background-color:#808000">&nbsp;</div> Dark Yellow</td></tr> <tr><td align="center">7</td><td align="center">112</td><td><div class="colorsample" style="background-color:#c0c0c0">&nbsp;</div> Gray</td></tr> <tr><td align="center">8</td><td align="center">128</td><td><div class="colorsample" style="background-color:#808080">&nbsp;</div> Dark Gray</td></tr> <tr><td align="center">9</td><td align="center">144</td><td><div class="colorsample" style="background-color:#0000ff">&nbsp;</div> Bright Blue</td></tr> <tr><td align="center">10</td><td align="center">160</td><td><div class="colorsample" style="background-color:#00ff00">&nbsp;</div> Bright Green</td></tr> <tr><td align="center">11</td><td align="center">176</td><td><div class="colorsample" style="background-color:#00ffff">&nbsp;</div> Bright Cyan</td></tr> <tr><td align="center">12</td><td align="center">192</td><td><div class="colorsample" style="background-color:#ff0000">&nbsp;</div> Bright Red</td></tr> <tr><td align="center">13</td><td align="center">208</td><td><div class="colorsample" style="background-color:#ff00ff">&nbsp;</div> Bright Magenta</td></tr> <tr><td align="center">14</td><td align="center">224</td><td><div class="colorsample" style="background-color:#ffff00">&nbsp;</div> Bright Yellow</td></tr> <tr><td align="center">15</td><td align="center">240</td><td><div class="colorsample" style="background-color:#ffffff">&nbsp;</div> White</td></tr> </table></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.plaintext" class="name"><a class="wlink" href="#console.plaintext"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.plaintext</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string ) : string, integer<br/><div class="version">v1.2.5 and newer</div></div></div><div class="body"><p class="desc">Returns the input <span class="arg">text</span> with ANSI escape codes removed, and the count of visible character cells that would be consumed if the text were output to the console.</p><p class="desc"> Note: backspace characters and line endings are counted as visible character cells and will skew the resulting count.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.readinput" class="name"><a class="wlink" href="#console.readinput"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.readinput</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">no_cursor</span>:boolean ) : string | nil<br/><div class="version">v1.2.29 and newer</div></div></div><div class="body"><p class="desc">Reads one key sequence from the console input.  If no input is available, it waits until input becomes available.</p><p class="desc"> This returns the full key sequence string for the pressed key. For example, <kbd>A</kbd> is <code>"A"</code> and <kbd>Home</kbd> is <code>"\027[A"</code>, etc.  Nil is returned when an interrupt occurs by pressing <kbd>Ctrl</kbd>-<kbd>Break</kbd>.</p><p class="desc"> See <a href="#discoverkeysequences">Discovering Key Sequences</a> for information on how to find the key sequence for a key.</p><p class="desc"> In Clink v1.3.42 and higher, passing true for <span class="arg">no_cursor</span> avoids modifying the cursor visibility or position.</p><p class="desc"> <strong>Note:</strong> Mouse input is not supported.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.screengrab" class="name"><a class="wlink" href="#console.screengrab"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.screengrab</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">candidate_pattern</span>:string, <span class="arg_name">accept_pattern</span>:string ) : table<br/><div class="version">v1.1.40 and newer</div></div></div><div class="body"><p class="desc">Uses the provided Lua string patterns to collect text from the current console screen and returns a table of matching text snippets.  The snippets are ordered by distance from the input line.</p><p class="desc"> For example <span class="arg">candidate_pattern</span> could specify a pattern that identifies words, and <span class="arg">accept_pattern</span> could specify a pattern that matches words composed of hexadecimal digits.</p><pre class="language-lua"><code>local matches = console.screengrab(
 &nbsp;       "[^%w]*(%w%w[%w]+)",   -- Words with 3 or more letters are candidates.
 &nbsp;       "^%x+$")               -- A candidate containing only hexadecimal digits is a match.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.scroll"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.scroll">console.scroll</a></div> <div class="signature">( <span class="arg_name">mode</span>:string, <span class="arg_name">amount</span>:integer ) : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Scrolls the console screen buffer and returns the number of lines scrolled up (negative) or down (positive).</p><p class="desc"> The <span class="arg">mode</span> specifies how to scroll: <table> <tr><th>Mode</th><th>Description</th></tr> <tr><td>"line"</td><td>Scrolls by <span class="arg">amount</span> lines; negative is up and positive is down.</td></tr> <tr><td>"page"</td><td>Scrolls by <span class="arg">amount</span> pages; negative is up and positive is down.</td></tr> <tr><td>"end"</td><td>Scrolls to the top if <span class="arg">amount</span> is negative, or to the bottom if positive.</td></tr> <tr><td>"absolute"</td><td>Scrolls to line <span class="arg">amount</span>, from 1 to <a href="#console.getnumlines">console.getnumlines()</a>.</td></tr> </table></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#console.settitle"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="console.settitle">console.settitle</a></div> <div class="signature">( <span class="arg_name">title</span>:string ) : nil<br/><div class="version">v1.1.32 and newer</div></div></div><div class="body"><p class="desc">Sets the console title text.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#io"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="io">io</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#io.open"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="io.open">io.open</a></div> <div class="signature">( <span class="arg_name">filename</span>:string, [<span class="arg_name">mode</span>:string] ) : file<br/><div class="version">v0.0.1 and newer</div></div></div><div class="body"><p class="desc">This function opens a file named by <span class="arg">filename</span>, in the mode specified in the string <span class="arg">mode</span>.  It returns a new file handle, or, in case of errors, nil plus an error message and error number.</p><p class="desc"> The <span class="arg">mode</span> string can be any of the following: <ul> <li><code>"r"</code>: read mode (the default); <li><code>"w"</code>: write mode; <li><code>"wx"</code>: write mode, but fail if the file already exists (requires v1.3.18 or higher); <li><code>"a"</code>: append mode; <li><code>"r+"</code>: update mode, all previous data is preserved; <li><code>"w+"</code>: update mode, all previous data is erased; <li><code>"w+x"</code>: update mode, all previous data is erased, but fail if the file already exists (requires v1.3.18 or higher); <li><code>"a+"</code>: append update mode, previous data is preserved, writing is only allowed at the end of file. </ul></p><p class="desc"> The <span class="arg">mode</span> string can also have a <code>'b'</code> at the end to open the file in binary mode.</p><p class="desc"> The <code>'x'</code> modes are Clink extensions to Lua.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#io.popenrw"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="io.popenrw">io.popenrw</a></div> <div class="signature">( <span class="arg_name">command</span>:string, [<span class="arg_name">mode</span>:string] ) : file, file<br/><div class="version">v1.1.42 and newer</div></div></div><div class="body"><p class="desc">Runs <span class="arg">command</span> and returns two file handles:  a file handle for reading output from the command, and a file handle for writing input to the command.</p><p class="desc"> <span class="arg">mode</span> can be "t" for text mode (the default if omitted) or "b" for binary mode.</p><p class="desc"> If the function fails it returns nil, an error message, and an error number.</p><p class="desc"> <fieldset><legend>Warning</legend> This can result in deadlocks unless the command fully reads all of its input before writing any output.  This is because Lua uses blocking IO to read and write file handles.  If the write buffer fills (or the read buffer is empty) then the write (or read) will block and can only become unblocked if the command correspondingly reads (or writes).  But the other command can easily experience the same blocking IO problem on its end, resulting in a deadlock: process 1 is blocked from writing more until process 2 reads, but process 2 can't read because it is blocked from writing until process 1 reads. </fieldset></p><pre class="language-lua"><code>local r,w = io.popenrw("fzf.exe --height 40%")
+
+<div class="function"><div class="header"> <div id="console.scroll" class="name"><a class="wlink" href="#console.scroll"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.scroll</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">mode</span>:string, <span class="arg_name">amount</span>:integer ) : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Scrolls the console screen buffer and returns the number of lines scrolled up (negative) or down (positive).</p><p class="desc"> The <span class="arg">mode</span> specifies how to scroll: <table> <tr><th>Mode</th><th>Description</th></tr> <tr><td>"line"</td><td>Scrolls by <span class="arg">amount</span> lines; negative is up and positive is down.</td></tr> <tr><td>"page"</td><td>Scrolls by <span class="arg">amount</span> pages; negative is up and positive is down.</td></tr> <tr><td>"end"</td><td>Scrolls to the top if <span class="arg">amount</span> is negative, or to the bottom if positive.</td></tr> <tr><td>"absolute"</td><td>Scrolls to line <span class="arg">amount</span>, from 1 to <a href="#console.getnumlines">console.getnumlines()</a>.</td></tr> </table></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="console.settitle" class="name"><a class="wlink" href="#console.settitle"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>console.settitle</span> <span class="uplinks"><a href="#console">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">title</span>:string ) : nil<br/><div class="version">v1.1.32 and newer</div></div></div><div class="body"><p class="desc">Sets the console title text.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="io" class="group_name"><a class="wlink" href="#io"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>io. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#io.open">open</a></td></tr><tr><td><a href="#io.popenrw">popenrw</a></td></tr><tr><td><a href="#io.popenyield">popenyield</a></td></tr><tr><td><a href="#io.sopen">sopen</a></td></tr><tr><td><a href="#io.truncate">truncate</a></td></tr></table>
+<div class="function"><div class="header"> <div id="io.open" class="name"><a class="wlink" href="#io.open"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>io.open</span> <span class="uplinks"><a href="#io">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">filename</span>:string, [<span class="arg_name">mode</span>:string] ) : file<br/><div class="version">v0.0.1 and newer</div></div></div><div class="body"><p class="desc">This function opens a file named by <span class="arg">filename</span>, in the mode specified in the string <span class="arg">mode</span>.  It returns a new file handle, or, in case of errors, nil plus an error message and error number.</p><p class="desc"> The <span class="arg">mode</span> string can be any of the following: <ul> <li><code>"r"</code>: read mode (the default); <li><code>"w"</code>: write mode; <li><code>"wx"</code>: write mode, but fail if the file already exists (requires v1.3.18 or higher); <li><code>"a"</code>: append mode; <li><code>"r+"</code>: update mode, all previous data is preserved; <li><code>"w+"</code>: update mode, all previous data is erased; <li><code>"w+x"</code>: update mode, all previous data is erased, but fail if the file already exists (requires v1.3.18 or higher); <li><code>"a+"</code>: append update mode, previous data is preserved, writing is only allowed at the end of file. </ul></p><p class="desc"> The <span class="arg">mode</span> string can also have a <code>'b'</code> at the end to open the file in binary mode.</p><p class="desc"> The <code>'x'</code> modes are Clink extensions to Lua.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="io.popenrw" class="name"><a class="wlink" href="#io.popenrw"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>io.popenrw</span> <span class="uplinks"><a href="#io">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">command</span>:string, [<span class="arg_name">mode</span>:string] ) : file, file<br/><div class="version">v1.1.42 and newer</div></div></div><div class="body"><p class="desc">Runs <span class="arg">command</span> and returns two file handles:  a file handle for reading output from the command, and a file handle for writing input to the command.</p><p class="desc"> <span class="arg">mode</span> can be "t" for text mode (the default if omitted) or "b" for binary mode.</p><p class="desc"> If the function fails it returns nil, an error message, and an error number.</p><p class="desc"> <fieldset><legend>Warning</legend> This can result in deadlocks unless the command fully reads all of its input before writing any output.  This is because Lua uses blocking IO to read and write file handles.  If the write buffer fills (or the read buffer is empty) then the write (or read) will block and can only become unblocked if the command correspondingly reads (or writes).  But the other command can easily experience the same blocking IO problem on its end, resulting in a deadlock: process 1 is blocked from writing more until process 2 reads, but process 2 can't read because it is blocked from writing until process 1 reads. </fieldset></p><pre class="language-lua"><code>local r,w = io.popenrw("fzf.exe --height 40%")
 
 w:write("hello\n")
 w:write("world\n")
@@ -6738,7 +7054,8 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;   print(line)
 end
 r:close()</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#io.popenyield"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="io.popenyield">io.popenyield</a></div> <div class="signature">( <span class="arg_name">command</span>:string, [<span class="arg_name">mode</span>:string] ) : file, function (see remarks below)<br/><div class="version">v1.2.10 and newer</div></div></div><div class="body"><p class="desc">This behaves similar to <a href="https://www.lua.org/manual/5.2/manual.html#pdf-io.popen">io.popen()</a> except that it only supports read mode and when used in a coroutine it yields until the command has finished.</p><p class="desc"> The <span class="arg">command</span> argument is the command to run.</p><p class="desc"> The <span class="arg">mode</span> argument is the optional mode to use.  It can contain "r" (read mode) and/or either "t" for text mode (the default if omitted) or "b" for binary mode.  Write mode is not supported, so it cannot contain "w".</p><p class="desc"> This runs the specified command and returns a read file handle for reading output from the command.  It yields until the command has finished and the complete output is ready to be read without blocking.</p><p class="desc"> In v1.3.31 and higher, it may also return a function.  If the second return value is a function then it can be used to get the exit status for the command.  The function returns the same values as <a href="https://www.lua.org/manual/5.2/manual.html#pdf-os.execute">os.execute()</a>. The function may be used only once, and it closes the read file handle, so if the function is used then do not use <code>file:close()</code>.  Or, if the second return value is not a function, then the exit status may be retrieved from calling <code>file:close()</code> on the returned file handle.</p><p class="desc"> <strong>Compatibility Note:</strong> when <code>io.popen()</code> is used in a coroutine, it is automatically redirected to <code>io.popenyield()</code>. This means on success the second return value from <code>io.popen()</code> in a coroutine may not be nil as callers might normally expect.</p><p class="desc"> <strong>Note:</strong> if the <code><a href="#prompt_async">prompt.async</a></code> setting is disabled, or while a <a href="#transientprompts">transient prompt filter</a> is executing, or if used outside of a coroutine, then this behaves like <a href="https://www.lua.org/manual/5.2/manual.html#pdf-io.popen">io.popen()</a> instead.</p><pre class="language-lua"><code>local file = io.popenyield("git status")
+
+<div class="function"><div class="header"> <div id="io.popenyield" class="name"><a class="wlink" href="#io.popenyield"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>io.popenyield</span> <span class="uplinks"><a href="#io">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">command</span>:string, [<span class="arg_name">mode</span>:string] ) : file, function (see remarks below)<br/><div class="version">v1.2.10 and newer</div></div></div><div class="body"><p class="desc">This behaves similar to <a href="https://www.lua.org/manual/5.2/manual.html#pdf-io.popen">io.popen()</a> except that it only supports read mode and when used in a coroutine it yields until the command has finished.</p><p class="desc"> The <span class="arg">command</span> argument is the command to run.</p><p class="desc"> The <span class="arg">mode</span> argument is the optional mode to use.  It can contain "r" (read mode) and/or either "t" for text mode (the default if omitted) or "b" for binary mode.  Write mode is not supported, so it cannot contain "w".</p><p class="desc"> This runs the specified command and returns a read file handle for reading output from the command.  It yields until the command has finished and the complete output is ready to be read without blocking.</p><p class="desc"> In v1.3.31 and higher, it may also return a function.  If the second return value is a function then it can be used to get the exit status for the command.  The function returns the same values as <a href="https://www.lua.org/manual/5.2/manual.html#pdf-os.execute">os.execute()</a>. The function may be used only once, and it closes the read file handle, so if the function is used then do not use <code>file:close()</code>.  Or, if the second return value is not a function, then the exit status may be retrieved from calling <code>file:close()</code> on the returned file handle.</p><p class="desc"> <strong>Compatibility Note:</strong> when <code>io.popen()</code> is used in a coroutine, it is automatically redirected to <code>io.popenyield()</code>. This means on success the second return value from <code>io.popen()</code> in a coroutine may not be nil as callers might normally expect.</p><p class="desc"> <strong>Note:</strong> if the <code><a href="#prompt_async">prompt.async</a></code> setting is disabled, or while a <a href="#transientprompts">transient prompt filter</a> is executing, or if used outside of a coroutine, then this behaves like <a href="https://www.lua.org/manual/5.2/manual.html#pdf-io.popen">io.popen()</a> instead.</p><pre class="language-lua"><code>local file = io.popenyield("git status")
 
 while (true) do
 &nbsp;   local line = file:read("*line")
@@ -6752,36 +7069,87 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 if file then
 &nbsp;   local ok, what, code = pclose()
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#io.sopen"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="io.sopen">io.sopen</a></div> <div class="signature">( <span class="arg_name">filename</span>:string, [<span class="arg_name">mode</span>:string], [<span class="arg_name">deny</span>:string] ) : file<br/><div class="version">v1.3.18 and newer</div></div></div><div class="body"><p class="desc">This is the same as <a href="#io.open">io.open()</a>, but adds an optional <code>deny</code> argument that specifies the type of sharing allowed.</p><p class="desc"> This function opens a file named by <span class="arg">filename</span>, in the mode specified in the string <span class="arg">mode</span>.  It returns a new file handle, or, in case of errors, nil plus an error message and error number.</p><p class="desc"> The <span class="arg">mode</span> string can be any of the following: <ul> <li><code>"r"</code>: read mode (the default); <li><code>"w"</code>: write mode; <li><code>"wx"</code>: write mode, but fail if the file already exists; <li><code>"a"</code>: append mode; <li><code>"r+"</code>: update mode, all previous data is preserved; <li><code>"w+"</code>: update mode, all previous data is erased; <li><code>"w+x"</code>: update mode, all previous data is erased, but fail if the file already exists; <li><code>"a+"</code>: append update mode, previous data is preserved, writing is only allowed at the end of file. </ul></p><p class="desc"> The <span class="arg">mode</span> string can also have a <code>'b'</code> at the end to open the file in binary mode.</p><p class="desc"> The <span class="arg">deny</span> string can be any of the following: <ul> <li><code>"r"</code> denies read access; <li><code>"w"</code> denies write access; <li><code>"rw"</code> denies read and write access; <li><code>""</code> permits read and write access (the default). </ul></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#io.truncate"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="io.truncate">io.truncate</a></div> <div class="signature">( <span class="arg_name">file</span>:file ) : boolean<br/><div class="version">v1.3.41 and newer</div></div></div><div class="body"><p class="desc">This function truncates the <span class="arg">file</span> previously opened by <a href="#io.open">io.open()</a> or <a href="#io.sopen">io.sopen()</a>. When used on a pipe or other file handle that doesn't refer to an actual file, the behavior is undefined.</p><p class="desc"> If successful, the return value is true. If an error occurs, the return value  is false, an error message, and an error code.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#line_state"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="line_state">line_state</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#line_state:getcommandoffset"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="line_state:getcommandoffset">line_state:getcommandoffset</a></div> <div class="signature">() : integer<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the offset to the start of the delimited command in the line that's being effectively edited. Note that this may not be the offset of the first command of the line unquoted as whitespace isn't considered for words.</p><pre class="language-lua"><code>-- Given the following line; abc&123
--- where commands are separated by & symbols.
-line_state:getcommandoffset() == 5</code></pre><p class="desc">The command offset points to the beginning of the command, but that might be a space character.  Two spaces after a command separator is like one space at the beginning of a line; it disables doskey alias expansion.  So, if the command offset points at a space, then you know the first word will not be treated as a doskey alias.</p><pre class="language-lua"><code>-- Given the following line; abc&  123
--- where commands are separated by & symbols.
+
+<div class="function"><div class="header"> <div id="io.sopen" class="name"><a class="wlink" href="#io.sopen"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>io.sopen</span> <span class="uplinks"><a href="#io">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">filename</span>:string, [<span class="arg_name">mode</span>:string], [<span class="arg_name">deny</span>:string] ) : file<br/><div class="version">v1.3.18 and newer</div></div></div><div class="body"><p class="desc">This is the same as <a href="#io.open">io.open()</a>, but adds an optional <code>deny</code> argument that specifies the type of sharing allowed.</p><p class="desc"> This function opens a file named by <span class="arg">filename</span>, in the mode specified in the string <span class="arg">mode</span>.  It returns a new file handle, or, in case of errors, nil plus an error message and error number.</p><p class="desc"> The <span class="arg">mode</span> string can be any of the following: <ul> <li><code>"r"</code>: read mode (the default); <li><code>"w"</code>: write mode; <li><code>"wx"</code>: write mode, but fail if the file already exists; <li><code>"a"</code>: append mode; <li><code>"r+"</code>: update mode, all previous data is preserved; <li><code>"w+"</code>: update mode, all previous data is erased; <li><code>"w+x"</code>: update mode, all previous data is erased, but fail if the file already exists; <li><code>"a+"</code>: append update mode, previous data is preserved, writing is only allowed at the end of file. </ul></p><p class="desc"> The <span class="arg">mode</span> string can also have a <code>'b'</code> at the end to open the file in binary mode.</p><p class="desc"> The <span class="arg">deny</span> string can be any of the following: <ul> <li><code>"r"</code> denies read access; <li><code>"w"</code> denies write access; <li><code>"rw"</code> denies read and write access; <li><code>""</code> permits read and write access (the default). </ul></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="io.truncate" class="name"><a class="wlink" href="#io.truncate"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>io.truncate</span> <span class="uplinks"><a href="#io">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">file</span>:file ) : boolean<br/><div class="version">v1.3.41 and newer</div></div></div><div class="body"><p class="desc">This function truncates the <span class="arg">file</span> previously opened by <a href="#io.open">io.open()</a> or <a href="#io.sopen">io.sopen()</a>. When used on a pipe or other file handle that doesn't refer to an actual file, the behavior is undefined.</p><p class="desc"> If successful, the return value is true. If an error occurs, the return value  is false, an error message, and an error code.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="line_state" class="group_name"><a class="wlink" href="#line_state"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>line_state: <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#line_state:getcommandoffset">getcommandoffset</a></td><td><a href="#line_state:getrangelength">getrangelength</a></td></tr><tr><td><a href="#line_state:getcommandwordindex">getcommandwordindex</a></td><td><a href="#line_state:getrangeoffset">getrangeoffset</a></td></tr><tr><td><a href="#line_state:getcursor">getcursor</a></td><td><a href="#line_state:getword">getword</a></td></tr><tr><td><a href="#line_state:getendword">getendword</a></td><td><a href="#line_state:getwordcount">getwordcount</a></td></tr><tr><td><a href="#line_state:getline">getline</a></td><td><a href="#line_state:getwordinfo">getwordinfo</a></td></tr></table>
+<div class="function"><div class="header"> <div id="line_state:getcommandoffset" class="name"><a class="wlink" href="#line_state:getcommandoffset"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>line_state:getcommandoffset</span> <span class="uplinks"><a href="#line_state">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the offset to the start of the delimited command in the line that's being effectively edited. Note that this may not be the offset of the first command of the line unquoted as whitespace isn't considered for words.</p><pre class="language-lua"><code>-- Given the following line;  abc&123
+--                                ^
+-- In the line_state for the second command;
+line_state:getcommandoffset() == 5</code></pre><p class="desc">The command offset points to the beginning of the command, but that might be a space character.  Two spaces after a command separator is like one space at the beginning of a line; it disables doskey alias expansion.  So, if the command offset points at a space, then you know the first word will not be treated as a doskey alias.</p><pre class="language-lua"><code>-- Given the following line;  abc&  123
+--                                 ^
+-- In the line_state for the second command;
 line_state:getcommandoffset() == 6</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#line_state:getcommandwordindex"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="line_state:getcommandwordindex">line_state:getcommandwordindex</a></div> <div class="signature">() : integer<br/><div class="version">v1.2.27 and newer</div></div></div><div class="body"><p class="desc">Returns the index of the command word. Usually the index is 1, but if a redirection symbol occurs before the command name then the index can be greater than 1.</p><pre class="language-lua"><code>-- Given the following line; >x abc
+
+<div class="function"><div class="header"> <div id="line_state:getcommandwordindex" class="name"><a class="wlink" href="#line_state:getcommandwordindex"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>line_state:getcommandwordindex</span> <span class="uplinks"><a href="#line_state">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.2.27 and newer</div></div></div><div class="body"><p class="desc">Returns the index of the command word. Usually the index is 1, but if a redirection symbol occurs before the command name then the index can be greater than 1.</p><pre class="language-lua"><code>-- Given the following line;  >x abc
 -- the first word is "x" and is an argument to the redirection symbol,
 -- and the second word is "abc" and is the command word.
 line_state:getcommandwordindex() == 2</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#line_state:getcursor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="line_state:getcursor">line_state:getcursor</a></div> <div class="signature">() : integer<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the position of the cursor.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#line_state:getendword"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="line_state:getendword">line_state:getendword</a></div> <div class="signature">() : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the last word of the line. This is the word that matches are being generated for.</p><p class="desc"> <strong>Note:</strong>  The returned word omits any quotes.  This helps generators naturally complete <code>"foo\"ba</code> to <code>"foo\bar"</code>.  The raw word including quotes can be obtained using the <code>offset</code> and <code>length</code> fields from <a href="#line_state:getwordinfo">line_state:getwordinfo()</a> to extract a substring from the line returned by <a href="#line_state:getline">line_state:getline()</a>.</p><pre class="language-lua"><code>line_state:getword(line_state:getwordcount()) == line_state:getendword()</code></pre><p class="desc"><strong>However:</strong>  During <code><a href="#the-getwordbreakinfo-function">generator:getwordbreakinfo()</a></code> functions the returned word includes quotes, otherwise word break offsets could be garbled.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#line_state:getline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="line_state:getline">line_state:getline</a></div> <div class="signature">() : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the current line in its entirety.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#line_state:getword"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="line_state:getword">line_state:getword</a></div> <div class="signature">( <span class="arg_name">index</span>:integer ) : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the word of the line at <span class="arg">index</span>.</p><p class="desc"> <strong>Note:</strong>  The returned word omits any quotes.  This helps generators naturally complete <code>"foo\"ba</code> to <code>"foo\bar"</code>.  The raw word including quotes can be obtained using the <code>offset</code> and <code>length</code> fields from <a href="#line_state:getwordinfo">line_state:getwordinfo()</a> to extract a substring from the line returned by <a href="#line_state:getline">line_state:getline()</a>.</p><p class="desc"> <strong>However:</strong>  During <code><a href="#the-getwordbreakinfo-function">generator:getwordbreakinfo()</a></code> functions the returned word includes quotes, otherwise word break offsets could be garbled.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#line_state:getwordcount"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="line_state:getwordcount">line_state:getwordcount</a></div> <div class="signature">() : integer<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the number of words in the current line.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#line_state:getwordinfo"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="line_state:getwordinfo">line_state:getwordinfo</a></div> <div class="signature">( <span class="arg_name">index</span>:integer ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns a table of information about the Nth word in the line.</p><p class="desc"> Note:  The length refers to the substring in the line; it omits leading and trailing quotes, but <em><strong>includes</strong></em> embedded quotes. <a href="#line_state:getword">line_state:getword()</a> conveniently strips embedded quotes to help generators naturally complete <code>"foo\"ba</code> to <code>"foo\bar"</code>.</p><p class="desc"> The table returned has the following scheme:</p><pre class="language-lua"><code>local t = line_state:getwordinfo(word_index)
+
+<div class="function"><div class="header"> <div id="line_state:getcursor" class="name"><a class="wlink" href="#line_state:getcursor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>line_state:getcursor</span> <span class="uplinks"><a href="#line_state">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the position of the cursor.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="line_state:getendword" class="name"><a class="wlink" href="#line_state:getendword"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>line_state:getendword</span> <span class="uplinks"><a href="#line_state">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the last word of the line. This is the word that matches are being generated for.</p><p class="desc"> <strong>Note:</strong>  The returned word omits any quotes.  This helps generators naturally complete <code>"foo\"ba</code> to <code>"foo\bar"</code>.  The raw word including quotes can be obtained using the <code>offset</code> and <code>length</code> fields from <a href="#line_state:getwordinfo">line_state:getwordinfo()</a> to extract a substring from the line returned by <a href="#line_state:getline">line_state:getline()</a>.</p><pre class="language-lua"><code>line_state:getword(line_state:getwordcount()) == line_state:getendword()</code></pre><p class="desc"><strong>However:</strong>  During <code><a href="#the-getwordbreakinfo-function">generator:getwordbreakinfo()</a></code> functions the returned word includes quotes, otherwise word break offsets could be garbled.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="line_state:getline" class="name"><a class="wlink" href="#line_state:getline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>line_state:getline</span> <span class="uplinks"><a href="#line_state">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the current line in its entirety.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="line_state:getrangelength" class="name"><a class="wlink" href="#line_state:getrangelength"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>line_state:getrangelength</span> <span class="uplinks"><a href="#line_state">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.6.1 and newer</div></div></div><div class="body"><p class="desc">Each line_state describes a range of text in a line.  This function returns the length of the range described by this line_state.</p><p class="desc"> For all commands after the first command in a line, the first space (if any) is not part of the range. See [line_state:getcommandoffset](#line_state:getcommandoffset) for details.</p><pre class="language-lua"><code>-- Given a line_state for the 2nd command in;  abc & ( @where   >nul  )  & xyz
+line_state:getrangeoffset() == 9           --          ^
+line_state:getcommandoffset() == 10        --           ^
+line_state:getrangelength() == 15          --          <------------->
+
+-- Given a line_state for the 2nd command in;  abc & (   @ where   >nul  )  & xyz
+line_state:getrangeoffset() == 9           --          ^
+line_state:getcommandoffset() == 13        --              ^
+line_state:getrangelength() == 18          --          <----------------></code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="line_state:getrangeoffset" class="name"><a class="wlink" href="#line_state:getrangeoffset"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>line_state:getrangeoffset</span> <span class="uplinks"><a href="#line_state">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.6.1 and newer</div></div></div><div class="body"><p class="desc">Each line_state describes a range of text in a line.  This function returns the offset to the start of the range described by this line_state.</p><p class="desc"> For all commands after the first command in a line, the first space (if any) is not part of the range. See [line_state:getcommandoffset](#line_state:getcommandoffset) for details.</p><pre class="language-lua"><code>-- Given a line_state for the 2nd command in;  abc & ( @where   >nul  )  & xyz
+line_state:getrangeoffset() == 9           --          ^
+line_state:getcommandoffset() == 10        -            ^
+line_state:getrangelength() == 15          --          <------------->
+
+-- Given a line_state for the 2nd command in;  abc & (   @ where   >nul  )  & xyz
+line_state:getrangeoffset() == 9           --          ^
+line_state:getcommandoffset() == 13        --              ^
+line_state:getrangelength() == 18          --          <----------------></code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="line_state:getword" class="name"><a class="wlink" href="#line_state:getword"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>line_state:getword</span> <span class="uplinks"><a href="#line_state">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">index</span>:integer ) : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the word of the line at <span class="arg">index</span>.</p><p class="desc"> <strong>Note:</strong>  The returned word omits any quotes.  This helps generators naturally complete <code>"foo\"ba</code> to <code>"foo\bar"</code>.  The raw word including quotes can be obtained using the <code>offset</code> and <code>length</code> fields from <a href="#line_state:getwordinfo">line_state:getwordinfo()</a> to extract a substring from the line returned by <a href="#line_state:getline">line_state:getline()</a>.</p><p class="desc"> <strong>However:</strong>  During <code><a href="#the-getwordbreakinfo-function">generator:getwordbreakinfo()</a></code> functions the returned word includes quotes, otherwise word break offsets could be garbled.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="line_state:getwordcount" class="name"><a class="wlink" href="#line_state:getwordcount"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>line_state:getwordcount</span> <span class="uplinks"><a href="#line_state">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the number of words in the current line.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="line_state:getwordinfo" class="name"><a class="wlink" href="#line_state:getwordinfo"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>line_state:getwordinfo</span> <span class="uplinks"><a href="#line_state">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">index</span>:integer ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns a table of information about the Nth word in the line.</p><p class="desc"> Note:  The length refers to the substring in the line; it omits leading and trailing quotes, but <em><strong>includes</strong></em> embedded quotes. <a href="#line_state:getword">line_state:getword()</a> conveniently strips embedded quotes to help generators naturally complete <code>"foo\"ba</code> to <code>"foo\bar"</code>.</p><p class="desc"> The table returned has the following scheme:</p><pre class="language-lua"><code>local t = line_state:getwordinfo(word_index)
 -- t.offset     [integer] Offset where the word starts in the line_state:getline() string.
 -- t.length     [integer] Length of the word (includes embedded quotes).
 -- t.quoted     [boolean] Indicates whether the word is quoted.
 -- t.delim      [string] The delimiter character, or an empty string.
 -- t.alias      [boolean | nil] true if the word is a doskey alias, otherwise nil.
 -- t.redir      [boolean | nil] true if the word is a redirection arg, otherwise nil.</code></pre></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#log"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="log">log</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#log.getfile"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="log.getfile">log.getfile</a></div> <div class="signature">() : string | nil<br/><div class="version">v1.4.15 and newer</div></div></div><div class="body"><p class="desc">Returns the file name of the current session's log file.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#log.info"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="log.info">log.info</a></div> <div class="signature">( <span class="arg_name">message</span>:string, [<span class="arg_name">level</span>:integer] ) : nil<br/><div class="version">v1.1.3 and newer</div></div></div><div class="body"><p class="desc">Writes info <span class="arg">message</span> to the Clink log file.  Use this sparingly, or it could cause performance problems or disk space problems.</p><p class="desc"> In v1.4.10 and higher, the optional <span class="arg">level</span> number tells which stack level to log as the source of the log message (default is 1, the function calling <code>log.info</code>).</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#matches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="matches">matches</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#matches:getcount"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="matches:getcount">matches:getcount</a></div> <div class="signature">() : integer<br/><div class="version">v1.2.47 and newer</div></div></div><div class="body"><p class="desc">Returns the number of available matches.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#matches:getmatch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="matches:getmatch">matches:getmatch</a></div> <div class="signature">( <span class="arg_name">index</span>:integer ) : string<br/><div class="version">v1.2.47 and newer</div></div></div><div class="body"><p class="desc">Returns the match text for the <span class="arg">index</span> match.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#matches:getprefix"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="matches:getprefix">matches:getprefix</a></div> <div class="signature">() : string<br/><div class="version">v1.2.47 and newer</div></div></div><div class="body"><p class="desc">Returns the longest common prefix of the available matches.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#matches:gettype"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="matches:gettype">matches:gettype</a></div> <div class="signature">( <span class="arg_name">index</span>:integer ) : string<br/><div class="version">v1.2.47 and newer</div></div></div><div class="body"><p class="desc">Returns the match type for the <span class="arg">index</span> match.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#os"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os">os</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.abbreviatepath"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.abbreviatepath">os.abbreviatepath</a></div> <div class="signature">( <span class="arg_name">path</span>:string, [<span class="arg_name">decide</span>:function], [<span class="arg_name">transform</span>:function] ) : string<br/><div class="version">v1.4.1 and newer</div></div></div><div class="body"><p class="desc">This abbreviates parent directories in <span class="arg">path</span> to the shortest string that uniquely identifies the directory.  The drive, if present, is never abbreviated.  By default, the first and last names in the string are not abbreviated.</p><p class="desc"> For performance reasons, UNC paths and paths on remote or removeable drives are never abbreviated.</p><p class="desc"> The return value is the resulting path after abbreviation.</p><p class="desc"> If an optional <span class="arg">decide</span> function is provided then it is called once for each directory name in <span class="arg">path</span>, and it can control which directories get abbreviated.  The <span class="arg">decide</span> function receives one argument: the path to the directory that may be abbreviated.  The function can return true to try to abbreviate the directory, or false to prevent abbreviating the directory, or nil to allow the default behavior (don't abbreviate the first or last directory names).</p><p class="desc"> If an optional <span class="arg">transform</span> function is provided then it is called once for each directory name in the resulting string.  The <span class="arg">transform</span> function receives two arguments: the string to be appended, and a boolean indicating whether it has been abbreviated.  The function can adjust the string, and should return a string to appended.  If it returns nil, the string is appended as-is.  This is intended to be able to apply ANSI escape color codes, for example to highlight special directories or to show which directory names have been abbreviated.</p><p class="desc"> This function can potentially take some time to complete, but it can be called in a coroutine and yields appropriately.  It is the caller's responsibility to ensure that any <span class="arg">decide</span> or <span class="arg">transform</span> functions are either very fast, yield appropriately, or are not used from a coroutine.</p><pre class="language-lua"><code>-- Suppose only the following directories exist in the D:\xyz directory:
+
+</div><div class="group">
+<h5 id="log" class="group_name"><a class="wlink" href="#log"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>log. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#log.getfile">getfile</a></td></tr><tr><td><a href="#log.info">info</a></td></tr></table>
+<div class="function"><div class="header"> <div id="log.getfile" class="name"><a class="wlink" href="#log.getfile"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>log.getfile</span> <span class="uplinks"><a href="#log">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string | nil<br/><div class="version">v1.4.15 and newer</div></div></div><div class="body"><p class="desc">Returns the file name of the current session's log file.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="log.info" class="name"><a class="wlink" href="#log.info"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>log.info</span> <span class="uplinks"><a href="#log">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">message</span>:string, [<span class="arg_name">level</span>:integer] ) : nil<br/><div class="version">v1.1.3 and newer</div></div></div><div class="body"><p class="desc">Writes info <span class="arg">message</span> to the Clink log file.  Use this sparingly, or it could cause performance problems or disk space problems.</p><p class="desc"> In v1.4.10 and higher, the optional <span class="arg">level</span> number tells which stack level to log as the source of the log message (default is 1, the function calling <code>log.info</code>).</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="matches" class="group_name"><a class="wlink" href="#matches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>matches: <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#matches:getcount">getcount</a></td></tr><tr><td><a href="#matches:getmatch">getmatch</a></td></tr><tr><td><a href="#matches:getprefix">getprefix</a></td></tr><tr><td><a href="#matches:gettype">gettype</a></td></tr></table>
+<div class="function"><div class="header"> <div id="matches:getcount" class="name"><a class="wlink" href="#matches:getcount"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>matches:getcount</span> <span class="uplinks"><a href="#matches">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.2.47 and newer</div></div></div><div class="body"><p class="desc">Returns the number of available matches.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="matches:getmatch" class="name"><a class="wlink" href="#matches:getmatch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>matches:getmatch</span> <span class="uplinks"><a href="#matches">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">index</span>:integer ) : string<br/><div class="version">v1.2.47 and newer</div></div></div><div class="body"><p class="desc">Returns the match text for the <span class="arg">index</span> match.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="matches:getprefix" class="name"><a class="wlink" href="#matches:getprefix"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>matches:getprefix</span> <span class="uplinks"><a href="#matches">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string<br/><div class="version">v1.2.47 and newer</div></div></div><div class="body"><p class="desc">Returns the longest common prefix of the available matches.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="matches:gettype" class="name"><a class="wlink" href="#matches:gettype"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>matches:gettype</span> <span class="uplinks"><a href="#matches">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">index</span>:integer ) : string<br/><div class="version">v1.2.47 and newer</div></div></div><div class="body"><p class="desc">Returns the match type for the <span class="arg">index</span> match.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="os" class="group_name"><a class="wlink" href="#os"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>os. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#os.abbreviatepath">abbreviatepath</a></td><td><a href="#os.getbatterystatus">getbatterystatus</a></td><td><a href="#os.getnetconnectionname">getnetconnectionname</a></td><td><a href="#os.issignaled">issignaled</a></td></tr><tr><td><a href="#os.chdir">chdir</a></td><td><a href="#os.getclipboardtext">getclipboardtext</a></td><td><a href="#os.getpid">getpid</a></td><td><a href="#os.isuseradmin">isuseradmin</a></td></tr><tr><td><a href="#os.clock">clock</a></td><td><a href="#os.getcwd">getcwd</a></td><td><a href="#os.getpushddepth">getpushddepth</a></td><td><a href="#os.mkdir">mkdir</a></td></tr><tr><td><a href="#os.copy">copy</a></td><td><a href="#os.getdrivetype">getdrivetype</a></td><td><a href="#os.getscreeninfo">getscreeninfo</a></td><td><a href="#os.move">move</a></td></tr><tr><td><a href="#os.createtmpfile">createtmpfile</a></td><td><a href="#os.getenv">getenv</a></td><td><a href="#os.getshortpathname">getshortpathname</a></td><td><a href="#os.resolvealias">resolvealias</a></td></tr><tr><td><a href="#os.debugprint">debugprint</a></td><td><a href="#os.getenvnames">getenvnames</a></td><td><a href="#os.gettemppath">gettemppath</a></td><td><a href="#os.rmdir">rmdir</a></td></tr><tr><td><a href="#os.enumshares">enumshares</a></td><td><a href="#os.geterrorlevel">geterrorlevel</a></td><td><a href="#os.globdirs">globdirs</a></td><td><a href="#os.setclipboardtext">setclipboardtext</a></td></tr><tr><td><a href="#os.expandabbreviatedpath">expandabbreviatedpath</a></td><td><a href="#os.getfileversion">getfileversion</a></td><td><a href="#os.globfiles">globfiles</a></td><td><a href="#os.setenv">setenv</a></td></tr><tr><td><a href="#os.expandenv">expandenv</a></td><td><a href="#os.getfullpathname">getfullpathname</a></td><td><a href="#os.globmatch">globmatch</a></td><td><a href="#os.sleep">sleep</a></td></tr><tr><td><a href="#os.getalias">getalias</a></td><td><a href="#os.gethost">gethost</a></td><td><a href="#os.isdir">isdir</a></td><td><a href="#os.touch">touch</a></td></tr><tr><td><a href="#os.getaliases">getaliases</a></td><td><a href="#os.getlongpathname">getlongpathname</a></td><td><a href="#os.isfile">isfile</a></td><td><a href="#os.unlink">unlink</a></td></tr></table>
+<div class="function"><div class="header"> <div id="os.abbreviatepath" class="name"><a class="wlink" href="#os.abbreviatepath"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.abbreviatepath</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string, [<span class="arg_name">decide</span>:function], [<span class="arg_name">transform</span>:function] ) : string<br/><div class="version">v1.4.1 and newer</div></div></div><div class="body"><p class="desc">This abbreviates parent directories in <span class="arg">path</span> to the shortest string that uniquely identifies the directory.  The drive, if present, is never abbreviated.  By default, the first and last names in the string are not abbreviated.</p><p class="desc"> For performance reasons, UNC paths and paths on remote or removeable drives are never abbreviated.</p><p class="desc"> The return value is the resulting path after abbreviation.</p><p class="desc"> If an optional <span class="arg">decide</span> function is provided then it is called once for each directory name in <span class="arg">path</span>, and it can control which directories get abbreviated.  The <span class="arg">decide</span> function receives one argument: the path to the directory that may be abbreviated.  The function can return true to try to abbreviate the directory, or false to prevent abbreviating the directory, or nil to allow the default behavior (don't abbreviate the first or last directory names).</p><p class="desc"> If an optional <span class="arg">transform</span> function is provided then it is called once for each directory name in the resulting string.  The <span class="arg">transform</span> function receives two arguments: the string to be appended, and a boolean indicating whether it has been abbreviated.  The function can adjust the string, and should return a string to appended.  If it returns nil, the string is appended as-is.  This is intended to be able to apply ANSI escape color codes, for example to highlight special directories or to show which directory names have been abbreviated.</p><p class="desc"> This function can potentially take some time to complete, but it can be called in a coroutine and yields appropriately.  It is the caller's responsibility to ensure that any <span class="arg">decide</span> or <span class="arg">transform</span> functions are either very fast, yield appropriately, or are not used from a coroutine.</p><pre class="language-lua"><code>-- Suppose only the following directories exist in the D:\xyz directory:
 --  - D:\xyz\bag
 --  - D:\xyz\bookkeeper
 --  - D:\xyz\bookkeeping
@@ -6831,12 +7199,18 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 
 os.chdir("d:\\xyz")
 os.abbreviatesetcurrentdir("bag\\subdir", true)     -- returns "ba\\s" (if "subdir" is unique)</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.chdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.chdir">os.chdir</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Changes the current directory to <span class="arg">path</span> and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.clock"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.clock">os.clock</a></div> <div class="signature">() : number<br/><div class="version">v1.2.30 and newer</div></div></div><div class="body"><p class="desc">This returns the number of seconds since the program started.</p><p class="desc"> Normally, Lua's os.clock() has millisecond precision until the program has been running for almost 25 days, and then it suddenly breaks and starts always returning -0.001 seconds.</p><p class="desc"> Clink's version of os.clock() has microsecond precision until the program has been running for many weeks.  It maintains at least millisecond precision until the program has been running for many years.</p><p class="desc"> It was necessary to replace os.clock() in order for <a href="#asyncpromptfiltering">asynchronous prompt filtering</a> to continue working when CMD has been running for more than 25 days.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.copy"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.copy">os.copy</a></div> <div class="signature">( <span class="arg_name">src</span>:string, <span class="arg_name">dest</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Copies the <span class="arg">src</span> file to the <span class="arg">dest</span> file. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.createtmpfile"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.createtmpfile">os.createtmpfile</a></div> <div class="signature">( [<span class="arg_name">prefix</span>:string], [<span class="arg_name">ext</span>:string], [<span class="arg_name">path</span>:string], [<span class="arg_name">mode</span>:string] ) : file, string<br/><div class="version">v1.1.42 and newer</div></div></div><div class="body"><p class="desc">Creates a uniquely named file, intended for use as a temporary file.  The name pattern is "<em>location</em> <code>\</code> <em>prefix</em> <code>_</code> <em>processId</em> <code>_</code> <em>uniqueNum</em> <em>extension</em>".</p><p class="desc"> <span class="arg">prefix</span> optionally specifies a prefix for the file name and defaults to "tmp".</p><p class="desc"> <span class="arg">ext</span> optionally specifies a suffix for the file name and defaults to "" (if <span class="arg">ext</span> starts with a period "." then it is a filename extension).</p><p class="desc"> <span class="arg">path</span> optionally specifies a path location in which to create the file.  The default is the system TEMP directory.</p><p class="desc"> <span class="arg">mode</span> optionally specifies "t" for text mode (line endings are translated) or "b" for binary mode (untranslated IO).  The default is "t".</p><p class="desc"> When successful, the function returns a file handle and the file name. If unsuccessful it returns nil, an error message, and the error number.</p><p class="desc"> <strong>Note:</strong> Be sure to delete the file when finished, or it will be leaked.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.debugprint"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.debugprint">os.debugprint</a></div> <div class="signature">( ... ) : nil<br/><div class="version">v1.2.20 and newer</div></div></div><div class="body"><p class="desc">This works like <a href="https://www.lua.org/manual/5.2/manual.html#pdf-print">print()</a> but writes the output via the OS <code>OutputDebugString()</code> API.</p><p class="desc"> This function has no effect if the <code><a href="#lua_debug">lua.debug</a></code> Clink setting is off.</p><pre class="language-lua"><code>clink.debugprint("my variable = "..myvar)</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.enumshares"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.enumshares">os.enumshares</a></div> <div class="signature">( <span class="arg_name">server</span>:string, [<span class="arg_name">hidden</span>:boolean], [<span class="arg_name">timeout</span>:number] ) : iterator<br/><div class="version">v1.6.0 and newer</div></div></div><div class="body"><p class="desc">This returns an iterator function which steps through the share names available on the given <span class="arg">server</span> one name at a time. (This only enumerates SMB UNC share names.)</p><p class="desc"> When <span class="arg">hidden</span> is true, special hidden shares like ADMIN$ or C$ are included.</p><p class="desc"> The optional <span class="arg">timeout</span> is the maximum number of seconds to wait for shares to be retrieved (use a floating point number for fractional seconds).  The default is 0, which means an unlimited wait (negative numbers are treated the same as 0).</p><p class="desc"> Each call to the returned iterator function returns a share name, a boolean indicating whether it's a special share, and either nil or "canceled" (if it takes longer than <span class="arg">timeout</span> to retrieve the share names for the given <span class="arg">server</span>).  When there are no more shares, the iterator function returns nil.</p><p class="desc"> When called from a coroutine, the iterator function automatically yields when appropriate.</p><pre class="language-lua"><code>local server = "localhost"
+
+<div class="function"><div class="header"> <div id="os.chdir" class="name"><a class="wlink" href="#os.chdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.chdir</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Changes the current directory to <span class="arg">path</span> and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.clock" class="name"><a class="wlink" href="#os.clock"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.clock</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : number<br/><div class="version">v1.2.30 and newer</div></div></div><div class="body"><p class="desc">This returns the number of seconds since the program started.</p><p class="desc"> Normally, Lua's os.clock() has millisecond precision until the program has been running for almost 25 days, and then it suddenly breaks and starts always returning -0.001 seconds.</p><p class="desc"> Clink's version of os.clock() has microsecond precision until the program has been running for many weeks.  It maintains at least millisecond precision until the program has been running for many years.</p><p class="desc"> It was necessary to replace os.clock() in order for <a href="#asyncpromptfiltering">asynchronous prompt filtering</a> to continue working when CMD has been running for more than 25 days.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.copy" class="name"><a class="wlink" href="#os.copy"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.copy</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">src</span>:string, <span class="arg_name">dest</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Copies the <span class="arg">src</span> file to the <span class="arg">dest</span> file. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.createtmpfile" class="name"><a class="wlink" href="#os.createtmpfile"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.createtmpfile</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">prefix</span>:string], [<span class="arg_name">ext</span>:string], [<span class="arg_name">path</span>:string], [<span class="arg_name">mode</span>:string] ) : file, string<br/><div class="version">v1.1.42 and newer</div></div></div><div class="body"><p class="desc">Creates a uniquely named file, intended for use as a temporary file.  The name pattern is "<em>location</em> <code>\</code> <em>prefix</em> <code>_</code> <em>processId</em> <code>_</code> <em>uniqueNum</em> <em>extension</em>".</p><p class="desc"> <span class="arg">prefix</span> optionally specifies a prefix for the file name and defaults to "tmp".</p><p class="desc"> <span class="arg">ext</span> optionally specifies a suffix for the file name and defaults to "" (if <span class="arg">ext</span> starts with a period "." then it is a filename extension).</p><p class="desc"> <span class="arg">path</span> optionally specifies a path location in which to create the file.  The default is the system TEMP directory.</p><p class="desc"> <span class="arg">mode</span> optionally specifies "t" for text mode (line endings are translated) or "b" for binary mode (untranslated IO).  The default is "t".</p><p class="desc"> When successful, the function returns a file handle and the file name. If unsuccessful it returns nil, an error message, and the error number.</p><p class="desc"> <strong>Note:</strong> Be sure to delete the file when finished, or it will be leaked.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.debugprint" class="name"><a class="wlink" href="#os.debugprint"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.debugprint</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( ... ) : nil<br/><div class="version">v1.2.20 and newer</div></div></div><div class="body"><p class="desc">This works like <a href="https://www.lua.org/manual/5.2/manual.html#pdf-print">print()</a> but writes the output via the OS <code>OutputDebugString()</code> API.</p><p class="desc"> This function has no effect if the <code><a href="#lua_debug">lua.debug</a></code> Clink setting is off.</p><pre class="language-lua"><code>clink.debugprint("my variable = "..myvar)</code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.enumshares" class="name"><a class="wlink" href="#os.enumshares"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.enumshares</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">server</span>:string, [<span class="arg_name">hidden</span>:boolean], [<span class="arg_name">timeout</span>:number] ) : iterator<br/><div class="version">v1.6.0 and newer</div></div></div><div class="body"><p class="desc">This returns an iterator function which steps through the share names available on the given <span class="arg">server</span> one name at a time. (This only enumerates SMB UNC share names.)</p><p class="desc"> When <span class="arg">hidden</span> is true, special hidden shares like ADMIN$ or C$ are included.</p><p class="desc"> The optional <span class="arg">timeout</span> is the maximum number of seconds to wait for shares to be retrieved (use a floating point number for fractional seconds).  The default is 0, which means an unlimited wait (negative numbers are treated the same as 0).</p><p class="desc"> Each call to the returned iterator function returns a share name, a boolean indicating whether it's a special share, and either nil or "canceled" (if it takes longer than <span class="arg">timeout</span> to retrieve the share names for the given <span class="arg">server</span>).  When there are no more shares, the iterator function returns nil.</p><p class="desc"> When called from a coroutine, the iterator function automatically yields when appropriate.</p><pre class="language-lua"><code>local server = "localhost"
 local hidden = true -- Include special hidden shares.
 local timeout = 2.5 -- Wait up to 2.5 seconds for completion.
 for share, special, canceled in os.enumshares(server, hidden, timeout) do
@@ -6849,7 +7223,8 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 end
 print(s)
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.expandabbreviatedpath"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.expandabbreviatedpath">os.expandabbreviatedpath</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : nil | string, string, boolean<br/><div class="version">v1.4.1 and newer</div></div></div><div class="body"><p class="desc">This expands any abbreviated directory components in <span class="arg">path</span>.</p><p class="desc"> The return value is nil if <span class="arg">path</span> couldn't be expanded.  It can't be expanded if it is a UNC path or a remote drive, or if it is already expanded, or if there are no matches for one of the directory components.</p><p class="desc"> Otherwise three values are returned.  First, a string containing the expanded part of <span class="arg">path</span>.  Second, a string containing the rest of <span class="arg">path</span> that wasn't expanded.  Third, a boolean indicating whether <span class="arg">path</span> was able to expand uniquely.</p><pre class="language-lua"><code>-- Suppose only the following directories exist in the D: drive:
+
+<div class="function"><div class="header"> <div id="os.expandabbreviatedpath" class="name"><a class="wlink" href="#os.expandabbreviatedpath"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.expandabbreviatedpath</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : nil | string, string, boolean<br/><div class="version">v1.4.1 and newer</div></div></div><div class="body"><p class="desc">This expands any abbreviated directory components in <span class="arg">path</span>.</p><p class="desc"> The return value is nil if <span class="arg">path</span> couldn't be expanded.  It can't be expanded if it is a UNC path or a remote drive, or if it is already expanded, or if there are no matches for one of the directory components.</p><p class="desc"> Otherwise three values are returned.  First, a string containing the expanded part of <span class="arg">path</span>.  Second, a string containing the rest of <span class="arg">path</span> that wasn't expanded.  Third, a boolean indicating whether <span class="arg">path</span> was able to expand uniquely.</p><pre class="language-lua"><code>-- Suppose only the following directories exist in the D: drive:
 --  - D:\bag
 --  - D:\bookkeeper
 --  - D:\bookkeeping
@@ -6876,26 +7251,37 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 
 expanded, remaining, unique = os.expandabbreviatedpath("d:\\boxes\\file")
 -- returns nil                              -- Is already expanded.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.expandenv"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.expandenv">os.expandenv</a></div> <div class="signature">( <span class="arg_name">value</span>:string ) : string<br/><div class="version">v1.2.5 and newer</div></div></div><div class="body"><p class="desc">Returns <span class="arg">value</span> with any <code>%name%</code> environment variables expanded.  Names are case insensitive.  Special CMD syntax is not supported (e.g. <code>%name:str1=str2%</code> or <code>%name:~offset,length%</code>).</p><p class="desc"> Note: See <a href="#os.getenv">os.getenv()</a> for a list of special variable names.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getalias"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getalias">os.getalias</a></div> <div class="signature">( <span class="arg_name">name</span>:string ) : string | nil<br/><div class="version">v1.1.4 and newer</div></div></div><div class="body"><p class="desc">Returns command string for doskey alias <span class="arg">name</span>, or nil if the named alias does not exist.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getaliases"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getaliases">os.getaliases</a></div> <div class="signature">() : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns doskey alias names in a table of strings.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getbatterystatus"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getbatterystatus">os.getbatterystatus</a></div> <div class="signature">() : table<br/><div class="version">v1.1.17 and newer</div></div></div><div class="body"><p class="desc">Returns a table containing the battery status for the device, or nil if an error occurs.  The returned table has the following scheme:</p><pre class="language-lua"><code>local t = os.getbatterystatus()
+
+<div class="function"><div class="header"> <div id="os.expandenv" class="name"><a class="wlink" href="#os.expandenv"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.expandenv</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">value</span>:string ) : string<br/><div class="version">v1.2.5 and newer</div></div></div><div class="body"><p class="desc">Returns <span class="arg">value</span> with any <code>%name%</code> environment variables expanded.  Names are case insensitive.  Special CMD syntax is not supported (e.g. <code>%name:str1=str2%</code> or <code>%name:~offset,length%</code>).</p><p class="desc"> Note: See <a href="#os.getenv">os.getenv()</a> for a list of special variable names.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getalias" class="name"><a class="wlink" href="#os.getalias"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getalias</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">name</span>:string ) : string | nil<br/><div class="version">v1.1.4 and newer</div></div></div><div class="body"><p class="desc">Returns command string for doskey alias <span class="arg">name</span>, or nil if the named alias does not exist.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getaliases" class="name"><a class="wlink" href="#os.getaliases"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getaliases</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns doskey alias names in a table of strings.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getbatterystatus" class="name"><a class="wlink" href="#os.getbatterystatus"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getbatterystatus</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : table<br/><div class="version">v1.1.17 and newer</div></div></div><div class="body"><p class="desc">Returns a table containing the battery status for the device, or nil if an error occurs.  The returned table has the following scheme:</p><pre class="language-lua"><code>local t = os.getbatterystatus()
 -- t.level              [integer] The battery life from 0 to 100, or -1 if error or no battery.
 -- t.acpower            [boolean] Whether the device is connected to AC power.
 -- t.charging           [boolean] Whether the battery is charging.
 -- t.batterysaver       [boolean] Whether Battery Saver mode is active.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getclipboardtext"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getclipboardtext">os.getclipboardtext</a></div> <div class="signature">() : string | nil<br/><div class="version">v1.2.32 and newer</div></div></div><div class="body"><p class="desc">This returns the text from the system clipboard, or nil if there is no text on the system clipboard.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getcwd"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getcwd">os.getcwd</a></div> <div class="signature">() : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the current directory.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getdrivetype"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getdrivetype">os.getdrivetype</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.3.37 and newer</div></div></div><div class="body"><p class="desc">Returns the drive type for the drive associated with the specified <span class="arg">path</span>.</p><p class="desc"> Relative paths automatically use the current drive.  Absolute paths use the specified drive.  UNC paths are always reported as remote drives.</p><p class="desc"> The possible drive types are: <p><table> <tr><th>Type</th><th>Description</th></tr> <tr><td>"unknown"</td><td>The drive type could not be determined.</td></tr> <tr><td>"invalid"</td><td>The drive type is invalid; for example, there is no volume mounted at the specified path.</td></tr> <tr><td>"removable"</td><td>Floppy disk drive, thumb drive, flash card reader, CD-ROM, etc.</td></tr> <tr><td>"fixed"</td><td>Hard drive, solid state drive, etc.</td></tr> <tr><td>"ramdisk"</td><td>RAM disk.</td></tr> <tr><td>"remote"</td><td>Remote (network) drive.</td></tr> </table></p></p><pre class="language-lua"><code>local t = os.getdrivetype("c:")
+
+<div class="function"><div class="header"> <div id="os.getclipboardtext" class="name"><a class="wlink" href="#os.getclipboardtext"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getclipboardtext</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string | nil<br/><div class="version">v1.2.32 and newer</div></div></div><div class="body"><p class="desc">This returns the text from the system clipboard, or nil if there is no text on the system clipboard.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getcwd" class="name"><a class="wlink" href="#os.getcwd"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getcwd</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the current directory.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getdrivetype" class="name"><a class="wlink" href="#os.getdrivetype"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getdrivetype</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.3.37 and newer</div></div></div><div class="body"><p class="desc">Returns the drive type for the drive associated with the specified <span class="arg">path</span>.</p><p class="desc"> Relative paths automatically use the current drive.  Absolute paths use the specified drive.  UNC paths are always reported as remote drives.</p><p class="desc"> The possible drive types are: <p><table> <tr><th>Type</th><th>Description</th></tr> <tr><td>"unknown"</td><td>The drive type could not be determined.</td></tr> <tr><td>"invalid"</td><td>The drive type is invalid; for example, there is no volume mounted at the specified path.</td></tr> <tr><td>"removable"</td><td>Floppy disk drive, thumb drive, flash card reader, CD-ROM, etc.</td></tr> <tr><td>"fixed"</td><td>Hard drive, solid state drive, etc.</td></tr> <tr><td>"ramdisk"</td><td>RAM disk.</td></tr> <tr><td>"remote"</td><td>Remote (network) drive.</td></tr> </table></p></p><pre class="language-lua"><code>local t = os.getdrivetype("c:")
 if t == "remote" then
 &nbsp;   -- Network paths are often slow, and code may want to detect and skip them.
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getenv"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getenv">os.getenv</a></div> <div class="signature">( <span class="arg_name">name</span>:string ) : string | nil<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the value of the named environment variable, or nil if it doesn't exist.</p><p class="desc"> Note: Certain environment variable names receive special treatment:</p><p class="desc"> <table> <tr><th>Name</th><th>Special Behavior</th></tr> <tr><td><code>"CD"</code></td><td>If %CD% is not set then a return value is synthesized from the current working directory path name.</td></tr> <tr><td><code>"CMDCMDLINE"</code></td><td>If %CMDCMDLINE% is not set then this returns the command line that started the CMD process.</td></tr> <tr><td><code>"ERRORLEVEL"</code></td><td>If %ERRORLEVEL% is not set and the <code><a href="#cmd_get_errorlevel">cmd.get_errorlevel</a></code> setting is enabled this returns the most recent exit code, just like the <code>echo %ERRORLEVEL%</code> command displays.  Otherwise this returns 0.</td></tr> <tr><td><code>"HOME"</code></td><td>If %HOME% is not set then a return value is synthesized from %HOMEDRIVE% and %HOMEPATH%, or from %USERPROFILE%.</td></tr> <tr><td><code>"RANDOM"</code></td><td>If %RANDOM% is not set then this returns a random integer.</td></tr> </table></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getenvnames"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getenvnames">os.getenvnames</a></div> <div class="signature">() : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns all environment variables in a table with the following scheme:</p><pre class="language-lua"><code>local t = os.getenvnames()
+
+<div class="function"><div class="header"> <div id="os.getenv" class="name"><a class="wlink" href="#os.getenv"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getenv</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">name</span>:string ) : string | nil<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the value of the named environment variable, or nil if it doesn't exist.</p><p class="desc"> Note: Certain environment variable names receive special treatment:</p><p class="desc"> <table> <tr><th>Name</th><th>Special Behavior</th></tr> <tr><td><code>"CD"</code></td><td>If %CD% is not set then a return value is synthesized from the current working directory path name.</td></tr> <tr><td><code>"CMDCMDLINE"</code></td><td>If %CMDCMDLINE% is not set then this returns the command line that started the CMD process.</td></tr> <tr><td><code>"ERRORLEVEL"</code></td><td>If %ERRORLEVEL% is not set and the <code><a href="#cmd_get_errorlevel">cmd.get_errorlevel</a></code> setting is enabled this returns the most recent exit code, just like the <code>echo %ERRORLEVEL%</code> command displays.  Otherwise this returns 0.</td></tr> <tr><td><code>"HOME"</code></td><td>If %HOME% is not set then a return value is synthesized from %HOMEDRIVE% and %HOMEPATH%, or from %USERPROFILE%.</td></tr> <tr><td><code>"RANDOM"</code></td><td>If %RANDOM% is not set then this returns a random integer.</td></tr> </table></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getenvnames" class="name"><a class="wlink" href="#os.getenvnames"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getenvnames</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns all environment variables in a table with the following scheme:</p><pre class="language-lua"><code>local t = os.getenvnames()
 -- t[index].name        [string] The environment variable's name.
 -- t[index].value       [string] The environment variable's value.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.geterrorlevel"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.geterrorlevel">os.geterrorlevel</a></div> <div class="signature">() : integer<br/><div class="version">v1.2.14 and newer</div></div></div><div class="body"><p class="desc">Returns the last command's exit code, if the <code><a href="#cmd_get_errorlevel">cmd.get_errorlevel</a></code> setting is enabled.  Otherwise it returns 0.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getfileversion"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getfileversion">os.getfileversion</a></div> <div class="signature">( <span class="arg_name">file</span>:string ) : table | nil<br/><div class="version">v1.4.17 and newer</div></div></div><div class="body"><p class="desc">This tries to get a Windows file version info resource from the specified file.  It tries to get translated strings in the closest available language to the current user language configured in the OS.</p><p class="desc"> If successful, the returned table contains as many of the following fields as were available in the file's version info resource.</p><pre class="language-lua"><code>local info = os.getfileversion("c:/windows/notepad.exe")
+
+<div class="function"><div class="header"> <div id="os.geterrorlevel" class="name"><a class="wlink" href="#os.geterrorlevel"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.geterrorlevel</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.2.14 and newer</div></div></div><div class="body"><p class="desc">Returns the last command's exit code, if the <code><a href="#cmd_get_errorlevel">cmd.get_errorlevel</a></code> setting is enabled.  Otherwise it returns 0.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getfileversion" class="name"><a class="wlink" href="#os.getfileversion"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getfileversion</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">file</span>:string ) : table | nil<br/><div class="version">v1.4.17 and newer</div></div></div><div class="body"><p class="desc">This tries to get a Windows file version info resource from the specified file.  It tries to get translated strings in the closest available language to the current user language configured in the OS.</p><p class="desc"> If successful, the returned table contains as many of the following fields as were available in the file's version info resource.</p><pre class="language-lua"><code>local info = os.getfileversion("c:/windows/notepad.exe")
 -- info.filename            c:\windows\notepad.exe
 -- info.filevernum          10.0.19041.1865
 -- info.productvernum       10.0.19041.1865
@@ -6920,13 +7306,20 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 -- info.fileflags.privatebuild
 -- info.fileflags.specialbuild
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getfullpathname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getfullpathname">os.getfullpathname</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.42 and newer</div></div></div><div class="body"><p class="desc">Returns the full path name for <span class="arg">path</span>. If unsuccessful it returns nil, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.gethost"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.gethost">os.gethost</a></div> <div class="signature">() : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the fully qualified file name of the host process.  Currently only CMD.EXE can host Clink.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getlongpathname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getlongpathname">os.getlongpathname</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.42 and newer</div></div></div><div class="body"><p class="desc">Returns the long path name for <span class="arg">path</span>. If unsuccessful it returns nil, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getnetconnectionname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getnetconnectionname">os.getnetconnectionname</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.2.27 and newer</div></div></div><div class="body"><p class="desc">Returns the remote name associated with <span class="arg">path</span>, or an empty string if it's not a network drive. If unsuccessful it returns nil, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getpid"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getpid">os.getpid</a></div> <div class="signature">() : integer<br/><div class="version">v1.1.41 and newer</div></div></div><div class="body"><p class="desc">Returns the CMD.EXE process ID. This is mainly intended to help with salting unique resource names (for example named pipes).</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getpushddepth"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getpushddepth">os.getpushddepth</a></div> <div class="signature">() : integer, boolean<br/><div class="version">v1.5.6 and newer</div></div></div><div class="body"><p class="desc">Returns the depth of the <code>pushd</code> directory stack, and a boolean indicating whether the depth is known.</p><p class="desc"> <strong>Note:</strong> The depth is only known if the <code>%PROMPT%</code> environment variable includes the <code>$+</code> code exactly once.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getscreeninfo"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getscreeninfo">os.getscreeninfo</a></div> <div class="signature">() : table<br/><div class="version">v1.1.2 and newer</div></div></div><div class="body"><p class="desc">Returns dimensions of the terminal's buffer and visible window. The returned table has the following scheme:</p><pre class="language-lua"><code>local info = os.getscreeninfo()
+
+<div class="function"><div class="header"> <div id="os.getfullpathname" class="name"><a class="wlink" href="#os.getfullpathname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getfullpathname</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.42 and newer</div></div></div><div class="body"><p class="desc">Returns the full path name for <span class="arg">path</span>. If unsuccessful it returns nil, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.gethost" class="name"><a class="wlink" href="#os.gethost"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.gethost</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the fully qualified file name of the host process.  Currently only CMD.EXE can host Clink.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getlongpathname" class="name"><a class="wlink" href="#os.getlongpathname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getlongpathname</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.42 and newer</div></div></div><div class="body"><p class="desc">Returns the long path name for <span class="arg">path</span>. If unsuccessful it returns nil, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getnetconnectionname" class="name"><a class="wlink" href="#os.getnetconnectionname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getnetconnectionname</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.2.27 and newer</div></div></div><div class="body"><p class="desc">Returns the remote name associated with <span class="arg">path</span>, or an empty string if it's not a network drive. If unsuccessful it returns nil, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getpid" class="name"><a class="wlink" href="#os.getpid"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getpid</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.1.41 and newer</div></div></div><div class="body"><p class="desc">Returns the CMD.EXE process ID. This is mainly intended to help with salting unique resource names (for example named pipes).</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getpushddepth" class="name"><a class="wlink" href="#os.getpushddepth"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getpushddepth</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer, boolean<br/><div class="version">v1.5.6 and newer</div></div></div><div class="body"><p class="desc">Returns the depth of the <code>pushd</code> directory stack, and a boolean indicating whether the depth is known.</p><p class="desc"> <strong>Note:</strong> The depth is only known if the <code>%PROMPT%</code> environment variable includes the <code>$+</code> code exactly once.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.getscreeninfo" class="name"><a class="wlink" href="#os.getscreeninfo"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getscreeninfo</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : table<br/><div class="version">v1.1.2 and newer</div></div></div><div class="body"><p class="desc">Returns dimensions of the terminal's buffer and visible window. The returned table has the following scheme:</p><pre class="language-lua"><code>local info = os.getscreeninfo()
 -- info.bufwidth        [integer] Width of the screen buffer.
 -- info.bufheight       [integer] Height of the screen buffer.
 -- info.winwidth        [integer] Width of the visible window.
@@ -6935,9 +7328,12 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 -- v1.4.28 and higher include the cursor position:
 -- info.x               [integer] Current cursor column (from 1 to bufwidth).
 -- info.y               [integer] Current cursor row (from 1 to bufheight).</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.getshortpathname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.getshortpathname">os.getshortpathname</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.42 and newer</div></div></div><div class="body"><p class="desc">Returns the 8.3 short path name for <span class="arg">path</span>.  This may return the input path if an 8.3 short path name is not available. If unsuccessful it returns nil, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.gettemppath"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.gettemppath">os.gettemppath</a></div> <div class="signature">() : string<br/><div class="version">v1.3.18 and newer</div></div></div><div class="body"><p class="desc">Returns the path of the system temporary directory. If unsuccessful it returns nil, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.globdirs"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.globdirs">os.globdirs</a></div> <div class="signature">( <span class="arg_name">globpattern</span>:string, [<span class="arg_name">extrainfo</span>:integer|boolean], [<span class="arg_name">flags</span>:table] ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Collects directories matching <span class="arg">globpattern</span> and returns them in a table of strings.</p><p class="desc"> <strong>Note:</strong> any quotation marks (<code>"</code>) in <span class="arg">globpattern</span> are stripped.</p><p class="desc"> Starting in v1.3.1, when this is used in a coroutine it automatically yields periodically.</p><p class="desc"> The optional <span class="arg">extrainfo</span> argument can return a table of tables instead, where each sub-table corresponds to one directory and has the following scheme:</p><pre class="language-lua"><code>local t = os.globdirs(pattern, extrainfo)
+
+<div class="function"><div class="header"> <div id="os.getshortpathname" class="name"><a class="wlink" href="#os.getshortpathname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.getshortpathname</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.42 and newer</div></div></div><div class="body"><p class="desc">Returns the 8.3 short path name for <span class="arg">path</span>.  This may return the input path if an 8.3 short path name is not available. If unsuccessful it returns nil, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.gettemppath" class="name"><a class="wlink" href="#os.gettemppath"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.gettemppath</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string<br/><div class="version">v1.3.18 and newer</div></div></div><div class="body"><p class="desc">Returns the path of the system temporary directory. If unsuccessful it returns nil, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.globdirs" class="name"><a class="wlink" href="#os.globdirs"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.globdirs</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">globpattern</span>:string, [<span class="arg_name">extrainfo</span>:integer|boolean], [<span class="arg_name">flags</span>:table] ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Collects directories matching <span class="arg">globpattern</span> and returns them in a table of strings.</p><p class="desc"> <strong>Note:</strong> any quotation marks (<code>"</code>) in <span class="arg">globpattern</span> are stripped.</p><p class="desc"> Starting in v1.3.1, when this is used in a coroutine it automatically yields periodically.</p><p class="desc"> The optional <span class="arg">extrainfo</span> argument can return a table of tables instead, where each sub-table corresponds to one directory and has the following scheme:</p><pre class="language-lua"><code>local t = os.globdirs(pattern, extrainfo)
 -- Included when extrainfo is true or >= 1 (requires v1.1.7 or higher):
 --   t[index].name      -- [string] The directory name.
 --   t[index].type      -- [string] The match type (see below).
@@ -6950,7 +7346,8 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;   system = false,     -- True includes system directories, or false omits them (default).
 }
 local t = os.globdirs("*", true, flags)</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.globfiles"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.globfiles">os.globfiles</a></div> <div class="signature">( <span class="arg_name">globpattern</span>:string, [<span class="arg_name">extrainfo</span>:integer|boolean], [<span class="arg_name">flags</span>:table] ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Collects files and/or directories matching <span class="arg">globpattern</span> and returns them in a table of strings.</p><p class="desc"> <strong>Note:</strong> any quotation marks (<code>"</code>) in <span class="arg">globpattern</span> are stripped.</p><p class="desc"> Starting in v1.3.1, when this is used in a coroutine it automatically yields periodically.</p><p class="desc"> The optional <span class="arg">extrainfo</span> argument can return a table of tables instead, where each sub-table corresponds to one file or directory and has the following scheme:</p><pre class="language-lua"><code>local t = os.globfiles(pattern, extrainfo)
+
+<div class="function"><div class="header"> <div id="os.globfiles" class="name"><a class="wlink" href="#os.globfiles"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.globfiles</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">globpattern</span>:string, [<span class="arg_name">extrainfo</span>:integer|boolean], [<span class="arg_name">flags</span>:table] ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Collects files and/or directories matching <span class="arg">globpattern</span> and returns them in a table of strings.</p><p class="desc"> <strong>Note:</strong> any quotation marks (<code>"</code>) in <span class="arg">globpattern</span> are stripped.</p><p class="desc"> Starting in v1.3.1, when this is used in a coroutine it automatically yields periodically.</p><p class="desc"> The optional <span class="arg">extrainfo</span> argument can return a table of tables instead, where each sub-table corresponds to one file or directory and has the following scheme:</p><pre class="language-lua"><code>local t = os.globfiles(pattern, extrainfo)
 -- Included when extrainfo is true or >= 1 (requires v1.1.7 or higher):
 --   t[index].name      -- [string] The file or directory name.
 --   t[index].type      -- [string] The match type (see below).
@@ -6963,7 +7360,8 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;   system = false,     -- True includes system files, or false omits them (default).
 }
 local t = os.globfiles("*", true, flags)</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.globmatch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.globmatch">os.globmatch</a></div> <div class="signature">( <span class="arg_name">pattern</span>:string, [<span class="arg_name">extrainfo</span>:integer|boolean], [<span class="arg_name">flags</span>:table] ) : table<br/><div class="version">v1.4.24 and newer</div></div></div><div class="body"><p class="desc">Collects files or directories matching <span class="arg">pattern</span> and returns them in a table of strings.  This matches <code>**</code> patterns <a href="https://git-scm.com/docs/gitignore#_pattern_format">the same as git does</a>.  When <span class="arg">pattern</span> ends with <code>/</code> this collects directories, otherwise it collects files.</p><p class="desc"> <strong>Note:</strong> any quotation marks (<code>"</code>) in <span class="arg">pattern</span> are stripped.</p><p class="desc"> When this is used in a coroutine it automatically yields periodically.</p><p class="desc"> The optional <span class="arg">extrainfo</span> argument can return a table of tables instead, where each sub-table corresponds to one file or directory and has the following scheme:</p><pre class="language-lua"><code>local t = os.globmatch(pattern, extrainfo)
+
+<div class="function"><div class="header"> <div id="os.globmatch" class="name"><a class="wlink" href="#os.globmatch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.globmatch</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">pattern</span>:string, [<span class="arg_name">extrainfo</span>:integer|boolean], [<span class="arg_name">flags</span>:table] ) : table<br/><div class="version">v1.4.24 and newer</div></div></div><div class="body"><p class="desc">Collects files or directories matching <span class="arg">pattern</span> and returns them in a table of strings.  This matches <code>**</code> patterns <a href="https://git-scm.com/docs/gitignore#_pattern_format">the same as git does</a>.  When <span class="arg">pattern</span> ends with <code>/</code> this collects directories, otherwise it collects files.</p><p class="desc"> <strong>Note:</strong> any quotation marks (<code>"</code>) in <span class="arg">pattern</span> are stripped.</p><p class="desc"> When this is used in a coroutine it automatically yields periodically.</p><p class="desc"> The optional <span class="arg">extrainfo</span> argument can return a table of tables instead, where each sub-table corresponds to one file or directory and has the following scheme:</p><pre class="language-lua"><code>local t = os.globmatch(pattern, extrainfo)
 -- Included when extrainfo is true or >= 1:
 --   t[index].name      -- [string] The file or directory name.
 --   t[index].type      -- [string] The match type (see below).
@@ -6979,23 +7377,42 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;   nocasefold = false, -- True is case-sensitive, or false is case-insensitive (default).
 }
 local t = os.globmatch("docs/**/*.md", true, flags)</code></pre><p class="desc"><strong>Note:</strong> The returned table is built using a pre-order traversal, so files in a directory are listed before recursing into its subdirectories ("dir\xyzfile" precedes "dir\abcdir\abcfile").</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.isdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.isdir">os.isdir</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns whether <span class="arg">path</span> is a directory.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.isfile"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.isfile">os.isfile</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns whether <span class="arg">path</span> is a file.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.issignaled"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.issignaled">os.issignaled</a></div> <div class="signature">() : boolean<br/><div class="version">v1.3.14 and newer</div></div></div><div class="body"><p class="desc">Returns whether a <kbb>Ctrl</kbd>+<kbd>Break</kbd> has been received. Scripts may use this to decide when to end work early.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.isuseradmin"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.isuseradmin">os.isuseradmin</a></div> <div class="signature">() : boolean<br/><div class="version">v1.4.17 and newer</div></div></div><div class="body"><p class="desc">Returns true if running as an administrator account.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.mkdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.mkdir">os.mkdir</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Creates the directory <span class="arg">path</span> and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.move"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.move">os.move</a></div> <div class="signature">( <span class="arg_name">src</span>:string, <span class="arg_name">dest</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Moves the <span class="arg">src</span> file to the <span class="arg">dest</span> file. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.resolvealias"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.resolvealias">os.resolvealias</a></div> <div class="signature">( <span class="arg_name">text</span>:string ) : table|nil<br/><div class="version">v1.3.12 and newer</div></div></div><div class="body"><p class="desc">Identifies whether <span class="arg">text</span> begins with a doskey alias, and expands the doskey alias.</p><p class="desc"> Returns a table of strings, or nil if there is no associated doskey alias. The return type is a table of strings because doskey aliases can be defined to expand into multiple command lines:  one entry in the table per resolved command line.  Most commonly, the table will contain one string.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.rmdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.rmdir">os.rmdir</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Removes the directory <span class="arg">path</span> and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.setclipboardtext"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.setclipboardtext">os.setclipboardtext</a></div> <div class="signature">( string ) : boolean<br/><div class="version">v1.2.32 and newer</div></div></div><div class="body"><p class="desc">This sets the text onto the system clipboard, and returns whether it was successful.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.setenv"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.setenv">os.setenv</a></div> <div class="signature">( <span class="arg_name">name</span>:string, <span class="arg_name">value</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Sets the <span class="arg">name</span> environment variable to <span class="arg">value</span> and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.sleep"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.sleep">os.sleep</a></div> <div class="signature">( <span class="arg_name">seconds</span>:number ) : nil<br/><div class="version">v1.3.16 and newer</div></div></div><div class="body"><p class="desc">Sleeps for the indicated duration, in seconds, with millisecond granularity.</p><pre class="language-lua"><code>os.sleep(0.01)  -- Sleep for 10 milliseconds.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.touch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.touch">os.touch</a></div> <div class="signature">( <span class="arg_name">path</span>:string, [<span class="arg_name">atime</span>:number], [<span class="arg_name">mtime</span>:number] ) : boolean<br/><div class="version">v1.2.31 and newer</div></div></div><div class="body"><p class="desc">Sets the access and modified times for <span class="arg">path</span>, and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p><p class="desc"> The second argument is <span class="arg">atime</span> and is a time to set as the file's access time.  If omitted, the current time is used.  If present, the value must use the same format as <code><a href="https://www.lua.org/manual/5.2/manual.html#pdf-os.time">os.time()</a></code>.</p><p class="desc"> The third argument is <span class="arg">mtime</span> and is a time to set as the file's modified time.  If omitted, the <span class="arg">atime</span> value is used (or the current time).  If present, the value must use the same format as <code>os.time()</code>.  In order to pass <span class="arg">mtime</span> it is necessary to also pass <span class="arg">atime</span>.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.unlink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.unlink">os.unlink</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Deletes the file <span class="arg">path</span> and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#path"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path">path</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#path.fnmatch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path.fnmatch">path.fnmatch</a></div> <div class="signature">( <span class="arg_name">pattern</span>:string, <span class="arg_name">string</span>:string, [<span class="arg_name">flags</span>:string] ) : boolean<br/><div class="version">v1.4.24 and newer</div></div></div><div class="body"><p class="desc">This compares the two strings <span class="arg">pattern</span> and <span class="arg">string</span> and returns whether they are considered to match.  This is like the Linux <code>fnmatch</code> function, with an additional optional mode that can allow matching <code>**</code> patterns <a href="https://git-scm.com/docs/gitignore#_pattern_format">the same as git does</a>.</p><p class="desc"> The optional <span class="arg">flags</span> string may contain any of the following characters to modify the behavior accordingly: <table> <tr><th>Flag</th><th>Mnemonic</th><th>Description</th></tr> <tr><td>"<code>e</code>"</td><td>NoEscape</td><td>Treat backslash in <span class="arg">pattern</span> as a normal character, rather than as an escape character.</td></tr> <tr><td>"<code>p</code>"</td><td>PathName</td><td>Path separators in <span class="arg">string</span> are matched only by a slash <code>/</code> in <span class="arg">pattern</span> (unless the <code>*</code> flag is used; see below).</td></tr> <tr><td>"<code>.</code>"</td><td>Period</td><td>A leading period <code>.</code> in <span class="arg">string</span> is matched only by a period <code>.</code> in <span class="arg">pattern</span>.  A leading period is one at the beginning of <span class="arg">string</span>, or immediately following a path separator when the <code>p</code> flag is used.</td></tr> <tr><td>"<code>l</code>"</td><td>LeadingDir</td><td>Consider <span class="arg">pattern</span> to be matched if it completely matches <span class="arg">string</span>, or if it matches <span class="arg">string</span> up to a path separator.</td></tr> <tr><td>"<code>c</code>"</td><td>NoCaseFold</td><td>Match with case sensitivity. By default it matches case-insensitively, because Windows is case-insensitive.</td></tr> <tr><td>"<code>*</code>"</td><td>WildStar</td><td>Treat double-asterisks in <span class="arg">pattern</span> as matching path separators as well, the same as how git does (implies the <code>p</code> flag).</td></tr> <tr><td>"<code>s</code>"</td><td>NoSlashFold</td><td>Treat slashes <code>/</code> in <span class="arg">pattern</span> as only matching slashes in <span class="arg">string</span>. By default slashes in <span class="arg">pattern</span> match both slash <code>/</code> and backslash <code>\</code> because Windows recognizes both as path separators.</td></tr> </table></p><p class="desc"> The <span class="arg">pattern</span> supports wildcards (<code>?</code> and <code>*</code>), character classes (<code>[</code>...<code>]</code>), ranges (<code>[</code>.<code>-</code>.<code>]</code>), and complementation (<code>[!</code>...<code>]</code> and <code>[!</code>.<code>-</code>.<code>]</code>).</p><p class="desc"> The <span class="arg">pattern</span> also supports the following character classes: <ul> <li>"<code>[[:alnum:]]</code>": Matches any alphabetic character or digit a - z, or A - Z, or 0 - 9. <li>"<code>[[:alpha:]]</code>": Matches any alphabetic character a - z or A - Z. <li>"<code>[[:blank:]]</code>": Matches 0x20 (space) or 0x09 (tab). <li>"<code>[[:cntrl:]]</code>": Matches 0x00 - 0x1F or 0x7F. <li>"<code>[[:digit:]]</code>": Matches any of the digits 0 - 9. <li>"<code>[[:graph:]]</code>": Matches any character that matches <code>[[:print:]]</code> but does not match <code>[[:space:]]</code>. <li>"<code>[[:lower:]]</code>": Matches any lower case ASCII letter a - z. <li>"<code>[[:print:]]</code>": Matches any printable character (e.g. 0x20 - 0x7E). <li>"<code>[[:punct:]]</code>": Matches any character that matches <code>[[:print:]]</code> but does not match <code>[[:alnum:]]</code>, <code>[[:space:]]</code>, or <code>[[:alnum:]]</code>. <li>"<code>[[:space:]]</code>": Matches 0x20 (space) or 0x09 - 0x0D (tab, linefeed, carriage return, etc). <li>"<code>[[:xdigit:]]</code>": Matches any of the hexadecimal digits 0 - 9, A - F, or a - f. <li>"<code>[[:upper:]]</code>": Matches any upper case ASCII letter A - Z. </ul></p><p class="desc"> <strong>Note:</strong> At this time the character classes and case-insensitivity operate on one byte at a time, so they do not fully work as expected with non-ASCII characters.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#path.getbasename"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path.getbasename">path.getbasename</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc"></p><pre class="language-lua"><code>path.getbasename("/foo/bar.ext")    -- returns "bar"
+
+<div class="function"><div class="header"> <div id="os.isdir" class="name"><a class="wlink" href="#os.isdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.isdir</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns whether <span class="arg">path</span> is a directory.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.isfile" class="name"><a class="wlink" href="#os.isfile"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.isfile</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns whether <span class="arg">path</span> is a file.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.issignaled" class="name"><a class="wlink" href="#os.issignaled"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.issignaled</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : boolean<br/><div class="version">v1.3.14 and newer</div></div></div><div class="body"><p class="desc">Returns whether a <kbb>Ctrl</kbd>+<kbd>Break</kbd> has been received. Scripts may use this to decide when to end work early.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.isuseradmin" class="name"><a class="wlink" href="#os.isuseradmin"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.isuseradmin</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : boolean<br/><div class="version">v1.4.17 and newer</div></div></div><div class="body"><p class="desc">Returns true if running as an administrator account.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.mkdir" class="name"><a class="wlink" href="#os.mkdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.mkdir</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Creates the directory <span class="arg">path</span> and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.move" class="name"><a class="wlink" href="#os.move"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.move</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">src</span>:string, <span class="arg_name">dest</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Moves the <span class="arg">src</span> file to the <span class="arg">dest</span> file. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.resolvealias" class="name"><a class="wlink" href="#os.resolvealias"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.resolvealias</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string ) : table|nil<br/><div class="version">v1.3.12 and newer</div></div></div><div class="body"><p class="desc">Identifies whether <span class="arg">text</span> begins with a doskey alias, and expands the doskey alias.</p><p class="desc"> Returns a table of strings, or nil if there is no associated doskey alias. The return type is a table of strings because doskey aliases can be defined to expand into multiple command lines:  one entry in the table per resolved command line.  Most commonly, the table will contain one string.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.rmdir" class="name"><a class="wlink" href="#os.rmdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.rmdir</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Removes the directory <span class="arg">path</span> and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.setclipboardtext" class="name"><a class="wlink" href="#os.setclipboardtext"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.setclipboardtext</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( string ) : boolean<br/><div class="version">v1.2.32 and newer</div></div></div><div class="body"><p class="desc">This sets the text onto the system clipboard, and returns whether it was successful.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.setenv" class="name"><a class="wlink" href="#os.setenv"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.setenv</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">name</span>:string, <span class="arg_name">value</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Sets the <span class="arg">name</span> environment variable to <span class="arg">value</span> and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.sleep" class="name"><a class="wlink" href="#os.sleep"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.sleep</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">seconds</span>:number ) : nil<br/><div class="version">v1.3.16 and newer</div></div></div><div class="body"><p class="desc">Sleeps for the indicated duration, in seconds, with millisecond granularity.</p><pre class="language-lua"><code>os.sleep(0.01)  -- Sleep for 10 milliseconds.</code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.touch" class="name"><a class="wlink" href="#os.touch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.touch</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string, [<span class="arg_name">atime</span>:number], [<span class="arg_name">mtime</span>:number] ) : boolean<br/><div class="version">v1.2.31 and newer</div></div></div><div class="body"><p class="desc">Sets the access and modified times for <span class="arg">path</span>, and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p><p class="desc"> The second argument is <span class="arg">atime</span> and is a time to set as the file's access time.  If omitted, the current time is used.  If present, the value must use the same format as <code><a href="https://www.lua.org/manual/5.2/manual.html#pdf-os.time">os.time()</a></code>.</p><p class="desc"> The third argument is <span class="arg">mtime</span> and is a time to set as the file's modified time.  If omitted, the <span class="arg">atime</span> value is used (or the current time).  If present, the value must use the same format as <code>os.time()</code>.  In order to pass <span class="arg">mtime</span> it is necessary to also pass <span class="arg">atime</span>.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.unlink" class="name"><a class="wlink" href="#os.unlink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.unlink</span> <span class="uplinks"><a href="#os">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Deletes the file <span class="arg">path</span> and returns whether it was successful. If unsuccessful it returns false, an error message, and the error number.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="path" class="group_name"><a class="wlink" href="#path"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>path. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#path.fnmatch">fnmatch</a></td><td><a href="#path.getname">getname</a></td></tr><tr><td><a href="#path.getbasename">getbasename</a></td><td><a href="#path.isexecext">isexecext</a></td></tr><tr><td><a href="#path.getdirectory">getdirectory</a></td><td><a href="#path.join">join</a></td></tr><tr><td><a href="#path.getdrive">getdrive</a></td><td><a href="#path.normalise">normalise</a></td></tr><tr><td><a href="#path.getextension">getextension</a></td><td><a href="#path.toparent">toparent</a></td></tr></table>
+<div class="function"><div class="header"> <div id="path.fnmatch" class="name"><a class="wlink" href="#path.fnmatch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>path.fnmatch</span> <span class="uplinks"><a href="#path">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">pattern</span>:string, <span class="arg_name">string</span>:string, [<span class="arg_name">flags</span>:string] ) : boolean<br/><div class="version">v1.4.24 and newer</div></div></div><div class="body"><p class="desc">This compares the two strings <span class="arg">pattern</span> and <span class="arg">string</span> and returns whether they are considered to match.  This is like the Linux <code>fnmatch</code> function, with an additional optional mode that can allow matching <code>**</code> patterns <a href="https://git-scm.com/docs/gitignore#_pattern_format">the same as git does</a>.</p><p class="desc"> The optional <span class="arg">flags</span> string may contain any of the following characters to modify the behavior accordingly: <table> <tr><th>Flag</th><th>Mnemonic</th><th>Description</th></tr> <tr><td>"<code>e</code>"</td><td>NoEscape</td><td>Treat backslash in <span class="arg">pattern</span> as a normal character, rather than as an escape character.</td></tr> <tr><td>"<code>p</code>"</td><td>PathName</td><td>Path separators in <span class="arg">string</span> are matched only by a slash <code>/</code> in <span class="arg">pattern</span> (unless the <code>*</code> flag is used; see below).</td></tr> <tr><td>"<code>.</code>"</td><td>Period</td><td>A leading period <code>.</code> in <span class="arg">string</span> is matched only by a period <code>.</code> in <span class="arg">pattern</span>.  A leading period is one at the beginning of <span class="arg">string</span>, or immediately following a path separator when the <code>p</code> flag is used.</td></tr> <tr><td>"<code>l</code>"</td><td>LeadingDir</td><td>Consider <span class="arg">pattern</span> to be matched if it completely matches <span class="arg">string</span>, or if it matches <span class="arg">string</span> up to a path separator.</td></tr> <tr><td>"<code>c</code>"</td><td>NoCaseFold</td><td>Match with case sensitivity. By default it matches case-insensitively, because Windows is case-insensitive.</td></tr> <tr><td>"<code>*</code>"</td><td>WildStar</td><td>Treat double-asterisks in <span class="arg">pattern</span> as matching path separators as well, the same as how git does (implies the <code>p</code> flag).</td></tr> <tr><td>"<code>s</code>"</td><td>NoSlashFold</td><td>Treat slashes <code>/</code> in <span class="arg">pattern</span> as only matching slashes in <span class="arg">string</span>. By default slashes in <span class="arg">pattern</span> match both slash <code>/</code> and backslash <code>\</code> because Windows recognizes both as path separators.</td></tr> </table></p><p class="desc"> The <span class="arg">pattern</span> supports wildcards (<code>?</code> and <code>*</code>), character classes (<code>[</code>...<code>]</code>), ranges (<code>[</code>.<code>-</code>.<code>]</code>), and complementation (<code>[!</code>...<code>]</code> and <code>[!</code>.<code>-</code>.<code>]</code>).</p><p class="desc"> The <span class="arg">pattern</span> also supports the following character classes: <ul> <li>"<code>[[:alnum:]]</code>": Matches any alphabetic character or digit a - z, or A - Z, or 0 - 9. <li>"<code>[[:alpha:]]</code>": Matches any alphabetic character a - z or A - Z. <li>"<code>[[:blank:]]</code>": Matches 0x20 (space) or 0x09 (tab). <li>"<code>[[:cntrl:]]</code>": Matches 0x00 - 0x1F or 0x7F. <li>"<code>[[:digit:]]</code>": Matches any of the digits 0 - 9. <li>"<code>[[:graph:]]</code>": Matches any character that matches <code>[[:print:]]</code> but does not match <code>[[:space:]]</code>. <li>"<code>[[:lower:]]</code>": Matches any lower case ASCII letter a - z. <li>"<code>[[:print:]]</code>": Matches any printable character (e.g. 0x20 - 0x7E). <li>"<code>[[:punct:]]</code>": Matches any character that matches <code>[[:print:]]</code> but does not match <code>[[:alnum:]]</code>, <code>[[:space:]]</code>, or <code>[[:alnum:]]</code>. <li>"<code>[[:space:]]</code>": Matches 0x20 (space) or 0x09 - 0x0D (tab, linefeed, carriage return, etc). <li>"<code>[[:xdigit:]]</code>": Matches any of the hexadecimal digits 0 - 9, A - F, or a - f. <li>"<code>[[:upper:]]</code>": Matches any upper case ASCII letter A - Z. </ul></p><p class="desc"> <strong>Note:</strong> At this time the character classes and case-insensitivity operate on one byte at a time, so they do not fully work as expected with non-ASCII characters.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="path.getbasename" class="name"><a class="wlink" href="#path.getbasename"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>path.getbasename</span> <span class="uplinks"><a href="#path">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc"></p><pre class="language-lua"><code>path.getbasename("/foo/bar.ext")    -- returns "bar"
 path.getbasename("")                -- returns ""</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#path.getdirectory"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path.getdirectory">path.getdirectory</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : nil or string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc">This is similar to <a href="#path.toparent">path.toparent()</a> but can behave differently when the input path ends with a path separator.  This is the recommended API for parsing a path into its component pieces, but is not recommended for walking up through parent directories.</p><pre class="language-lua"><code>path.getdirectory("foo")                -- returns nil
+
+<div class="function"><div class="header"> <div id="path.getdirectory" class="name"><a class="wlink" href="#path.getdirectory"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>path.getdirectory</span> <span class="uplinks"><a href="#path">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : nil or string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc">This is similar to <a href="#path.toparent">path.toparent()</a> but can behave differently when the input path ends with a path separator.  This is the recommended API for parsing a path into its component pieces, but is not recommended for walking up through parent directories.</p><pre class="language-lua"><code>path.getdirectory("foo")                -- returns nil
 path.getdirectory("\\foo")              -- returns "\\"
 path.getdirectory("c:foo")              -- returns "c:"
 path.getdirectory("c:\\")               -- returns "c:\\"
@@ -7008,24 +7425,31 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 -- These split the path components differently than path.toparent().
 path.getdirectory("c:\\foo\\bar\\")         -- returns "c:\\foo\\bar"
 path.getdirectory("\\\\foo\\bar\\dir\\")    -- returns "\\\\foo\\bar\\dir"</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#path.getdrive"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path.getdrive">path.getdrive</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : nil or string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc"></p><pre class="language-lua"><code>path.getdrive("e:/foo/bar")     -- returns "e:"
+
+<div class="function"><div class="header"> <div id="path.getdrive" class="name"><a class="wlink" href="#path.getdrive"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>path.getdrive</span> <span class="uplinks"><a href="#path">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : nil or string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc"></p><pre class="language-lua"><code>path.getdrive("e:/foo/bar")     -- returns "e:"
 path.getdrive("foo/bar")        -- returns nil
 path.getdrive("")               -- returns nil</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#path.getextension"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path.getextension">path.getextension</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc"></p><pre class="language-lua"><code>path.getextension("bar.ext")    -- returns ".ext"
+
+<div class="function"><div class="header"> <div id="path.getextension" class="name"><a class="wlink" href="#path.getextension"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>path.getextension</span> <span class="uplinks"><a href="#path">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc"></p><pre class="language-lua"><code>path.getextension("bar.ext")    -- returns ".ext"
 path.getextension("bar")        -- returns ""
 path.getextension("")           -- returns ""</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#path.getname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path.getname">path.getname</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc"></p><pre class="language-lua"><code>path.getname("/foo/bar.ext")    -- returns "bar.ext"
+
+<div class="function"><div class="header"> <div id="path.getname" class="name"><a class="wlink" href="#path.getname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>path.getname</span> <span class="uplinks"><a href="#path">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc"></p><pre class="language-lua"><code>path.getname("/foo/bar.ext")    -- returns "bar.ext"
 path.getname("")                -- returns ""</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#path.isexecext"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path.isexecext">path.isexecext</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.1.5 and newer</div></div></div><div class="body"><p class="desc">Examines the extension of the path name.  Returns true if the extension is listed in %PATHEXT%.  This caches the extensions in a map so that it's more efficient than getting and parsing %PATHEXT% each time.</p><pre class="language-lua"><code>path.isexecext("program.exe")   -- returns true
+
+<div class="function"><div class="header"> <div id="path.isexecext" class="name"><a class="wlink" href="#path.isexecext"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>path.isexecext</span> <span class="uplinks"><a href="#path">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean<br/><div class="version">v1.1.5 and newer</div></div></div><div class="body"><p class="desc">Examines the extension of the path name.  Returns true if the extension is listed in %PATHEXT%.  This caches the extensions in a map so that it's more efficient than getting and parsing %PATHEXT% each time.</p><pre class="language-lua"><code>path.isexecext("program.exe")   -- returns true
 path.isexecext("file.doc")      -- returns false
 path.isexecext("")              -- returns false</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#path.join"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path.join">path.join</a></div> <div class="signature">( <span class="arg_name">left</span>:string, <span class="arg_name">right</span>:string ) : string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc">If <span class="arg">right</span> is a relative path, this joins <span class="arg">left</span> and <span class="arg">right</span>.</p><p class="desc"> If <span class="arg">right</span> is not a relative path, this returns <span class="arg">right</span>.</p><pre class="language-lua"><code>path.join("/foo", "bar")        -- returns "/foo\\bar"
+
+<div class="function"><div class="header"> <div id="path.join" class="name"><a class="wlink" href="#path.join"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>path.join</span> <span class="uplinks"><a href="#path">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">left</span>:string, <span class="arg_name">right</span>:string ) : string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc">If <span class="arg">right</span> is a relative path, this joins <span class="arg">left</span> and <span class="arg">right</span>.</p><p class="desc"> If <span class="arg">right</span> is not a relative path, this returns <span class="arg">right</span>.</p><pre class="language-lua"><code>path.join("/foo", "bar")        -- returns "/foo\\bar"
 path.join("", "bar")            -- returns "bar"
 path.join("/foo", "")           -- returns "/foo\\"
 path.join("/foo", "/bar/xyz")   -- returns "/bar/xyz"</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#path.normalise"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path.normalise">path.normalise</a></div> <div class="signature">( <span class="arg_name">path</span>:string, [<span class="arg_name">separator</span>:string] ) : string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc">Cleans <span class="arg">path</span> by normalising separators and removing "." and ".." elements.  If <span class="arg">separator</span> is provided it is used to delimit path elements, otherwise a system-specific delimiter is used.</p><pre class="language-lua"><code>path.normalise("a////b/\\/c/")  -- returns "a\\b\\c\\"
+
+<div class="function"><div class="header"> <div id="path.normalise" class="name"><a class="wlink" href="#path.normalise"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>path.normalise</span> <span class="uplinks"><a href="#path">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string, [<span class="arg_name">separator</span>:string] ) : string<br/><div class="version">v1.1.0 and newer</div></div></div><div class="body"><p class="desc">Cleans <span class="arg">path</span> by normalising separators and removing "." and ".." elements.  If <span class="arg">separator</span> is provided it is used to delimit path elements, otherwise a system-specific delimiter is used.</p><pre class="language-lua"><code>path.normalise("a////b/\\/c/")  -- returns "a\\b\\c\\"
 path.normalise("")              -- returns ""</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#path.toparent"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="path.toparent">path.toparent</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : parent:string, child:string<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Splits the last path component from <span class="arg">path</span>, if possible. Returns the result and the component that was split, if any.</p><p class="desc"> This is similar to <a href="#path.getdirectory">path.getdirectory()</a> but can behave differently when the input path ends with a path separator.  This is the recommended API for walking up through parent directories.</p><pre class="language-lua"><code>local parent,child
+
+<div class="function"><div class="header"> <div id="path.toparent" class="name"><a class="wlink" href="#path.toparent"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>path.toparent</span> <span class="uplinks"><a href="#path">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : parent:string, child:string<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Splits the last path component from <span class="arg">path</span>, if possible. Returns the result and the component that was split, if any.</p><p class="desc"> This is similar to <a href="#path.getdirectory">path.getdirectory()</a> but can behave differently when the input path ends with a path separator.  This is the recommended API for walking up through parent directories.</p><pre class="language-lua"><code>local parent,child
 parent,child = path.toparent("foo")                 -- returns "", "foo"
 parent,child = path.toparent("\\foo")               -- returns "\\", "foo"
 parent,child = path.toparent("c:foo")               -- returns "c:", "foo"
@@ -7039,19 +7463,27 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 -- These split the path components differently than path.getdirectory().
 parent,child = path.toparent("c:\\foo\\bar\\"")     -- returns "c:\\foo", "bar"
 parent,child = path.toparent("\\\\foo\\bar\\dir\\") -- returns "\\\\foo\\bar", "dir"</code></pre></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#rl"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl">rl</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.collapsetilde"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.collapsetilde">rl.collapsetilde</a></div> <div class="signature">( <span class="arg_name">path</span>:string, [<span class="arg_name">force</span>:boolean] ) : string<br/><div class="version">v1.1.6 and newer</div></div></div><div class="body"><p class="desc">Undoes Readline tilde expansion.  See <a href="#rl.expandtilde">rl.expandtilde()</a> for more information.</p><pre class="language-lua"><code>rl.collapsetilde("C:\\Users\\yourusername\\Documents")
+
+</div><div class="group">
+<h5 id="rl" class="group_name"><a class="wlink" href="#rl"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>rl. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#rl.bracketpromptcodes">bracketpromptcodes</a></td><td><a href="#rl.gethistorycount">gethistorycount</a></td><td><a href="#rl.getpromptinfo">getpromptinfo</a></td><td><a href="#rl.isvariabletrue">isvariabletrue</a></td></tr><tr><td><a href="#rl.collapsetilde">collapsetilde</a></td><td><a href="#rl.gethistoryitems">gethistoryitems</a></td><td><a href="#rl.getvariable">getvariable</a></td><td><a href="#rl.needquotes">needquotes</a></td></tr><tr><td><a href="#rl.describemacro">describemacro</a></td><td><a href="#rl.getinputrcfilename">getinputrcfilename</a></td><td><a href="#rl.insertmode">insertmode</a></td><td><a href="#rl.setbinding">setbinding</a></td></tr><tr><td><a href="#rl.expandtilde">expandtilde</a></td><td><a href="#rl.getkeybindings">getkeybindings</a></td><td><a href="#rl.invokecommand">invokecommand</a></td><td><a href="#rl.setmatches">setmatches</a></td></tr><tr><td><a href="#rl.getbinding">getbinding</a></td><td><a href="#rl.getlastcommand">getlastcommand</a></td><td><a href="#rl.islineequal">islineequal</a></td><td><a href="#rl.setvariable">setvariable</a></td></tr><tr><td><a href="#rl.getcommandbindings">getcommandbindings</a></td><td><a href="#rl.getmatchcolor">getmatchcolor</a></td><td><a href="#rl.ismodifiedline">ismodifiedline</a></td><td><a href="#rl.translatekey">translatekey</a></td></tr></table>
+<div class="function"><div class="header"> <div id="rl.bracketpromptcodes" class="name"><a class="wlink" href="#rl.bracketpromptcodes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.bracketpromptcodes</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">prompt</span>:string ) : string<br/><div class="version">v1.6.1 and newer</div></div></div><div class="body"><p class="desc">Certain Readline configuration variables need for ANSI escape codes to be bracketed with <code>\1</code> and <code>\2</code>.  This function returns the <span class="arg">prompt</span> string with that bracketing applied.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.collapsetilde" class="name"><a class="wlink" href="#rl.collapsetilde"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.collapsetilde</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string, [<span class="arg_name">force</span>:boolean] ) : string<br/><div class="version">v1.1.6 and newer</div></div></div><div class="body"><p class="desc">Undoes Readline tilde expansion.  See <a href="#rl.expandtilde">rl.expandtilde()</a> for more information.</p><pre class="language-lua"><code>rl.collapsetilde("C:\\Users\\yourusername\\Documents")
 &nbsp;
 -- The return value depends on the expand-tilde configuration variable:
 -- When "on", the function returns "C:\\Users\\yourusername\\Documents".
 -- When "off", the function returns "~\\Documents".
 &nbsp;
 -- Or when <span class="arg">force</span> is true, the function returns "~\Documents".</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.describemacro"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.describemacro">rl.describemacro</a></div> <div class="signature">( <span class="arg_name">macro</span>:string, <span class="arg_name">description</span>:string ) : nil<br/><div class="version">v1.3.41 and newer</div></div></div><div class="body"><p class="desc">This associates <span class="arg">description</span> with <span class="arg">macro</span>, to be displayed in the <code><a href="#rlcmd-clink-show-help">clink-show-help</a></code> and <code><a href="#rlcmd-clink-what-is">clink-what-is</a></code> commands.</p><p class="desc"> This may be used to add a description for a <a href="#luakeybindings">luafunc: key binding</a> macro, or for a keyboard macro.</p><p class="desc"> The <span class="arg">macro</span> string should include quotes, just like in <a href="#rl.setbinding">rl.setbinding()</a>.  If quotes are not present, they are added automatically.</p><pre class="language-lua"><code>rl.describemacro([["luafunc:mycommand"]], "Does whatever mycommand does")
+
+<div class="function"><div class="header"> <div id="rl.describemacro" class="name"><a class="wlink" href="#rl.describemacro"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.describemacro</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">macro</span>:string, <span class="arg_name">description</span>:string ) : nil<br/><div class="version">v1.3.41 and newer</div></div></div><div class="body"><p class="desc">This associates <span class="arg">description</span> with <span class="arg">macro</span>, to be displayed in the <code><a href="#rlcmd-clink-show-help">clink-show-help</a></code> and <code><a href="#rlcmd-clink-what-is">clink-what-is</a></code> commands.</p><p class="desc"> This may be used to add a description for a <a href="#luakeybindings">luafunc: key binding</a> macro, or for a keyboard macro.</p><p class="desc"> The <span class="arg">macro</span> string should include quotes, just like in <a href="#rl.setbinding">rl.setbinding()</a>.  If quotes are not present, they are added automatically.</p><pre class="language-lua"><code>rl.describemacro([["luafunc:mycommand"]], "Does whatever mycommand does")
 rl.describemacro([["\e[Hrem "]], "Insert 'rem ' at the beginning of the line")
 rl.setbinding([["\C-o"]], [["luafunc:mycommand"]])
 rl.setbinding([["\C-r"]], [["\e[Hrem "]])
 -- Press Alt-H to see the list of key bindings and descriptions.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.expandtilde"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.expandtilde">rl.expandtilde</a></div> <div class="signature">( <span class="arg_name">path</span>:string, [<span class="arg_name">whole_line</span>:boolean] ) : string, boolean<br/><div class="version">v1.1.6 and newer</div></div></div><div class="body"><p class="desc">Performs Readline tilde expansion.</p><p class="desc"> When generating filename matches for a word, use the <a href="#rl.expandtilde">rl.expandtilde()</a> and <a href="#rl.collapsetilde">rl.collapsetilde()</a> helper functions to perform tilde completion expansion according to Readline's configuration.</p><p class="desc"> An optional <span class="arg">whole_line</span> argument selects whether to expand tildes everywhere in the input string (pass true), or to expand only a tilde at the beginning of the input string (pass false or omit the second argument).  See the Compatibility Note below for more information.</p><p class="desc"> Use <a href="#rl.expandtilde">rl.expandtilde()</a> to do tilde expansion before collecting file matches (e.g. via <a href="#os.globfiles">os.globfiles()</a>).  If it indicates that it expanded the string, then use <a href="#rl.collapsetilde">rl.collapsetilde()</a> to put back the tilde before returning a match.</p><pre class="language-lua"><code>local result, expanded = rl.expandtilde("~\\Documents")
+
+<div class="function"><div class="header"> <div id="rl.expandtilde" class="name"><a class="wlink" href="#rl.expandtilde"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.expandtilde</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string, [<span class="arg_name">whole_line</span>:boolean] ) : string, boolean<br/><div class="version">v1.1.6 and newer</div></div></div><div class="body"><p class="desc">Performs Readline tilde expansion.</p><p class="desc"> When generating filename matches for a word, use the <a href="#rl.expandtilde">rl.expandtilde()</a> and <a href="#rl.collapsetilde">rl.collapsetilde()</a> helper functions to perform tilde completion expansion according to Readline's configuration.</p><p class="desc"> An optional <span class="arg">whole_line</span> argument selects whether to expand tildes everywhere in the input string (pass true), or to expand only a tilde at the beginning of the input string (pass false or omit the second argument).  See the Compatibility Note below for more information.</p><p class="desc"> Use <a href="#rl.expandtilde">rl.expandtilde()</a> to do tilde expansion before collecting file matches (e.g. via <a href="#os.globfiles">os.globfiles()</a>).  If it indicates that it expanded the string, then use <a href="#rl.collapsetilde">rl.collapsetilde()</a> to put back the tilde before returning a match.</p><pre class="language-lua"><code>local result, expanded = rl.expandtilde("~\\Documents")
 -- result is "C:\\Users\\yourusername\\Documents"
 -- expanded is true
 
@@ -7078,13 +7510,15 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;   end
 &nbsp;   return matches
 end</code></pre><p class="desc"><fieldset><legend>Compatibility Note:</legend> The original intended usage for this function was to expand tildes in a single word.  But sometimes it may be convenient to expand tildes for an entire command line all at once.</p><p class="desc"> Prior to v1.3.36, this function simply asked the Readline library to expand tildes, but that mode of operation doesn't respect quotes and has quirks that can produce unexpected results when the input is a single pathname (which was the documented supported usage).</p><p class="desc"> In v1.3.36 this function fixed that problem, and expands tildes correctly a single pathname as the input (and also accepts quotes).  But that broke an undocumented quirk that could expand tildes for a whole command line as the input.</p><p class="desc"> In v1.3.37 and newer, this function accepts a boolean second argument which selects whether to expand for a whole input line using the quirky Readline tilde expansion (pass true), or to expand for a single pathname as the input (pass false or omit the second argument).</p><p class="desc"> Passing true for the second argument causes any version of Clink (except v1.3.36) to expand the input as a whole command line. </fieldset></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.getbinding"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.getbinding">rl.getbinding</a></div> <div class="signature">( <span class="arg_name">key</span>:string, [<span class="arg_name">keymap</span>:string] ) : binding:string, type:string<br/><div class="version">v1.2.46 and newer</div></div></div><div class="body"><p class="desc">Returns the command or macro bound to <span class="arg">key</span>, and the type of the binding.</p><p class="desc"> If nothing is bound to the specified key sequence, the returned binding will be nil.</p><p class="desc"> The returned type can be <code>"function"</code>, <code>"macro"</code>, or <code>"keymap"</code> (if <span class="arg">key</span> is an incomplete key sequence).</p><p class="desc"> If an error occurs, only nil is returned.</p><p class="desc"> The <span class="arg">key</span> sequence string is the same format as from <code>clink echo</code>.  See <a href="#discoverkeysequences">Discovering Clink key sindings</a> for more information.</p><p class="desc"> An optional <span class="arg">keymap</span> may be specified as well.  If it is omitted or nil, then the current keymap is searched.  Otherwise it may refer to one of the three built in keymaps: <table> <tr><th>Keymap</th><th>Description</th></tr> <tr><td><code>"emacs"</code></td><td>The Emacs keymap, which is the default keymap.</td></tr> <tr><td><code>"vi"</code>, <code>"vi-move"</code>, or <code>"vi-command"</code></td><td>The VI command mode keymap.</td></tr> <tr><td><code>"vi-insert"</code></td><td>The VI insertion mode keymap.</td></tr> </table></p><p class="desc"> The return value can be passed as input to <a href="#rl.setbinding">rl.setbinding()</a> or <a href="#rl.invokecommand">rl.invokecommand()</a>.</p><pre class="language-lua"><code>local b,t = rl.getbinding([["\e[H"]], "emacs")
+
+<div class="function"><div class="header"> <div id="rl.getbinding" class="name"><a class="wlink" href="#rl.getbinding"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.getbinding</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">key</span>:string, [<span class="arg_name">keymap</span>:string] ) : binding:string, type:string<br/><div class="version">v1.2.46 and newer</div></div></div><div class="body"><p class="desc">Returns the command or macro bound to <span class="arg">key</span>, and the type of the binding.</p><p class="desc"> If nothing is bound to the specified key sequence, the returned binding will be nil.</p><p class="desc"> The returned type can be <code>"function"</code>, <code>"macro"</code>, or <code>"keymap"</code> (if <span class="arg">key</span> is an incomplete key sequence).</p><p class="desc"> If an error occurs, only nil is returned.</p><p class="desc"> The <span class="arg">key</span> sequence string is the same format as from <code>clink echo</code>.  See <a href="#discoverkeysequences">Discovering Clink key bindings</a> for more information.</p><p class="desc"> An optional <span class="arg">keymap</span> may be specified as well.  If it is omitted or nil, then the current keymap is searched.  Otherwise it may refer to one of the three built in keymaps: <table> <tr><th>Keymap</th><th>Description</th></tr> <tr><td><code>"emacs"</code></td><td>The Emacs keymap, which is the default keymap.</td></tr> <tr><td><code>"vi"</code>, <code>"vi-move"</code>, or <code>"vi-command"</code></td><td>The VI command mode keymap.</td></tr> <tr><td><code>"vi-insert"</code></td><td>The VI insertion mode keymap.</td></tr> </table></p><p class="desc"> The return value can be passed as input to <a href="#rl.setbinding">rl.setbinding()</a> or <a href="#rl.invokecommand">rl.invokecommand()</a>.</p><pre class="language-lua"><code>local b,t = rl.getbinding([["\e[H"]], "emacs")
 if b then
 &nbsp;   print("Home is bound to "..b.." ("..t..") in emacs mode.")
 else
 &nbsp;   print("Home is not bound in emacs mode.")
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.getcommandbindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.getcommandbindings">rl.getcommandbindings</a></div> <div class="signature">( <span class="arg_name">command</span>:string, <span class="arg_name">raw</span>:boolean ) : table | nil<br/><div class="version">v1.5.1 and newer</div></div></div><div class="body"><p class="desc">Returns key bindings and info for <span class="arg">command</span> in a table with the following scheme:</p><pre class="language-lua"><code>local t = rl.getcommandbindings("complete")
+
+<div class="function"><div class="header"> <div id="rl.getcommandbindings" class="name"><a class="wlink" href="#rl.getcommandbindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.getcommandbindings</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">command</span>:string, <span class="arg_name">raw</span>:boolean ) : table | nil<br/><div class="version">v1.5.1 and newer</div></div></div><div class="body"><p class="desc">Returns key bindings and info for <span class="arg">command</span> in a table with the following scheme:</p><pre class="language-lua"><code>local t = rl.getcommandbindings("complete")
 -- t.desc               [string] Description of the command.
 -- t.category           [string] Category of the command.
 -- t.keys               [table] Table of strings listing the key names that are bound to the command.</code></pre><p class="desc">When <span class="arg">raw</span> is true, the key names are the literal key sequences without being converted to user-friendly key names.</p><p class="desc"> If <span class="arg">command</span> is neither a command nor a macro string, then nil is returned.</p><pre class="language-lua"><code>local command = 'complete'
@@ -7106,11 +7540,16 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 else
 &nbsp;   print("Command '"..command.."' not recognized.")
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.gethistorycount"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.gethistorycount">rl.gethistorycount</a></div> <div class="signature">() : integer<br/><div class="version">v1.3.18 and newer</div></div></div><div class="body"><p class="desc">Returns the number of history items.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.gethistoryitems"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.gethistoryitems">rl.gethistoryitems</a></div> <div class="signature">() : start:integer<br/><div class="version">v1.3.18 and newer</div></div></div><div class="body"><p class="desc">Returns a table of history items.</p><p class="desc"> The first history item is 1, and the last history item is <a href="#rl.gethistorycount">rl.gethistorycount()</a>.  For best performance, use <span class="arg">start</span> and <span class="arg">end</span> to request only the range of history items that will be needed.</p><p class="desc"> Each history item is a table with the following scheme:</p><pre class="language-lua"><code>local h = rl.gethistoryitems(1, rl.gethistorycount())
+
+<div class="function"><div class="header"> <div id="rl.gethistorycount" class="name"><a class="wlink" href="#rl.gethistorycount"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.gethistorycount</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.3.18 and newer</div></div></div><div class="body"><p class="desc">Returns the number of history items.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.gethistoryitems" class="name"><a class="wlink" href="#rl.gethistoryitems"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.gethistoryitems</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : start:integer<br/><div class="version">v1.3.18 and newer</div></div></div><div class="body"><p class="desc">Returns a table of history items.</p><p class="desc"> The first history item is 1, and the last history item is <a href="#rl.gethistorycount">rl.gethistorycount()</a>.  For best performance, use <span class="arg">start</span> and <span class="arg">end</span> to request only the range of history items that will be needed.</p><p class="desc"> Each history item is a table with the following scheme:</p><pre class="language-lua"><code>local h = rl.gethistoryitems(1, rl.gethistorycount())
 -- h.line       [string] The item's command line string.
 -- h.time       [integer or nil] The item's time, compatible with os.time().</code></pre><p class="desc"><strong>Note:</strong> the time field is omitted if the history item does not have an associated time.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.getkeybindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.getkeybindings">rl.getkeybindings</a></div> <div class="signature">( <span class="arg_name">raw</span>:boolean, [<span class="arg_name">mode</span>:integer] ) : table<br/><div class="version">v1.2.16 and newer</div></div></div><div class="body"><p class="desc">Returns key bindings in a table with the following scheme:</p><pre class="language-lua"><code>local t = rl.getkeybindings()
+
+<div class="function"><div class="header"> <div id="rl.getinputrcfilename" class="name"><a class="wlink" href="#rl.getinputrcfilename"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.getinputrcfilename</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string|nil, string|nil<br/><div class="version">v1.6.1 and newer</div></div></div><div class="body"><p class="desc">Returns the path and file name of the Readline init file that was loaded, if any.  Also returns the path and file name of the default Readline init file, if any is present.</p><p class="desc"> See [Init File](#init-file) for more info.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.getkeybindings" class="name"><a class="wlink" href="#rl.getkeybindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.getkeybindings</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">raw</span>:boolean, [<span class="arg_name">mode</span>:integer] ) : table<br/><div class="version">v1.2.16 and newer</div></div></div><div class="body"><p class="desc">Returns key bindings in a table with the following scheme:</p><pre class="language-lua"><code>local t = rl.getkeybindings()
 -- t[index].key         [string] Key name.
 -- t[index].binding     [string] Command or macro bound to the key.
 -- t[index].desc        [string] Description of the command.
@@ -7138,9 +7577,12 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;       rl.invokecommand(binding)
 &nbsp;   end
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.getlastcommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.getlastcommand">rl.getlastcommand</a></div> <div class="signature">() : string, function<br/><div class="version">v1.1.40 and newer</div></div></div><div class="body"><p class="desc">Returns two values: <ul> <li>The name of the last Readline command invoked by a key binding. <li>The name of the last Lua function invoked by a key binding. </ul></p><p class="desc"> If the last key binding invoked a Lua function, then the first return value is an empty string unless the Lua function used <a href="#rl.invokecommand">rl.invokecommand()</a> to also internally invoke a Readline command. If the last key binding did not invoke a Lua function, then the second return value is an empty string.</p><pre class="language-lua"><code>local last_rl_func, last_lua_func = rl.getlastcommand()</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.getmatchcolor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.getmatchcolor">rl.getmatchcolor</a></div> <div class="signature">( <span class="arg_name">match</span>:string|table, [<span class="arg_name">type</span>:string] ) : string<br/><div class="version">v1.3.4 and newer</div></div></div><div class="body"><p class="desc">Returns the color string associated with the match.</p><p class="desc"> The arguments are the same as in <a href="#builder:addmatch">builder:addmatch()</a>.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.getpromptinfo"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.getpromptinfo">rl.getpromptinfo</a></div> <div class="signature">() : table<br/><div class="version">v1.2.28 and newer</div></div></div><div class="body"><p class="desc">Returns information about the current prompt and input line.</p><p class="desc"> Note: the <span class="arg">promptline</span> and <span class="arg">inputline</span> fields may be skewed if any additional terminal output has occurred (for example if any <a href="#https://www.lua.org/manual/5.2/manual.html#pdf-print">print()</a> calls have happened, or if <code>rl.getpromptinfo()</code> is used inside a <a href="#clink_onendedit">clink.onendedit()</a> event handler, or any other output that the Readline library wouldn't know about).</p><p class="desc"> The returned table has the following scheme:</p><pre class="language-lua"><code>local info = rl.getpromptinfo()
+
+<div class="function"><div class="header"> <div id="rl.getlastcommand" class="name"><a class="wlink" href="#rl.getlastcommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.getlastcommand</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string, function<br/><div class="version">v1.1.40 and newer</div></div></div><div class="body"><p class="desc">Returns two values: <ul> <li>The name of the last Readline command invoked by a key binding. <li>The name of the last Lua function invoked by a key binding. </ul></p><p class="desc"> If the last key binding invoked a Lua function, then the first return value is an empty string unless the Lua function used <a href="#rl.invokecommand">rl.invokecommand()</a> to also internally invoke a Readline command. If the last key binding did not invoke a Lua function, then the second return value is an empty string.</p><pre class="language-lua"><code>local last_rl_func, last_lua_func = rl.getlastcommand()</code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.getmatchcolor" class="name"><a class="wlink" href="#rl.getmatchcolor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.getmatchcolor</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">match</span>:string|table, [<span class="arg_name">type</span>:string] ) : string<br/><div class="version">v1.3.4 and newer</div></div></div><div class="body"><p class="desc">Returns the color string associated with the match.</p><p class="desc"> The arguments are the same as in <a href="#builder:addmatch">builder:addmatch()</a>.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.getpromptinfo" class="name"><a class="wlink" href="#rl.getpromptinfo"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.getpromptinfo</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : table<br/><div class="version">v1.2.28 and newer</div></div></div><div class="body"><p class="desc">Returns information about the current prompt and input line.</p><p class="desc"> Note: the <span class="arg">promptline</span> and <span class="arg">inputline</span> fields may be skewed if any additional terminal output has occurred (for example if any <a href="#https://www.lua.org/manual/5.2/manual.html#pdf-print">print()</a> calls have happened, or if <code>rl.getpromptinfo()</code> is used inside a <a href="#clink_onendedit">clink.onendedit()</a> event handler, or any other output that the Readline library wouldn't know about).</p><p class="desc"> The returned table has the following scheme:</p><pre class="language-lua"><code>local info = rl.getpromptinfo()
 -- info.promptprefix              [string] The prompt string, minus the last line of the prompt string.
 -- info.promptprefixlinecount     [integer] Number of lines in the promptprefix string.
 -- info.prompt                    [string] The last line of the prompt string.
@@ -7148,10 +7590,14 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 -- info.promptline                [integer] Console line on which the prompt starts.
 -- info.inputline                 [integer] Console line on which the input text starts.
 -- info.inputlinecount            [integer] Number of lines in the input text.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.getvariable"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.getvariable">rl.getvariable</a></div> <div class="signature">( <span class="arg_name">name</span>:string ) : string | nil<br/><div class="version">v1.1.6 and newer</div></div></div><div class="body"><p class="desc">Returns the value of the named Readline configuration variable as a string, or nil if the variable name is not recognized.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.insertmode"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.insertmode">rl.insertmode</a></div> <div class="signature">( [<span class="arg_name">insert</span>:boolean] ) : boolean<br/><div class="version">v1.2.50 and newer</div></div></div><div class="body"><p class="desc">Returns true when typing insertion mode is on.</p><p class="desc"> When the optional <span class="arg">insert</span> argument is passed, this also sets typing insertion mode on or off accordingly.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.invokecommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.invokecommand">rl.invokecommand</a></div> <div class="signature">( <span class="arg_name">command</span>:string, [<span class="arg_name">count</span>:integer] ) : boolean | nil<br/><div class="version">v1.1.26 and newer</div></div></div><div class="body"><p class="desc">Invokes a Readline command named <span class="arg">command</span>.  May only be used within a <a href="#luakeybindings">luafunc: key binding</a>.</p><p class="desc"> <span class="arg">count</span> is optional and defaults to 1 if omitted.</p><p class="desc"> Returns true if the named command succeeds, false if the named command fails, or nil if the named command doesn't exist.</p><p class="desc"> Warning:  Invoking more than one Readline command in a luafunc: key binding could have unexpected results, depending on which commands are invoked.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.islineequal"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.islineequal">rl.islineequal</a></div> <div class="signature">( <span class="arg_name">text</span>:string, [<span class="arg_name">to_cursor</span>:boolean] ) : boolean<br/><div class="version">v1.4.14 and newer</div></div></div><div class="body"><p class="desc">Returns whether the current input line exactly matches <span class="arg">text</span>.  This can be useful in a coroutine that wants to know whether the current input line has already changed, before it starts a potentially slow operation to generate matches. If the optional <span class="arg">to_cursor</span> is true, then only the line up to the current cursor position is compared.</p><pre class="language-lua"><code>local function matches_func(word, index, line_state, builder)
+
+<div class="function"><div class="header"> <div id="rl.getvariable" class="name"><a class="wlink" href="#rl.getvariable"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.getvariable</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">name</span>:string ) : string | nil<br/><div class="version">v1.1.6 and newer</div></div></div><div class="body"><p class="desc">Returns the value of the named Readline configuration variable as a string, or nil if the variable name is not recognized.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.insertmode" class="name"><a class="wlink" href="#rl.insertmode"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.insertmode</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">insert</span>:boolean] ) : boolean<br/><div class="version">v1.2.50 and newer</div></div></div><div class="body"><p class="desc">Returns true when typing insertion mode is on.</p><p class="desc"> When the optional <span class="arg">insert</span> argument is passed, this also sets typing insertion mode on or off accordingly.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.invokecommand" class="name"><a class="wlink" href="#rl.invokecommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.invokecommand</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">command</span>:string, [<span class="arg_name">count</span>:integer] ) : boolean | nil<br/><div class="version">v1.1.26 and newer</div></div></div><div class="body"><p class="desc">Invokes a Readline command named <span class="arg">command</span>.  May only be used within a <a href="#luakeybindings">luafunc: key binding</a>.</p><p class="desc"> <span class="arg">count</span> is optional and defaults to 1 if omitted.</p><p class="desc"> Returns true if the named command succeeds, false if the named command fails, or nil if the named command doesn't exist.</p><p class="desc"> Warning:  Invoking more than one Readline command in a luafunc: key binding could have unexpected results, depending on which commands are invoked.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.islineequal" class="name"><a class="wlink" href="#rl.islineequal"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.islineequal</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string, [<span class="arg_name">to_cursor</span>:boolean] ) : boolean<br/><div class="version">v1.4.14 and newer</div></div></div><div class="body"><p class="desc">Returns whether the current input line exactly matches <span class="arg">text</span>.  This can be useful in a coroutine that wants to know whether the current input line has already changed, before it starts a potentially slow operation to generate matches. If the optional <span class="arg">to_cursor</span> is true, then only the line up to the current cursor position is compared.</p><pre class="language-lua"><code>local function matches_func(word, index, line_state, builder)
 &nbsp;    -- Delay match generation briefly, to allow coalescing typed letters into
 &nbsp;    -- a single query.  This can make auto-suggestions more responsive if the
 &nbsp;    -- match generation operation is slow, such as doing a network query.
@@ -7182,7 +7628,8 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp;    end
 &nbsp;    return matches
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.ismodifiedline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.ismodifiedline">rl.ismodifiedline</a></div> <div class="signature">() : boolean<br/><div class="version">v1.2.51 and newer</div></div></div><div class="body"><p class="desc">Returns true when the current input line is a history entry that has been modified (i.e. has an undo list).</p><p class="desc"> This enables prompt filters to show a "modmark" of their own, as an alternative to the modmark shown when the <code><a href="#configmarkmodifiedlines">mark-modified-lines</a></code> Readline config setting is enabled.</p><p class="desc"> The following sample illustrates a prompt filter that shows a "modified line" indicator when the current line is a history entry and has been modified.</p><pre class="language-lua"><code>local p = clink.promptfilter(10)
+
+<div class="function"><div class="header"> <div id="rl.ismodifiedline" class="name"><a class="wlink" href="#rl.ismodifiedline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.ismodifiedline</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : boolean<br/><div class="version">v1.2.51 and newer</div></div></div><div class="body"><p class="desc">Returns true when the current input line is a history entry that has been modified (i.e. has an undo list).</p><p class="desc"> This enables prompt filters to show a "modmark" of their own, as an alternative to the modmark shown when the <code><a href="#configmarkmodifiedlines">mark-modified-lines</a></code> Readline config setting is enabled.</p><p class="desc"> The following sample illustrates a prompt filter that shows a "modified line" indicator when the current line is a history entry and has been modified.</p><pre class="language-lua"><code>local p = clink.promptfilter(10)
 local normal = "\x1b[m"
 
 local function get_settings_color(name)
@@ -7220,9 +7667,12 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 
 clink.onbeginedit(modmark_reset)
 clink.onaftercommand(modmark_refilter)</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.isvariabletrue"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.isvariabletrue">rl.isvariabletrue</a></div> <div class="signature">( <span class="arg_name">name</span>:string ) : boolean | nil<br/><div class="version">v1.1.6 and newer</div></div></div><div class="body"><p class="desc">Returns a boolean value indicating whether the named Readline configuration variable is set to true (on), or nil if the variable name is not recognized.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.needquotes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.needquotes">rl.needquotes</a></div> <div class="signature">( <span class="arg_name">text</span>:string ) : boolean<br/><div class="version">v1.4.8 and newer</div></div></div><div class="body"><p class="desc">Returns whether the <span class="arg">text</span> needs quotes to be parsed correctly in a command line.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.setbinding"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.setbinding">rl.setbinding</a></div> <div class="signature">( <span class="arg_name">key</span>:string, <span class="arg_name">binding</span>:string | nil, [<span class="arg_name">keymap</span>:string] ) : boolean<br/><div class="version">v1.2.46 and newer</div></div></div><div class="body"><p class="desc">Binds <span class="arg">key</span> to invoke <span class="arg">binding</span>, and returns whether it was successful.</p><p class="desc"> The <span class="arg">key</span> sequence string is the same format as from <code>clink echo</code>.  See <a href="#discoverkeysequences">Discovering Clink key sindings</a> for more information.</p><p class="desc"> The <span class="arg">binding</span> is either the name of a Readline command, a quoted macro string (just like in the .inputrc config file), or nil to clear the key binding.</p><p class="desc"> An optional <span class="arg">keymap</span> may be specified as well.  If it is omitted or nil, then the current keymap is searched.  Otherwise it may refer to one of the three built in keymaps: <table> <tr><th>Keymap</th><th>Description</th></tr> <tr><td><code>"emacs"</code></td><td>The Emacs keymap, which is the default keymap.</td></tr> <tr><td><code>"vi"</code>, <code>"vi-move"</code>, or <code>"vi-command"</code></td><td>The VI command mode keymap.</td></tr> <tr><td><code>"vi-insert"</code></td><td>The VI insertion mode keymap.</td></tr> </table></p><p class="desc"> Using Lua's <code>[[</code>..<code>]]</code> string syntax conveniently lets you simply copy the key string exactly from the <code>clink echo</code> output, without needing to translate the quotes or backslashes.</p><p class="desc"> <strong>Note:</strong> This does not write the value into a config file. Instead it updates the key binding in memory, temporarily overriding whatever is present in any config files.  When config files are reloaded, they may replace the key binding again.</p><pre class="language-lua"><code>local old_space = rl.getbinding('" "')
+
+<div class="function"><div class="header"> <div id="rl.isvariabletrue" class="name"><a class="wlink" href="#rl.isvariabletrue"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.isvariabletrue</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">name</span>:string ) : boolean | nil<br/><div class="version">v1.1.6 and newer</div></div></div><div class="body"><p class="desc">Returns a boolean value indicating whether the named Readline configuration variable is set to true (on), or nil if the variable name is not recognized.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.needquotes" class="name"><a class="wlink" href="#rl.needquotes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.needquotes</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string ) : boolean<br/><div class="version">v1.4.8 and newer</div></div></div><div class="body"><p class="desc">Returns whether the <span class="arg">text</span> needs quotes to be parsed correctly in a command line.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.setbinding" class="name"><a class="wlink" href="#rl.setbinding"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.setbinding</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">key</span>:string, <span class="arg_name">binding</span>:string | nil, [<span class="arg_name">keymap</span>:string] ) : boolean<br/><div class="version">v1.2.46 and newer</div></div></div><div class="body"><p class="desc">Binds <span class="arg">key</span> to invoke <span class="arg">binding</span>, and returns whether it was successful.</p><p class="desc"> The <span class="arg">key</span> sequence string is the same format as from <code>clink echo</code>.  See <a href="#discoverkeysequences">Discovering Clink key bindings</a> for more information.</p><p class="desc"> The <span class="arg">binding</span> is either the name of a Readline command, a quoted macro string (just like in the .inputrc config file), or nil to clear the key binding.</p><p class="desc"> An optional <span class="arg">keymap</span> may be specified as well.  If it is omitted or nil, then the current keymap is searched.  Otherwise it may refer to one of the three built in keymaps: <table> <tr><th>Keymap</th><th>Description</th></tr> <tr><td><code>"emacs"</code></td><td>The Emacs keymap, which is the default keymap.</td></tr> <tr><td><code>"vi"</code>, <code>"vi-move"</code>, or <code>"vi-command"</code></td><td>The VI command mode keymap.</td></tr> <tr><td><code>"vi-insert"</code></td><td>The VI insertion mode keymap.</td></tr> </table></p><p class="desc"> Using Lua's <code>[[</code>..<code>]]</code> string syntax conveniently lets you simply copy the key string exactly from the <code>clink echo</code> output, without needing to translate the quotes or backslashes.</p><p class="desc"> <strong>Note:</strong> This does not write the value into a config file. Instead it updates the key binding in memory, temporarily overriding whatever is present in any config files.  When config files are reloaded, they may replace the key binding again.</p><pre class="language-lua"><code>local old_space = rl.getbinding('" "')
 function hijack_space(rl_buffer)
 &nbsp;   rl.invokecommand("clink-expand-line")   -- Expand envvars, etc in the line.
 &nbsp;   rl.invokecommand(old_space)             -- Then invoke whatever was previously bound to Space.
@@ -7232,7 +7682,8 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 -- The [[]] string syntax lets you copy key strings directly from 'clink echo'.
 -- [["\e[H"]] is much easier than translating to "\"\\e[H\"", for example.
 rl.setbinding([["\e[H"]], [[beginning-of-line]])</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.setmatches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.setmatches">rl.setmatches</a></div> <div class="signature">( <span class="arg_name">matches</span>:table, [<span class="arg_name">type</span>:string] ) : integer, boolean<br/><div class="version">v1.1.40 and newer</div></div></div><div class="body"><p class="desc">Provides an alternative set of matches for the current word.  This discards any matches that may have already been collected and uses <span class="arg">matches</span> for subsequent Readline completion commands until any action that normally resets the matches (such as moving the cursor or editing the input line).</p><p class="desc"> The syntax is the same as for <a href="#builder:addmatches()">builder:addmatches()</a> with one addition: You can add a <code>"nosort"</code> key to the <span class="arg">matches</span> table to disable sorting the matches.</p><p class="desc"> <pre><code class="lua">local matches = {}<br/>matches["nosort"] = true<br/>rl.setmatches(matches)</code></pre></p><p class="desc"> This function may (only) be used by a <a href="#luakeybindings">luafunc: key binding</a> to provide matches based on some special criteria.  For example, a key binding could collect numbers from the current screen buffer (such as issue numbers, commit hashes, line numbers, etc) and provide them to Readline as matches, making it convenient to grab a number from the screen and insert it as a command line argument.</p><p class="desc"> Match display filtering is also possible by using <a href="#clink.ondisplaymatches">clink.ondisplaymatches()</a> after setting the matches.</p><p class="desc"> <em>Example .inputrc key binding:</em> <pre><code class="plaintext">M-n:            <span class="hljs-string">"luafunc:completenumbers"</span>       <span class="hljs-comment"># Alt+N</span></code></pre></p><p class="desc"> <em>Example Lua function:</em></p><pre class="language-lua"><code>function completenumbers()
+
+<div class="function"><div class="header"> <div id="rl.setmatches" class="name"><a class="wlink" href="#rl.setmatches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.setmatches</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">matches</span>:table, [<span class="arg_name">type</span>:string] ) : integer, boolean<br/><div class="version">v1.1.40 and newer</div></div></div><div class="body"><p class="desc">Provides an alternative set of matches for the current word.  This discards any matches that may have already been collected and uses <span class="arg">matches</span> for subsequent Readline completion commands until any action that normally resets the matches (such as moving the cursor or editing the input line).</p><p class="desc"> The syntax is the same as for <a href="#builder:addmatches()">builder:addmatches()</a> with one addition: You can add a <code>"nosort"</code> key to the <span class="arg">matches</span> table to disable sorting the matches.</p><p class="desc"> <pre><code class="lua">local matches = {}<br/>matches["nosort"] = true<br/>rl.setmatches(matches)</code></pre></p><p class="desc"> This function may (only) be used by a <a href="#luakeybindings">luafunc: key binding</a> to provide matches based on some special criteria.  For example, a key binding could collect numbers from the current screen buffer (such as issue numbers, commit hashes, line numbers, etc) and provide them to Readline as matches, making it convenient to grab a number from the screen and insert it as a command line argument.</p><p class="desc"> Match display filtering is also possible by using <a href="#clink.ondisplaymatches">clink.ondisplaymatches()</a> after setting the matches.</p><p class="desc"> <em>Example .inputrc key binding:</em> <pre><code class="plaintext">M-n:            <span class="hljs-string">"luafunc:completenumbers"</span>       <span class="hljs-comment"># Alt+N</span></code></pre></p><p class="desc"> <em>Example Lua function:</em></p><pre class="language-lua"><code>function completenumbers()
 &nbsp;   local _,last_luafunc = rl.getlastcommand()
 &nbsp;   if last_luafunc ~= "completenumbers" then
 &nbsp;       -- Collect numbers from the screen (minimum of three digits).
@@ -7245,30 +7696,60 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 
 &nbsp;   rl.invokecommand("old-menu-complete")
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl.setvariable"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl.setvariable">rl.setvariable</a></div> <div class="signature">( <span class="arg_name">name</span>:string, <span class="arg_name">value</span>:string ) : boolean<br/><div class="version">v1.1.46 and newer</div></div></div><div class="body"><p class="desc">Temporarily overrides the named Readline configuration variable to the specified value.  The return value reports whether it was successful, or is nil if the variable name is not recognized.</p><p class="desc"> <strong>Note:</strong> This does not write the value into a config file. Instead it updates the variable in memory, temporarily overriding whatever is present in any config files.  When config files are reloaded, they may replace the value again.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#rl_buffer"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer">rl_buffer</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:beginoutput"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:beginoutput">rl_buffer:beginoutput</a></div> <div class="signature">() : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Advances the output cursor to the next line after the Readline input buffer so that subsequent output doesn't overwrite the input buffer display.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:beginundogroup"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:beginundogroup">rl_buffer:beginundogroup</a></div> <div class="signature">() : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Starts a new undo group.  This is useful for grouping together multiple editing actions into a single undo operation.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:ding"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:ding">rl_buffer:ding</a></div> <div class="signature">() : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Dings the bell.  If the <code><a href="#configbellstyle">bell-style</a></code> Readline variable is <code>visible</code> then it flashes the cursor instead.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:endundogroup"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:endundogroup">rl_buffer:endundogroup</a></div> <div class="signature">() : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Ends an undo group.  This is useful for grouping together multiple editing actions into a single undo operation.</p><p class="desc"> Note:  all undo groups are automatically ended when a key binding finishes execution, so this function is only needed if a key binding needs to create more than one undo group.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:getanchor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:getanchor">rl_buffer:getanchor</a></div> <div class="signature">() : integer | nil<br/><div class="version">v1.2.35 and newer</div></div></div><div class="body"><p class="desc">Returns the anchor position of the currently selected text in the input line, or nil if there is no selection.  The value can be from 1 to rl_buffer:getlength() + 1.  It can exceed the length of the input line because the anchor can be positioned just past the end of the input line.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:getargument"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:getargument">rl_buffer:getargument</a></div> <div class="signature">() : integer | nil<br/><div class="version">v1.2.22 and newer</div></div></div><div class="body"><p class="desc">Returns any accumulated numeric argument (<kbd>Alt</kbd>+Digits, etc), or nil if no numeric argument has been entered.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:getbuffer"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:getbuffer">rl_buffer:getbuffer</a></div> <div class="signature">() : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the current input line.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:getcursor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:getcursor">rl_buffer:getcursor</a></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the cursor position in the input line.  The value can be from 1 to rl_buffer:getlength() + 1.  It can exceed the length of the input line because the cursor can be positioned just past the end of the input line.</p><p class="desc"> <strong>Note:</strong> In v1.1.20 through v1.2.31 this accidentally returned 1 less than the actual cursor position.  In v1.2.32 and higher it returns the correct cursor position.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:getlength"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:getlength">rl_buffer:getlength</a></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the length of the input line.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:insert"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:insert">rl_buffer:insert</a></div> <div class="signature">( <span class="arg_name">text</span>:string ) : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Inserts <span class="arg">text</span> at the cursor position in the input line.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:refreshline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:refreshline">rl_buffer:refreshline</a></div> <div class="signature">() : nil<br/><div class="version">v1.1.41 and newer</div></div></div><div class="body"><p class="desc">Redraws the input line.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:remove"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:remove">rl_buffer:remove</a></div> <div class="signature">( <span class="arg_name">from</span>:integer, <span class="arg_name">to</span>:integer ) : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Removes text from the input line starting at cursor position <span class="arg">from</span> up to but not including <span class="arg">to</span>.</p><p class="desc"> If <span class="arg">from</span> is greater than <span class="arg">to</span> then the positions are swapped before removing text.</p><p class="desc"> Note:  the input line is UTF8, and removing only part of a multi-byte Unicode character may have undesirable results.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:setargument"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:setargument">rl_buffer:setargument</a></div> <div class="signature">( <span class="arg_name">argument</span>:integer | nil ) : nil<br/><div class="version">v1.2.32 and newer</div></div></div><div class="body"><p class="desc">When <span class="arg">argument</span> is a number, it is set as the numeric argument for use by Readline commands (as entered using <kbd>Alt</kbd>+Digits, etc).  When <span class="arg">argument</span> is nil, the numeric argument is cleared (having no numeric argument is different from having 0 as the numeric argument).</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_buffer:setcursor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_buffer:setcursor">rl_buffer:setcursor</a></div> <div class="signature">( <span class="arg_name">cursor</span>:integer ) : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Sets the cursor position in the input line and returns the previous cursor position.  <span class="arg">cursor</span> can be from 1 to rl_buffer:getlength() + 1.  It can exceed the length of the input line because the cursor can be positioned just past the end of the input line.</p><p class="desc"> Note:  the input line is UTF8, and setting the cursor position inside a multi-byte Unicode character may have undesirable results.</p><p class="desc"> <strong>Note:</strong> In v1.1.20 through v1.2.31 this accidentally returned 1 less than the actual cursor position.  In v1.2.32 and higher it returns the correct cursor position.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#settings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="settings">settings</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#settings.add"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="settings.add">settings.add</a></div> <div class="signature">( <span class="arg_name">name</span>:string, <span class="arg_name">default</span>:..., [<span class="arg_name">short_desc</span>:string], [<span class="arg_name">long_desc</span>:string] ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Adds a setting to the list of Clink settings and includes it in <code>clink set</code>.  The new setting is named <span class="arg">name</span> and has a default value <span class="arg">default</span> when the setting isn't explicitly set.</p><p class="desc"> The type of <span class="arg">default</span> determines what kind of setting is added: <ul> <li>Boolean; a boolean value adds a boolean setting. <li>Integer; an integer value adds an integer setting. <li>Enum; a table adds an enum setting.  The table defines the accepted string values, and the first value is the default value.  The setting has an integer value which corresponds to the position in the table of accepted values.  The first position is 0, the second position is 1, etc. <li>String; a string value adds a string setting. <li>Color; when <span class="arg">name</span> begins with <code>"color."</code> then a string value adds a color setting. </ul></p><p class="desc"> <span class="arg">name</span> can't be more than 32 characters.</p><p class="desc"> <span class="arg">short_desc</span> is an optional quick summary description and can't be more than 48 characters.</p><p class="desc"> <span class="arg">long_desc</span> is an optional long description.</p><pre class="language-lua"><code>settings.add("myscript.myabc", true, "Boolean setting")
+
+<div class="function"><div class="header"> <div id="rl.setvariable" class="name"><a class="wlink" href="#rl.setvariable"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.setvariable</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">name</span>:string, <span class="arg_name">value</span>:string ) : boolean<br/><div class="version">v1.1.46 and newer</div></div></div><div class="body"><p class="desc">Temporarily overrides the named Readline configuration variable to the specified value.  The return value reports whether it was successful, or is nil if the variable name is not recognized.</p><p class="desc"> <strong>Note:</strong> This does not write the value into a config file. Instead it updates the variable in memory, temporarily overriding whatever is present in any config files.  When config files are reloaded, they may replace the value again.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl.translatekey" class="name"><a class="wlink" href="#rl.translatekey"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl.translatekey</span> <span class="uplinks"><a href="#rl">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">input</span>:string, <span class="arg_name">form</span>:integer ) : string | nil<br/><div class="version">v1.6.1 and newer</div></div></div><div class="body"><p class="desc">Translates <span class="arg">input</span> to another format, according to the value of <span class="arg">form</span>: format.</p><p class="desc"> <ul> <li><code>1</code> converts from an input key sequence (as returned by <a href="#console.readinput">console.readinput</a>) to a friendly key name. <li><code>2</code> converts from an input key sequence (as returned by <a href="#console.readinput">console.readinput</a>) to a bindable key sequence string suitable for use with <a href="#rl.setkeybinding">rl.setkeybinding</a>. <li><code>3</code> converts from a key binding sequence (as understood by <a href="#readline-key-bindings">Readline key bindings</a>) to a friendly key name. <li><code>4</code> converts from a key binding sequence (as understood by <a href="#readline-key-bindings">Readline key bindings</a>) to an input key sequence. </ul></p><p class="desc"> If the input key sequence string cannot be translated then nil is returned.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="rl_buffer" class="group_name"><a class="wlink" href="#rl_buffer"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>rl_buffer: <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#rl_buffer:beginoutput">beginoutput</a></td><td><a href="#rl_buffer:getargument">getargument</a></td><td><a href="#rl_buffer:refreshline">refreshline</a></td></tr><tr><td><a href="#rl_buffer:beginundogroup">beginundogroup</a></td><td><a href="#rl_buffer:getbuffer">getbuffer</a></td><td><a href="#rl_buffer:remove">remove</a></td></tr><tr><td><a href="#rl_buffer:ding">ding</a></td><td><a href="#rl_buffer:getcursor">getcursor</a></td><td><a href="#rl_buffer:setargument">setargument</a></td></tr><tr><td><a href="#rl_buffer:endundogroup">endundogroup</a></td><td><a href="#rl_buffer:getlength">getlength</a></td><td><a href="#rl_buffer:setcursor">setcursor</a></td></tr><tr><td><a href="#rl_buffer:getanchor">getanchor</a></td><td><a href="#rl_buffer:insert">insert</a></td></tr></table>
+<div class="function"><div class="header"> <div id="rl_buffer:beginoutput" class="name"><a class="wlink" href="#rl_buffer:beginoutput"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:beginoutput</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Advances the output cursor to the next line after the Readline input buffer so that subsequent output doesn't overwrite the input buffer display.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:beginundogroup" class="name"><a class="wlink" href="#rl_buffer:beginundogroup"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:beginundogroup</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Starts a new undo group.  This is useful for grouping together multiple editing actions into a single undo operation.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:ding" class="name"><a class="wlink" href="#rl_buffer:ding"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:ding</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Dings the bell.  If the <code><a href="#configbellstyle">bell-style</a></code> Readline variable is <code>visible</code> then it flashes the cursor instead.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:endundogroup" class="name"><a class="wlink" href="#rl_buffer:endundogroup"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:endundogroup</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Ends an undo group.  This is useful for grouping together multiple editing actions into a single undo operation.</p><p class="desc"> Note:  all undo groups are automatically ended when a key binding finishes execution, so this function is only needed if a key binding needs to create more than one undo group.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:getanchor" class="name"><a class="wlink" href="#rl_buffer:getanchor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:getanchor</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer | nil<br/><div class="version">v1.2.35 and newer</div></div></div><div class="body"><p class="desc">Returns the anchor position of the currently selected text in the input line, or nil if there is no selection.  The value can be from 1 to rl_buffer:getlength() + 1.  It can exceed the length of the input line because the anchor can be positioned just past the end of the input line.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:getargument" class="name"><a class="wlink" href="#rl_buffer:getargument"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:getargument</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer | nil<br/><div class="version">v1.2.22 and newer</div></div></div><div class="body"><p class="desc">Returns any accumulated numeric argument (<kbd>Alt</kbd>+Digits, etc), or nil if no numeric argument has been entered.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:getbuffer" class="name"><a class="wlink" href="#rl_buffer:getbuffer"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:getbuffer</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the current input line.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:getcursor" class="name"><a class="wlink" href="#rl_buffer:getcursor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:getcursor</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the cursor position in the input line.  The value can be from 1 to rl_buffer:getlength() + 1.  It can exceed the length of the input line because the cursor can be positioned just past the end of the input line.</p><p class="desc"> <strong>Note:</strong> In v1.1.20 through v1.2.31 this accidentally returned 1 less than the actual cursor position.  In v1.2.32 and higher it returns the correct cursor position.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:getlength" class="name"><a class="wlink" href="#rl_buffer:getlength"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:getlength</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns the length of the input line.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:insert" class="name"><a class="wlink" href="#rl_buffer:insert"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:insert</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string ) : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Inserts <span class="arg">text</span> at the cursor position in the input line.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:refreshline" class="name"><a class="wlink" href="#rl_buffer:refreshline"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:refreshline</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil<br/><div class="version">v1.1.41 and newer</div></div></div><div class="body"><p class="desc">Redraws the input line.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:remove" class="name"><a class="wlink" href="#rl_buffer:remove"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:remove</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">from</span>:integer, <span class="arg_name">to</span>:integer ) : nil<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Removes text from the input line starting at cursor position <span class="arg">from</span> up to but not including <span class="arg">to</span>.</p><p class="desc"> If <span class="arg">from</span> is greater than <span class="arg">to</span> then the positions are swapped before removing text.</p><p class="desc"> Note:  the input line is UTF8, and removing only part of a multi-byte Unicode character may have undesirable results.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:setargument" class="name"><a class="wlink" href="#rl_buffer:setargument"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:setargument</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">argument</span>:integer | nil ) : nil<br/><div class="version">v1.2.32 and newer</div></div></div><div class="body"><p class="desc">When <span class="arg">argument</span> is a number, it is set as the numeric argument for use by Readline commands (as entered using <kbd>Alt</kbd>+Digits, etc).  When <span class="arg">argument</span> is nil, the numeric argument is cleared (having no numeric argument is different from having 0 as the numeric argument).</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_buffer:setcursor" class="name"><a class="wlink" href="#rl_buffer:setcursor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_buffer:setcursor</span> <span class="uplinks"><a href="#rl_buffer">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">cursor</span>:integer ) : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Sets the cursor position in the input line and returns the previous cursor position.  <span class="arg">cursor</span> can be from 1 to rl_buffer:getlength() + 1.  It can exceed the length of the input line because the cursor can be positioned just past the end of the input line.</p><p class="desc"> Note:  the input line is UTF8, and setting the cursor position inside a multi-byte Unicode character may have undesirable results.</p><p class="desc"> <strong>Note:</strong> In v1.1.20 through v1.6.0 this accidentally didn't return the previous cursor position.  In v1.6.1 and higher it returns the the correct previous cursor position.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="settings" class="group_name"><a class="wlink" href="#settings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>settings. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#settings.add">add</a></td></tr><tr><td><a href="#settings.get">get</a></td></tr><tr><td><a href="#settings.set">set</a></td></tr></table>
+<div class="function"><div class="header"> <div id="settings.add" class="name"><a class="wlink" href="#settings.add"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>settings.add</span> <span class="uplinks"><a href="#settings">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">name</span>:string, <span class="arg_name">default</span>:..., [<span class="arg_name">short_desc</span>:string], [<span class="arg_name">long_desc</span>:string] ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Adds a setting to the list of Clink settings and includes it in <code>clink set</code>.  The new setting is named <span class="arg">name</span> and has a default value <span class="arg">default</span> when the setting isn't explicitly set.</p><p class="desc"> The type of <span class="arg">default</span> determines what kind of setting is added: <ul> <li>Boolean; a boolean value adds a boolean setting. <li>Integer; an integer value adds an integer setting. <li>Enum; a table adds an enum setting.  The table defines the accepted string values, and the first value is the default value.  The setting has an integer value which corresponds to the position in the table of accepted values.  The first position is 0, the second position is 1, etc. <li>String; a string value adds a string setting. <li>Color; when <span class="arg">name</span> begins with <code>"color."</code> then a string value adds a color setting. </ul></p><p class="desc"> <span class="arg">name</span> can't be more than 32 characters.</p><p class="desc"> <span class="arg">short_desc</span> is an optional quick summary description and can't be more than 48 characters.</p><p class="desc"> <span class="arg">long_desc</span> is an optional long description.</p><pre class="language-lua"><code>settings.add("myscript.myabc", true, "Boolean setting")
 settings.add("myscript.mydef", 100, "Number setting")
 settings.add("myscript.myghi", "abc", "String setting")
 settings.add("myscript.myjkl", {"x","y","z"}, "Enum setting")
 settings.add("color.mymno", "bright magenta", "Color setting")</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#settings.get"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="settings.get">settings.get</a></div> <div class="signature">( <span class="arg_name">name</span>:string, [<span class="arg_name">descriptive</span>:boolean] ) : boolean | string | integer | nil<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the current value of the <span class="arg">name</span> Clink setting or nil if the setting does not exist.</p><p class="desc"> The return type corresponds to the setting type: <ul> <li>Boolean settings return a boolean value. <li>Integer settings return an integer value. <li>Enum settings return an integer value corresponding to a position in the setting's table of accepted values.  The first position is 0, the second position is 1, etc. <li>String settings return a string. <li>Color settings return a string. </ul></p><p class="desc"> Color settings normally return the ANSI color code, suitable for use in an ANSI escape sequence.  If the optional <span class="arg">descriptive</span> parameter is true then the friendly color name is returned.</p><pre class="language-lua"><code>print(settings.get("color.doskey"))         -- Can print "1;36"
+
+<div class="function"><div class="header"> <div id="settings.get" class="name"><a class="wlink" href="#settings.get"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>settings.get</span> <span class="uplinks"><a href="#settings">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">name</span>:string, [<span class="arg_name">descriptive</span>:boolean] ) : boolean | string | integer | nil<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns the current value of the <span class="arg">name</span> Clink setting or nil if the setting does not exist.</p><p class="desc"> The return type corresponds to the setting type: <ul> <li>Boolean settings return a boolean value. <li>Integer settings return an integer value. <li>Enum settings return an integer value corresponding to a position in the setting's table of accepted values.  The first position is 0, the second position is 1, etc. <li>String settings return a string. <li>Color settings return a string. </ul></p><p class="desc"> Color settings normally return the ANSI color code, suitable for use in an ANSI escape sequence.  If the optional <span class="arg">descriptive</span> parameter is true then the friendly color name is returned.</p><pre class="language-lua"><code>print(settings.get("color.doskey"))         -- Can print "1;36"
 print(settings.get("color.doskey", true))   -- Can print "bold cyan"</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#settings.set"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="settings.set">settings.set</a></div> <div class="signature">( <span class="arg_name">name</span>:string, <span class="arg_name">value</span>:... ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Sets the <span class="arg">name</span> Clink setting to <span class="arg">value</span> and returns whether it was successful.</p><p class="desc"> The type of <span class="arg">value</span> depends on the type of the setting.  Some automatic type conversions are performed when appropriate.</p><p class="desc"> <ul> <li>Boolean settings convert string values <code>"true"</code>/<code>"false"</code>, <code>"yes"</code>/<code>"no"</code>, and <code>"on"</code>/<code>"off"</code> into a boolean <code>true</code>/<code>false</code>.  Any numeric values are converted to <code>true</code>, even <code>0</code> (Lua considers 0 to be true, unlike some other languages). <li>Integer settings convert string values starting with a digit or minus sign into an integer value. <li>Enum settings convert the allowed string values into an integer value corresponding to the position in the table of allowed values.  The first position is 0, the second position is 1, etc. <li>String settings convert boolean or number values into a corresponding string value. <li>Color settings convert boolean or number values into a corresponding string value. </ul></p><p class="desc"> Note: Beginning in Clink v1.2.31 this updates the settings file.  Prior to that, it was necessary to separately use <code>clink set</code> to update the settings file.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#string"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="string">string</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#string.comparematches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="string.comparematches">string.comparematches</a></div> <div class="signature">( <span class="arg_name">a</span>:string, [<span class="arg_name">a_type</span>:string], <span class="arg_name">b</span>:string, [<span class="arg_name">b_type</span>:string] ) : boolean<br/><div class="version">v1.3.41 and newer</div></div></div><div class="body"><p class="desc">Returns true if <span class="arg">a</code> sorts as "less than" <span class="arg">b</code>.</p><p class="desc"> The <span class="arg">a_type</code> and <span class="arg">b_type</code> are optional, and affect the sort order accordingly when present.</p><p class="desc"> This produces the same sort order as normally used for displaying matches. This can be used for manually sorting a subset of matches when a match builder has been told not to sort the list of matches.</p><pre class="language-lua"><code>local files = {
+
+<div class="function"><div class="header"> <div id="settings.set" class="name"><a class="wlink" href="#settings.set"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>settings.set</span> <span class="uplinks"><a href="#settings">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">name</span>:string, <span class="arg_name">value</span>:... ) : boolean<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Sets the <span class="arg">name</span> Clink setting to <span class="arg">value</span> and returns whether it was successful.</p><p class="desc"> The type of <span class="arg">value</span> depends on the type of the setting.  Some automatic type conversions are performed when appropriate.</p><p class="desc"> <ul> <li>Boolean settings convert string values <code>"true"</code>/<code>"false"</code>, <code>"yes"</code>/<code>"no"</code>, and <code>"on"</code>/<code>"off"</code> into a boolean <code>true</code>/<code>false</code>.  Any numeric values are converted to <code>true</code>, even <code>0</code> (Lua considers 0 to be true, unlike some other languages). <li>Integer settings convert string values starting with a digit or minus sign into an integer value. <li>Enum settings convert the allowed string values into an integer value corresponding to the position in the table of allowed values.  The first position is 0, the second position is 1, etc. <li>String settings convert boolean or number values into a corresponding string value. <li>Color settings convert boolean or number values into a corresponding string value. </ul></p><p class="desc"> Note: Beginning in Clink v1.2.31 this updates the settings file.  Prior to that, it was necessary to separately use <code>clink set</code> to update the settings file.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="string" class="group_name"><a class="wlink" href="#string"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>string. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#string.comparematches">comparematches</a></td></tr><tr><td><a href="#string.equalsi">equalsi</a></td></tr><tr><td><a href="#string.explode">explode</a></td></tr><tr><td><a href="#string.hash">hash</a></td></tr><tr><td><a href="#string.matchlen">matchlen</a></td></tr></table>
+<div class="function"><div class="header"> <div id="string.comparematches" class="name"><a class="wlink" href="#string.comparematches"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>string.comparematches</span> <span class="uplinks"><a href="#string">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">a</span>:string, [<span class="arg_name">a_type</span>:string], <span class="arg_name">b</span>:string, [<span class="arg_name">b_type</span>:string] ) : boolean<br/><div class="version">v1.3.41 and newer</div></div></div><div class="body"><p class="desc">Returns true if <span class="arg">a</code> sorts as "less than" <span class="arg">b</code>.</p><p class="desc"> The <span class="arg">a_type</code> and <span class="arg">b_type</code> are optional, and affect the sort order accordingly when present.</p><p class="desc"> This produces the same sort order as normally used for displaying matches. This can be used for manually sorting a subset of matches when a match builder has been told not to sort the list of matches.</p><pre class="language-lua"><code>local files = {
 &nbsp;   { match="xyzFile", type="file" },
 &nbsp;   { match="abcFile", type="file" },
 }
@@ -7294,15 +7775,25 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 
 -- The overall sort order ends up listing all the files in sorted
 -- order, followed by branches and tags sorted together.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#string.equalsi"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="string.equalsi">string.equalsi</a></div> <div class="signature">( <span class="arg_name">a</span>:string, <span class="arg_name">b</span>:string ) : boolean<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Performs a case insensitive comparison of the strings with international linguistic awareness.  This is more efficient than converting both strings to lowercase and comparing the results.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#string.explode"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="string.explode">string.explode</a></div> <div class="signature">( <span class="arg_name">text</span>:string, [<span class="arg_name">delims</span>:string], [<span class="arg_name">quote_pair</span>:string] ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Splits <span class="arg">text</span> delimited by <span class="arg">delims</span> (or by spaces if not provided) and returns a table containing the substrings.</p><p class="desc"> The optional <span class="arg">quote_pair</span> can provide a beginning quote character and an ending quote character.  If only one character is provided it is used as both a beginning and ending quote character.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#string.hash"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="string.hash">string.hash</a></div> <div class="signature">( <span class="arg_name">text</span>:string ) : integer<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns a hash of the input <span class="arg">text</span>.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#string.matchlen"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="string.matchlen">string.matchlen</a></div> <div class="signature">( <span class="arg_name">a</span>:string, <span class="arg_name">b</span>:string ) : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns how many characters match at the beginning of the strings, or -1 if the entire strings match.  This respects the <code><a href="#match_ignore_case">match.ignore_case</a></code> and <code><a href="#match_ignore_accent">match.ignore_accent</a></code> Clink settings.</p><pre class="language-lua"><code>string.matchlen("abx", "a")         -- returns 1
+
+<div class="function"><div class="header"> <div id="string.equalsi" class="name"><a class="wlink" href="#string.equalsi"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>string.equalsi</span> <span class="uplinks"><a href="#string">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">a</span>:string, <span class="arg_name">b</span>:string ) : boolean<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Performs a case insensitive comparison of the strings with international linguistic awareness.  This is more efficient than converting both strings to lowercase and comparing the results.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="string.explode" class="name"><a class="wlink" href="#string.explode"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>string.explode</span> <span class="uplinks"><a href="#string">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string, [<span class="arg_name">delims</span>:string], [<span class="arg_name">quote_pair</span>:string] ) : table<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Splits <span class="arg">text</span> delimited by <span class="arg">delims</span> (or by spaces if not provided) and returns a table containing the substrings.</p><p class="desc"> The optional <span class="arg">quote_pair</span> can provide a beginning quote character and an ending quote character.  If only one character is provided it is used as both a beginning and ending quote character.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="string.hash" class="name"><a class="wlink" href="#string.hash"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>string.hash</span> <span class="uplinks"><a href="#string">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string ) : integer<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Returns a hash of the input <span class="arg">text</span>.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="string.matchlen" class="name"><a class="wlink" href="#string.matchlen"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>string.matchlen</span> <span class="uplinks"><a href="#string">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">a</span>:string, <span class="arg_name">b</span>:string ) : integer<br/><div class="version">v1.1.20 and newer</div></div></div><div class="body"><p class="desc">Returns how many characters match at the beginning of the strings, or -1 if the entire strings match.  This respects the <code><a href="#match_ignore_case">match.ignore_case</a></code> and <code><a href="#match_ignore_accent">match.ignore_accent</a></code> Clink settings.</p><pre class="language-lua"><code>string.matchlen("abx", "a")         -- returns 1
 string.matchlen("abx", "aby")       -- returns 2
 string.matchlen("abx", "abx")       -- returns -1</code></pre></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#unicode"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="unicode">unicode</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#unicode.fromcodepage"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="unicode.fromcodepage">unicode.fromcodepage</a></div> <div class="signature">( <span class="arg_name">text</span>:string, [<span class="arg_name">codepage</span>:integer] ) : string | nil<br/><div class="version">v1.3.27 and newer</div></div></div><div class="body"><p class="desc">This converts <span class="arg">text</span> from the <span class="arg">codepage</span> encoding to UTF8.</p><p class="desc"> When <span class="arg">codepage</span> is omitted, the current Active Code Page is used.</p><p class="desc"> If the text cannot be converted, nil is returned.</p><p class="desc"> <strong>Note:</strong>  Clink uses UTF8 internally, and conversion to/from other encodings is intended for use with file input/output or network input/output.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#unicode.isnormalized"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="unicode.isnormalized">unicode.isnormalized</a></div> <div class="signature">( <span class="arg_name">form</span>:integer, <span class="arg_name">text</span>:string ) : boolean [, integer]<br/><div class="version">v1.3.26 and newer</div></div></div><div class="body"><p class="desc">Returns whether <span class="arg">text</span> is already normalized according to the Unicode normalization <span class="arg">form</span>:</p><p class="desc"> <ul> <li><code>1</code> is Unicode normalization form C, canonical composition. Transforms each base character + combining characters into the precomposed equivalent.  For example, A + umlaut becomes Ä. <li><code>2</code> is Unicode normalization form D, canonical decomposition. Transforms each precomposed character into base character + combining characters.  For example, Ä becomes A + umlaut. <li><code>3</code> is Unicode normalization form KC, compatibility composition.  Transforms each base character + combining characters into the precomposed equivalent, and transforms compatibility characters into their equivalents.  For example, A + umlaut + ligature for "fi" becomes Ä + f + i. <li><code>4</code> is Unicode normalization form KD, compatibility decomposition.  Transforms each precomposed character into base character + combining characters, and transforms compatibility characters to their equivalents.  For example, Ä + ligature for "fi" becomes A + umlaut + f + i. </ul></p><p class="desc"> If successful, true or false is returned.</p><p class="desc"> If unsuccessful, false and an error code are returned.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#unicode.iter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="unicode.iter">unicode.iter</a></div> <div class="signature">( <span class="arg_name">text</span>:string ) : iterator<br/><div class="version">v1.3.26 and newer</div></div></div><div class="body"><p class="desc">This returns an iterator function which steps through <span class="arg">text</span> one Unicode codepoint at a time.  Each call to the iterator function returns the string for the next codepoint, the numeric value of the codepoint, and a boolean indicating whether the codepoint is a combining mark.</p><pre class="language-lua"><code>-- UTF8 sample string:
+
+</div><div class="group">
+<h5 id="unicode" class="group_name"><a class="wlink" href="#unicode"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>unicode. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#unicode.fromcodepage">fromcodepage</a></td></tr><tr><td><a href="#unicode.isnormalized">isnormalized</a></td></tr><tr><td><a href="#unicode.iter">iter</a></td></tr><tr><td><a href="#unicode.normalize">normalize</a></td></tr><tr><td><a href="#unicode.tocodepage">tocodepage</a></td></tr></table>
+<div class="function"><div class="header"> <div id="unicode.fromcodepage" class="name"><a class="wlink" href="#unicode.fromcodepage"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>unicode.fromcodepage</span> <span class="uplinks"><a href="#unicode">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string, [<span class="arg_name">codepage</span>:integer] ) : string | nil<br/><div class="version">v1.3.27 and newer</div></div></div><div class="body"><p class="desc">This converts <span class="arg">text</span> from the <span class="arg">codepage</span> encoding to UTF8.</p><p class="desc"> When <span class="arg">codepage</span> is omitted, the current Active Code Page is used.</p><p class="desc"> If the text cannot be converted, nil is returned.</p><p class="desc"> <strong>Note:</strong>  Clink uses UTF8 internally, and conversion to/from other encodings is intended for use with file input/output or network input/output.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="unicode.isnormalized" class="name"><a class="wlink" href="#unicode.isnormalized"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>unicode.isnormalized</span> <span class="uplinks"><a href="#unicode">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">form</span>:integer, <span class="arg_name">text</span>:string ) : boolean [, integer]<br/><div class="version">v1.3.26 and newer</div></div></div><div class="body"><p class="desc">Returns whether <span class="arg">text</span> is already normalized according to the Unicode normalization <span class="arg">form</span>:</p><p class="desc"> <ul> <li><code>1</code> is Unicode normalization form C, canonical composition. Transforms each base character + combining characters into the precomposed equivalent.  For example, A + umlaut becomes Ä. <li><code>2</code> is Unicode normalization form D, canonical decomposition. Transforms each precomposed character into base character + combining characters.  For example, Ä becomes A + umlaut. <li><code>3</code> is Unicode normalization form KC, compatibility composition.  Transforms each base character + combining characters into the precomposed equivalent, and transforms compatibility characters into their equivalents.  For example, A + umlaut + ligature for "fi" becomes Ä + f + i. <li><code>4</code> is Unicode normalization form KD, compatibility decomposition.  Transforms each precomposed character into base character + combining characters, and transforms compatibility characters to their equivalents.  For example, Ä + ligature for "fi" becomes A + umlaut + f + i. </ul></p><p class="desc"> If successful, true or false is returned.</p><p class="desc"> If unsuccessful, false and an error code are returned.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="unicode.iter" class="name"><a class="wlink" href="#unicode.iter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>unicode.iter</span> <span class="uplinks"><a href="#unicode">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string ) : iterator<br/><div class="version">v1.3.26 and newer</div></div></div><div class="body"><p class="desc">This returns an iterator function which steps through <span class="arg">text</span> one Unicode codepoint at a time.  Each call to the iterator function returns the string for the next codepoint, the numeric value of the codepoint, and a boolean indicating whether the codepoint is a combining mark.</p><pre class="language-lua"><code>-- UTF8 sample string:
 -- Index by codepoint:   1       2       3           4       5
 -- Unicode character:    à       é       ᴆ           õ       û
 local text            = "\xc3\xa0\xc3\xa9\xe1\xb4\x86\xc3\xb5\xc3\xbb"
@@ -7324,20 +7815,45 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 --      ᴆ       7430    false   \xe1\xb4\x86
 --      õ       245     false   \xc3\xb5
 --      û       373     false   \xc3\xbb</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#unicode.normalize"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="unicode.normalize">unicode.normalize</a></div> <div class="signature">( <span class="arg_name">form</span>:integer, <span class="arg_name">text</span>:string ) : string [, integer]<br/><div class="version">v1.3.26 and newer</div></div></div><div class="body"><p class="desc">Transforms the <span class="arg">text</span> according to the Unicode normalization <span class="arg">form</span>:</p><p class="desc"> <ul> <li><code>1</code> is Unicode normalization form C, canonical composition. Transforms each base character + combining characters into the precomposed equivalent.  For example, A + umlaut becomes Ä. <li><code>2</code> is Unicode normalization form D, canonical decomposition. Transforms each precomposed character into base character + combining characters.  For example, Ä becomes A + umlaut. <li><code>3</code> is Unicode normalization form KC, compatibility composition.  Transforms each base character + combining characters into the precomposed equivalent, and transforms compatibility characters into their equivalents.  For example, A + umlaut + ligature for "fi" becomes Ä + f + i. <li><code>4</code> is Unicode normalization form KD, compatibility decomposition.  Transforms each precomposed character into base character + combining characters, and transforms compatibility characters to their equivalents.  For example, Ä + ligature for "fi" becomes A + umlaut + f + i. </ul></p><p class="desc"> If successful, the resulting string is returned.</p><p class="desc"> If unsuccessful, both the original string and an error code are returned.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#unicode.tocodepage"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="unicode.tocodepage">unicode.tocodepage</a></div> <div class="signature">( <span class="arg_name">text</span>:string, [<span class="arg_name">codepage</span>:integer] ) : string | nil<br/><div class="version">v1.3.27 and newer</div></div></div><div class="body"><p class="desc">This converts <span class="arg">text</span> from UTF8 to the <span class="arg">codepage</span> encoding.</p><p class="desc"> When <span class="arg">codepage</span> is omitted, the current Active Code Page is used.</p><p class="desc"> If the text cannot be converted, nil is returned.</p><p class="desc"> <strong>Note:</strong>  Clink uses UTF8 internally, and conversion to/from other encodings is intended for use with file input/output or network input/output.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#word_classifications"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="word_classifications">word_classifications</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#word_classifications:applycolor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="word_classifications:applycolor">word_classifications:applycolor</a></div> <div class="signature">( <span class="arg_name">start</span>:integer, <span class="arg_name">length</span>:integer, <span class="arg_name">color</span>:string, [<span class="arg_name">overwrite</span>:boolean] ) : nil<br/><div class="version">v1.1.49 and newer</div></div></div><div class="body"><p class="desc">Applies an ANSI <a href="https://en.wikipedia.org/wiki/ANSI_escape_code#SGR">SGR escape code</a> to some characters in the input line.</p><p class="desc"> <span class="arg">start</span> is where to begin applying the SGR code.</p><p class="desc"> <span class="arg">length</span> is the number of characters to affect.</p><p class="desc"> <span class="arg">color</span> is the SGR parameters sequence to apply (for example <code>"7"</code> is the code for reverse video, which swaps the foreground and background colors).</p><p class="desc"> By default the color is applied to the characters even if some of them are already colored.  But if <span class="arg">overwrite</span> is <code>false</code> each character is only colored if it hasn't been yet.</p><p class="desc"> See <a href="#classifywords">Coloring the Input Text</a> for more information.</p><p class="desc"> Note: an input line can have up to 100 different unique color strings applied, and then this stops applying new colors.  The counter gets reset when the onbeginedit event is sent.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#word_classifications:classifyword"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="word_classifications:classifyword">word_classifications:classifyword</a></div> <div class="signature">( <span class="arg_name">word_index</span>:integer, <span class="arg_name">word_class</span>:string, [<span class="arg_name">overwrite</span>:boolean] ) : nil<br/><div class="version">v1.1.18 and newer</div></div></div><div class="body"><p class="desc">This classifies the indicated word so that it can be colored appropriately.</p><p class="desc"> The <span class="arg">word_class</span> is one of the following codes:</p><p class="desc"> <table> <tr><th>Code</th><th>Classification</th><th>Clink Color Setting</th></tr> <tr><td><code>"a"</code></td><td>Argument; used for words that match a list of preset argument matches.</td><td><code><a href="#color_arg">color.arg</a></code> or <code><a href="#color_input">color.input</a></code></td></tr> <tr><td><code>"c"</code></td><td>Shell command; used for CMD command names.</td><td><code><a href="#color_cmd">color.cmd</a></code></td></tr> <tr><td><code>"d"</code></td><td>Doskey alias.</td><td><code><a href="#color_doskey">color.doskey</a></code></td></tr> <tr><td><code>"f"</code></td><td>Flag; used for flags that match a list of preset flag matches.</td><td><code><a href="#color_flag">color.flag</a></code></td></tr> <tr><td><code>"x"</code></td><td>Executable; used for the first word when it is not a command or doskey alias, but is an executable name that exists.</td><td><code><a href="#color_executable">color.executable</a></code></td></tr> <tr><td><code>"u"</code></td><td>Unrecognized; used for the first word when it is not a command, doskey alias, or recognized executable name.</td><td><code><a href="#color_unrecognized">color.unrecognized</a></code></td></tr> <tr><td><code>"o"</code></td><td>Other; used for file names and words that don't fit any of the other classifications.</td><td><code><a href="#color_input">color.input</a></code></td></tr> <tr><td><code>"n"</code></td><td>None; used for words that aren't recognized as part of the expected input syntax.</td><td><code><a href="#color_unexpected">color.unexpected</a></code></td></tr> <tr><td><code>"m"</code></td><td>Prefix that can be combined with another code (for the first word) to indicate the command has an argmatcher (e.g. <code>"mc"</code> or <code>"md"</code>).</td><td><code><a href="#color_argmatcher">color.argmatcher</a></code> or the other code's color</td></tr> </table></p><p class="desc"> By default the classification is applied to the word even if the word has already been classified.  But if <span class="arg">overwrite</span> is <code>false</code> the word is only classified if it hasn't been yet.</p><p class="desc"> See <a href="#classifywords">Coloring the Input Text</a> for more information.</p></div></div><hr/>
-</div><div class="group"><h5 class="group_name"><a class="wlink" href="#[other]"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="[other]">[other]</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#pause"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="pause">pause</a></div> <div class="signature">( [<span class="arg_name">message</span>:string], [<span class="arg_name">lines</span>:integer], [<span class="arg_name">force</span>:boolean] ) : nil<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Breaks into the Lua debugger, if the <code><a href="#lua_debug">lua.debug</a></code> setting is enabled.</p><p class="desc"> If <code>pause()</code> is used by itself, the debugger breaks on the line after the pause call.</p><p class="desc"> The <span class="arg">message</span> argument can be a message the debugger will display, for example to differentiate between multiple pause calls.</p><p class="desc"> The <span class="arg">lines</span> argument indicates how many lines to step further before breaking into the debugger.  The default is nil, which breaks on the line immediately following the pause call.  Passing an integer value will step some number of lines before breaking (this will produce confusing results and is discouraged).</p><p class="desc"> When the <span class="arg">force</span> argument is <code>true</code> then it will break into the debugger even if the <code>poff</code> debugger command has been used to turn off the pause command.</p></div></div><hr/>
-</div><div class="group deprecated"><h5 class="group_name"><a class="wlink" href="#Deprecated"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="Deprecated">Deprecated</a></h5><div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:add_arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:add_arguments">_argmatcher:add_arguments</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#_argmatcher:addarg">_argmatcher:addarg</a> for more information.</p><p class="desc">Adds one argument slot per table passed to it (as v0.4.9 did).</p><p class="desc"> <strong>Note:</strong> v1.3.10 and lower <code>:add_arguments()</code> mistakenly added all arguments into the first argument slot.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:add_flags"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:add_flags">_argmatcher:add_flags</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#_argmatcher:addflags">_argmatcher:addflags</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:be_precise"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:be_precise">_argmatcher:be_precise</a></div> <div class="signature">() : self</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:disable_file_matching"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:disable_file_matching">_argmatcher:disable_file_matching</a></div> <div class="signature">() : self</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#_argmatcher:nofiles">_argmatcher:nofiles</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:set_arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:set_arguments">_argmatcher:set_arguments</a></div> <div class="signature">( <span class="arg_name">choices...</span>:string|table ) : self</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#_argmatcher:addarg">_argmatcher:addarg</a> for more information.</p><p class="desc">Sets one argument slot per table passed to it (as v0.4.9 did).</p><p class="desc"> <strong>Note:</strong> v1.3.10 and lower <code>:add_arguments()</code> mistakenly set all arguments into the first argument slot.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#_argmatcher:set_flags"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="_argmatcher:set_flags">_argmatcher:set_flags</a></div> <div class="signature">( <span class="arg_name">flags...</span>:string ) : self</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#_argmatcher:addflags">_argmatcher:addflags</a> for more information.</p><p class="desc"><strong>Note:</strong>  The new API has no way to remove flags that were previously added, so converting from <code>:set_flags()</code> to <code>:addflags()</code> may require the calling script to reorganize how and when it adds flags.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.add_match"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.add_match">clink.add_match</a></div> <div class="signature">( <span class="arg_name">match</span>:string ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#builder:addmatch">builder:addmatch</a> for more information.</p><p class="desc">This is a shim that lets clink.register_match_generator continue to work for now, despite being obsolete.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.addcoroutine"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.addcoroutine">clink.addcoroutine</a></div> <div class="signature">( <span class="arg_name">coroutine</span>:coroutine, [<span class="arg_name">interval</span>:number] ) : nil<br/><div class="version">v1.2.10 and newer</div></div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.setcoroutineinterval">clink.setcoroutineinterval</a> for more information.</p><p class="desc">Prior to v1.3.1 this was undocumented, and coroutines had to be manually added in order to be scheduled for resume while waiting for input.  Starting in v1.3.1 this is no longer necessary, but it can still be used to override the interval at which to resume the coroutine.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.arg.new_parser"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.arg.new_parser">clink.arg.new_parser</a></div> <div class="signature">( ... ) : table</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.argmatcher">clink.argmatcher</a> for more information.</p><p class="desc">Creates a new parser and adds <span class="arg">...</span> to it.</p><pre class="language-lua"><code>-- Deprecated form:
+
+<div class="function"><div class="header"> <div id="unicode.normalize" class="name"><a class="wlink" href="#unicode.normalize"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>unicode.normalize</span> <span class="uplinks"><a href="#unicode">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">form</span>:integer, <span class="arg_name">text</span>:string ) : string [, integer]<br/><div class="version">v1.3.26 and newer</div></div></div><div class="body"><p class="desc">Transforms the <span class="arg">text</span> according to the Unicode normalization <span class="arg">form</span>:</p><p class="desc"> <ul> <li><code>1</code> is Unicode normalization form C, canonical composition. Transforms each base character + combining characters into the precomposed equivalent.  For example, A + umlaut becomes Ä. <li><code>2</code> is Unicode normalization form D, canonical decomposition. Transforms each precomposed character into base character + combining characters.  For example, Ä becomes A + umlaut. <li><code>3</code> is Unicode normalization form KC, compatibility composition.  Transforms each base character + combining characters into the precomposed equivalent, and transforms compatibility characters into their equivalents.  For example, A + umlaut + ligature for "fi" becomes Ä + f + i. <li><code>4</code> is Unicode normalization form KD, compatibility decomposition.  Transforms each precomposed character into base character + combining characters, and transforms compatibility characters to their equivalents.  For example, Ä + ligature for "fi" becomes A + umlaut + f + i. </ul></p><p class="desc"> If successful, the resulting string is returned.</p><p class="desc"> If unsuccessful, both the original string and an error code are returned.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="unicode.tocodepage" class="name"><a class="wlink" href="#unicode.tocodepage"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>unicode.tocodepage</span> <span class="uplinks"><a href="#unicode">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string, [<span class="arg_name">codepage</span>:integer] ) : string | nil<br/><div class="version">v1.3.27 and newer</div></div></div><div class="body"><p class="desc">This converts <span class="arg">text</span> from UTF8 to the <span class="arg">codepage</span> encoding.</p><p class="desc"> When <span class="arg">codepage</span> is omitted, the current Active Code Page is used.</p><p class="desc"> If the text cannot be converted, nil is returned.</p><p class="desc"> <strong>Note:</strong>  Clink uses UTF8 internally, and conversion to/from other encodings is intended for use with file input/output or network input/output.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="word_classifications" class="group_name"><a class="wlink" href="#word_classifications"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>word_classifications: <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#word_classifications:applycolor">applycolor</a></td></tr><tr><td><a href="#word_classifications:classifyword">classifyword</a></td></tr></table>
+<div class="function"><div class="header"> <div id="word_classifications:applycolor" class="name"><a class="wlink" href="#word_classifications:applycolor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>word_classifications:applycolor</span> <span class="uplinks"><a href="#word_classifications">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">start</span>:integer, <span class="arg_name">length</span>:integer, <span class="arg_name">color</span>:string, [<span class="arg_name">overwrite</span>:boolean] ) : nil<br/><div class="version">v1.1.49 and newer</div></div></div><div class="body"><p class="desc">Applies an ANSI <a href="https://en.wikipedia.org/wiki/ANSI_escape_code#SGR">SGR escape code</a> to some characters in the input line.</p><p class="desc"> <span class="arg">start</span> is where to begin applying the SGR code.</p><p class="desc"> <span class="arg">length</span> is the number of characters to affect.</p><p class="desc"> <span class="arg">color</span> is the SGR parameters sequence to apply (for example <code>"7"</code> is the code for reverse video, which swaps the foreground and background colors).</p><p class="desc"> By default the color is applied to the characters even if some of them are already colored.  But if <span class="arg">overwrite</span> is <code>false</code> each character is only colored if it hasn't been yet.</p><p class="desc"> See <a href="#classifywords">Coloring the Input Text</a> for more information.</p><p class="desc"> Note: an input line can have up to 100 different unique color strings applied, and then this stops applying new colors.  The counter gets reset when the onbeginedit event is sent.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="word_classifications:classifyword" class="name"><a class="wlink" href="#word_classifications:classifyword"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>word_classifications:classifyword</span> <span class="uplinks"><a href="#word_classifications">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">word_index</span>:integer, <span class="arg_name">word_class</span>:string, [<span class="arg_name">overwrite</span>:boolean] ) : nil<br/><div class="version">v1.1.18 and newer</div></div></div><div class="body"><p class="desc">This classifies the indicated word so that it can be colored appropriately.</p><p class="desc"> The <span class="arg">word_class</span> is one of the following codes:</p><p class="desc"> <table> <tr><th>Code</th><th>Classification</th><th>Clink Color Setting</th></tr> <tr><td><code>"a"</code></td><td>Argument; used for words that match a list of preset argument matches.</td><td><code><a href="#color_arg">color.arg</a></code> or <code><a href="#color_input">color.input</a></code></td></tr> <tr><td><code>"c"</code></td><td>Shell command; used for CMD command names.</td><td><code><a href="#color_cmd">color.cmd</a></code></td></tr> <tr><td><code>"d"</code></td><td>Doskey alias.</td><td><code><a href="#color_doskey">color.doskey</a></code></td></tr> <tr><td><code>"f"</code></td><td>Flag; used for flags that match a list of preset flag matches.</td><td><code><a href="#color_flag">color.flag</a></code></td></tr> <tr><td><code>"x"</code></td><td>Executable; used for the first word when it is not a command or doskey alias, but is an executable name that exists.</td><td><code><a href="#color_executable">color.executable</a></code></td></tr> <tr><td><code>"u"</code></td><td>Unrecognized; used for the first word when it is not a command, doskey alias, or recognized executable name.</td><td><code><a href="#color_unrecognized">color.unrecognized</a></code></td></tr> <tr><td><code>"o"</code></td><td>Other; used for file names and words that don't fit any of the other classifications.</td><td><code><a href="#color_input">color.input</a></code></td></tr> <tr><td><code>"n"</code></td><td>None; used for words that aren't recognized as part of the expected input syntax.</td><td><code><a href="#color_unexpected">color.unexpected</a></code></td></tr> <tr><td><code>"m"</code></td><td>Prefix that can be combined with another code (for the first word) to indicate the command has an argmatcher (e.g. <code>"mc"</code> or <code>"md"</code>).</td><td><code><a href="#color_argmatcher">color.argmatcher</a></code> or the other code's color</td></tr> </table></p><p class="desc"> By default the classification is applied to the word even if the word has already been classified.  But if <span class="arg">overwrite</span> is <code>false</code> the word is only classified if it hasn't been yet.</p><p class="desc"> See <a href="#classifywords">Coloring the Input Text</a> for more information.</p></div></div><hr/>
+
+</div><div class="group">
+<h5 id="[other]" class="group_name"><a class="wlink" href="#[other]"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>[other] <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#CLINK_EXE">CLINK_EXE</a></td></tr><tr><td><a href="#pause">pause</a></td></tr></table>
+<div class="function"><div class="header"> <div id="CLINK_EXE" class="name"><a class="wlink" href="#CLINK_EXE"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>CLINK_EXE</span> <span class="uplinks"><a href="#[other]">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">string variable<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">The full path to the Clink executable file.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="pause" class="name"><a class="wlink" href="#pause"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>pause</span> <span class="uplinks"><a href="#[other]">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">message</span>:string], [<span class="arg_name">lines</span>:integer], [<span class="arg_name">force</span>:boolean] ) : nil<br/><div class="version">v1.0.0 and newer</div></div></div><div class="body"><p class="desc">Breaks into the Lua debugger, if the <code><a href="#lua_debug">lua.debug</a></code> setting is enabled.</p><p class="desc"> If <code>pause()</code> is used by itself, the debugger breaks on the line after the pause call.</p><p class="desc"> The <span class="arg">message</span> argument can be a message the debugger will display, for example to differentiate between multiple pause calls.</p><p class="desc"> The <span class="arg">lines</span> argument indicates how many lines to step further before breaking into the debugger.  The default is nil, which breaks on the line immediately following the pause call.  Passing an integer value will step some number of lines before breaking (this will produce confusing results and is discouraged).</p><p class="desc"> When the <span class="arg">force</span> argument is <code>true</code> then it will break into the debugger even if the <code>poff</code> debugger command has been used to turn off the pause command.</p></div></div><hr/>
+
+</div><div class="group deprecated">
+<h5 id="Deprecated" class="group_name"><a class="wlink" href="#Deprecated"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Deprecated. <span class="uplinks"><a href="#lua-api-groups">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></h5>
+<table class="grouplist"><tr><td><a href="#_argmatcher:add_arguments">add_arguments</a></td><td><a href="#clink.compute_lcd">compute_lcd</a></td><td><a href="#clink.get_screen_info">get_screen_info</a></td><td><a href="#clink.matches_are_files">matches_are_files</a></td></tr><tr><td><a href="#_argmatcher:add_flags">add_flags</a></td><td><a href="#clink.find_dirs">find_dirs</a></td><td><a href="#clink.get_setting_int">get_setting_int</a></td><td><a href="#clink.prompt.register_filter">register_filter</a></td></tr><tr><td><a href="#_argmatcher:be_precise">be_precise</a></td><td><a href="#clink.find_files">find_files</a></td><td><a href="#clink.get_setting_str">get_setting_str</a></td><td><a href="#clink.quote_split">quote_split</a></td></tr><tr><td><a href="#_argmatcher:disable_file_matching">disable_file_matching</a></td><td><a href="#clink.get_console_aliases">get_console_aliases</a></td><td><a href="#clink.is_dir">is_dir</a></td><td><a href="#clink.register_match_generator">register_match_generator</a></td></tr><tr><td><a href="#_argmatcher:set_arguments">set_arguments</a></td><td><a href="#clink.get_cwd">get_cwd</a></td><td><a href="#clink.is_match">is_match</a></td><td><a href="#clink.set_match">set_match</a></td></tr><tr><td><a href="#_argmatcher:set_flags">set_flags</a></td><td><a href="#clink.get_cwd">get_cwd</a></td><td><a href="#clink.is_rl_variable_true">is_rl_variable_true</a></td><td><a href="#clink.slash_translation">slash_translation</a></td></tr><tr><td><a href="#clink.add_match">add_match</a></td><td><a href="#clink.get_env">get_env</a></td><td><a href="#clink.is_single_match">is_single_match</a></td><td><a href="#clink.split">split</a></td></tr><tr><td><a href="#clink.addcoroutine">addcoroutine</a></td><td><a href="#clink.get_env_var_names">get_env_var_names</a></td><td><a href="#clink.match_count">match_count</a></td><td><a href="#clink.suppress_char_append">suppress_char_append</a></td></tr><tr><td><a href="#clink.arg.new_parser">new_parser</a></td><td><a href="#clink.get_host_process">get_host_process</a></td><td><a href="#clink.match_display_filter">match_display_filter</a></td><td><a href="#clink.suppress_quoting">suppress_quoting</a></td></tr><tr><td><a href="#clink.arg.register_parser">register_parser</a></td><td><a href="#clink.get_match">get_match</a></td><td><a href="#clink.match_files">match_files</a></td><td><a href="#os.ishidden">ishidden</a></td></tr><tr><td><a href="#clink.chdir">chdir</a></td><td><a href="#clink.get_rl_variable">get_rl_variable</a></td><td><a href="#clink.match_words">match_words</a></td><td><a href="#rl_state">rl_state</a></td></tr></table>
+<div class="function"><div class="header"> <div id="_argmatcher:add_arguments" class="name"><a class="wlink" href="#_argmatcher:add_arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:add_arguments</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#_argmatcher:addarg">_argmatcher:addarg</a> for more information.</p><p class="desc">Adds one argument slot per table passed to it (as v0.4.9 did).</p><p class="desc"> <strong>Note:</strong> v1.3.10 and lower <code>:add_arguments()</code> mistakenly added all arguments into the first argument slot.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:add_flags" class="name"><a class="wlink" href="#_argmatcher:add_flags"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:add_flags</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#_argmatcher:addflags">_argmatcher:addflags</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:be_precise" class="name"><a class="wlink" href="#_argmatcher:be_precise"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:be_precise</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : self</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:disable_file_matching" class="name"><a class="wlink" href="#_argmatcher:disable_file_matching"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:disable_file_matching</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : self</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#_argmatcher:nofiles">_argmatcher:nofiles</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:set_arguments" class="name"><a class="wlink" href="#_argmatcher:set_arguments"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:set_arguments</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">choices...</span>:string|table ) : self</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#_argmatcher:addarg">_argmatcher:addarg</a> for more information.</p><p class="desc">Sets one argument slot per table passed to it (as v0.4.9 did).</p><p class="desc"> <strong>Note:</strong> v1.3.10 and lower <code>:add_arguments()</code> mistakenly set all arguments into the first argument slot.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="_argmatcher:set_flags" class="name"><a class="wlink" href="#_argmatcher:set_flags"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>_argmatcher:set_flags</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">flags...</span>:string ) : self</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#_argmatcher:addflags">_argmatcher:addflags</a> for more information.</p><p class="desc"><strong>Note:</strong>  The new API has no way to remove flags that were previously added, so converting from <code>:set_flags()</code> to <code>:addflags()</code> may require the calling script to reorganize how and when it adds flags.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.add_match" class="name"><a class="wlink" href="#clink.add_match"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.add_match</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">match</span>:string ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#builder:addmatch">builder:addmatch</a> for more information.</p><p class="desc">This is a shim that lets clink.register_match_generator continue to work for now, despite being obsolete.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.addcoroutine" class="name"><a class="wlink" href="#clink.addcoroutine"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.addcoroutine</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">coroutine</span>:coroutine, [<span class="arg_name">interval</span>:number] ) : nil<br/><div class="version">v1.2.10 and newer</div></div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.setcoroutineinterval">clink.setcoroutineinterval</a> for more information.</p><p class="desc">Prior to v1.3.1 this was undocumented, and coroutines had to be manually added in order to be scheduled for resume while waiting for input.  Starting in v1.3.1 this is no longer necessary, but it can still be used to override the interval at which to resume the coroutine.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.arg.new_parser" class="name"><a class="wlink" href="#clink.arg.new_parser"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.arg.new_parser</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( ... ) : table</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.argmatcher">clink.argmatcher</a> for more information.</p><p class="desc">Creates a new parser and adds <span class="arg">...</span> to it.</p><pre class="language-lua"><code>-- Deprecated form:
 local parser = clink.arg.new_parser(
 &nbsp; { "abc", "def" },       -- arg position 1
 &nbsp; { "ghi", "jkl" },       -- arg position 2
@@ -7349,7 +7865,8 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 :addarg("abc", "def")               -- arg position 1
 :addarg("ghi", "jkl")               -- arg position 2
 :addflags("--flag1", "--flag2")     -- flags</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.arg.register_parser"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.arg.register_parser">clink.arg.register_parser</a></div> <div class="signature">( <span class="arg_name">cmd</span>:string, <span class="arg_name">parser</span>:table ) : table</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.argmatcher">clink.argmatcher</a> for more information.</p><p class="desc">Adds <span class="arg">parser</span> to the argmatcher for <span class="arg">cmd</span>.</p><p class="desc"> If there is already an argmatcher for <span class="arg">cmd</span> then the two argmatchers are merged.  It is only a simple merge; a more sophisticated merge would be much slower and use much more memory.  The simple merge should be sufficient for common simple cases.</p><p class="desc"> <strong>Note:</strong> In v1.3.11, merging parsers should be a bit improved compared to how v0.4.9 merging worked.  In v1.0 through v1.3.10, merging parsers doesn't work very well.</p><pre class="language-lua"><code>-- Deprecated form:
+
+<div class="function"><div class="header"> <div id="clink.arg.register_parser" class="name"><a class="wlink" href="#clink.arg.register_parser"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.arg.register_parser</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">cmd</span>:string, <span class="arg_name">parser</span>:table ) : table</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.argmatcher">clink.argmatcher</a> for more information.</p><p class="desc">Adds <span class="arg">parser</span> to the argmatcher for <span class="arg">cmd</span>.</p><p class="desc"> If there is already an argmatcher for <span class="arg">cmd</span> then the two argmatchers are merged.  It is only a simple merge; a more sophisticated merge would be much slower and use much more memory.  The simple merge should be sufficient for common simple cases.</p><p class="desc"> <strong>Note:</strong> In v1.3.11, merging parsers should be a bit improved compared to how v0.4.9 merging worked.  In v1.0 through v1.3.10, merging parsers doesn't work very well.</p><pre class="language-lua"><code>-- Deprecated form:
 local parser1 = clink.arg.new_parser():set_arguments({ "abc", "def" }, { "old_second" })
 local parser2 = clink.arg.new_parser():set_arguments({ "ghi", "jkl" }, { "new_second" })
 clink.arg.register_parser("foo", parser1)
@@ -7363,31 +7880,56 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 clink.argmatcher("foo"):addarg(parser2)
 -- In v1.3.11 and higher this syntax ends up with all 4 first argument strings
 -- having both "old_second" and "new_second" as a second argument.</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.chdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.chdir">clink.chdir</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.chdir">os.chdir</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.compute_lcd"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.compute_lcd">clink.compute_lcd</a></div> <div class="signature">( <span class="arg_name">text</span>:string, <span class="arg_name">matches</span>:table ) : string</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">This is no longer supported, and always returns an empty string.</p><p class="desc"> Returning an empty string works because in Clink v1.x and higher match generators are no longer responsible for filtering matches.  The match pipeline itself handles that internally now.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.find_dirs"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.find_dirs">clink.find_dirs</a></div> <div class="signature">( <span class="arg_name">mask</span>:string, [<span class="arg_name">case_map</span>:boolean] ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.globdirs">os.globdirs</a> for more information.</p><p class="desc">The <span class="arg">case_map</span> argument is ignored, because match generators are no longer responsible for filtering matches.  The match pipeline itself handles that internally now.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.find_files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.find_files">clink.find_files</a></div> <div class="signature">( <span class="arg_name">mask</span>:string, [<span class="arg_name">case_map</span>:boolean] ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.globfiles">os.globfiles</a> for more information.</p><p class="desc">The <span class="arg">case_map</span> argument is ignored, because match generators are no longer responsible for filtering matches.  The match pipeline itself handles that internally now.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_console_aliases"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_console_aliases">clink.get_console_aliases</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getaliases">os.getaliases</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_cwd"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_cwd">clink.get_cwd</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getcwd">os.getcwd</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_cwd"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_cwd">clink.get_cwd</a></div> <div class="signature">() : string</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getcwd">os.getcwd</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_env"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_env">clink.get_env</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getenv">os.getenv</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_env_var_names"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_env_var_names">clink.get_env_var_names</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getenvnames">os.getenvnames</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_host_process"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_host_process">clink.get_host_process</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">Always returns "clink"; this corresponds to the "clink" word in the <code>$if clink</code> directives in Readline's .inputrc file.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_match"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_match">clink.get_match</a></div> <div class="signature">( <span class="arg_name">index</span>:integer ) : string</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">This is no longer supported, and always returns an empty string.  If a script needs to access matches it added, the script should keep track of the matches itself.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_rl_variable"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_rl_variable">clink.get_rl_variable</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#rl.getvariable">rl.getvariable</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_screen_info"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_screen_info">clink.get_screen_info</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getscreeninfo">os.getscreeninfo</a> for more information.</p><p class="desc"><strong>Note:</strong> The field names are different between <code>os.getscreeninfo()</code> and the v0.4.9 implementation of <code>clink.get_screen_info</code>.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_setting_int"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_setting_int">clink.get_setting_int</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#settings.get">settings.get</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.get_setting_str"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.get_setting_str">clink.get_setting_str</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#settings.get">settings.get</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.is_dir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.is_dir">clink.is_dir</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.isdir">os.isdir</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.is_match"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.is_match">clink.is_match</a></div> <div class="signature">( <span class="arg_name">needle</span>:string, <span class="arg_name">candidate</span>:string ) : boolean</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.generator">clink.generator</a> for more information.</p><p class="desc">This returns true if <span class="arg">needle</span> is a prefix of <span class="arg">candidate</span> with a case insensitive comparison.</p><p class="desc"> Normally in Clink v1.x and higher the <span class="arg">needle</span> will be an empty string because match generators are no longer responsible for filtering matches.  The match pipeline itself handles that internally now.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.is_rl_variable_true"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.is_rl_variable_true">clink.is_rl_variable_true</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#rl.isvariabletrue">rl.isvariabletrue</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.is_single_match"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.is_single_match">clink.is_single_match</a></div> <div class="signature">( <span class="arg_name">matches</span>:table ) : boolean</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">This is no longer supported, and always returns false.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.match_count"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.match_count">clink.match_count</a></div> <div class="signature">() : integer</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">This is no longer supported, and always returns 0.  If a script needs to know how many matches it added, the script should keep track of the count itself.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.match_display_filter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.match_display_filter">clink.match_display_filter</a></div> <div class="signature">function variable</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.ondisplaymatches">clink.ondisplaymatches</a> for more information.</p><p class="desc">A match generator can set this varible to a filter function that is called before displaying matches.  It is reset every time match generation is invoked.  The filter function receives table argument containing the matches that are going to be displayed, and it returns a table filtered as required by the match generator.</p><p class="desc"> See <a href="#filteringthematchdisplay">Filtering the Match Display</a> for more information.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.match_files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.match_files">clink.match_files</a></div> <div class="signature">( <span class="arg_name">pattern</span>:string, [<span class="arg_name">full_path</span>:boolean], [<span class="arg_name">find_func</span>:function] ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.filematches">clink.filematches</a> for more information.</p><p class="desc">Globs files using <span class="arg">pattern</span> and adds results as matches. If <span class="arg">full_path</span> is true then the path from <span class="arg">pattern</span> is prefixed to the results (otherwise only the file names are included). The last argument <span class="arg">find_func</span> is the function to use to do the globbing. If it's unspecified (or nil) Clink falls back to <a href="#clink.find_files">clink.find_files</a>.</p><p class="desc"> <strong>Note:</strong> This exists for backward compatibility but malfunctions with some inputs, in the same ways it did in v0.4.9.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.match_words"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.match_words">clink.match_words</a></div> <div class="signature">( <span class="arg_name">text</span>:string, <span class="arg_name">words</span>:table ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#builder:addmatches">builder:addmatches</a> for more information.</p><p class="desc">This adds words that match the text.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.matches_are_files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.matches_are_files">clink.matches_are_files</a></div> <div class="signature">( [<span class="arg_name">files</span>:boolean] ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#builder:addmatch">builder:addmatch</a> for more information.</p><p class="desc">This is only needed when using deprecated APIs.  It's automatically inferred from the match types when using the current APIs.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.prompt.register_filter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.prompt.register_filter">clink.prompt.register_filter</a></div> <div class="signature">( <span class="arg_name">filter_func</span>:function, [<span class="arg_name">priority</span>:integer] ) : table</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.promptfilter">clink.promptfilter</a> for more information.</p><p class="desc">Registers a prompt filter function.  The capabilities are the same as before but the syntax is changed.</p><pre class="language-lua"><code>-- Deprecated form:
+
+<div class="function"><div class="header"> <div id="clink.chdir" class="name"><a class="wlink" href="#clink.chdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.chdir</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.chdir">os.chdir</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.compute_lcd" class="name"><a class="wlink" href="#clink.compute_lcd"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.compute_lcd</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string, <span class="arg_name">matches</span>:table ) : string</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">This is no longer supported, and always returns an empty string.</p><p class="desc"> Returning an empty string works because in Clink v1.x and higher match generators are no longer responsible for filtering matches.  The match pipeline itself handles that internally now.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.find_dirs" class="name"><a class="wlink" href="#clink.find_dirs"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.find_dirs</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">mask</span>:string, [<span class="arg_name">case_map</span>:boolean] ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.globdirs">os.globdirs</a> for more information.</p><p class="desc">The <span class="arg">case_map</span> argument is ignored, because match generators are no longer responsible for filtering matches.  The match pipeline itself handles that internally now.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.find_files" class="name"><a class="wlink" href="#clink.find_files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.find_files</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">mask</span>:string, [<span class="arg_name">case_map</span>:boolean] ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.globfiles">os.globfiles</a> for more information.</p><p class="desc">The <span class="arg">case_map</span> argument is ignored, because match generators are no longer responsible for filtering matches.  The match pipeline itself handles that internally now.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_console_aliases" class="name"><a class="wlink" href="#clink.get_console_aliases"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_console_aliases</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getaliases">os.getaliases</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_cwd" class="name"><a class="wlink" href="#clink.get_cwd"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_cwd</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getcwd">os.getcwd</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_cwd" class="name"><a class="wlink" href="#clink.get_cwd"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_cwd</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getcwd">os.getcwd</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_env" class="name"><a class="wlink" href="#clink.get_env"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_env</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getenv">os.getenv</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_env_var_names" class="name"><a class="wlink" href="#clink.get_env_var_names"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_env_var_names</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getenvnames">os.getenvnames</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_host_process" class="name"><a class="wlink" href="#clink.get_host_process"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_host_process</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">Always returns "clink"; this corresponds to the "clink" word in the <code>$if clink</code> directives in Readline's .inputrc file.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_match" class="name"><a class="wlink" href="#clink.get_match"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_match</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">index</span>:integer ) : string</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">This is no longer supported, and always returns an empty string.  If a script needs to access matches it added, the script should keep track of the matches itself.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_rl_variable" class="name"><a class="wlink" href="#clink.get_rl_variable"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_rl_variable</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#rl.getvariable">rl.getvariable</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_screen_info" class="name"><a class="wlink" href="#clink.get_screen_info"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_screen_info</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.getscreeninfo">os.getscreeninfo</a> for more information.</p><p class="desc"><strong>Note:</strong> The field names are different between <code>os.getscreeninfo()</code> and the v0.4.9 implementation of <code>clink.get_screen_info</code>.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_setting_int" class="name"><a class="wlink" href="#clink.get_setting_int"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_setting_int</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#settings.get">settings.get</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.get_setting_str" class="name"><a class="wlink" href="#clink.get_setting_str"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.get_setting_str</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#settings.get">settings.get</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.is_dir" class="name"><a class="wlink" href="#clink.is_dir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.is_dir</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.isdir">os.isdir</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.is_match" class="name"><a class="wlink" href="#clink.is_match"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.is_match</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">needle</span>:string, <span class="arg_name">candidate</span>:string ) : boolean</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.generator">clink.generator</a> for more information.</p><p class="desc">This returns true if <span class="arg">needle</span> is a prefix of <span class="arg">candidate</span> with a case insensitive comparison.</p><p class="desc"> Normally in Clink v1.x and higher the <span class="arg">needle</span> will be an empty string because match generators are no longer responsible for filtering matches.  The match pipeline itself handles that internally now.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.is_rl_variable_true" class="name"><a class="wlink" href="#clink.is_rl_variable_true"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.is_rl_variable_true</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#rl.isvariabletrue">rl.isvariabletrue</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.is_single_match" class="name"><a class="wlink" href="#clink.is_single_match"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.is_single_match</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">matches</span>:table ) : boolean</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">This is no longer supported, and always returns false.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.match_count" class="name"><a class="wlink" href="#clink.match_count"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.match_count</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : integer</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">This is no longer supported, and always returns 0.  If a script needs to know how many matches it added, the script should keep track of the count itself.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.match_display_filter" class="name"><a class="wlink" href="#clink.match_display_filter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.match_display_filter</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">function variable</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.ondisplaymatches">clink.ondisplaymatches</a> for more information.</p><p class="desc">A match generator can set this varible to a filter function that is called before displaying matches.  It is reset every time match generation is invoked.  The filter function receives table argument containing the matches that are going to be displayed, and it returns a table filtered as required by the match generator.</p><p class="desc"> See <a href="#filteringthematchdisplay">Filtering the Match Display</a> for more information.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.match_files" class="name"><a class="wlink" href="#clink.match_files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.match_files</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">pattern</span>:string, [<span class="arg_name">full_path</span>:boolean], [<span class="arg_name">find_func</span>:function] ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.filematches">clink.filematches</a> for more information.</p><p class="desc">Globs files using <span class="arg">pattern</span> and adds results as matches. If <span class="arg">full_path</span> is true then the path from <span class="arg">pattern</span> is prefixed to the results (otherwise only the file names are included). The last argument <span class="arg">find_func</span> is the function to use to do the globbing. If it's unspecified (or nil) Clink falls back to <a href="#clink.find_files">clink.find_files</a>.</p><p class="desc"> <strong>Note:</strong> This exists for backward compatibility but malfunctions with some inputs, in the same ways it did in v0.4.9.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.match_words" class="name"><a class="wlink" href="#clink.match_words"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.match_words</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">text</span>:string, <span class="arg_name">words</span>:table ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#builder:addmatches">builder:addmatches</a> for more information.</p><p class="desc">This adds words that match the text.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.matches_are_files" class="name"><a class="wlink" href="#clink.matches_are_files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.matches_are_files</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">files</span>:boolean] ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#builder:addmatch">builder:addmatch</a> for more information.</p><p class="desc">This is only needed when using deprecated APIs.  It's automatically inferred from the match types when using the current APIs.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.prompt.register_filter" class="name"><a class="wlink" href="#clink.prompt.register_filter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.prompt.register_filter</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">filter_func</span>:function, [<span class="arg_name">priority</span>:integer] ) : table</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.promptfilter">clink.promptfilter</a> for more information.</p><p class="desc">Registers a prompt filter function.  The capabilities are the same as before but the syntax is changed.</p><pre class="language-lua"><code>-- Deprecated form:
 function foo_prompt()
 &nbsp; clink.prompt.value = "FOO "..clink.prompt.value.." >>"
 &nbsp; --return true  -- Returning true stops further filtering.
@@ -7399,8 +7941,10 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 function foo_prompt:filter(prompt)
 &nbsp; return "FOO "..prompt.." >>" --,false  -- Adding ,false stops further filtering.
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.quote_split"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.quote_split">clink.quote_split</a></div> <div class="signature">( <span class="arg_name">str</span>:string, <span class="arg_name">ql</span>:string, <span class="arg_name">qr</span>:string ) : table</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#string.explode">string.explode</a> for more information.</p><p class="desc">This function takes the string <span class="arg">str</span> which is quoted by <span class="arg">ql</span> (the opening quote character) and <span class="arg">qr</span> (the closing character) and splits it into parts as per the quotes. A table of these parts is returned.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.register_match_generator"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.register_match_generator">clink.register_match_generator</a></div> <div class="signature">( <span class="arg_name">func</span>:function, <span class="arg_name">priority</span>:integer ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.generator">clink.generator</a> for more information.</p><p class="desc">Registers a generator function for producing matches.  This behaves similarly to v0.4.8, but not identically.  The Clink schema has changed significantly enough that there is no direct 1:1 translation; generators are called at a different time than before and have access to more information than before.</p><pre class="language-lua"><code>-- Deprecated form:
+
+<div class="function"><div class="header"> <div id="clink.quote_split" class="name"><a class="wlink" href="#clink.quote_split"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.quote_split</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">str</span>:string, <span class="arg_name">ql</span>:string, <span class="arg_name">qr</span>:string ) : table</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#string.explode">string.explode</a> for more information.</p><p class="desc">This function takes the string <span class="arg">str</span> which is quoted by <span class="arg">ql</span> (the opening quote character) and <span class="arg">qr</span> (the closing character) and splits it into parts as per the quotes. A table of these parts is returned.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.register_match_generator" class="name"><a class="wlink" href="#clink.register_match_generator"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.register_match_generator</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">func</span>:function, <span class="arg_name">priority</span>:integer ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.generator">clink.generator</a> for more information.</p><p class="desc">Registers a generator function for producing matches.  This behaves similarly to v0.4.8, but not identically.  The Clink schema has changed significantly enough that there is no direct 1:1 translation; generators are called at a different time than before and have access to more information than before.</p><pre class="language-lua"><code>-- Deprecated form:
 local function match_generator_func(text, first, last)
 &nbsp; -- `text` is the word text.
 &nbsp; -- `first` is the index of the beginning of the end word.
@@ -7417,25 +7961,78 @@ <h3 id="lua-api-groups"><a class="wlink" href="#lua-api-groups"><svg width=16 he
 &nbsp; -- `match_builder:<a href="#builder:addmatch">addmatch</a>()` is used to add matches.
 &nbsp; -- return true if handled, or false to let another generator try.
 end</code></pre></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.set_match"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.set_match">clink.set_match</a></div> <div class="signature">( <span class="arg_name">index</span>:integer, <span class="arg_name">value</span>:string ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">This is no longer supported, and does nothing.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.slash_translation"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.slash_translation">clink.slash_translation</a></div> <div class="signature">( <span class="arg_name">type</span>:integer ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.translateslashes">clink.translateslashes</a> for more information.</p><p class="desc">Controls how Clink will translate the path separating slashes for the current path being completed. Values for <span class="arg">type</span> are; <ul> <li>-1 - no translation</li> <li>0 - to backslashes</li> <li>1 - to forward slashes</li> </ul></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.split"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.split">clink.split</a></div> <div class="signature">( <span class="arg_name">str</span>:string, <span class="arg_name">sep</span>:string ) : table</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#string.explode">string.explode</a> for more information.</p><p class="desc">Splits the string <span class="arg">str</span> into pieces separated by <span class="arg">sep</span>, returning a table of the pieces.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.suppress_char_append"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.suppress_char_append">clink.suppress_char_append</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#builder:setsuppressappend">builder:setsuppressappend</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#clink.suppress_quoting"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink.suppress_quoting">clink.suppress_quoting</a></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#builder:setsuppressquoting">builder:setsuppressquoting</a> for more information.</p><p class="desc"></p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#os.ishidden"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="os.ishidden">os.ishidden</a></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.globfiles">os.globfiles</a> for more information.</p><p class="desc">Returns whether <span class="arg">path</span> has the hidden attribute set.</p></div></div><hr/>
-<div class="function"><div class="header"> <div class="name"><a class="wlink" href="#rl_state"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="rl_state">rl_state</a></div> <div class="signature">table variable</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#line_state">line_state</a> for more information.</p><p class="desc">This is an obsolete global variable that was set while running match generators.  It has been superseded by the <a href="#line_state">line_state</a> type parameter passed into match generator functions when using the new <a href="#clink.generator">clink.generator()</a> API.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.set_match" class="name"><a class="wlink" href="#clink.set_match"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.set_match</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">index</span>:integer, <span class="arg_name">value</span>:string ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong></p><p class="desc">This is no longer supported, and does nothing.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.slash_translation" class="name"><a class="wlink" href="#clink.slash_translation"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.slash_translation</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">type</span>:integer ) : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#clink.translateslashes">clink.translateslashes</a> for more information.</p><p class="desc">Controls how Clink will translate the path separating slashes for the current path being completed. Values for <span class="arg">type</span> are; <ul> <li>-1 - no translation</li> <li>0 - to backslashes</li> <li>1 - to forward slashes</li> </ul></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.split" class="name"><a class="wlink" href="#clink.split"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.split</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">str</span>:string, <span class="arg_name">sep</span>:string ) : table</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#string.explode">string.explode</a> for more information.</p><p class="desc">Splits the string <span class="arg">str</span> into pieces separated by <span class="arg">sep</span>, returning a table of the pieces.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.suppress_char_append" class="name"><a class="wlink" href="#clink.suppress_char_append"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.suppress_char_append</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#builder:setsuppressappend">builder:setsuppressappend</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.suppress_quoting" class="name"><a class="wlink" href="#clink.suppress_quoting"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.suppress_quoting</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : nil</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#builder:setsuppressquoting">builder:setsuppressquoting</a> for more information.</p><p class="desc"></p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="os.ishidden" class="name"><a class="wlink" href="#os.ishidden"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.ishidden</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( <span class="arg_name">path</span>:string ) : boolean</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#os.globfiles">os.globfiles</a> for more information.</p><p class="desc">Returns whether <span class="arg">path</span> has the hidden attribute set.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="rl_state" class="name"><a class="wlink" href="#rl_state"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>rl_state</span> <span class="uplinks"><a href="#Deprecated">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">table variable</div></div><div class="body"><p class="desc"><strong>Deprecated; don't use this.</strong> See <a href="#line_state">line_state</a> for more information.</p><p class="desc">This is an obsolete global variable that was set while running match generators.  It has been superseded by the <a href="#line_state">line_state</a> type parameter passed into match generator functions when using the new <a href="#clink.generator">clink.generator()</a> API.</p></div></div><hr/>
+
 </div>
         </div>
         <div class="section" id="changes">
-<h1 id="changes"><a class="wlink" href="#changes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Changes</h1>
-<h3 id="releases-from-chrisant996clink-fork"><a class="wlink" href="#releases-from-chrisant996clink-fork"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Releases from <a href="https://github.com/chrisant996/clink">chrisant996/clink</a> fork</h3>
-<h4 id="v160"><a class="wlink" href="#v160"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.6.0</h4>
+<h1 id="changes"><a class="wlink" href="#changes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Changes <span class="uplinks"><a href="#toc">top</a></span></h1>
+<h3 id="releases-from-chrisant996clink-fork"><a class="wlink" href="#releases-from-chrisant996clink-fork"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Releases from <a href="https://github.com/chrisant996/clink">chrisant996/clink</a> fork <span class="uplinks"><a href="#changes">up</a> <a href="#toc">top</a></span></h3>
+<h4 id="v161"><a class="wlink" href="#v161"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.6.1 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
+<p><strong>Features:</strong></p>
+<ul>
+<li>Improved input line parsing and coloring:<ul>
+<li>Commands starting with <code>@</code> are supported, and completion correctly ignores the <code>@</code>.</li>
+<li>Each of the following CMD syntax errors are recognized:  lines starting with <code>&amp;</code> or <code>@2&gt;</code>, and lines containing <code>&amp; &amp;</code> or <code>2&gt;&amp;file</code>.</li>
+<li>The whole redirections <code>2&gt;file</code> or <code>&gt;file</code> or <code>2&gt;&amp;1</code> are colored instead of only the <code>&gt;</code> or <code>&gt;&amp;</code>.</li>
+</ul>
+</li>
+<li>Completions for <code>clink set</code> color settings include a color sample in the description field (e.g. type <code>clink set color</code><kbd>Alt</kbd>-<kbd>=</kbd> to see the color settings and their current color samples).</li>
+<li>The <code>clink-reload</code> bindable command now reverts key bindings and config variables before reloading the inputrc file, so that old bindings and values don&#39;t linger in the current session if they&#39;ve been removed from the inputrc file.</li>
+<li>Added <code>clink-dump-functions</code> and <code>clink-dump-macros</code> bindable commands.  These behave similar to <code>dump-functions</code> and <code>dump-macros</code>, but they show user-friendly key names and <code>luafunc:</code> macros are listed as functions instead of as macros.</li>
+<li>Added some new &quot;bigword&quot; cursor movement commands for moving to the next or previous space delimited word; <code>clink-backward-bigword</code>, <code>clink-forward-bigword</code>, <code>cua-backward-bigword</code>, <code>cua-forward-bigword</code>.</li>
+<li>Added a new conditional directive <code>$if clink_version</code> in the inputrc file (e.g. <code>$if clink_version &gt;= 1.6.1</code>).</li>
+<li>Added a new <code>prompt.spacing</code> setting which can control blank lines before the prompt (it was a clink-flex-prompt feature which has now been incorporated into Clink itself).</li>
+<li>Added a new <code>match.coloring_rules</code> setting and <code>%CLINK_MATCH_COLORS%</code> environment variable, both of which supersede Readline&#39;s <code>%LS_COLORS%</code> definitions when displaying match completions.</li>
+<li>Internal changes.</li>
+</ul>
+<p><strong>Lua:</strong></p>
+<ul>
+<li>Added <code>line_state:getrangeoffset()</code> and <code>line_state:getrangelength()</code> to get the beginning offset and length of the range in the input line described by the line_state.</li>
+<li>Added <code>console.explodeansi()</code> to split a string into substrings on ANSI escape code boundaries.</li>
+<li>Added <code>rl.getinputrcfilename()</code> to get the loaded inputrc file name.</li>
+<li>Added <code>rl.translatekey()</code> to translate between key sequence formats (input key, key binding, and friendly key name).</li>
+<li>Added <code>rl.bracketpromptcodes()</code> to apply <code>\1</code> and <code>\2</code> codes as needed by Readline in certain inputrc config variables.</li>
+<li>Document the <code>CLINK_EXE</code> global variable which has existed since v1.0.0 but was accidentally undocumented.</li>
+</ul>
+<p><strong>Fixes:</strong></p>
+<ul>
+<li>Removed superfluous <code>;39</code> and/or <code>;49</code> from color setting escape codes in some cases.</li>
+<li>Fixed <code>console.readinput()</code> repeatedly returning nil after <code>console.checkinput()</code> returns true (regression introduced in v1.5.12).</li>
+<li>Fixed loading the <code>default_inputrc</code> file if it exists (introduced in v1.3.5, and it never worked properly until now).</li>
+<li>Fixed the <code>history-size</code> config variable to be completely ignored (it interfered with Clink&#39;s history database and settings, which were meant to supersede it).</li>
+<li>Fixed the <code>clink-popup-show-help</code> command when including unbound commands (numeric argument of 4) so it doesn&#39;t double-list the bound <code>luafunc:</code> macros.</li>
+<li>Fixed updating column text in <code>clink.popuplist()</code> when <kbd>Del</kbd> is pressed (e.g. history timestamps in the <code>clink-popup-history</code> command).</li>
+<li>Fixed the width of <code>clink.popuplist()</code> to take the title into account.</li>
+<li>Fixed Lua argument errors for some objects (the argument # in the error message was one lower than it should have been in some messages).</li>
+<li>Fixed the return value from <code>rl_buffer:setcursor()</code>.</li>
+<li>Fixed <code>console:getnumlines()</code> between onendedit and onbeginedit.</li>
+<li>Fixed erasing the &quot;History expansion for&quot; preview when the transient prompt is enabled.</li>
+<li>Fixed the transient prompt sometimes not erasing properly (regression introduced in v1.5.17).</li>
+<li>Fixed the color of flags for <code>clink set</code> (e.g. <code>--help</code>).</li>
+<li>Fixed the <code>clink-reload</code> command so any inputrc file parse errors are printed on new lines.</li>
+<li>Fixed the <code>lua.break_on_error</code> setting so it works properly in released builds of Clink.</li>
+</ul>
+<h4 id="v160"><a class="wlink" href="#v160"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.6.0 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Updated the Readline library to v8.2 patch 7 (the list here omits changes that were contributed to Readline from Clink, or which do not affect Clink).<ul>
 <li>New features:<ul>
 <li>History expansion better understands multiple history expansions that may contain strings that would ordinarily inhibit history expansion (e.g., <code>abc!$!$</code>).</li>
 <li>There is a new <code>fetch-history</code> bindable command that retrieves the history entry corresponding to its numeric argument. Negative arguments count back from the end of the history.</li>
-<li>There is a new option: <code>enable-active-region</code>. This separates control of the active region and bracketed-paste. It has the same default value as <code>bracketed-paste</code>, and enabling bracketed paste enables the active region. Users can now turn off the active region while leaving bracketed paste enabled.</li>
+<li>There is a new option: <code>enable-active-region</code>. This separates control of the active region and bracketed-paste. It has the same default value as <code>enable-bracketed-paste</code>, and enabling bracketed paste enables the active region. Users can now turn off the active region while leaving bracketed paste enabled. (Note that bracketed paste is currently ignored in Clink.)</li>
 <li>Readline looks in <code>%LS_COLORS%</code> for a custom filename extension (<code>*.readline-colored-completion-prefix</code>) and uses that as the default color for the common prefix displayed when <code>colored-completion-prefix</code> is set, superseding the <code>so</code> type if both are present.</li>
 <li>Two new bindable string variables: <code>active-region-start-color</code> and <code>active-region-end-color</code>. The first sets the color used to display the active region; the second is unused and unnecessary in Clink, but exists anyway for compatibility. If set, these are used in place of terminal standout mode.</li>
 </ul>
@@ -7446,7 +8043,6 @@ <h4 id="v160"><a class="wlink" href="#v160"><svg width=16 height=16><use href="#
 <li>Fixed a bug that could cause readline to crash if the application removed the callback line handler before readline read all typeahead.</li>
 <li>Added additional checks for read errors in the middle of readline commands.</li>
 <li>Fixed a problem with <code>unix-filename-rubout</code> that caused it to delete too much when applied to a pathname consisting only of one or more slashes.</li>
-<li>Fixed a problem that caused the <code>\r</code> output by turning off bracketed paste to overwrite the line if terminal echo was disabled.</li>
 <li>Fixed a couple problems where <code>transpose-words</code> could corrupt the end of the input line.</li>
 <li>Fixed an issue that caused a history line&#39;s undo list to be cleared when it should not have been.</li>
 <li>Fixed leaked memory from undo lists.</li>
@@ -7463,12 +8059,12 @@ <h4 id="v160"><a class="wlink" href="#v160"><svg width=16 height=16><use href="#
 <li>Fixed issue with the <code>autosuggest.hint</code> setting where it could apply incorrect input line coloring when the <kbd>Right</kbd> key isn&#39;t bound to one of the usual commands for that key.</li>
 <li>Internal changes and optimizations.</li>
 </ul>
-<h4 id="v1518"><a class="wlink" href="#v1518"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.18</h4>
+<h4 id="v1518"><a class="wlink" href="#v1518"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.18 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/524">#524</a> and <a href="https://github.com/chrisant996/clink/issues/523">#523</a>; garbled display in wide terminal windows (regression introduced in v1.5.14, which exacerbated and revealed a bug that&#39;s existed since Clink v1.0.0 alpha and which could intermittently garble Unicode text or escape sequences).</li>
 <li>Fixed the transient prompt sometimes not displaying properly (regression introduced in v1.5.17).</li>
 </ul>
-<h4 id="v1517"><a class="wlink" href="#v1517"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.17</h4>
+<h4 id="v1517"><a class="wlink" href="#v1517"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.17 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Reduced flicker when async prompt filtering redraws the prompt.</li>
 <li>When <code>_argmatcher:addarg()</code> or <code>_argmatcher:addflags()</code> is passed a table containing <code>nowordbreakchars="<span class="arg">chars</span>"</code> then the <span class="arg">chars</span> are not treated as word breaks for that argument index or for flags (see <a href="#addarg_nowordbreakchars">Overcoming Word Breaks</a> for more information).</li>
@@ -7478,7 +8074,7 @@ <h4 id="v1517"><a class="wlink" href="#v1517"><svg width=16 height=16><use href=
 <li>Fixed accidentally showing matches in a single column sometimes even when there are no descriptions.</li>
 <li>Fixed an incomplete <code>clink inject</code> if an explicit or implicit <code>endlocal</code> happens after <code>clink inject</code> but before the prompt is shown (the injection didn&#39;t finish successfully until the next time an environment variable was set, but now it finishes immediately).</li>
 </ul>
-<h4 id="v1516"><a class="wlink" href="#v1516"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.16</h4>
+<h4 id="v1516"><a class="wlink" href="#v1516"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.16 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/522">#522</a>; garbled display in JetBrains WebStorm terminal (regression introduced in v1.5.15).<ul>
 <li>Fixing this required reverting the change that automatically chose a default for <code>color.suggestion</code> based on the current console colors.</li>
@@ -7489,7 +8085,7 @@ <h4 id="v1516"><a class="wlink" href="#v1516"><svg width=16 height=16><use href=
 <li>Fixed the word parser to recognize a single digit as a word when followed by punctuation.</li>
 <li>Fixed <code>loopchars</code> for characters like <code>-</code> or <code>*</code> that are also Lua pattern characters.</li>
 </ul>
-<h4 id="v1515"><a class="wlink" href="#v1515"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.15</h4>
+<h4 id="v1515"><a class="wlink" href="#v1515"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.15 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added localized descriptions for flag completions in <code>cmd</code>, <code>cd</code>, and <code>rd</code>.</li>
 <li>Added partial ability to detect light/dark console color themes:<ul>
@@ -7502,7 +8098,7 @@ <h4 id="v1515"><a class="wlink" href="#v1515"><svg width=16 height=16><use href=
 <li>Fixed the upper bound line number for Lua console line API functions.</li>
 <li>Fixed <code>console.getlinetext()</code> when emoji are present.</li>
 </ul>
-<h4 id="v1514"><a class="wlink" href="#v1514"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.14</h4>
+<h4 id="v1514"><a class="wlink" href="#v1514"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.14 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added a visible usage hint for <a href="#gettingstarted_autosuggest">Auto-Suggestions</a> to help make the feature more discoverable and usable.  The usage hint can be hidden by turning off the <code>autosuggest.hint</code> setting.</li>
 <li>Added new callback functions that can be assigned to an argument position in the table given to <code>:addarg()</code> via <code>onadvance=</code> and <code>onlink=</code> (see <a href="#responsive-argmatchers">Responding to Arguments in Argmatchers</a> for more information).</li>
@@ -7512,24 +8108,24 @@ <h4 id="v1514"><a class="wlink" href="#v1514"><svg width=16 height=16><use href=
 <li>Fixed the <code>exec.commands</code> setting with an argmatcher that uses the <code>:chaincommand()</code> function.</li>
 <li>Fixed <code>_argmatcher:setclassifier()</code> so the custom classifier is called for flags as well as for arguments.</li>
 </ul>
-<h4 id="v1513"><a class="wlink" href="#v1513"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.13</h4>
+<h4 id="v1513"><a class="wlink" href="#v1513"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.13 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.onhistory()</code> to register a function to be called when the input line has been accepted and is about to be added to history (and optionally cancel adding it).</li>
 <li>Fixed <code>history delete</code> with a negative number so it indexes backwards from the end, as advertised.</li>
 <li>Fixed calling <code>clink.refilterprompt()</code> from a coroutine, and related fixes to ensure various Lua functions coexist properly with coroutines.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/520">#520</a>; add a link to the Releases page in the updater dialog box.</li>
 </ul>
-<h4 id="v1512"><a class="wlink" href="#v1512"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.12</h4>
+<h4 id="v1512"><a class="wlink" href="#v1512"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.12 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed updating the input line display after using <code>clink-popup-history</code> or <code>win-popup-history</code> (regression introduced in v1.5.3; the fix in v1.5.4 was incomplete).</li>
 <li>Fixed <code>console.checkinput()</code> so it doesn&#39;t eat whatever pending input it detects.</li>
 <li>Fixed the updater to be more specific about what PowerShell cmdlet it invokes, in case a module replaces the built-in <code>Expand-Archive</code> cmdlet.</li>
 </ul>
-<h4 id="v1511"><a class="wlink" href="#v1511"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.11</h4>
+<h4 id="v1511"><a class="wlink" href="#v1511"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.11 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed prompt filters and other Lua coroutines when <code>color.executable</code> and <code>color.unrecognized</code> are both empty (regression introduced in v1.5.10).</li>
 </ul>
-<h4 id="v1510"><a class="wlink" href="#v1510"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.10</h4>
+<h4 id="v1510"><a class="wlink" href="#v1510"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.10 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Changed <code>clink update</code> to consider &quot;up-to-date&quot; as a successful case.</li>
 <li>Fixed a case where the <code>completion</code> auto-suggest strategy could be temporarily prevented from providing a suggestion (regression introduced in v1.4.22).</li>
@@ -7537,18 +8133,18 @@ <h4 id="v1510"><a class="wlink" href="#v1510"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/511">#511</a>; <code>!</code> doesn&#39;t need to be treated as a word break character.</li>
 <li>Internal changes.</li>
 </ul>
-<h4 id="v159"><a class="wlink" href="#v159"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.9</h4>
+<h4 id="v159"><a class="wlink" href="#v159"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.9 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added default key binding <kbd>Alt</kbd>-<kbd>Ctrl</kbd>-<kbd>Up</kbd> for <code>clink-popup-history</code>.</li>
 <li>Fixed the <code>match.max_rows</code> setting to control the number of rows of items (instead of the total number of rows including description rows).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/509">#509</a>; crash when using <code>clink-popup-history</code> if <code>history.time_stamp</code> is <code>off</code> (regression introduced in v1.5.7).</li>
 </ul>
-<h4 id="v158"><a class="wlink" href="#v158"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.8</h4>
+<h4 id="v158"><a class="wlink" href="#v158"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.8 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/504">#504</a>; the <code>clink.autoupdate</code> setting behaves like <code>auto</code> even when it&#39;s set to <code>check</code> (regression introduced in v1.5.5).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/503">#503</a>; the updater could hang if any additional CMD instances were started while the &quot;Clink Update&quot; prompt window was open (regression introduced in v1.5.5).</li>
 </ul>
-<h4 id="v157"><a class="wlink" href="#v157"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.7</h4>
+<h4 id="v157"><a class="wlink" href="#v157"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.7 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added vertical scrollbars in <code>clink-select-complete</code> and in popup lists.</li>
 <li>Added <code>terminal.scrollbars</code> setting which can disable the vertical scrollbars (e.g. according to preference, or if a terminal or font is incompatible with extended Unicode box drawing characters).</li>
@@ -7561,7 +8157,7 @@ <h4 id="v157"><a class="wlink" href="#v157"><svg width=16 height=16><use href="#
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/498">#498</a>; when <code>autosuggest.enable</code> is False, cycling or searching through history and then pressing <kbd>Right</kbd> does nothing (regression introduced in v1.5.4).</li>
 <li>Internal improvements.</li>
 </ul>
-<h4 id="v156"><a class="wlink" href="#v156"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.6</h4>
+<h4 id="v156"><a class="wlink" href="#v156"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.6 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>os.getpushddepth()</code>, which works when <code>%PROMPT%</code> contains exactly one <code>$+</code>.</li>
 <li>The <code>clink-popup-history</code> and <code>win-history-list</code> commands show timestamps when <code>history.time_stamp</code> is set to <code>show</code>.</li>
@@ -7576,7 +8172,7 @@ <h4 id="v156"><a class="wlink" href="#v156"><svg width=16 height=16><use href="#
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/494">#494</a>; Lua error when using <code>unicode.fromcodepage()</code> (reported and fixed before the bug was published).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/493">#493</a>; <code>clink-select-complete</code> displays the selected item incorrectly if both <code>colored-stats</code> and <code>colored-completion-prefix</code> are <code>off</code> (regression introduced in v1.5.5).</li>
 </ul>
-<h4 id="v155"><a class="wlink" href="#v155"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.5</h4>
+<h4 id="v155"><a class="wlink" href="#v155"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.5 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Changed the <code>clink.autoupdate</code> setting to allow <code>off</code>, <code>check</code> (the default), <code>prompt</code>, and <code>auto</code> for more control over how and when updating happens.  When set to <code>prompt</code> or <code>auto</code> Clink can trigger updates automatically, so you don&#39;t need to even run <code>clink update</code>.</li>
 <li>Enhanced <code>debug.log_terminal</code> to include low level console keyboard and mouse input events.</li>
@@ -7586,7 +8182,7 @@ <h4 id="v155"><a class="wlink" href="#v155"><svg width=16 height=16><use href="#
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/486">#486</a>; window title escape code doesn&#39;t work properly if it contains emoji or UTF content.</li>
 <li>Internal changes.</li>
 </ul>
-<h4 id="v154"><a class="wlink" href="#v154"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.4</h4>
+<h4 id="v154"><a class="wlink" href="#v154"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.4 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Further contrast improvements for default colors to be readable in both Dark and Light terminal themes.</li>
 <li>Added <code>arginfo</code> field in <code>builder:addmatches()</code> and in match display filtering.</li>
@@ -7601,7 +8197,7 @@ <h4 id="v154"><a class="wlink" href="#v154"><svg width=16 height=16><use href="#
 <li>Fixed input line coloring after <code>non-incremental-reverse-search-history</code> or <code>non-incremental-forward-search-history</code> finds an exact match for the search text (since v1.1.5).</li>
 <li>Internal changes and optimizations.</li>
 </ul>
-<h4 id="v153"><a class="wlink" href="#v153"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.3</h4>
+<h4 id="v153"><a class="wlink" href="#v153"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.3 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>builder:setfullyqualified()</code> to force completions to be inserted as fully qualified path names.</li>
 <li>Completions for <code>clink set <span class="arg">setting_name</span> <span class="arg">input</span></code> use fully qualified path names for <span class="arg">input</span>.  This helps avoid accidentally setting relative paths in global settings; since the current directory changes frequently, setting relative paths usually leads to unintended consequences.</li>
@@ -7613,7 +8209,7 @@ <h4 id="v153"><a class="wlink" href="#v153"><svg width=16 height=16><use href="#
 <li>Fixed coloring the command word in the command line when queued keys select and accept a command line from history instantly (it could accidentally continue without applying the appropriate coloring).</li>
 <li>Fixed script error in <code>clink.filematches(nil)</code> and <code>clink.dirmatches(nil)</code>; they were meant to behave the same as passing an empty string.</li>
 </ul>
-<h4 id="v152"><a class="wlink" href="#v152"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.2</h4>
+<h4 id="v152"><a class="wlink" href="#v152"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.2 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Adjusted the colors in &quot;Use enhanced defaults&quot; to have sufficient contrast to be readable in both Dark and Light terminal themes.</li>
 <li>More reliably detect whether hosted in Windows Terminal, and even when Windows Terminal is set as the default terminal application.</li>
@@ -7622,13 +8218,13 @@ <h4 id="v152"><a class="wlink" href="#v152"><svg width=16 height=16><use href="#
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/474">#474</a>; pasting is slow in Windows Terminal and ConEmu.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/470">#470</a>; typo in help text.</li>
 </ul>
-<h4 id="v151"><a class="wlink" href="#v151"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.1</h4>
+<h4 id="v151"><a class="wlink" href="#v151"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.1 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>rl.getcommandbindings()</code> to get info about a command, including the key(s) bound to it, if any.</li>
 <li>Changed to also allow <code>clink.popuplist()</code> inside a function registered by <code>clink.onfiltermatches()</code>.</li>
 <li>Changed console input mode handling to more aggressively clear <code>ENABLE_VIRTUAL_TERMINAL_INPUT</code> since it interferes with input (especially <kbd>Ctrl</kbd> key combinations) and some console programs set it but accidentally neglect to clear it when they&#39;re finished.</li>
 </ul>
-<h4 id="v150"><a class="wlink" href="#v150"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.0</h4>
+<h4 id="v150"><a class="wlink" href="#v150"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.5.0 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added code-signing.</li>
 <li>Added note after successful <code>clink update</code> to clarify that the update will take effect in new Clink windows.</li>
@@ -7636,7 +8232,7 @@ <h4 id="v150"><a class="wlink" href="#v150"><svg width=16 height=16><use href="#
 <li>Fixed precedence of match colors; readonly should be lower precedence than executable.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/469">#469</a>; incorrect usage of <code>memset()</code>.</li>
 </ul>
-<h4 id="v1428"><a class="wlink" href="#v1428"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.28</h4>
+<h4 id="v1428"><a class="wlink" href="#v1428"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.28 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>console.getcursorpos()</code> to get the cursor position.</li>
 <li>Updated <code>os.getscreeninfo()</code> to include the cursor position.</li>
@@ -7649,18 +8245,18 @@ <h4 id="v1428"><a class="wlink" href="#v1428"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/467">#467</a>; On-Screen Keyboard in Swedish keyboard layout can&#39;t type <code>\</code>.</li>
 <li>Internal improvements.</li>
 </ul>
-<h4 id="v1427"><a class="wlink" href="#v1427"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.27</h4>
+<h4 id="v1427"><a class="wlink" href="#v1427"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.27 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed when the <code>terminal.emulate</code> setting is <code>auto</code> on Windows 8.1 and earlier (regression introduced in v1.4.26).</li>
 </ul>
-<h4 id="v1426"><a class="wlink" href="#v1426"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.26</h4>
+<h4 id="v1426"><a class="wlink" href="#v1426"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.26 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added built-in support for shell integration with Windows Terminal v1.18 and higher.  <em>Note: Windows Terminal gets confused about the command line text when the transient prompt is enabled.</em></li>
 <li>Changed <code>clink.getansihost()</code> to return two strings; the first string is the mode in use, and the new second string is what Clink detected (and will use when the <code>terminal.emulation</code> setting is <code>auto</code>).</li>
 <li>Fixed to use terminal emulation when the <code>terminal.emulate</code> setting is <code>auto</code> and ANSICON is present.  Clink&#39;s output is no longer able to be intercepted by ANSICON, so bypass it and use Clink&#39;s own terminal emulation.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/461">#461</a>; crash due to invalid RVA in ANSI32.DLL or ANSI64.DLL (ANSICON).</li>
 </ul>
-<h4 id="v1425"><a class="wlink" href="#v1425"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.25</h4>
+<h4 id="v1425"><a class="wlink" href="#v1425"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.25 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Now <code>os.issignaled()</code> works during <code>onendedit</code> and <code>onfilterinput</code> events.</li>
 <li>Improve emulation for <kbd>F7</kbd> history popup (the <code>win-history-popup</code> command); <kbd>Left</kbd> or <kbd>Right</kbd> replace the input text with the selected line.</li>
@@ -7669,7 +8265,7 @@ <h4 id="v1425"><a class="wlink" href="#v1425"><svg width=16 height=16><use href=
 <li>Fixed where the prompt prefix (from v1.4.24) is inserted in the prompt string, so that shell integration escape codes can work properly.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/457">#457</a>; unrecognized OSC escape codes accidentally stripped from prompt string.</li>
 </ul>
-<h4 id="v1424"><a class="wlink" href="#v1424"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.24</h4>
+<h4 id="v1424"><a class="wlink" href="#v1424"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.24 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>path.fnmatch()</code> which behaves like the Linux <code>fnmatch(3)</code> function.</li>
 <li>Added <code>os.globmatch()</code> which performs recursive file pattern globbing <a href="https://git-scm.com/docs/gitignore#_pattern_format">the same as git does</a>.</li>
@@ -7679,43 +8275,43 @@ <h4 id="v1424"><a class="wlink" href="#v1424"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/452">#452</a>; <code>history delete #</code> doesn&#39;t work (regression introduced in v1.1.43).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/448">#448</a>; completion malfunction with <code>..\does_not_exist</code> (regression introduced in v1.4.1).</li>
 </ul>
-<h4 id="v1423"><a class="wlink" href="#v1423"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.23</h4>
+<h4 id="v1423"><a class="wlink" href="#v1423"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.23 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added help message in <code>clink-select-complete</code>: when descriptions are shown below the matches, this adds text to mention that <kbd>F1</kbd> toggles showing descriptions inline with the matches.</li>
 <li>Added <code>clink update --check</code> to only check for an update without installing it.</li>
 </ul>
-<h4 id="v1422"><a class="wlink" href="#v1422"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.22</h4>
+<h4 id="v1422"><a class="wlink" href="#v1422"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.22 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <code>clink-select-complete</code> to use per-match <code>appendchar</code> when present.</li>
 <li>Fixed repetitive unnecessary work in the background when the <code>completion</code> auto-suggest strategy encounters a <code>fromhistory</code> argument slot in an argmatcher.</li>
 <li>Fixed the installer <code>/S</code> flag (silent install) so it returns exit code 0 on success.</li>
 </ul>
-<h4 id="v1421"><a class="wlink" href="#v1421"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.21</h4>
+<h4 id="v1421"><a class="wlink" href="#v1421"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.21 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>The <code>clink-diagnostics</code> command can report merged argmatchers.  When a numeric arg of 2 or greater is given (e.g. <kbd>Alt</kbd>-<kbd>2</kbd>,<kbd>Ctrl</kbd>-<kbd>x</kbd>,<kbd>Ctrl</kbd>-<kbd>z</kbd>) then it includes a list of defined argmatchers.  The list now also reports any merging of argmatchers that occurred.</li>
 <li>Fixed <code>clink update</code> so <code>winget</code> doesn&#39;t get confused about whether an update is available for Clink.  Once <code>winget update clink</code> performs an update, or once a Clink v1.4.21 or greater .exe installer is run, then <code>winget</code> should stop getting confused.</li>
 </ul>
-<h4 id="v1420"><a class="wlink" href="#v1420"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.20</h4>
+<h4 id="v1420"><a class="wlink" href="#v1420"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.20 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <code>os.isfile()</code> and <code>os.isdir()</code> when the specified name contains <code>&lt;</code> or <code>&gt;</code> or <code>&quot;</code>, which are special wildcard characters for MS-DOS compatibility.  This caused an error when typing <code>&quot;&lt;</code>, which then mistakenly thought a completion script named <code>&lt;.lua</code> existed.</li>
 <li>Fixed <code>rl.expandtilde()</code> to omit a trailing backslash when expanding <code>~</code> by itself.  This is to avoid running afoul of the <a href="https://learn.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-commandlinetoargvw"><code>\&quot;</code> parsing rules</a> for <code>argv[]</code> for programs.</li>
 <li>Fixed potential crash when the <code>clink</code> command line takes more bytes as UTF8 than it does as UTF16.</li>
 </ul>
-<h4 id="v1419"><a class="wlink" href="#v1419"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.19</h4>
+<h4 id="v1419"><a class="wlink" href="#v1419"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.19 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>builder:setforcequoting()</code> to force quoting rules to be applied to matches even if they aren&#39;t filenames.  This also reverts &quot;quoting for non-filename completions&quot; in v1.4.13; there isn&#39;t a safe and backward-compatible way to automatically deduce when non-filenames matches need quoting, so a match generator needs to turn it on explicitly when desired.</li>
 </ul>
-<h4 id="v1418"><a class="wlink" href="#v1418"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.18</h4>
+<h4 id="v1418"><a class="wlink" href="#v1418"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.18 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.oninputlinechanged()</code> to register a function to be called whenever the input line is changed.</li>
 </ul>
-<h4 id="v1417"><a class="wlink" href="#v1417"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.17</h4>
+<h4 id="v1417"><a class="wlink" href="#v1417"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.17 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>os.isuseradmin()</code> to get whether CMD is running as an admin account.</li>
 <li>Added <code>os.getfileversion()</code> to get a table with version information if the file contains a Windows version info resource.</li>
 <li>The <code>clink-diagnostics</code> command now reports costs for Lua event callback functions when a numeric arg is given (e.g. <kbd>Alt</kbd>-<kbd>1</kbd>,<kbd>Ctrl</kbd>-<kbd>x</kbd>,<kbd>Ctrl</kbd>-<kbd>z</kbd>) or when the <code>lua.debug</code> setting is enabled.</li>
 </ul>
-<h4 id="v1416"><a class="wlink" href="#v1416"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.16</h4>
+<h4 id="v1416"><a class="wlink" href="#v1416"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.16 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>history.show_preview</code> setting that controls whether to show a preview of history expansions (previously it was inferred by whether <code>color.histexpand</code> was set).</li>
 <li>Added detection for problematic codes in the prompt string.  The <code>clink-diagnostics</code> <kbd>Ctrl</kbd>-<kbd>X</kbd>,<kbd>Ctrl</kbd>-<kbd>Z</kbd> command reports problem codes in the prompt string.  When certain problem codes exist in the prompt string, then Clink compensates by reprinting the entire input line after printing the prompt string.  Ideally, the prompt string should be fixed by the user, but sometimes that&#39;s difficult if the prompt string was generated by a tool.</li>
@@ -7724,7 +8320,7 @@ <h4 id="v1416"><a class="wlink" href="#v1416"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/421">#421</a>; <code>clink.bat</code> errors with quoted arguments (regression introduced in v1.3.47).</li>
 <li>Updated documentation with more cross-referencing links for Clink settings, Readline commands, Readline config variables, and standard Lua APIs.</li>
 </ul>
-<h4 id="v1415"><a class="wlink" href="#v1415"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.15</h4>
+<h4 id="v1415"><a class="wlink" href="#v1415"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.15 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>log.getfile()</code> to get the current log file path.</li>
 <li>Fixed match display to better accommodate escape codes for italics and underline, if present and supported by the terminal.</li>
@@ -7732,11 +8328,11 @@ <h4 id="v1415"><a class="wlink" href="#v1415"><svg width=16 height=16><use href=
 <li>PR <a href="https://github.com/chrisant996/clink/pull/418">#418</a>; Fix crash caused by destruction of non detached threads.</li>
 <li>PR <a href="https://github.com/chrisant996/clink/pull/417">#417</a>; Fix buffer overread caused by usage of strcmp on non null-terminated char arrays.</li>
 </ul>
-<h4 id="v1414"><a class="wlink" href="#v1414"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.14</h4>
+<h4 id="v1414"><a class="wlink" href="#v1414"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.14 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed autosuggest to update again if matches are marked as volatile and the input line changed while matches were generated in the background (related to <a href="https://github.com/vladimir-kotikov/clink-completions/issues/164">clink-completions#164</a>).</li>
 </ul>
-<h4 id="v1413"><a class="wlink" href="#v1413"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.13</h4>
+<h4 id="v1413"><a class="wlink" href="#v1413"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.13 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added more status information in <code>clink-diagnostics</code> <kbd>Ctrl</kbd>-<kbd>X</kbd>,<kbd>Ctrl</kbd>-<kbd>Z</kbd>.</li>
 <li>Fixed quoting in the <code>insert-completions</code> <kbd>Alt</kbd>-<kbd>*</kbd> command.</li>
@@ -7744,29 +8340,29 @@ <h4 id="v1413"><a class="wlink" href="#v1413"><svg width=16 height=16><use href=
 <li>Fixed a CPU busy-loop after <code>match_builder:setvolatile()</code> was called during an autosuggest strategy.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/411">#411</a>; setting <code>%CLINK_HISTORY_LABEL%</code> after Clink started didn&#39;t take effect (regression introduced in v1.3.18).</li>
 </ul>
-<h4 id="v1412"><a class="wlink" href="#v1412"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.12</h4>
+<h4 id="v1412"><a class="wlink" href="#v1412"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.12 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Additional improvements and logging for East Asian ambiguous width characters.</li>
 <li>Running <code>clink inject</code> no longer empties the log file, so that AutoRun doesn&#39;t result in the log file being cleared over and over, which interferes with diagnostic efforts.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/407">#407</a>; the <code>complete</code> command gets confused by <code>.</code> prefix on files.</li>
 </ul>
-<h4 id="v1411"><a class="wlink" href="#v1411"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.11</h4>
+<h4 id="v1411"><a class="wlink" href="#v1411"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.11 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/406">#406</a>; the &quot;lambdagenerated.omp.json&quot; theme for Oh-My-Posh has problems in CJK codepages.  The <a href="https://www.unicode.org/reports/tr11-2/#:~:text=East%20Asian%20Ambiguous%20%28A%29%20-%20Characters%20that%20occur,sets%2C%20but%20also%20some%20of%20the%20mathematical%20symbols%29.">East Asian Ambiguous</a> support has been rewritten to solve multiple subtle issues; the fix in v1.4.9 exposed other inaccuracies.</li>
 </ul>
-<h4 id="v1410"><a class="wlink" href="#v1410"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.10</h4>
+<h4 id="v1410"><a class="wlink" href="#v1410"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.10 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added optional <code>level</code> argument to <code>log.info()</code> to facilitate more accurate reporting about the calling code.</li>
 <li>Fixed extra duplicate log entry when the updater finds that Clink is already up to date.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/405">#405</a>; vi search gives unexpected results (regression introduced in v1.4.7).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/402">#402</a>; for convenience, print the Clink Releases page URL after a successful update (takes effect on the next upgrade <em>after</em> v1.4.10).</li>
 </ul>
-<h4 id="v149"><a class="wlink" href="#v149"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.9</h4>
+<h4 id="v149"><a class="wlink" href="#v149"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.9 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Improved the problematic character reporting in the <code>clink-diagnostics</code> command.</li>
 <li>Fixed measurements for the East Asian ambiguous width characters (this should solve the Cmder problems with lambda in the CMD.exe prompt text, including the space after the lambda).</li>
 </ul>
-<h4 id="v148"><a class="wlink" href="#v148"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.8</h4>
+<h4 id="v148"><a class="wlink" href="#v148"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.8 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>rl.needquotes()</code> function to check whether text needs quotes in a command line.</li>
 <li>Changed the <code>terminal.color_emoji</code> setting <code>auto</code> mode to more broadly support accurate width measurements for color emoji (regardless whether the terminal program is capable of actually drawing the color emoji).</li>
@@ -7774,7 +8370,7 @@ <h4 id="v148"><a class="wlink" href="#v148"><svg width=16 height=16><use href="#
 <li>Fixed the <code>completion</code> autosuggest strategy so it doesn&#39;t provide a suggestion that requires quoting if the command line input is not currently quoted.</li>
 <li>Fixed overly aggressive detection of color emoji (regression introduced in v1.4.7).</li>
 </ul>
-<h4 id="v147"><a class="wlink" href="#v147"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.7</h4>
+<h4 id="v147"><a class="wlink" href="#v147"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.7 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Clink now supports ARM64.</li>
 <li>Clink now recognizes when the terminal host is WezTerm.</li>
@@ -7785,38 +8381,38 @@ <h4 id="v147"><a class="wlink" href="#v147"><svg width=16 height=16><use href="#
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/393">#393</a>; backward compatibility issue when <code>clink.arg.register_parser()</code> is passed something that is not a parser at all.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/111">#111</a> again; <code>cd ..</code><kbd>Tab</kbd> didn&#39;t complete to <code>..\</code> (regression introduced in v1.3.1).</li>
 </ul>
-<h4 id="v146"><a class="wlink" href="#v146"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.6</h4>
+<h4 id="v146"><a class="wlink" href="#v146"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.6 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added a more informative exit code from <code>clink inject</code>.  It returns 0 if successful, 2 if a fatal error occurred, or 1 if a non-fatal error occurred (such as Clink was already present; related to <a href="https://github.com/cmderdev/cmder/issues/2800">cmderdev/cmder#2800</a>).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/382">#382</a>; <code>%CLINK_PROFILE%</code> doesn&#39;t supersede <code>--profile</code> (regression introduced in v1.0.0).</li>
 </ul>
-<h4 id="v145"><a class="wlink" href="#v145"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.5</h4>
+<h4 id="v145"><a class="wlink" href="#v145"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.5 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Improved debug Lua messages; Clink&#39;s built-in Lua scripts reported &quot;?&quot; as the filename, and now they report &quot;{filename.lua}&quot;.</li>
 <li>Fixed potential for a crash in <code>clink-help</code> when including unbound &quot;luafunc:&quot; macros for which custom descriptions have been provided (e.g. <kbd>Alt</kbd>-<kbd>4</kbd> then <kbd>Alt</kbd>-<kbd>H</kbd>).</li>
 </ul>
-<h4 id="v144"><a class="wlink" href="#v144"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.4</h4>
+<h4 id="v144"><a class="wlink" href="#v144"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.4 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed the screen width in the Help commands and Completion commands (regression introduced in v1.3.43).</li>
 <li>Fixed to not load the same Lua script more than once from a completions directory when the Lua script doesn&#39;t define an argmatcher.</li>
 <li>Fixed architecture reported by <code>clink-diagnostics</code> <kbd>Ctrl</kbd>-<kbd>X</kbd>,<kbd>Ctrl</kbd>-<kbd>Z</kbd> (regression introduced in v1.3.49).</li>
 </ul>
-<h4 id="v143"><a class="wlink" href="#v143"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.3</h4>
+<h4 id="v143"><a class="wlink" href="#v143"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.3 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added backward compatibility for obsolete <code>clink.quote_split()</code>, <code>clink.split()</code>, and <code>clink.get_screen_info()</code>.</li>
 <li>Fixed empty completion list when typing two letters in rapid succession when both the <code>autosuggest.enable</code> and <code>autosuggest.async</code> settings are enabled.</li>
 </ul>
-<h4 id="v142"><a class="wlink" href="#v142"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.2</h4>
+<h4 id="v142"><a class="wlink" href="#v142"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.2 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed path abbreviation in some cases.</li>
 </ul>
-<h4 id="v141"><a class="wlink" href="#v141"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.1</h4>
+<h4 id="v141"><a class="wlink" href="#v141"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.1 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>os.abbreviatepath()</code> and <code>os.expandabbreviatedpath()</code>.</li>
 <li>Invoking completion expands abbreviated paths when the new <code>match.expand_abbrev</code> setting is enabled.</li>
 <li>Fixed displayed matches for <code>c:</code> or <code>c:dir\</code>.</li>
 </ul>
-<h4 id="v140"><a class="wlink" href="#v140"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.0</h4>
+<h4 id="v140"><a class="wlink" href="#v140"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.4.0 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.getpopuplistcolors()</code> to get the default popup list colors.</li>
 <li>Added <code>clink.refilterafterterminalresize()</code> to enable automatic prompt refilter after terminal resize.  Prompt filters should only enable this if they&#39;re designed to refilter very quickly, otherwise they may cause responsiveness problems.</li>
@@ -7826,46 +8422,46 @@ <h4 id="v140"><a class="wlink" href="#v140"><svg width=16 height=16><use href="#
 <li>Fixed leaked file handle when <code>history.save</code> is False.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/370">#370</a>; <kbd>Tab</kbd> inside <code>set /p var=</code> mistakenly discards any previous input.</li>
 </ul>
-<h4 id="v1351"><a class="wlink" href="#v1351"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.51</h4>
+<h4 id="v1351"><a class="wlink" href="#v1351"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.51 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <code>:setendofflags()</code>; it made <code>--</code> work correctly for input line coloring, but it didn&#39;t work correctly when generating match completions.</li>
 <li>Fixed obscure edge cases where matches returned by Lua scripts could display incorrectly in <code>clink-select-complete</code>, or could potentially even crash if Lua scripts returned invalid results from the <code>ondisplaymatches</code> or <code>onfiltermatches</code> events.</li>
 </ul>
-<h4 id="v1350"><a class="wlink" href="#v1350"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.50</h4>
+<h4 id="v1350"><a class="wlink" href="#v1350"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.50 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed the prefix highlighting when displaying matches.</li>
 </ul>
-<h4 id="v1349"><a class="wlink" href="#v1349"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.49</h4>
+<h4 id="v1349"><a class="wlink" href="#v1349"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.49 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Autorun detects non-interactive CMD process earlier, before injecting the Clink DLL.  This can improve performance somewhat, and may be able to reduce spurious problems with antivirus tools (such as described in <a href="https://github.com/chrisant996/clink/issues/367">#367</a>).</li>
 <li>Updater deletes zip file if it fails to unzip.  This can help automatically recover from a damaged zip download.</li>
 </ul>
-<h4 id="v1348"><a class="wlink" href="#v1348"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.48</h4>
+<h4 id="v1348"><a class="wlink" href="#v1348"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.48 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed another <a href="https://github.com/chrisant996/clink/issues/356">#356</a> case; trailing spaces at end of display were sometimes optimized away by mistake (regression introduced in v1.3.43).</li>
 </ul>
-<h4 id="v1347"><a class="wlink" href="#v1347"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.47</h4>
+<h4 id="v1347"><a class="wlink" href="#v1347"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.47 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Removed the message &quot;Clink autorun is disabled by CLINK_NOAUTORUN&quot;.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/361">#361</a>; detect <code>%CLINK_NOAUTORUN%</code> faster.</li>
 <li>Fixed another <a href="https://github.com/chrisant996/clink/issues/356">#356</a> case; end of display line not cleared sometimes (regression introduced in v1.3.43).</li>
 </ul>
-<h4 id="v1346"><a class="wlink" href="#v1346"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.46</h4>
+<h4 id="v1346"><a class="wlink" href="#v1346"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.46 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed right-side prompts on Windows 8.1 (they never worked correctly on Windows 8.1).</li>
 <li>More fixes for <a href="https://github.com/chrisant996/clink/issues/356">#356</a>; input line display garbled on Windows 8.1 (regression introduced in v1.3.43).</li>
 </ul>
-<h4 id="v1345"><a class="wlink" href="#v1345"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.45</h4>
+<h4 id="v1345"><a class="wlink" href="#v1345"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.45 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed the history expansion preview when the input line grows or shrinks to use a different number of screen rows.</li>
 <li>Fixed <code>&quot;cd&quot;</code> so it doesn&#39;t match the <code>cd</code> argmatcher, because CMD commands cannot be quoted.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/356">#356</a>; input line display garbled on Windows 8.1 (regression introduced in v1.3.43).</li>
 </ul>
-<h4 id="v1344"><a class="wlink" href="#v1344"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.44</h4>
+<h4 id="v1344"><a class="wlink" href="#v1344"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.44 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/348">#348</a>; pasting in ConEmu or Windows Terminal duplicates the 2nd character (regression introduced in v1.3.43).</li>
 </ul>
-<h4 id="v1343"><a class="wlink" href="#v1343"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.43</h4>
+<h4 id="v1343"><a class="wlink" href="#v1343"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.43 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.max_input_rows</code> setting that limits the number of screen rows to use for displaying the input line, scrolling as appropriate if the input line exceeds the limit.</li>
 <li>Added <code>color.histexpand</code> setting.  When this is configured with a color, then Clink highlights history expansions in the input line and shows a preview of the expansion that will be applied near the current cursor position.</li>
@@ -7891,13 +8487,13 @@ <h4 id="v1343"><a class="wlink" href="#v1343"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/340">#340</a>; various display glitches in the Readline library (Clink now uses custom display routines instead of the Readline display routines).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/339">#339</a>; <code>%CD%</code> doesn&#39;t expand.</li>
 </ul>
-<h4 id="v1342"><a class="wlink" href="#v1342"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.42</h4>
+<h4 id="v1342"><a class="wlink" href="#v1342"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.42 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>console.checkinput()</code> to check whether input is available.</li>
 <li>Changed <code>console.readinput()</code> to accept an optional <span class="arg">no_cursor</span> argument to avoid changing cursor visibility or position.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/320">#320</a>; resizing the terminal can garble the prompt (<code>bash</code> has the same problem, so Clink now uses custom code to handle resizing the terminal).</li>
 </ul>
-<h4 id="v1341"><a class="wlink" href="#v1341"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.41</h4>
+<h4 id="v1341"><a class="wlink" href="#v1341"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.41 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>io.truncate()</code> to truncate a file.</li>
 <li>Added <code>string.comparematches()</code> to compare two matches; this is normally not needed because Clink automatically sorts matches, but some match generators may prefer to disable the automatic sorting and perform custom sorting.</li>
@@ -7908,7 +8504,7 @@ <h4 id="v1341"><a class="wlink" href="#v1341"><svg width=16 height=16><use href=
 <li>Fixed the <code>completion-prefix-display-length</code> configuration variable in various cases.</li>
 <li>Fixed timing condition that could potentially crash (regression introduced in v1.3.40).</li>
 </ul>
-<h4 id="v1340"><a class="wlink" href="#v1340"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.40</h4>
+<h4 id="v1340"><a class="wlink" href="#v1340"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.40 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Clink now has an icon, and also includes some colored icons for color-coding your shortcut files, terminal tabs, and etc.</li>
 <li>Avoid mis-coloring a directory name as though it is an argmatcher (uses a background thread to stay responsive).</li>
@@ -7918,7 +8514,7 @@ <h4 id="v1340"><a class="wlink" href="#v1340"><svg width=16 height=16><use href=
 <li>Fixed backward compatibility for argmatchers using the old v0.4.9 APIs with <a href="#argmatcher_functions">functions as argument options</a> (regression introduced in v1.2.7).</li>
 <li>Fixed the <code>clink-select-complete</code> command with match display filtering.</li>
 </ul>
-<h4 id="v1339"><a class="wlink" href="#v1339"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.39</h4>
+<h4 id="v1339"><a class="wlink" href="#v1339"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.39 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>&quot;Use enhanced defaults&quot; now includes history timestamps.</li>
 <li>Fixed delay while loading the history file when history timestamps are enabled (regression introduced in v1.3.18).</li>
@@ -7927,7 +8523,7 @@ <h4 id="v1339"><a class="wlink" href="#v1339"><svg width=16 height=16><use href=
 <li>Fixed to normalize path separators in a fully qualified pathname when using <code>clink.argmatcher(full_path)</code>.</li>
 <li>The documentation now shows a link icon when hovering over any heading or API name, to make it easy to copy and share links.</li>
 </ul>
-<h4 id="v1338"><a class="wlink" href="#v1338"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.38</h4>
+<h4 id="v1338"><a class="wlink" href="#v1338"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.38 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.recognizecommand()</code> function that input line coloring classifiers can use to find whether to color a word as executable.  This is the same mechanism Clink uses internally, and the analysis is asynchronous.</li>
 <li>Now <code>clink.argmatcher(command)</code> may be passed a fully qualified pathname for <span class="arg">command</span> to enable different argmatchers for programs with the same name.</li>
@@ -7939,7 +8535,7 @@ <h4 id="v1338"><a class="wlink" href="#v1338"><svg width=16 height=16><use href=
 <li>Fixed <code>color.argmatcher</code> color to not overwrite custom colors that may have already been applied.</li>
 <li>Fixed <code>^</code> to not be a word break character when parsing the input line.</li>
 </ul>
-<h4 id="v1337"><a class="wlink" href="#v1337"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.37</h4>
+<h4 id="v1337"><a class="wlink" href="#v1337"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.37 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>When <code>argmatcher:addarg()</code> is passed a table containing <code>loopchars="<span class="arg">chars</span>"</code> then the <span class="arg">chars</span> are treated as delimiters for a single argument, and they do not move on to the next argument slot in the parser.</li>
 <li>Added <code>clink.parseline()</code> to parse a string into one or more <code>line_state</code> objects.</li>
@@ -7952,7 +8548,7 @@ <h4 id="v1337"><a class="wlink" href="#v1337"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/326">#326</a>; <code>rl.expandtilde()</code> doesn&#39;t have a way to expand tildes everywhere in an input line string.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/325">#325</a>; potential hangs while typing if <code>%PATH%</code> contains a UNC path.</li>
 </ul>
-<h4 id="v1336"><a class="wlink" href="#v1336"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.36</h4>
+<h4 id="v1336"><a class="wlink" href="#v1336"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.36 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Incremental search in <code>clink-popup-history</code> now centers the found item if it is scrolled out of view.</li>
 <li>Tilde expansion is supported for all Lua script directory names and for the <code>%CLINK_PROFILE%</code> environment variable (but there is a quirk, and for the profile directory tilde expands to <code>%LOCALAPPDATA%</code> for backward compatibility purposes).</li>
@@ -7961,7 +8557,7 @@ <h4 id="v1336"><a class="wlink" href="#v1336"><svg width=16 height=16><use href=
 <li>Fixed stack exhaustion crash when using <code>inject --profile nul</code>.</li>
 <li>Fixed detection of device names when coloring command words; a device name anywhere in a path is not a valid executable.</li>
 </ul>
-<h4 id="v1335"><a class="wlink" href="#v1335"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.35</h4>
+<h4 id="v1335"><a class="wlink" href="#v1335"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.35 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed finding a <code>completions</code> directory under the profile directory.</li>
 <li>Fixed finding a <code>completions</code> directory under script directories set via <code>clink installscripts</code>.</li>
@@ -7972,7 +8568,7 @@ <h4 id="v1335"><a class="wlink" href="#v1335"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/321">#321</a>; incremental search not working in the <code>clink-popup-history</code> command (regression introduced in v1.3.19).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/320">#320</a>; prompt becomes garbled when prompt is updated by async prompt filters and wraps past the edge of the screen and a right-sided prompt string is present.</li>
 </ul>
-<h4 id="v1334"><a class="wlink" href="#v1334"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.34</h4>
+<h4 id="v1334"><a class="wlink" href="#v1334"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.34 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Improved error reporting in <code>lua.debug</code> mode for coroutine failures.</li>
 <li>Fixed argmatcher flag definitions that begin with <code>+</code> (regression introduced in v1.3.11).</li>
@@ -7981,39 +8577,39 @@ <h4 id="v1334"><a class="wlink" href="#v1334"><svg width=16 height=16><use href=
 <li>Fixed <code>os.getfileattributes()</code>, <code>os.isfile()</code>, and <code>os.isdir()</code> to fail as intended when the input includes a wildcard (regression introduced in v1.1.0).</li>
 <li>Fixed potential Lua error when typing a command name that included a wildcard, if the wildcard matched a file in a <code>completions</code> directory (regression introduced in v1.3.23, due to the <code>os.getfileattributes()</code> issue above).</li>
 </ul>
-<h4 id="v1333"><a class="wlink" href="#v1333"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.33</h4>
+<h4 id="v1333"><a class="wlink" href="#v1333"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.33 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>The <code>io.popenyield()</code> function now also returns a function that can be used to get the exit status from the command.</li>
 <li>Fixed <code>io.popenyield()</code> for some programs (such as FC and XCOPY) that fail to start if the stdin handle is empty.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/312">#312</a>; slow startup due to inefficiency in the updater check at startup (regression introduced in v1.3.26).</li>
 </ul>
-<h4 id="v1331"><a class="wlink" href="#v1331"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.31</h4>
+<h4 id="v1331"><a class="wlink" href="#v1331"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.31 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Reverted the v1.3.29 change to <code>file:close()</code> that returned the process exit state even after <code>io.popen()</code> or <code>io.popenyield()</code> in a coroutine.  It had subtle negative side effects.</li>
 </ul>
-<h4 id="v1330"><a class="wlink" href="#v1330"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.30</h4>
+<h4 id="v1330"><a class="wlink" href="#v1330"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.30 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed the <code>menu-complete</code> family of commands for <code>fromhistory</code> argmatchers when <code>autosuggest.enable</code> is enabled.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/311">#311</a>; &quot;The handle is invalid.&quot; (regression introduced in v1.3.29).</li>
 </ul>
-<h4 id="v1329"><a class="wlink" href="#v1329"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.29</h4>
+<h4 id="v1329"><a class="wlink" href="#v1329"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.29 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed how <kbd>Right</kbd> and etc work after fully accepting an input line suggestion.  It shouldn&#39;t immediately show a new suggestion when the current suggestion is fully accepted (until the cursor is moved or the text changes), and <code>win-cursor-forward</code> shouldn&#39;t append characters from the previous command (e.g. when <code>clink.default_bindings</code> is <code>windows</code>).  Otherwise holding or double-pressing <kbd>Right</kbd> can accidentally turn into something the user didn&#39;t intend.</li>
 <li>Fixed double-loading completion script when a command word includes a path component (e.g. &quot;c:\clink_dir\program.exe&quot; mistakenly attempted to load &quot;c:\clink_dir\program.lua&quot; instead of loading &quot;program.lua&quot; from the completions directories).</li>
 <li>Fixed delayinit argmatchers so they don&#39;t get orphaned if a new input line starts before they finish.</li>
 <li>Fixed <code>file:close()</code> to be able to return the process exit state even after <code>io.popen()</code> or <code>io.popenyield()</code> in a coroutine.</li>
 </ul>
-<h4 id="v1328"><a class="wlink" href="#v1328"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.28</h4>
+<h4 id="v1328"><a class="wlink" href="#v1328"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.28 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/309">#309</a>; some locales fail to parse the PowerShell version number.</li>
 </ul>
-<h4 id="v1327"><a class="wlink" href="#v1327"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.27</h4>
+<h4 id="v1327"><a class="wlink" href="#v1327"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.27 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added more detailed logging when the updater fails.</li>
 <li>Added check to make sure PowerShell v5 is present when using <code>clink update</code>.</li>
 <li>Added <code>unicode.fromcodepage()</code> and <code>unicode.tocodepage()</code> for UTF8 conversions.  One of the cases where this can be useful is when handling redirected output from programs that product output using the current Active Code Page.</li>
 </ul>
-<h4 id="v1326"><a class="wlink" href="#v1326"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.26</h4>
+<h4 id="v1326"><a class="wlink" href="#v1326"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.26 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>unicode.iter()</code>, <code>unicode.isnormalized()</code>, and <code>unicode.normalize()</code> for more precise UTF8 string manipulation.</li>
 <li>The updater now includes an HTTP header to request no caching, in an effort to work around an issue on Win8.x.</li>
@@ -8027,49 +8623,49 @@ <h4 id="v1326"><a class="wlink" href="#v1326"><svg width=16 height=16><use href=
 <li>Fixed potential double-reporting of coroutine errors when the <code>lua.debug</code> setting is enabled.</li>
 <li>Internal maintenance to the coroutine management system.</li>
 </ul>
-<h4 id="v1325"><a class="wlink" href="#v1325"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.25</h4>
+<h4 id="v1325"><a class="wlink" href="#v1325"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.25 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed updater when <code>%TEMP%</code> contains spaces.</li>
 <li>Fixed executable file detection to color device names (such as nul, aux, con, lpt1, and com1) as neither recognized nor unrecognized.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/304">#304</a>; hang when typing device names (such as aux, con, lpt1, and com1) (regression introduced in v1.3.23).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/303">#303</a>; downloading latest update doesn&#39;t work on Windows 8.x.</li>
 </ul>
-<h4 id="v1324"><a class="wlink" href="#v1324"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.24</h4>
+<h4 id="v1324"><a class="wlink" href="#v1324"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.24 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Standardized the order in which <code>completions</code> directories are searched.</li>
 <li>Fixed the second return value from <code>clink.popuplist()</code>, which was backwards by mistake.</li>
 </ul>
-<h4 id="v1323"><a class="wlink" href="#v1323"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.23</h4>
+<h4 id="v1323"><a class="wlink" href="#v1323"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.23 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Automatically loads Lua completion scripts from <code>completions</code> directories.  This allows you to optionally store completion scripts (argmatcher scripts) in a separate directory from your other Lua scripts, so that completion scripts are only loaded when needed.  This can speed up Clink start time, if you have a large volume of argmatcher scripts.  See <a href="#completion-directories">Completion Directories</a> for more information.</li>
 <li>Fixed <code>clink.oncommand()</code> when redirection appears on the command line before the command name (e.g. <code>&gt;somefile command</code>).</li>
 <li>Fixed both parts of <a href="https://github.com/chrisant996/clink/issues/300">#300</a>; unable to find latest release zip file (incomplete fix in v1.3.22 by mistake).</li>
 </ul>
-<h4 id="v1322"><a class="wlink" href="#v1322"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.22</h4>
+<h4 id="v1322"><a class="wlink" href="#v1322"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.22 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>When the <code>lua.debug</code> setting is enabled, any uncaught errors in coroutines are reported (and logged).</li>
 <li>Fixed edge case that could cause Windows Terminal to temporarily stop responding mouse input.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/300">#300</a>; unable to find latest release zip file.</li>
 </ul>
-<h4 id="v1321"><a class="wlink" href="#v1321"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.21</h4>
+<h4 id="v1321"><a class="wlink" href="#v1321"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.21 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Improved the auto-updater when there are multiple copies of Clink on a computer; it no longer needs to download the .zip update file multiple times.</li>
 <li>Fixed mouse input when the console is scrolled.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/299">#299</a>; update shown even though up to date.</li>
 </ul>
-<h4 id="v1320"><a class="wlink" href="#v1320"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.20</h4>
+<h4 id="v1320"><a class="wlink" href="#v1320"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.20 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed potential crash in popup lists if there are only a few items (regression introduced in v1.3.18).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/296">#296</a>; on some computers closing CMD reports it&#39;s taking too long to close (the fix works around external issue).</li>
 </ul>
-<h4 id="v1319"><a class="wlink" href="#v1319"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.19</h4>
+<h4 id="v1319"><a class="wlink" href="#v1319"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.19 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>directories.dupe_mode</code> setting that controls how duplicates are handled in the directory history list for the <code>clink-popup-directories</code> command.</li>
 <li>Added <kbd>Del</kbd> to delete a directory entry in the <code>clink-popup-directories</code> command.</li>
 <li>Fixed obscure intermittent problem with <code>delayinit</code> argmatchers.</li>
 <li>Fixed <kbd>Ctrl</kbd>-<kbd>C</kbd> and <kbd>Ctrl</kbd>-<kbd>Break</kbd> in CMD built-in commands (regression introduced in v1.3.14).</li>
 </ul>
-<h4 id="v1318"><a class="wlink" href="#v1318"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.18</h4>
+<h4 id="v1318"><a class="wlink" href="#v1318"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.18 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added a built-in updater for Clink, which is enabled by default.  When enabled, Clink reports when an update is available.  Run <code>clink update</code> to apply the update.</li>
 <li>Added <code>clink-insert-suggested-line</code>, <code>clink-insert-suggested-word</code>, <code>clink-insert-suggested-full-word</code>, and <code>clink-accept-suggested-line</code> commands (see <a href="https://github.com/chrisant996/clink/issues/280">#280</a>).</li>
@@ -8092,13 +8688,13 @@ <h4 id="v1318"><a class="wlink" href="#v1318"><svg width=16 height=16><use href=
 <li>Fixed keyboard driver for <kbd>Alt</kbd>-<kbd>Ctrl</kbd>-<kbd>[</kbd> when the <code>terminal.raw_esc</code> setting is enabled.</li>
 <li>Fixed keyboard driver for <kbd>Alt</kbd>-<kbd>Ctrl</kbd>-<kbd>]</kbd> and <kbd>Alt</kbd>-<kbd>Ctrl</kbd>-<kbd>&lt;/kbd>.</li>
 </ul>
-<h4 id="v1317"><a class="wlink" href="#v1317"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.17</h4>
+<h4 id="v1317"><a class="wlink" href="#v1317"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.17 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed coloring executable files in the input line (some file types weren&#39;t detected correctly, and missing files were considered executable if their extension had a file type association).</li>
 <li>Fixed a potential crash when coloring executable files in the input line (regression introduced in v1.3.16).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/281">#281</a>; screen height detected incorrectly (regression introduced in v1.3.16).</li>
 </ul>
-<h4 id="v1316"><a class="wlink" href="#v1316"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.16</h4>
+<h4 id="v1316"><a class="wlink" href="#v1316"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.16 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>os.sleep()</code>.</li>
 <li>Revised the Clink documentation to directly include the Readline documentation.</li>
@@ -8107,11 +8703,11 @@ <h4 id="v1316"><a class="wlink" href="#v1316"><svg width=16 height=16><use href=
 <li>Fixed crash when file permissions block accessing the history file, and the <code>history</code> command reports an error message accordingly.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/262">#262</a>; changing the terminal width between prompts (while a different program is running) caused Readline to start displaying the input line incorrectly.</li>
 </ul>
-<h4 id="v1315"><a class="wlink" href="#v1315"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.15</h4>
+<h4 id="v1315"><a class="wlink" href="#v1315"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.15 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/269">#269</a>; reverse video could get confused (regression introduced in v1.3, and incompletely fixed in v1.3.4).</li>
 </ul>
-<h4 id="v1314"><a class="wlink" href="#v1314"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.14</h4>
+<h4 id="v1314"><a class="wlink" href="#v1314"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.14 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li><kbd>Ctrl</kbd>+<kbd>Break</kbd> can now interrupt some operations, including match display and match generators and the <code>os.globfiles()</code> and <code>os.globdirs()</code> functions in Lua scripts.</li>
 <li>Added <code>os.issignaled()</code> so Lua scripts can cooperatively interrupt themselves.</li>
@@ -8120,7 +8716,7 @@ <h4 id="v1314"><a class="wlink" href="#v1314"><svg width=16 height=16><use href=
 <li>Fixed doskey aliases in pasted lines.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/268">#268</a>; crash when <code>copy</code> command prompts whether to overwrite a file (regression introduced in v1.3.13).</li>
 </ul>
-<h4 id="v1313"><a class="wlink" href="#v1313"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.13</h4>
+<h4 id="v1313"><a class="wlink" href="#v1313"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.13 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Argmatchers can use <code>:chaincommand()</code> to treat the rest of the command line as another command.<ul>
 <li>Added an argmatcher for <code>cmd</code> that uses <code>:chaincommand()</code>.</li>
@@ -8141,7 +8737,7 @@ <h4 id="v1313"><a class="wlink" href="#v1313"><svg width=16 height=16><use href=
 <li>Fixed obscure edge case with delayinit argmatchers and <code>operate-and-get-next</code>.</li>
 <li>Fixed potentially inconsistent input line coloring when <code>classifier:applycolor()</code> is given an escape code that sets only the foreground or background color.</li>
 </ul>
-<h4 id="v1312"><a class="wlink" href="#v1312"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.12</h4>
+<h4 id="v1312"><a class="wlink" href="#v1312"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.12 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Improved <code>clink-select-complete</code> to show inline descriptions as long as they don&#39;t require more than 9 rows to display the matches.</li>
 <li>Added second argument to the <code>delayinit</code> function for an argmatcher.</li>
@@ -8156,7 +8752,7 @@ <h4 id="v1312"><a class="wlink" href="#v1312"><svg width=16 height=16><use href=
 <li>Fixed redundant argmatcher delayinit for flags.</li>
 <li>Various minor backward compatibility fixes.</li>
 </ul>
-<h4 id="v1311"><a class="wlink" href="#v1311"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.11</h4>
+<h4 id="v1311"><a class="wlink" href="#v1311"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.11 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Updated the list of recognized CMD command names.</li>
 <li>Better support for <code>(</code> and <code>)</code> when expanding doskey macros (e.g. now <code>( macro foo ) &amp; ( macro bar )</code> works).</li>
@@ -8171,7 +8767,7 @@ <h4 id="v1311"><a class="wlink" href="#v1311"><svg width=16 height=16><use href=
 </li>
 <li>And other obscure minor backward compatibility fixes.</li>
 </ul>
-<h4 id="v1310"><a class="wlink" href="#v1310"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.10</h4>
+<h4 id="v1310"><a class="wlink" href="#v1310"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.10 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>An argmatcher can extend itself on the fly, when needed.  For example, if it needs to parse arguments and flags from <code>--help</code> text, or if the available command arguments change based on the current directory, or etc.  See <a href="#adaptive-argmatchers">Adaptive Argmatchers</a> for more information.</li>
 <li>Recognizes <code>^</code> and environment variables when coloring the command word, and when navigating by typing a directory name by itself.</li>
@@ -8183,7 +8779,7 @@ <h4 id="v1310"><a class="wlink" href="#v1310"><svg width=16 height=16><use href=
 <li>Fixed mouse clicks in <code>clink-select-complete</code> to insert the clicked match, in addition to highlighting it.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/252">#252</a>; <code>md</code> and <code>rd</code> should complete more than 1 argument.</li>
 </ul>
-<h4 id="v139"><a class="wlink" href="#v139"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.9</h4>
+<h4 id="v139"><a class="wlink" href="#v139"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.9 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>When <code>argmatcher:addarg()</code> is passed a table containing <code>fromhistory=true</code> then additional matches are generated by parsing the history file to find values for that argument slot from commands in the history file.</li>
 <li>Added <code>clink.reclassifyline()</code> which triggers input line coloring and redisplays the input line.  This is intended for use by a coroutine that has made changes that will affect input line coloring.</li>
@@ -8204,7 +8800,7 @@ <h4 id="v139"><a class="wlink" href="#v139"><svg width=16 height=16><use href="#
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/249">#249</a>; sending keystrokes from WScript does nothing for some keys.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/244">#244</a>; installer did not detect previous installation directory (regression introduced in v1.3.5; the fix takes effect on the next install <em>after</em> an install with the fix).</li>
 </ul>
-<h4 id="v138"><a class="wlink" href="#v138"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.8</h4>
+<h4 id="v138"><a class="wlink" href="#v138"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.8 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>terminal.mouse_modifier</code> setting and <code>%CLINK_MOUSE_MODIFIER%</code> environment variable; these can override the modifier keys that activate Clink mouse input.</li>
 <li>Added <code>%CLINK_SETTINGS%</code> environment variable; this can override the directory where the <code>clink_settings</code> file is located.  This can be used to put it in a directory that syncs between computers, for example.</li>
@@ -8216,14 +8812,14 @@ <h4 id="v138"><a class="wlink" href="#v138"><svg width=16 height=16><use href="#
 <li>Fixed <code>argmatcher:addargunsorted()</code> to turn off sort.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/239">#239</a>; crash when <kbd>F7</kbd> and <kbd>Del</kbd>.</li>
 </ul>
-<h4 id="v137"><a class="wlink" href="#v137"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.7</h4>
+<h4 id="v137"><a class="wlink" href="#v137"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.7 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Mouse click+drag now works.</li>
 <li>Mouse click below <code>clink-select-complete</code> list expands the list instead of dismissing it.</li>
 <li>Fixed responding to mouse clicks when the terminal&#39;s scrollback buffer is not empty (it only worked in Windows Terminal).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/237">#237</a>; installer does not maintain previously selected &quot;Autorun when cmd.exe starts&quot; (regression introduced in v1.3.5).</li>
 </ul>
-<h4 id="v136"><a class="wlink" href="#v136"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.6</h4>
+<h4 id="v136"><a class="wlink" href="#v136"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.6 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>terminal.mouse_input</code> setting; the default is <code>auto</code>.  <code>auto</code> lets mouse input work in ConEmu, or in the default Conhost terminal when Quick Edit mode is unchecked in the console Properties dialog.  See the documentation for more information.</li>
 <li>Added <code>cua-select-word</code> command that selects the word at the cursor.</li>
@@ -8232,7 +8828,7 @@ <h4 id="v136"><a class="wlink" href="#v136"><svg width=16 height=16><use href="#
 <li>Fixed a potential busy loop when the command word is unrecognized.</li>
 <li>Fixed Quick Edit mode in plain Conhost windows; it had always been disabled (I never noticed because I always configure console windows to disable it anyway).</li>
 </ul>
-<h4 id="v135"><a class="wlink" href="#v135"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.5</h4>
+<h4 id="v135"><a class="wlink" href="#v135"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.5 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Raised default <code>history.max_lines</code> to 10000.</li>
 <li>Added an optional <code>default_inputrc</code> file:<ul>
@@ -8250,7 +8846,7 @@ <h4 id="v135"><a class="wlink" href="#v135"><svg width=16 height=16><use href="#
 <li>Fixed problems when displaying matches that exceed the screen width.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/231">#231</a>; installer fails sometimes when uncheck &quot;Use versioned install directory&quot;.</li>
 </ul>
-<h4 id="v134"><a class="wlink" href="#v134"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.4</h4>
+<h4 id="v134"><a class="wlink" href="#v134"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.4 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Pressing <kbd>Del</kbd> or <kbd>Ctrl</kbd>+<kbd>D</kbd> in a command history popup deletes the selected history entry.</li>
 <li>Changed the default color for directory match completions to bright yellow (bright blue is hard to see).</li>
@@ -8274,7 +8870,7 @@ <h4 id="v134"><a class="wlink" href="#v134"><svg width=16 height=16><use href="#
 <li>Fixed quirk when using Clink file completion to complete a directory name for <code>clink --profile \foo\</code>, so that the path doesn&#39;t end up malformed.</li>
 <li>Fixed a memory leak.</li>
 </ul>
-<h4 id="v133"><a class="wlink" href="#v133"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.3</h4>
+<h4 id="v133"><a class="wlink" href="#v133"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.3 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Match completion display calculates column widths to fit the most columns on the screen.  Can be controlled by the <code>match.fit_columns</code> and <code>match.limit_fitted_columns</code> settings.</li>
 <li>Match descriptions are right-justified when more than one column is displayed, to help more columns fit.</li>
@@ -8293,7 +8889,7 @@ <h4 id="v133"><a class="wlink" href="#v133"><svg width=16 height=16><use href="#
 <li>Fixed a couple of memory leaks, and added memory tracking system to more easily catch leaks.</li>
 <li>Various minor fixes in <code>clink-select-complete</code>.</li>
 </ul>
-<h4 id="v132"><a class="wlink" href="#v132"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.2</h4>
+<h4 id="v132"><a class="wlink" href="#v132"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.2 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <kbd>Shift</kbd>+<kbd>Space</kbd> as a recognized key.  By default it is bound to <code>clink-shift-space</code>, which invokes whatever is bound to the normal <kbd>Space</kbd> key, so that it continues to behave as before unless you specifically bind something else to the <kbd>Shift</kbd>+<kbd>Space</kbd> key.</li>
 <li>Added <code>clink-magic-suggest-space</code> command which inserts the next full suggested word (if any) up to a space, and then inserts a space.  Binding this to <kbd>Shift</kbd>+<kbd>Space</kbd> can be very handy.</li>
@@ -8306,7 +8902,7 @@ <h4 id="v132"><a class="wlink" href="#v132"><svg width=16 height=16><use href="#
 <li>Fixed cursor blink, which was accidentally disabled (regression introduced in v1.2.44).</li>
 <li>Fixed the <code>win-cursor-forward</code> command so it doesn&#39;t trigger generating a new suggestion if there isn&#39;t already one.</li>
 </ul>
-<h4 id="v131"><a class="wlink" href="#v131"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.1</h4>
+<h4 id="v131"><a class="wlink" href="#v131"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3.1 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>autosuggest.async</code> setting (on by default) that lets suggestions generate matches asynchronously to stay responsive while typing.</li>
 <li>Added <code>match.max_rows</code> setting that limits the number of rows <code>clink-select-complete</code> can use.</li>
@@ -8325,7 +8921,7 @@ <h4 id="v131"><a class="wlink" href="#v131"><svg width=16 height=16><use href="#
 <li>Fixed displaying matches when only a drive letter is entered.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/216">#216</a>; Long escaped URLs do not display correctly in a prompt.</li>
 </ul>
-<h4 id="v13"><a class="wlink" href="#v13"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3</h4>
+<h4 id="v13"><a class="wlink" href="#v13"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.3 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added back <code>mark-modified-lines</code> support (was removed in v1.2.36).</li>
 <li>Added <code>rl.ismodifiedline()</code> function so prompt filters can show a modified line indicator if they wish.</li>
@@ -8343,13 +8939,13 @@ <h4 id="v13"><a class="wlink" href="#v13"><svg width=16 height=16><use href="#wi
 <li>Fixed the &quot;show help&quot; commands when listing unbound commands:  unbound vi mode commands should not be listed in emacs mode because the vi mode commands are only meant to be used in vi mode, and are not meant to be bound to custom keys.</li>
 <li>Fixed memory leak in suggestions.</li>
 </ul>
-<h4 id="v1250"><a class="wlink" href="#v1250"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.50</h4>
+<h4 id="v1250"><a class="wlink" href="#v1250"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.50 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>rl.insertmode()</code> function to get or set whether insert mode is active.</li>
 <li>Added <code>clink.onaftercommand()</code> so scripts can register a function to be called after every input command (key binding).</li>
 <li>Added additional failure logging during <code>clink inject</code>.</li>
 </ul>
-<h4 id="v1249"><a class="wlink" href="#v1249"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.49</h4>
+<h4 id="v1249"><a class="wlink" href="#v1249"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.49 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>cua-previous-screen-line</code> and <code>cua-next-screen-line</code>, bound to <kbd>Shift</kbd>+<kbd>Up</kbd> and <kbd>Shift</kbd>+<kbd>Down</kbd>, to extend the text selection up/down by one screen line.</li>
 <li>Updated match generator for <code>clink set autosuggest.strategy</code> to list the available suggestion generators.</li>
@@ -8361,13 +8957,13 @@ <h4 id="v1249"><a class="wlink" href="#v1249"><svg width=16 height=16><use href=
 <li>Fixed when <code>history.dupe_mode</code> is &quot;erase_prev&quot; and <code>history.shared</code> starts true but changes to false; subsequent commands were not added to the history properly anymore in that session (regression introduced in v1.1.0).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/210">#210</a>; <code>clink-select-complete</code> drawing bug with RPROMPT.</li>
 </ul>
-<h4 id="v1248"><a class="wlink" href="#v1248"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.48</h4>
+<h4 id="v1248"><a class="wlink" href="#v1248"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.48 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li><kbd>Ctrl</kbd>+<kbd>Right</kbd> now inserts the next word of the suggestion the same way it would move to the next word, and <kbd>Shift</kbd>+<kbd>Right</kbd> inserts the next full word of the suggestion up to a space.</li>
 <li>Keys like <kbd>Home</kbd>/<kbd>End</kbd>, <kbd>Shift</kbd>+<kbd>Left</kbd>/<kbd>Right</kbd>, and <kbd>Ctrl</kbd>+<kbd>Left</kbd>/<kbd>Right</kbd> work in VI mode.</li>
 <li>Fixed input line coloring glitch when color settings use the <code>sgr</code> syntax.</li>
 </ul>
-<h4 id="v1247"><a class="wlink" href="#v1247"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.47</h4>
+<h4 id="v1247"><a class="wlink" href="#v1247"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.47 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added autosuggestions similar to the Fish shell.<ul>
 <li>Turn on by running <code>clink set autosuggest.enable true</code>.  See the <code>autosuggest.enable</code> and <code>autosuggest.strategy</code> Clink settings for details.</li>
@@ -8382,7 +8978,7 @@ <h4 id="v1247"><a class="wlink" href="#v1247"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/208">#208</a>; orphaned symlinks are colored wrong.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/203">#203</a>; unable to inject when Clink binary directory contains Chinese characters (regression introduced in v1.0.0).</li>
 </ul>
-<h4 id="v1246"><a class="wlink" href="#v1246"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.46</h4>
+<h4 id="v1246"><a class="wlink" href="#v1246"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.46 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added a <code>magic-space</code> command that performs history expansion on the text before the cursor point and then inserts a space.  Note: this is slightly different than one in bash, which performs history expansion on the whole line and can end up inserting the space in a wrong spot.</li>
 <li>Added <code>rl.getbinding()</code> and <code>rl.setbinding()</code> functions to query or override key bindings.</li>
@@ -8394,23 +8990,23 @@ <h4 id="v1246"><a class="wlink" href="#v1246"><svg width=16 height=16><use href=
 <li>Fixed potential for prompt to redraw incorrectly after showing help when the <code>prompt.transient</code> setting is enabled.</li>
 <li>Fixed settings defined by Lua scripts so that the Lua scripts can reliably see the current values even while the Lua scripts are being loaded or reloaded.</li>
 </ul>
-<h4 id="v1245"><a class="wlink" href="#v1245"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.45</h4>
+<h4 id="v1245"><a class="wlink" href="#v1245"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.45 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Clarified description of the <code>match.wild</code> Clink setting.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/196">#196</a>; installer checkboxes not working properly.</li>
 </ul>
-<h4 id="v1244"><a class="wlink" href="#v1244"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.44</h4>
+<h4 id="v1244"><a class="wlink" href="#v1244"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.44 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <code>clink.ondisplaymatches()</code> so it receives the right match strings (regression introduced in v1.2.39).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/194">#194</a>; argmatcher not found when command name contains a dash (regression introduced in v1.1.5).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/176">#176</a>; use current installation dir when upgrading clink.  Now the installer remembers the chosen installation directory and defaults to the same place when installing an upgrade (all of the checkbox states are remembered, in fact).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/171">#171</a>; have a way to override install directory.  Now the installer has a checkbox whether to install to a versioned directory (recommended).  Unchecking the box installs program files to a <code>bin</code> subdirectory, instead of the usual versioned subdirectory.</li>
 </ul>
-<h4 id="v1243"><a class="wlink" href="#v1243"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.43</h4>
+<h4 id="v1243"><a class="wlink" href="#v1243"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.43 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed lingering issues with non-ASCII characters in path names in Clink (follows up on the preceding fixes for non-ASCII user name characters).</li>
 </ul>
-<h4 id="v1242"><a class="wlink" href="#v1242"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.42</h4>
+<h4 id="v1242"><a class="wlink" href="#v1242"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.42 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed potential for history file to get corrupted during compacting, if multiple Clink instances are running concurrently.</li>
 <li>Fixed <code>clink inject</code> when the user account name contains non-ASCII characters (regression introduced in v1.0.0).</li>
@@ -8418,23 +9014,23 @@ <h4 id="v1242"><a class="wlink" href="#v1242"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/192">#192</a>; completing <code>~</code> by itself does nothing:  Completing <code>~</code> by itself now inserts the %USERPROFILE% directory.  This is different than bash, because on Windows it doesn&#39;t make sense for ~ by itself to complete other user accounts.  This is a convenient way to expand tilde into a path that Windows understands.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/191">#191</a>; <code>cd /d -</code> isn&#39;t supported:  The <code>cd -</code> feature now supports <code>cd /d -</code> as well.  It also supports <code>cd -</code> even if there is a doskey macro defined for <code>cd</code>.</li>
 </ul>
-<h4 id="v1241"><a class="wlink" href="#v1241"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.41</h4>
+<h4 id="v1241"><a class="wlink" href="#v1241"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.41 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/187">#187</a> differently:  <code>doskey.enhanced</code> is <code>true</code> by default again, but if a macro contains <code>$*</code> or <code>$1</code>...<code>$9</code> tags within quotes then <code>|</code> and <code>&amp;</code> symbols are part of the arguments, not command separators (and expansion stops after that macro).</li>
 <li>Fixed compatibility when <code>doskey.enhanced</code> is <code>false</code>; <code>alias|whatever</code> should not expand <code>alias</code> because there is no space after it.</li>
 <li>Fixed doskey expansion when <code>&gt;&amp;</code> redirection symbol is present; <code>command &gt;&amp; alias</code> should not attempt to expand <code>alias</code> because it&#39;s a redirection file name, not a command.</li>
 </ul>
-<h4 id="v1240"><a class="wlink" href="#v1240"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.40</h4>
+<h4 id="v1240"><a class="wlink" href="#v1240"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.40 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed display quirks when an empty <code>display</code> or <code>description</code> string is provided by a match generator.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/187">#187</a>; the <code>doskey.enhanced</code> setting interferes with some macros (regression introduced in v1.0.0).  The setting is now <code>false</code> by default, because of the incompatibilities it can cause.</li>
 </ul>
-<h4 id="v1239"><a class="wlink" href="#v1239"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.39</h4>
+<h4 id="v1239"><a class="wlink" href="#v1239"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.39 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed regression in match display filtering when listing possible completions (regression introduced in v1.2.38).</li>
 <li>Fixed display quirks in the <code>clink-select-complete</code> command when descriptions are at the bottom.</li>
 </ul>
-<h4 id="v1238"><a class="wlink" href="#v1238"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.38</h4>
+<h4 id="v1238"><a class="wlink" href="#v1238"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.38 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Enhancements for match descriptions (which are displayed when listing possible completions):<ul>
 <li>Argmatchers can provide description strings for flags and/or args (e.g. &quot;Verbose output&quot; for <code>-v</code>, or &quot;Do nothing&quot; for <code>-n</code>, etc).</li>
@@ -8462,14 +9058,14 @@ <h4 id="v1238"><a class="wlink" href="#v1238"><svg width=16 height=16><use href=
 <li>Fixed argmatcher for <code>clink --profile</code> so it produces directory matches.</li>
 <li>Fixed <code>%CLINK_RPROMPT%</code> alignment when <code>color.prompt</code> is set.</li>
 </ul>
-<h4 id="v1237"><a class="wlink" href="#v1237"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.37</h4>
+<h4 id="v1237"><a class="wlink" href="#v1237"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.37 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/180">#180</a>; <code>rl.collapsetilde()</code> behaves erratically.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/179">#179</a>; incorrect handling for certain keys on some keyboard layouts.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/178">#178</a>; OneDrive folders mistakenly show up as symlinks.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/177">#177</a>; be silent about autorun injection into TCC.</li>
 </ul>
-<h4 id="v1236"><a class="wlink" href="#v1236"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.36</h4>
+<h4 id="v1236"><a class="wlink" href="#v1236"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.36 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>win-history-list</code> command bound to <kbd>F7</kbd> by default.  This shows the history list, and executes the selected history entry.</li>
 <li>Changed all of the popup list commands to show popups using console text rather than GUI windows.<ul>
@@ -8488,7 +9084,7 @@ <h4 id="v1236"><a class="wlink" href="#v1236"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/172">#172</a>; add a choice in the installer to not add Start menu shortcuts.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/129">#129</a>; Bug completing files with - or _ characters (regression introduced in v1.0.0).</li>
 </ul>
-<h4 id="v1235"><a class="wlink" href="#v1235"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.35</h4>
+<h4 id="v1235"><a class="wlink" href="#v1235"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.35 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>rl_buffer:getanchor()</code> to get the text selection anchor (there is no set function; use <code>rl.invokecommand()</code> to invoke commands to set/extend the selection if needed).</li>
 <li>Reverted back to using IAT hooking (see issue #169).</li>
@@ -8496,14 +9092,14 @@ <h4 id="v1235"><a class="wlink" href="#v1235"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/170">#170</a>; directory symlink completion is truncated when <code>mark-directories</code> is <code>off</code> in the .inputrc file.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/169">#169</a>; incompatibility between AutoHotkey, AnsiCon, and Clink when all three are used in CMD&#39;s AutoRun regkey (regression introduced in v1.2.33).</li>
 </ul>
-<h4 id="v1234"><a class="wlink" href="#v1234"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.34</h4>
+<h4 id="v1234"><a class="wlink" href="#v1234"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.34 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Changed &quot;luafunc:&quot; macro functions to receive the <code>line_state</code> as a second argument.</li>
 <li>Fixed <kbd>Right</kbd> when <code>clink.default_bindings</code> is <code>windows</code>.</li>
 <li>Fixed <code>exec.files</code> setting so completion works when a path is specified (e.g. <code>subdir\foo</code>) (regression introduced in v1.2.33).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/158">#158</a>; crash when a keyboard macro contains <code>\015</code> (regression introduced in v1.0.0).</li>
 </ul>
-<h4 id="v1233"><a class="wlink" href="#v1233"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.33</h4>
+<h4 id="v1233"><a class="wlink" href="#v1233"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.33 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Rewrote how Clink hooks APIs in CMD.EXE; it no longer uses any IAT hooking, and exclusively uses Detours.</li>
 <li>Added <code>clink.default_bindings</code> Clink setting to choose between <code>bash</code> or <code>windows</code> default key bindings.  <code>bash</code> key bindings are still the default, for compatibility with existing Clink installations.</li>
@@ -8516,7 +9112,7 @@ <h4 id="v1233"><a class="wlink" href="#v1233"><svg width=16 height=16><use href=
 <li>Fixed script error when <code>%PATH%</code> is not set and <code>exec.enable</code> and <code>exec.path</code> are both enabled.</li>
 <li>Fixed some quirks when using the <code>quoted-insert</code> command.</li>
 </ul>
-<h4 id="v1232"><a class="wlink" href="#v1232"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.32</h4>
+<h4 id="v1232"><a class="wlink" href="#v1232"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.32 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>rl_buffer:setargument()</code> function for a &quot;luafunc:&quot; macro to be able to set Readline&#39;s numeric argument.</li>
 <li>Added <code>os.getclipboardtext()</code> and <code>os.setclipboardtext()</code> functions.</li>
@@ -8525,7 +9121,7 @@ <h4 id="v1232"><a class="wlink" href="#v1232"><svg width=16 height=16><use href=
 <li>Fixed <code>rl_buffer:getcursor()</code> and the return value from <code>rl_buffer:setcursor()</code>; both returned one less than the actual cursor position.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/162">#162</a>; clink completion shows script error (regression introduced in v1.2.31).</li>
 </ul>
-<h4 id="v1231"><a class="wlink" href="#v1231"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.31</h4>
+<h4 id="v1231"><a class="wlink" href="#v1231"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.31 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink uninstallscripts --all</code> to clear all script paths installed by <code>clink installscripts</code>.</li>
 <li>Added <code>os.touch()</code> function to set the access and modified times for a file.</li>
@@ -8542,12 +9138,12 @@ <h4 id="v1231"><a class="wlink" href="#v1231"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/161">#161</a>; <code>clink installscripts</code> garbles previously-installed script paths when installing a new one.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/155">#155</a>; <code>settings.set()</code> doesn&#39;t update the settings file.</li>
 </ul>
-<h4 id="v1230"><a class="wlink" href="#v1230"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.30</h4>
+<h4 id="v1230"><a class="wlink" href="#v1230"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.30 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Replaced the built-in Lua implementation of <code>os.clock()</code> so it doesn&#39;t stop working after the program has been running for more than 24 days (which caused asynchronous prompt filtering to stop working).  As a side effect, the new <code>os.clock()</code> has microsecond precision instead of millisecond precision.</li>
 <li>Fixed coroutine throttling.  It was meant to prevent running more than once per 5 seconds, but accidentally forced running every 5 seconds, even if the coroutine was registered to run less often.</li>
 </ul>
-<h4 id="v1229"><a class="wlink" href="#v1229"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.29</h4>
+<h4 id="v1229"><a class="wlink" href="#v1229"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.29 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>prompt.transient</code> Clink setting which can collapse prior prompts to a condensed form.  The new <code>%CLINK_TRANSIENT_PROMPT%</code> and <code>%CLINK_TRANSIENT_RPROMPT%</code> environment variables supply the initial prompt strings, and prompt filters can define <code>:transientfilter()</code> and <code>:transientrightfilter()</code> functions to filter the transient prompt.</li>
 <li>Added <code>clink.logo</code> Clink setting to globally control what startup logo is shown (full copyright logo by default, or a short version logo, or no startup logo).</li>
@@ -8562,7 +9158,7 @@ <h4 id="v1229"><a class="wlink" href="#v1229"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/153">#153</a>; ESC key problem.  Clink migrated the old <code>esc_clears_line</code> setting backwards, causing <kbd>Esc</kbd> to behave opposite from what was expected.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/152">#152</a>; LUA debugger breaks on the wrong line, and fails to execute expressions.</li>
 </ul>
-<h4 id="v1228"><a class="wlink" href="#v1228"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.28</h4>
+<h4 id="v1228"><a class="wlink" href="#v1228"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.28 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>rl.getpromptinfo()</code> function.</li>
 <li>Fixed loading .inputrc so that only one is loaded (regression introduced in v1.0.0a0 by the fix for <a href="https://github.com/mridgers/clink/issues/258">mridgers #258</a>).  If similar behavior is still desired, consider using the <code>$include</code> directive in the Readline init file, to load additional files.</li>
@@ -8570,14 +9166,14 @@ <h4 id="v1228"><a class="wlink" href="#v1228"><svg width=16 height=16><use href=
 <li>Fixed crash in <code>console.findline()</code> when no attributes are passed.  Callers using v1.2.27 and earlier can work around the crash by passing <code>{}</code> for attributes.</li>
 <li>Fixed an off-by-1 bug in <code>console.scroll(&quot;absolute&quot;, top)</code>.  This will fix edge case malfunctions in some callers, but some callers could experience this as a breaking change.</li>
 </ul>
-<h4 id="v1227"><a class="wlink" href="#v1227"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.27</h4>
+<h4 id="v1227"><a class="wlink" href="#v1227"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.27 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>The <code>cmd.get_errorlevel</code> Clink setting is now enabled by default.</li>
 <li>Clink now expands <code>$</code> codes in <code>%CLINK_RPROMPT%</code> before running prompt filters.</li>
 <li>Fixed parsing <code>2&gt;&amp;1</code> style redirection symbols, so the <code>&amp;</code> doesn&#39;t get treated as a command separator.</li>
 <li>Fixed argmatchers to generate file matches for redirection arguments; <code>app.exe &gt;</code> should generate file matches for the <code>&gt;</code> symbol, not matches for the <code>app</code> argmatcher&#39;s first argument.</li>
 </ul>
-<h4 id="v1226"><a class="wlink" href="#v1226"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.26</h4>
+<h4 id="v1226"><a class="wlink" href="#v1226"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.26 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed input line coloring for doskey aliases that don&#39;t have an argmatcher (regression introduced in v1.2.16).</li>
 <li>Fixed <kbd>Space</kbd> during <code>clink-select-complete</code> when there were already opening and closing quotes present.</li>
@@ -8585,7 +9181,7 @@ <h4 id="v1226"><a class="wlink" href="#v1226"><svg width=16 height=16><use href=
 <li>Fixed the <code>completion-auto-query-items</code> config variable to account for multiple lines of input, if present.</li>
 <li>Fixed potential race condition if multiple Clink instances try to get the last errorlevel at the same time.</li>
 </ul>
-<h4 id="v1225"><a class="wlink" href="#v1225"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.25</h4>
+<h4 id="v1225"><a class="wlink" href="#v1225"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.25 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>cua-select-all</code> command to select the entire input line.</li>
 <li>Added <code>edit-and-execute-command</code> command to invoke an editor on the current input line and then execute the results (<kbd>Ctrl</kbd>+<kbd>X</kbd>,<kbd>Ctrl</kbd>+<kbd>E</kbd>).  This attempts to invoke <code>%VISUAL%</code>, <code>%EDITOR%</code>, or <code>notepad.exe</code> as the editor, in that order.</li>
@@ -8619,17 +9215,17 @@ <h4 id="v1225"><a class="wlink" href="#v1225"><svg width=16 height=16><use href=
 <li>Fixed <code>/flag:</code> and <code>/flag=</code> handling quirks, especially when trying to complete an environment variable in <code>/flag:%env</code>.</li>
 <li>Fixed quirks about environment variable expansion in the <code>clink-expand-env-var</code> command and the <code>os.expandenv()</code> function.</li>
 </ul>
-<h4 id="v1224"><a class="wlink" href="#v1224"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.24</h4>
+<h4 id="v1224"><a class="wlink" href="#v1224"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.24 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added support for <code>%CLINK_RPROMPT%</code> to show a right side prompt, and for prompt filters to define a <code>:rightfilter()</code> function to filter the right side prompt.</li>
 <li>Fixed <code>clink-select-complete</code> to not append a space after a flag that ends with <code>:</code> or <code>=</code> (e.g. <code>/x:</code>).</li>
 </ul>
-<h4 id="v1223"><a class="wlink" href="#v1223"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.23</h4>
+<h4 id="v1223"><a class="wlink" href="#v1223"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.23 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <kbd>PgUp</kbd> and <kbd>PgDn</kbd> in the <code>clink-select-complete</code> command, under certain conditions where they don&#39;t navigate in the intended manner.</li>
 <li>Cosmetic change: better key names for <kbd>Enter</kbd> vs <kbd>Ctrl</kbd>+<kbd>M</kbd>, and <kbd>Alt</kbd>+<kbd>Bkspc</kbd> vs <kbd>Alt</kbd>+<kbd>Ctrl</kbd>+<kbd>H</kbd>, depending on the <code>terminal.differentiate_keys</code> setting.</li>
 </ul>
-<h4 id="v1222"><a class="wlink" href="#v1222"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.22</h4>
+<h4 id="v1222"><a class="wlink" href="#v1222"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.22 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink-what-is</code> command bound by default to <kbd>Alt</kbd>+<kbd>?</kbd>, which shows the key binding for the next key sequence that is input.</li>
 <li>Added <code>rl.getargument()</code> function to get the accumulated Readline numeric argument, if any.  For use in &quot;luafunc:&quot; macros.</li>
@@ -8639,13 +9235,13 @@ <h4 id="v1222"><a class="wlink" href="#v1222"><svg width=16 height=16><use href=
 <li>Fixed the <code>insert-comment</code> command, which accidentally fell back to inserting <code>#</code> after the first prompt (that&#39;s what bash inserts, and shouldn&#39;t be used in Clink).</li>
 <li>Fixed the <code>dump-functions</code> command, which accidentally didn&#39;t list UTF8 key sequences correctly.</li>
 </ul>
-<h4 id="v1221"><a class="wlink" href="#v1221"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.21</h4>
+<h4 id="v1221"><a class="wlink" href="#v1221"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.21 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed backwards exit codes from <code>clink autorun</code> commands.</li>
 <li>Fixed alert message text on startup when <code>debug.log_terminal</code> is set to true.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/143">#143</a>; crash on start when <code>terminal.raw_esc</code> is true (regression introduced in v1.2.19).</li>
 </ul>
-<h4 id="v1220"><a class="wlink" href="#v1220"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.20</h4>
+<h4 id="v1220"><a class="wlink" href="#v1220"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.20 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>os.debugprint()</code> function to print debug text via the OS <code>OutputDebugString()</code> API.</li>
 <li>Enabled match completion coloring even when using match display filtering.</li>
@@ -8654,20 +9250,20 @@ <h4 id="v1220"><a class="wlink" href="#v1220"><svg width=16 height=16><use href=
 <li>Fixed match display filtering in the <code>clink-popup-complete</code> command.</li>
 <li>Fixed quirk from Readline where it sometimes displays one fewer columns of matches than actually fit on the screen.</li>
 </ul>
-<h4 id="v1219"><a class="wlink" href="#v1219"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.19</h4>
+<h4 id="v1219"><a class="wlink" href="#v1219"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.19 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink-select-complete</code> command which shows an interactive list of possible completions.</li>
 <li>Added terminal emulation for CGI G, CSI s, and CSI u sequences.</li>
 <li>Fixed column alignment for match display filtering when some characters take more than one cell to display.</li>
 </ul>
-<h4 id="v1218"><a class="wlink" href="#v1218"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.18</h4>
+<h4 id="v1218"><a class="wlink" href="#v1218"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.18 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added completions for <code>clink installscripts</code> and <code>clink uninstallscripts</code>.</li>
 <li>Added support for Readline&#39;s coloring and marking of symlinks.</li>
 <li>Fixed <code>clink installscripts --help</code>.</li>
 <li>Fixed <code>clink-popup-directories</code> for directories with spaces.</li>
 </ul>
-<h4 id="v1217"><a class="wlink" href="#v1217"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.17</h4>
+<h4 id="v1217"><a class="wlink" href="#v1217"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.17 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink-popup-show-help</code> command to show popup list with searchable list of key bindings and invoke the selected key binding.</li>
 <li>Added <code>clink.popuplist()</code> function to show a popup list.  Only usable from inside a &quot;luafunc:&quot; key binding.</li>
@@ -8675,7 +9271,7 @@ <h4 id="v1217"><a class="wlink" href="#v1217"><svg width=16 height=16><use href=
 <li>Fixed potential internal error when a doskey alias starts with <code>$</code> (regression introduced in v1.2.16).</li>
 <li>Fixed potential infinite loop when the <code>cmd.auto_answer</code> setting is enabled but an error occurs while retrieving a language string (might be related to <a href="https://github.com/chrisant996/clink/issues/137">#137</a>).</li>
 </ul>
-<h4 id="v1216"><a class="wlink" href="#v1216"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.16</h4>
+<h4 id="v1216"><a class="wlink" href="#v1216"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.16 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li><strong>Breaking Change:</strong> The <code>clink.onendedit()</code> Lua event has been split into two separate events:<ul>
 <li><code>clink.onendedit()</code> registers a function to be called when the edit prompt ends.</li>
@@ -8686,11 +9282,11 @@ <h4 id="v1216"><a class="wlink" href="#v1216"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/134">#134</a>; <code>print()</code> can stop working.  Issue <a href="https://github.com/chrisant996/clink/issues/93">#93</a> can potentially happen any time redirection is used, so the fix must be applied repeatedly (not just after Clink injection).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/119">#119</a>; reuse registered parsers for doskey macros.</li>
 </ul>
-<h4 id="v1215"><a class="wlink" href="#v1215"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.15</h4>
+<h4 id="v1215"><a class="wlink" href="#v1215"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.15 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/132">#132</a>; multiline prompt gets overwritten when resizing the terminal width (regression introduced in v1.2.14).</li>
 </ul>
-<h4 id="v1214"><a class="wlink" href="#v1214"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.14</h4>
+<h4 id="v1214"><a class="wlink" href="#v1214"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.14 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Automatically runs <code>clink_start.cmd</code> from the binaries directory and/or the profile directory when Clink is injected.</li>
 <li>Clink is able to retrieve the last exit code for use by Lua scripts.<ul>
@@ -8702,16 +9298,16 @@ <h4 id="v1214"><a class="wlink" href="#v1214"><svg width=16 height=16><use href=
 <li>Improved refreshing the input line when resizing the terminal window.  It&#39;s better than before, but there&#39;s no way to make it work perfectly because Windows can resize the terminal further while a program is already trying to respond to the terminal having been resized previously.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/130">#130</a>; doskey alias completions stop working when there are many aliases.</li>
 </ul>
-<h4 id="v1213"><a class="wlink" href="#v1213"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.13</h4>
+<h4 id="v1213"><a class="wlink" href="#v1213"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.13 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added support for linking a parser to flags ending with <code>:</code> or <code>=</code>; now completion works for the flag&#39;s argument.</li>
 </ul>
-<h4 id="v1212"><a class="wlink" href="#v1212"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.12</h4>
+<h4 id="v1212"><a class="wlink" href="#v1212"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.12 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Improved diagnostic output for coroutines (<kbd>Ctrl</kbd>-<kbd>X</kbd>,<kbd>Ctrl</kbd>+<kbd>Z</kbd>), plus more diagnostic info when the <code>lua.debug</code> setting is enabled.</li>
 <li>Fixed potential for a script error when a coroutine gets skipped due to a new prompt starting.</li>
 </ul>
-<h4 id="v1211"><a class="wlink" href="#v1211"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.11</h4>
+<h4 id="v1211"><a class="wlink" href="#v1211"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.11 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.print()</code> function which behaves like <code>print()</code> but with support for ANSI escape codes (and terminal emulation), and also a <code>NONL</code> special argument that suppresses the usual newline at the end of the output.</li>
 <li>Expanded the sample code for async prompt filtering to clarify some things.</li>
@@ -8721,7 +9317,7 @@ <h4 id="v1211"><a class="wlink" href="#v1211"><svg width=16 height=16><use href=
 </ul>
 </li>
 </ul>
-<h4 id="v1210"><a class="wlink" href="#v1210"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.10</h4>
+<h4 id="v1210"><a class="wlink" href="#v1210"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.10 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added asynchronous prompt filtering -- scripts can use this to do work in the background (e.g. <code>git status</code>) and refresh the prompt when finished.<ul>
 <li>Added <code>clink.promptcoroutine()</code> function to allow a prompt filter to do some work in the background.</li>
@@ -8738,20 +9334,20 @@ <h4 id="v1210"><a class="wlink" href="#v1210"><svg width=16 height=16><use href=
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/123">#123</a>; Failed to inject (Host validation failed).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/117">#117</a>; Setup causes &quot;System Error&quot;.</li>
 </ul>
-<h4 id="v129"><a class="wlink" href="#v129"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.9</h4>
+<h4 id="v129"><a class="wlink" href="#v129"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.9 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added detection for possible antivirus interference when injecting Clink.</li>
 <li>Ignore duplicate scripts paths when loading scripts.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/118">#118</a>; inputrc is not read from state directory (regression introduced in v1.0.0).</li>
 </ul>
-<h4 id="v128"><a class="wlink" href="#v128"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.8</h4>
+<h4 id="v128"><a class="wlink" href="#v128"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.8 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <code>...\</code> or <code>.../</code> to change directories (path separator after several dots).</li>
 <li>Fixed <code>/dirname/</code> to change directories (forward slashes when a directory is the only thing in the input line).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/114">#114</a>; &quot;Clink already loaded in process&quot; error when autorun is installed for both Current User and All Users.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/113">#113</a>; forward slash translation didn&#39;t work with the <code>cd</code> command.</li>
 </ul>
-<h4 id="v127"><a class="wlink" href="#v127"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.7</h4>
+<h4 id="v127"><a class="wlink" href="#v127"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.7 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/113">#113</a>; <code>clink.slash_translation()</code> had been removed (regression introduced in v1.0.0).<ul>
 <li>The new <code>match.translate_slashes</code> setting controls the default behavior for slash translation for completion matches.</li>
@@ -8759,14 +9355,14 @@ <h4 id="v127"><a class="wlink" href="#v127"><svg width=16 height=16><use href="#
 </ul>
 </li>
 </ul>
-<h4 id="v126"><a class="wlink" href="#v126"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.6</h4>
+<h4 id="v126"><a class="wlink" href="#v126"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.6 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed tilde expansion for directory by itself; now <code>~\</code> can change the working directory to the <code>~</code> directory.</li>
 <li>Fixed pagination when displaying completions that take more than 1 line to display.</li>
 <li>Fixed inserting directory match completions when a Lua script didn&#39;t include a trailing path separator in the directory match.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/111">#111</a>; <code>..</code> completion is different from bash (regression introduced in v1.0.0).</li>
 </ul>
-<h4 id="v125"><a class="wlink" href="#v125"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.5</h4>
+<h4 id="v125"><a class="wlink" href="#v125"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.5 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>os.expandenv()</code> function to expand environment variables in a string.</li>
 <li>Added <code>console.cellcount()</code> function to count the cells a string will use when displayed.</li>
@@ -8777,7 +9373,7 @@ <h4 id="v125"><a class="wlink" href="#v125"><svg width=16 height=16><use href="#
 <li>Fixed <code>clink inject --profile</code> to use correct log file name while initially injecting.</li>
 <li>Fixed Clink autorun to be more compatible with Cmder (<a href="https://github.com/cmderdev/cmder/issues/2536">Cmder #2536</a>).</li>
 </ul>
-<h4 id="v124"><a class="wlink" href="#v124"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.4</h4>
+<h4 id="v124"><a class="wlink" href="#v124"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.4 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added support for <kbd>Shift</kbd>+<kbd>Arrows</kbd> to select text and typing to replace selected text.</li>
 <li>Added optional argument to <code>word_classifications:classifyword()</code> and <code>word_classifications:applycolor()</code> to allow only applying color where another color hasn&#39;t yet been applied.</li>
@@ -8790,7 +9386,7 @@ <h4 id="v124"><a class="wlink" href="#v124"><svg width=16 height=16><use href="#
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/107">#107</a>; autorun reports inject failures (regression introduced in v1.2.3).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/106">#106</a>; history missing <code>--bare</code> option (regression introduced in v1.2.3).</li>
 </ul>
-<h4 id="v123"><a class="wlink" href="#v123"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.3</h4>
+<h4 id="v123"><a class="wlink" href="#v123"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.3 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>history.sticky_search</code> setting:  when enabled, reusing a history line does not add the reused line to the end of the history, and it leaves the history search position on the reused line so next/prev history can continue from there (e.g. replaying commands via <kbd>Up</kbd> several times then <kbd>Enter</kbd>, <kbd>Down</kbd>, <kbd>Enter</kbd>, etc).</li>
 <li>Added failure reporting and logging when <code>clink inject</code> fails.</li>
@@ -8801,11 +9397,11 @@ <h4 id="v123"><a class="wlink" href="#v123"><svg width=16 height=16><use href="#
 <li>Fixed incremental search in the History popup list to search in reverse order (bottom to top).</li>
 <li>Fixed <code>clink-popup-history</code> to set the history search position like other history search commands do, so that it plays well with the <code>history.sticky_search</code> setting.</li>
 </ul>
-<h4 id="v122"><a class="wlink" href="#v122"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.2</h4>
+<h4 id="v122"><a class="wlink" href="#v122"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.2 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>%CLINK_HISTORY_LABEL%</code> environment variable to use a different master history file (fixes <a href="https://github.com/chrisant996/clink/issues/99">#99</a>).</li>
 </ul>
-<h4 id="v121"><a class="wlink" href="#v121"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.1</h4>
+<h4 id="v121"><a class="wlink" href="#v121"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2.1 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added Troubleshooting Tips section in the documentation.</li>
 <li>Added backward compatibility for <code>clink set</code> with v0.4.9.  Old setting names and values are not documented, but are automatically mapped to the appropriate new setting(s).  This was done so that suggestions in old web sites and posts can usually continue to work, to reduce confusion and support burden.</li>
@@ -8813,51 +9409,51 @@ <h4 id="v121"><a class="wlink" href="#v121"><svg width=16 height=16><use href="#
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/96">#96</a>; wrong setting string (the name of a setting was accidentally truncated).</li>
 <li>Fixed some slightly inaccurate/incomplete migration from old settings to new settings.</li>
 </ul>
-<h4 id="v12"><a class="wlink" href="#v12"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2</h4>
+<h4 id="v12"><a class="wlink" href="#v12"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.2 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>First official release from <a href="https://github.com/chrisant996/clink">chrisant996/clink</a> fork.</li>
 </ul>
-<h4 id="v1149"><a class="wlink" href="#v1149"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.49</h4>
+<h4 id="v1149"><a class="wlink" href="#v1149"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.49 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.classifier()</code> to enable coloring the input line independently from argmatchers.</li>
 <li>Added <code>word_classifications:applycolor()</code> to apply SGR escape codes anywhere in the input line.</li>
 <li>Removed <code>word_classifications:iswordclassified()</code>.</li>
 <li>Fixed the Product Version string in the binary file version resources.</li>
 </ul>
-<h4 id="v1148"><a class="wlink" href="#v1148"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.48</h4>
+<h4 id="v1148"><a class="wlink" href="#v1148"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.48 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.getansihost()</code> function to get Clink&#39;s best guess who will process ANSI escape codes (can be useful for avoiding 256 bit and 24 bit color codes, for example).</li>
 <li>Added detection for being hosted in ConsoleZ.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/20">#20</a>; <code>set /p VAR=&quot;&quot;</code> shows the normal command prompt text instead of empty prompt text.</li>
 </ul>
-<h4 id="v1147"><a class="wlink" href="#v1147"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.47</h4>
+<h4 id="v1147"><a class="wlink" href="#v1147"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.47 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added default key binding for <kbd>Ctrl</kbd>+<kbd>Space</kbd> to invoke <code>old-menu-complete</code>, which is the most similar to CMD&#39;s standard <kbd>Tab</kbd> behavior.</li>
 <li>Fixed <code>search-ignore-case</code> config variable to be on by default.</li>
 </ul>
-<h4 id="v1146"><a class="wlink" href="#v1146"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.46</h4>
+<h4 id="v1146"><a class="wlink" href="#v1146"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.46 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>rl.setvariable()</code> to temporarily override the value of a Readline config variable.</li>
 <li>The completion commands now also expand tilde by itself (<code>~</code>), in addition to tilde followed by a path separator (<code>~\etc</code>).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/94">#94</a>; setting <code>history.save</code> to False also disables interactive history in subsequent sessions.</li>
 </ul>
-<h4 id="v1145"><a class="wlink" href="#v1145"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.45</h4>
+<h4 id="v1145"><a class="wlink" href="#v1145"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.45 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/93">#93</a>; stdout is sometimes broken by Cmder init.bat.</li>
 </ul>
-<h4 id="v1144"><a class="wlink" href="#v1144"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.44</h4>
+<h4 id="v1144"><a class="wlink" href="#v1144"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.44 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.getsession()</code>.</li>
 <li>Added <code>%CLINK_NOAUTORUN%</code> which overrides automatic inject when Clink is installed for autorun.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/92">#92</a>; <code>clink-popup-history</code> and similar commands not working with ConEmu and Cmder (regression introduced in v1.1.25).</li>
 </ul>
-<h4 id="v1143"><a class="wlink" href="#v1143"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.43</h4>
+<h4 id="v1143"><a class="wlink" href="#v1143"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.43 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink history --diag</code> flag that prints diagnostic information while performing history operations.</li>
 <li>Minor optimization in <code>clink history</code> when printing the full list of history items.</li>
 <li>Fixed <code>clink history compact</code> so it actually performs compaction.</li>
 </ul>
-<h4 id="v1142"><a class="wlink" href="#v1142"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.42</h4>
+<h4 id="v1142"><a class="wlink" href="#v1142"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.42 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink history --bare</code> flag to omit history item numbers.</li>
 <li>Added several Lua functions:<ul>
@@ -8875,14 +9471,14 @@ <h4 id="v1142"><a class="wlink" href="#v1142"><svg width=16 height=16><use href=
 <li>Fixed backwards return value from <code>rl.invokecommand()</code>.</li>
 <li>Fixed console input/output modes across &quot;luafunc:&quot; key bindings, in case the Lua functions spawn a process that alters the console mode without restoring it.</li>
 </ul>
-<h4 id="v1141"><a class="wlink" href="#v1141"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.41</h4>
+<h4 id="v1141"><a class="wlink" href="#v1141"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.41 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>terminal.adjust_cursor_style</code> setting as a workaround to avoid interfering with the Windows 10 Cursor Shape console setting.  There are several trade-offs, though.</li>
 <li>Added <code>rl_buffer:refreshline()</code> function to redraw the input line, e.g. in case something has written over it.</li>
 <li>Added <code>os.getpid()</code> function to get the process ID, intended mainly to help salt unique resource names.</li>
 <li>Added <code>clink.onfiltermatches()</code> so scripts can register a callback function to run after Clink generates matches and before it displays them.</li>
 </ul>
-<h4 id="v1140"><a class="wlink" href="#v1140"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.40</h4>
+<h4 id="v1140"><a class="wlink" href="#v1140"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.40 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added a group of <code>clink-complete-numbers</code> commands that do completion for numbers from the console screen, bound to <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>N</kbd> by default.</li>
 <li>Added <code>rl.getlastcommand()</code> function that returns the name of the last command invoked by key bindings.</li>
@@ -8891,7 +9487,7 @@ <h4 id="v1140"><a class="wlink" href="#v1140"><svg width=16 height=16><use href=
 <li>Fixed various <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>whatever</kbd> combinations (regression introduced in v1.1.39).</li>
 <li>Fixed <code>rl.setmatches()</code> when the input line is not empty and <code>clink.colorize_input</code> is enabled.</li>
 </ul>
-<h4 id="v1139"><a class="wlink" href="#v1139"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.39</h4>
+<h4 id="v1139"><a class="wlink" href="#v1139"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.39 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added support for many more key bindings, such as <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+Letter keys.</li>
 <li>Added <code>terminal.differentiate_keys</code> setting that when enabled allows binding <kbd>Ctrl</kbd> + <kbd>H</kbd> or <kbd>I</kbd> or <kbd>M</kbd> or <kbd>[</kbd> separately from <kbd>Backspace</kbd>, <kbd>Tab</kbd>, <kbd>Return</kbd>, or <kbd>Escape</kbd>.</li>
@@ -8901,53 +9497,53 @@ <h4 id="v1139"><a class="wlink" href="#v1139"><svg width=16 height=16><use href=
 <li>Fixed <code>terminal.use_altgr_substitute</code> to only affect <kbd>AltGr</kbd> substitute key combinations (it had always broken the <kbd>RightAlt</kbd> key in general on other keyboard layouts).</li>
 <li>Fixed a benign issue with the console input mode in <code>clink echo</code>.</li>
 </ul>
-<h4 id="v1138"><a class="wlink" href="#v1138"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.38</h4>
+<h4 id="v1138"><a class="wlink" href="#v1138"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.38 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/84">#84</a>; added <code>terminal.use_altgr_substitute</code> setting.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/80">#80</a>; clink.log is not deleted when Cmder injects Clink.</li>
 </ul>
-<h4 id="v1137"><a class="wlink" href="#v1137"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.37</h4>
+<h4 id="v1137"><a class="wlink" href="#v1137"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.37 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed copy to clipboard (it never cleared the clipboard!).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/82">#82</a>; added two new <code>clink.paste_crlf</code> modes: <code>ampersand</code> replaces newlines with ampersands, and <code>crlf</code> pastes newlines as-is and executes any commands ending in a newline.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/69">#69</a>; space in the prompt disappears after enter echo: added support for CJK codepages.</li>
 </ul>
-<h4 id="v1136"><a class="wlink" href="#v1136"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.36</h4>
+<h4 id="v1136"><a class="wlink" href="#v1136"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.36 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/79">#79</a>; Issue with United States - international keyboard layout (regression introduced in v1.1.0).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/78">#78</a>; crash when history file contains a line longer than 8192 characters (regression introduced in v1.1.2-alpha).</li>
 </ul>
-<h4 id="v1135"><a class="wlink" href="#v1135"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.35</h4>
+<h4 id="v1135"><a class="wlink" href="#v1135"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.35 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed when the <code>mark-directories</code> inputrc variable is <code>off</code> (regression introduced in v1.1.1-alpha).</li>
 <li>Fixed Lua reading from stdin, especially in the Lua debugger (regression introduced in v1.1.25).</li>
 <li>Fixed exponential cost performance bug in Readline when removing duplicate matches.</li>
 </ul>
-<h4 id="v1134"><a class="wlink" href="#v1134"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.34</h4>
+<h4 id="v1134"><a class="wlink" href="#v1134"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.34 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed copying to clipboard (CF_UNICODETEXT was put on the clipboard correctly, but CF_TEXT was empty and should have been omitted to let Windows automatically convert it from the Unicode text).</li>
 </ul>
-<h4 id="v1133"><a class="wlink" href="#v1133"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.33</h4>
+<h4 id="v1133"><a class="wlink" href="#v1133"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.33 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Make the &quot;replacing arglink&quot; warning message a little more informative, and write a lua traceback to the Clink log file.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/77">#77</a>; with ConsoleZ scrolling does not always work.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/76">#76</a>; cannot <code>cd</code> up multiple directories normally.</li>
 </ul>
-<h4 id="v1132"><a class="wlink" href="#v1132"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.32</h4>
+<h4 id="v1132"><a class="wlink" href="#v1132"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.32 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added support for non-standard escape codes to set the window title or print environment variables.  Depending on the <code>terminal.emulation</code> setting, the behavior is slightly different.  When <code>emulate</code> Clink processes the escape codes.  When <code>native</code> with ConEmu (and Clink) the escape codes are passed to ConEmu, except that Clink processes the environment variable codes in prompt strings.  When <code>native</code> with other terminals, Clink preprocesses the title and environment variable escape codes in prompt strings, but passes the escape codes to the terminal outside of prompt strings.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/67">#67</a>; AutoRun interferes with Cmder.</li>
 </ul>
-<h4 id="v1131"><a class="wlink" href="#v1131"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.31</h4>
+<h4 id="v1131"><a class="wlink" href="#v1131"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.31 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/74">#74</a>; clink gets confused by non-standard ConEmu escape codes.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/73">#73</a>; <code>exec.space_prefix</code> and other settings defined in Lua scripts don&#39;t take effect until second input line (regression introduced in v1.1.4).</li>
 </ul>
-<h4 id="v1130"><a class="wlink" href="#v1130"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.30</h4>
+<h4 id="v1130"><a class="wlink" href="#v1130"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.30 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed history compacting on x86 (regression introduced in v1.1.2-alpha).</li>
 </ul>
-<h4 id="v1129"><a class="wlink" href="#v1129"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.29</h4>
+<h4 id="v1129"><a class="wlink" href="#v1129"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.29 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink installscripts</code> and <code>clink uninstallscripts</code> to make it easy for package managers like Scoop to install/uninstall script packages for use with Clink.  The installed script paths are stored in the registry for the current user.</li>
 <li>Fixed <code>bold</code> vs <code>bright</code> colors to more accurately follow generally accepted ANSI escape code conventions:<ul>
@@ -8961,24 +9557,24 @@ <h4 id="v1129"><a class="wlink" href="#v1129"><svg width=16 height=16><use href=
 <li>Fixed the <code>clink --profile</code> flag (regression introduced in v1.1.10).</li>
 <li>Fixed <code>clink info</code> to accurately report the script dirs (it didn&#39;t account for the <code>clink.path</code> setting correctly).</li>
 </ul>
-<h4 id="v1128"><a class="wlink" href="#v1128"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.28</h4>
+<h4 id="v1128"><a class="wlink" href="#v1128"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.28 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Renamed the <code>log.rl_terminal</code> setting to <code>debug.log_terminal</code>; it has already been repeatedly very useful in multiple was since it was added, so it stays.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/70">#70</a>; ctrl+c not working (regression introduced in v1.1.25).</li>
 </ul>
-<h4 id="v1127"><a class="wlink" href="#v1127"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.27</h4>
+<h4 id="v1127"><a class="wlink" href="#v1127"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.27 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>color.argmatcher</code> setting which, when set, is used to color a command name if it has an associated argmatcher (this supersedes <code>color.cmd</code>, <code>color.doskey</code>, and <code>color.input</code>).  By default it&#39;s not set.</li>
 <li>Added <code>log.rl_terminal</code> setting which logs all terminal input and output for Readline (this setting may be renamed or removed in the future).</li>
 </ul>
-<h4 id="v1126"><a class="wlink" href="#v1126"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.26</h4>
+<h4 id="v1126"><a class="wlink" href="#v1126"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.26 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>rl.invokecommand()</code> which can invoke a Readline command from inside a &quot;luafunc:&quot; key binding.</li>
 <li>Added <code>rl.setmatches()</code> which can override match completions from inside a &quot;luafunc:&quot; key binding.</li>
 <li>Worked around UTF8 key binding problem with Readline which had been causing some meta key bindings (M-x, M-C-x, etc) to sometimes produce garbled key bindings and garbled entries in <code>clink-show-help</code> (<kbd>Alt</kbd>+<kbd>H</kbd>).</li>
 <li>Fixed crash if &quot;luafunc:&quot; key binding macro refers to a symbol that doesn&#39;t exist.</li>
 </ul>
-<h4 id="v1125"><a class="wlink" href="#v1125"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.25</h4>
+<h4 id="v1125"><a class="wlink" href="#v1125"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.25 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink-find-conhost</code> command that, when in a default (conhost) console window, is equivalent to picking &quot;Find...&quot; from the system menu.</li>
 <li>Added <code>clink-mark-conhost</code> command that, when in a default (conhost) console window, is equivalent to picking &quot;Mark&quot; from the system menu.</li>
@@ -8989,7 +9585,7 @@ <h4 id="v1125"><a class="wlink" href="#v1125"><svg width=16 height=16><use href=
 <li>Fixed popup window location and size when using Windows Terminal.</li>
 <li>Fixed input coloring after <code>operate-and-get-next</code>; also fixes brief flicker of incorrect coloring whenever the input line is modified.</li>
 </ul>
-<h4 id="v1124"><a class="wlink" href="#v1124"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.24</h4>
+<h4 id="v1124"><a class="wlink" href="#v1124"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.24 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li><code>auto</code> for <code>terminal.emulation</code> now uses native VT support on Windows 10 build 15063 and higher, unless the HKCU\Console\ForceV2 regkey is 0.</li>
 <li>Special quote handling now enables <code>&quot;dir\&quot;fi</code> to complete to <code>&quot;dir\file&quot;</code>.  CMD simply strips quotes during completion, and now Clink behaves similarly.</li>
@@ -9003,13 +9599,13 @@ <h4 id="v1124"><a class="wlink" href="#v1124"><svg width=16 height=16><use href=
 <li>Fixed completion in some circumstances.  Readline and Clink didn&#39;t always agree on where the word breaks were; now Clink always tells Readline where the word breaks are (so that completion, input colorization, and lua scripts can all work properly and consistently).</li>
 <li>Fixed 256 color ANSI codes.</li>
 </ul>
-<h4 id="v1123"><a class="wlink" href="#v1123"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.23</h4>
+<h4 id="v1123"><a class="wlink" href="#v1123"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.23 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/57">#57</a>; slashes not normalized in some cases.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/45">#45</a>; interaction between <code>history.dupe_mode</code>=<code>erase_prev</code> and <code>history.shared</code>=<code>false</code>.</li>
 <li>Fixed <code>menu-complete-wraparound</code> when off and there&#39;s only 1 match.</li>
 </ul>
-<h4 id="v1122"><a class="wlink" href="#v1122"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.22</h4>
+<h4 id="v1122"><a class="wlink" href="#v1122"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.22 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>menu-complete-wraparound</code> (on by default) that controls whether completion commands wrap around when cycling past an end (affects popup windows as well).</li>
 <li>Fixed match completion getting stuck (regression introduced in v1.1.19).</li>
@@ -9017,7 +9613,7 @@ <h4 id="v1122"><a class="wlink" href="#v1122"><svg width=16 height=16><use href=
 <li>Fixed <code>clink-show-help</code> (<kbd>Alt</kbd>+<kbd>H</kbd>) so it&#39;s able to list <code>C-@</code> bindings.</li>
 <li>Fixed inconsistent mark color.</li>
 </ul>
-<h4 id="v1121"><a class="wlink" href="#v1121"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.21</h4>
+<h4 id="v1121"><a class="wlink" href="#v1121"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.21 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.oninject()</code> so scripts can register a callback function to run when Clink is injected into CMD.</li>
 <li>Added <code>console.linehascolor()</code> function that returns whether the specified line contains any of the specified colors.</li>
@@ -9025,7 +9621,7 @@ <h4 id="v1121"><a class="wlink" href="#v1121"><svg width=16 height=16><use href=
 <li>Fixed doskey alias parsing for match generators and input line coloring (Clink had been using slightly different parsing rules than CMD does).</li>
 <li>Fixed the &quot;-- More --&quot; prompt while listing key bindings; <kbd>Esc</kbd> didn&#39;t quit, and unexpected keys weren&#39;t ignored.</li>
 </ul>
-<h4 id="v1120"><a class="wlink" href="#v1120"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.20</h4>
+<h4 id="v1120"><a class="wlink" href="#v1120"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.20 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Now you can bind Lua functions to keys via &quot;luafunc:&quot; macros!  Added new <code>rl_buffer</code> type that gets passed to the Lua function.</li>
 <li>Added a group of <code>console</code> Lua APIs intended mainly for use by Lua function key bindings (e.g. <code>console.scroll()</code>).</li>
@@ -9038,12 +9634,12 @@ <h4 id="v1120"><a class="wlink" href="#v1120"><svg width=16 height=16><use href=
 <li>Fixed environment variable completion (regression introduced in v1.1.19).</li>
 <li>Fixed Cmder startup (regression introduced in v1.1.17).  Cmder expects to be able to replace Clink v0.4.9&#39;s clink.lua file, but there is no such thing anymore in newer versions of Clink.  To be properly backwardly compatible with Clink v0.4.9 requires loading clink.lua (if it exists) from the first script directory listed by <code>clink info</code>, and ignoring clink.lua files in all other script directories.</li>
 </ul>
-<h4 id="v1119"><a class="wlink" href="#v1119"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.19</h4>
+<h4 id="v1119"><a class="wlink" href="#v1119"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.19 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Improved responsiveness while typing:  matches are collected only on demand, instead of always while typing.  This makes it possible to always support match completion for UNC paths.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/50">#50</a>; <kbd>Alt</kbd>+<kbd>H</kbd> could warn about likely mistakes in key bindings.</li>
 </ul>
-<h4 id="v1118"><a class="wlink" href="#v1118"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.18</h4>
+<h4 id="v1118"><a class="wlink" href="#v1118"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.18 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>The input text now has context sensitive coloring based on the argmatchers. It&#39;s on by default and can be turned off with <code>clink set clink.colorize_input false</code>.</li>
 <li>Updated the Readline library to 8.1.</li>
@@ -9054,13 +9650,13 @@ <h4 id="v1118"><a class="wlink" href="#v1118"><svg width=16 height=16><use href=
 <li>Fixed restoring color after pager when showing help.</li>
 <li>Fixed <code>clink set</code> match completions for color settings.</li>
 </ul>
-<h4 id="v1117"><a class="wlink" href="#v1117"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.17</h4>
+<h4 id="v1117"><a class="wlink" href="#v1117"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.17 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>os.getbatterystatus()</code> function that gets battery status information much faster than launching <code>wmic</code>.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/44">#44</a>; Path completion doesn&#39;t work with <code>cd /d</code>.</li>
 <li>Fixed loading scripts to ignore loading clink.lua, so that loading scripts behaves like Clink v0.4.9.</li>
 </ul>
-<h4 id="v1116"><a class="wlink" href="#v1116"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.16</h4>
+<h4 id="v1116"><a class="wlink" href="#v1116"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.16 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>match.ignore_accent</code> setting (enabled by default) that ignores Latin alphabet diacriticals when completing matches (e.g. <code>ä</code> matches <code>a</code>, <code>ı</code> matches <code>i</code>, <code>ł</code> matches <code>l</code>, etc).</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/42">#42</a>; history lines are split on special characters.</li>
@@ -9068,7 +9664,7 @@ <h4 id="v1116"><a class="wlink" href="#v1116"><svg width=16 height=16><use href=
 <li>Fixed Readline bug inserting dir matches; <code>\win_  foo</code> (cursor at <code>_</code>) would become <code>\Windows\\_  foo</code>.</li>
 <li>Fixed the <code>quoted-insert</code> command to insert just <code>\x1b</code> when <kbd>ESC</kbd> is pressed.</li>
 </ul>
-<h4 id="v1115"><a class="wlink" href="#v1115"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.15</h4>
+<h4 id="v1115"><a class="wlink" href="#v1115"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.15 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Migrating settings now immediately writes a new settings file, instead of waiting until a setting is changed.</li>
 <li>Added support to detect when running in Windows Terminal and use native terminal support (which enables things like Xterm 256 and 24-bit color support).</li>
@@ -9079,22 +9675,22 @@ <h4 id="v1115"><a class="wlink" href="#v1115"><svg width=16 height=16><use href=
 <li>Fixed the <code>clink.print()</code> Lua function so it also works during loading scripts and during prompt filtering.</li>
 <li>Fixed the Readline input text display getting garbled if the filtered prompt includes Xterm&#39;s OSC window title code (<code>\x1b]0;text\x07</code>). Clink doesn&#39;t support that escape code, but at no longer garbles the input text if that escape code is present.</li>
 </ul>
-<h4 id="v1114"><a class="wlink" href="#v1114"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.14</h4>
+<h4 id="v1114"><a class="wlink" href="#v1114"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.14 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Migrate settings and history from an old version of Clink, if present.  This only happens if the new-version Clink settings or history files don&#39;t exist.  (Deleting an existing new-version Clink settings or history file will cause migration to happen again.)</li>
 <li>Added <code>color.prompt</code> setting for backward compatibility with Clink v0.4.x.</li>
 </ul>
-<h4 id="v1113"><a class="wlink" href="#v1113"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.13</h4>
+<h4 id="v1113"><a class="wlink" href="#v1113"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.13 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <code>clink.arg.register_parser</code> backward compatibility.</li>
 </ul>
-<h4 id="v1112"><a class="wlink" href="#v1112"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.12</h4>
+<h4 id="v1112"><a class="wlink" href="#v1112"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.12 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added <code>clink.ondisplaymatches()</code> as a replacement for the deprecated <code>clink.match_display_filter</code>.  The new API is able to support popup list windows as well.</li>
 <li>Speculative possible fix for <a href="https://github.com/chrisant996/clink/issues/35">#35</a> Crash when clink on clink.bat.</li>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/33">#33</a>; Tab autocomplete, auto-quoting paths doesn&#39;t seem to work as in Clink 0.4.9.</li>
 </ul>
-<h4 id="v1111"><a class="wlink" href="#v1111"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.11</h4>
+<h4 id="v1111"><a class="wlink" href="#v1111"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.11 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Changed to load Lua scripts only once per session, unless forced to reload them.  This enables backward compatibility for things like <a href="https://github.com/skywind3000/z.lua">z.lua</a> which has certain features that rely on Clink only loading scripts once per session.</li>
 <li>Added <code>clink.onbeginedit()</code> so scripts can register a callback function to run each time the edit prompt is activated.</li>
@@ -9102,11 +9698,11 @@ <h4 id="v1111"><a class="wlink" href="#v1111"><svg width=16 height=16><use href=
 <li>Added <code>color.message</code> setting for the Readline message area color (e.g. the search prompt message or digit argument prompt message, etc).</li>
 <li>Fixed stray sticky <code>=</code> appended to completions after typing <code>set </code> and then typing a different command.</li>
 </ul>
-<h4 id="v1110"><a class="wlink" href="#v1110"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.10</h4>
+<h4 id="v1110"><a class="wlink" href="#v1110"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.10 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <a href="https://github.com/chrisant996/clink/issues/32">#32</a>; hooking <code>ReadConsoleW</code> on Windows 7.</li>
 </ul>
-<h4 id="v119"><a class="wlink" href="#v119"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.9</h4>
+<h4 id="v119"><a class="wlink" href="#v119"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.9 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Added backward compatibility for <code>clink.match_display_filter</code>.  The clink-completions/git.lua script uses it a lot, and that should all be working now.</li>
 <li><code>settings.add</code> adds a color setting when the type is string and the name starts with &quot;color.&quot;.</li>
@@ -9122,7 +9718,7 @@ <h4 id="v119"><a class="wlink" href="#v119"><svg width=16 height=16><use href="#
 <li>Fixed potentially-missing trailing path separator when <code>menu-complete</code> completes a directory match (regression introduced by wildcard matching in v1.1.5).</li>
 <li>Other obscure minor fixes.</li>
 </ul>
-<h4 id="v118"><a class="wlink" href="#v118"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.8</h4>
+<h4 id="v118"><a class="wlink" href="#v118"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.8 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed file match completions when an argmatcher only generates flag matches.</li>
 <li>Fixed automatic inferring whether Readline should use filename completion and/or display rules (regression introduced by backward compatibility in v1.1.3-alpha).</li>
@@ -9133,7 +9729,7 @@ <h4 id="v118"><a class="wlink" href="#v118"><svg width=16 height=16><use href="#
 </li>
 <li>Fixed backward compatibility for coloring matches (regression introduced by backward compatibility changes in v1.1.4).</li>
 </ul>
-<h4 id="v117"><a class="wlink" href="#v117"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.7</h4>
+<h4 id="v117"><a class="wlink" href="#v117"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.7 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Performance improvement when displaying matches:  When enumerating files and dirs, the <code>os.globfiles</code> and <code>os.globdirs</code> functions have all the info about each file.  Now they can return that info in a table.  This frees the match display function from needing to do any further file system IO.  The performance boost is noticeable.</li>
 <li>Rewrote the color settings:  the .fg and .bg sub-settings are gone, and the main setting now uses a more natural syntax (e.g. <code>clink set color.input bright yellow</code> or <code>clink set color.modmark bright cyan on blue</code>).</li>
@@ -9142,13 +9738,13 @@ <h4 id="v117"><a class="wlink" href="#v117"><svg width=16 height=16><use href="#
 <li>Fixed tab completion for <code>clink set <em>setting</em></code>, and also handle the new color setting syntax.</li>
 <li>Fixed confusing behavior if multiple scripts try to add settings with the same name (now the first one succeeds and the rest report errors).</li>
 </ul>
-<h4 id="v116"><a class="wlink" href="#v116"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.6</h4>
+<h4 id="v116"><a class="wlink" href="#v116"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.6 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Hooked up tilde completion in the <code>cd</code>, <code>md</code>, and <code>rd</code> command argmatchers.</li>
 <li>Hooked up tilde completion with the <code>exec.enable</code> setting (&quot;~\pro&quot; matches &quot;C:\Users\myusername\program.exe&quot;).</li>
 <li>When <code>terminal.emulation</code> is <code>auto</code>, now it also detects ANSI{32|64}.DLL just like Clink 0.4.8 did.</li>
 </ul>
-<h4 id="v115"><a class="wlink" href="#v115"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.5</h4>
+<h4 id="v115"><a class="wlink" href="#v115"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.5 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>The <code>menu-complete</code> family of commands now support matching <code>?</code> and <code>*</code> wildcards when the <code>match.wild</code> setting is enabled.</li>
 <li>Added <code>colour.input</code> and <code>colour.modmark</code> settings for coloring Readline&#39;s input line.</li>
@@ -9170,7 +9766,7 @@ <h4 id="v115"><a class="wlink" href="#v115"><svg width=16 height=16><use href="#
 <li>Fixed the <code>exec.cwd</code> Clink setting to default to true, so that the default behavior is consistent with how v0.4.x behaved.</li>
 <li>Fixed the <code>cd</code>, <code>md</code>, <code>rd</code>, etc argmatchers to only match one argument to be consistent with the actual command syntax.</li>
 </ul>
-<h4 id="v114"><a class="wlink" href="#v114"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.4</h4>
+<h4 id="v114"><a class="wlink" href="#v114"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.4 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Automatically detect when running inside ConEmu and disable Clink&#39;s Virtual Terminal emulation.</li>
 <li>Added <code>search-ignore-case</code> inputrc variable that makes the history search commands case insensitive.</li>
@@ -9190,7 +9786,7 @@ <h4 id="v114"><a class="wlink" href="#v114"><svg width=16 height=16><use href="#
 <li>Fixed the key binding list to correctly respect <code>completion-display-width</code>.</li>
 <li><em>No visible effect yet:  internal change that parses the input line to identify colors to use for each word (command, argument, flag, etc), but the colors aren&#39;t yet applied to the input line.</em></li>
 </ul>
-<h4 id="v113-alpha"><a class="wlink" href="#v113-alpha"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.3-alpha</h4>
+<h4 id="v113-alpha"><a class="wlink" href="#v113-alpha"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.3-alpha <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed argmatcher lookup to be more strict, like in Clink 0.4.9 (match exact names, or name plus an extension from %PATHEXT%).</li>
 <li>Backward compatibility:<ul>
@@ -9216,7 +9812,7 @@ <h4 id="v113-alpha"><a class="wlink" href="#v113-alpha"><svg width=16 height=16>
 </ul>
 </li>
 </ul>
-<h4 id="v112-alpha"><a class="wlink" href="#v112-alpha"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.2-alpha</h4>
+<h4 id="v112-alpha"><a class="wlink" href="#v112-alpha"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.2-alpha <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Documentation is mostly updated; just the argmatcher Lua API and Clink command line options are left to be documented.</li>
 <li>Added <code>history.max_lines</code> setting that controls how many lines of command history to save (1 to 50000, default is 2500).</li>
@@ -9248,7 +9844,7 @@ <h4 id="v112-alpha"><a class="wlink" href="#v112-alpha"><svg width=16 height=16>
 </li>
 <li>Set locale to UTF8 much earlier to avoid quirky behavior early in script processing.</li>
 </ul>
-<h4 id="v111-alpha"><a class="wlink" href="#v111-alpha"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.1-alpha</h4>
+<h4 id="v111-alpha"><a class="wlink" href="#v111-alpha"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.1.1-alpha <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Exclusively use Readline&#39;s completion implementation.  This (with fixes and enhancements in Readline itself) makes the completion experience much nicer and more sophisticated, and removes a lot of code that was added in v1.0.0a0.</li>
 <li>Exclusively use Readline&#39;s key binding implementation.  This makes it possible to have a single consistent way to set key bindings (inputrc) and for <code>clink-show-help</code> to list all key bindings, and removes a lot of code that was added in v1.0.0a0.</li>
@@ -9368,8 +9964,8 @@ <h4 id="v111-alpha"><a class="wlink" href="#v111-alpha"><svg width=16 height=16>
 </li>
 <li>Fixed many other bugs.</li>
 </ul>
-<h3 id="releases-from-mridgersclink-original-repo"><a class="wlink" href="#releases-from-mridgersclink-original-repo"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Releases from <a href="https://github.com/mridgers/clink">mridgers/clink</a> original repo</h3>
-<h4 id="v100a1-alpha-test-release"><a class="wlink" href="#v100a1-alpha-test-release"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.0.0a1 <em>(alpha test release)</em></h4>
+<h3 id="releases-from-mridgersclink-original-repo"><a class="wlink" href="#releases-from-mridgersclink-original-repo"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Releases from <a href="https://github.com/mridgers/clink">mridgers/clink</a> original repo <span class="uplinks"><a href="#changes">up</a> <a href="#toc">top</a></span></h3>
+<h4 id="v100a1-alpha-test-release"><a class="wlink" href="#v100a1-alpha-test-release"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.0.0a1 <em>(alpha test release)</em> <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Improve terminal integration with the Readline library.</li>
 <li>Internal improvements to the built-in ecma48 terminal emulator.</li>
@@ -9383,7 +9979,7 @@ <h4 id="v100a1-alpha-test-release"><a class="wlink" href="#v100a1-alpha-test-rel
 <li>The origin path now affects the hash in the dll cache, to guard against directory moves.</li>
 <li>More code reorganization.</li>
 </ul>
-<h4 id="v100a0-alpha-test-release"><a class="wlink" href="#v100a0-alpha-test-release"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.0.0a0 <em>(alpha test release)</em></h4>
+<h4 id="v100a0-alpha-test-release"><a class="wlink" href="#v100a0-alpha-test-release"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.0.0a0 <em>(alpha test release)</em> <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Extensive code reorganization, refactoring, and rewriting -- multiple times -- almost everything was touched.</li>
 <li>OS integration:<ul>
@@ -9451,11 +10047,11 @@ <h4 id="v100a0-alpha-test-release"><a class="wlink" href="#v100a0-alpha-test-rel
 <li>Remove <code>clink_inputrc_base</code> file and embed its content (fixes <a href="https://github.com/mridgers/clink/issues/257">mridgers #257</a>).</li>
 <li>Include more metadata in the Clink&#39;s executables.</li>
 </ul>
-<h4 id="v049"><a class="wlink" href="#v049"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.9</h4>
+<h4 id="v049"><a class="wlink" href="#v049"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.9 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed broken Doskey on Win10 (#438, #451)</li>
 </ul>
-<h4 id="v048"><a class="wlink" href="#v048"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.8</h4>
+<h4 id="v048"><a class="wlink" href="#v048"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.8 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Environment variable <code>clink_profile</code> overrides Clink&#39;s profile path (#390).</li>
 <li>Load a clink_inputrc file from Clink&#39;s profile directory (fixes #406).</li>
@@ -9465,7 +10061,7 @@ <h4 id="v048"><a class="wlink" href="#v048"><svg width=16 height=16><use href="#
 </ul>
 </li>
 </ul>
-<h4 id="v047"><a class="wlink" href="#v047"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.7</h4>
+<h4 id="v047"><a class="wlink" href="#v047"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.7 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Bug fixes;<ul>
 <li>Sometimes autorun tries to run clink.exe (#374).</li>
@@ -9473,7 +10069,7 @@ <h4 id="v047"><a class="wlink" href="#v047"><svg width=16 height=16><use href="#
 </ul>
 </li>
 </ul>
-<h4 id="v046"><a class="wlink" href="#v046"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.6</h4>
+<h4 id="v046"><a class="wlink" href="#v046"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.6 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>HOME is only set if it is currently unset.</li>
 <li>Readline can be initialised with .inputrc and _inputrc files too (#258).</li>
@@ -9498,7 +10094,7 @@ <h4 id="v046"><a class="wlink" href="#v046"><svg width=16 height=16><use href="#
 </ul>
 </li>
 </ul>
-<h4 id="v045"><a class="wlink" href="#v045"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.5</h4>
+<h4 id="v045"><a class="wlink" href="#v045"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.5 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Improved <code>clink autorun</code>. It now defaults to the Current User registry hive.</li>
 <li><code>clink set</code> gives more details for enumeration-type settings.</li>
@@ -9525,7 +10121,7 @@ <h4 id="v045"><a class="wlink" href="#v045"><svg width=16 height=16><use href="#
 </ul>
 </li>
 </ul>
-<h4 id="v044"><a class="wlink" href="#v044"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.4</h4>
+<h4 id="v044"><a class="wlink" href="#v044"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.4 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Completing .. behaves more like Bash (#277).</li>
 <li>Escape from yes/no question when <kbd>Ctrl</kbd>+<kbd>C</kbd> is pressed.</li>
@@ -9535,7 +10131,7 @@ <h4 id="v044"><a class="wlink" href="#v044"><svg width=16 height=16><use href="#
 <li>Fixed <code>!0</code> causing Clink to crash.</li>
 <li>Save/restore cursor position in case Readline moves it.</li>
 </ul>
-<h4 id="v043"><a class="wlink" href="#v043"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.3</h4>
+<h4 id="v043"><a class="wlink" href="#v043"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.3 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Localised Y/N when auto-answering &quot;terminate?&quot; prompt.</li>
 <li><code>$*</code> would early out if there was no arguments.</li>
@@ -9556,7 +10152,7 @@ <h4 id="v043"><a class="wlink" href="#v043"><svg width=16 height=16><use href="#
 <li>Fixed missing WINCH signals if other processes resize the buffer.</li>
 <li>Support <kbd>Alt</kbd> codes sent from Conhost.</li>
 </ul>
-<h4 id="v042"><a class="wlink" href="#v042"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.2</h4>
+<h4 id="v042"><a class="wlink" href="#v042"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.2 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Prompt colouring no longer requires third party ANSI code utility.</li>
 <li>Override settings with environment variables prefixed with &#39;clink&#39;.</li>
@@ -9571,7 +10167,7 @@ <h4 id="v042"><a class="wlink" href="#v042"><svg width=16 height=16><use href="#
 </ul>
 </li>
 </ul>
-<h4 id="v041"><a class="wlink" href="#v041"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.1</h4>
+<h4 id="v041"><a class="wlink" href="#v041"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4.1 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Bug fixes;<ul>
 <li>Various Unicode fixes causing corrupt environment variables.</li>
@@ -9587,7 +10183,7 @@ <h4 id="v041"><a class="wlink" href="#v041"><svg width=16 height=16><use href="#
 <li>Added support for Windows&#39; <kbd>AltGr</kbd> substitute <kbd>Ctrl</kbd>-<kbd>Alt</kbd>.</li>
 <li>Support for Readline&#39;s &#39;menu&#39; style completion (see docs).</li>
 </ul>
-<h4 id="v04"><a class="wlink" href="#v04"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4</h4>
+<h4 id="v04"><a class="wlink" href="#v04"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.4 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>New features;<ul>
 <li>Better <code>clink.arg</code> API. Easier, more intuitive, and more powerful.</li>
@@ -9626,7 +10222,7 @@ <h4 id="v04"><a class="wlink" href="#v04"><svg width=16 height=16><use href="#wi
 </ul>
 </li>
 </ul>
-<h4 id="v03"><a class="wlink" href="#v03"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.3</h4>
+<h4 id="v03"><a class="wlink" href="#v03"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.3 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Automatic answering of cmd.exe&#39;s &quot;Terminate batch script?&quot; prompt.</li>
 <li>Coloured prompts (requires ANSICON or ConEmu).</li>
@@ -9664,14 +10260,14 @@ <h4 id="v03"><a class="wlink" href="#v03"><svg width=16 height=16><use href="#wi
 <li>Start menu shortcut starts in USERPROFILE, like cmd.exe</li>
 <li>Zip distribution is now portable.</li>
 </ul>
-<h4 id="v021"><a class="wlink" href="#v021"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.2.1</h4>
+<h4 id="v021"><a class="wlink" href="#v021"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.2.1 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>The .history file now merges multiple sessions together.</li>
 <li>Fixed missing y/n, pause, and other prompts.</li>
 <li>Fixed segfault in loader executable.</li>
 <li>Better ConEmu compatibility.</li>
 </ul>
-<h4 id="v02"><a class="wlink" href="#v02"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.2</h4>
+<h4 id="v02"><a class="wlink" href="#v02"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.2 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Basic argument completion for <code>git</code>, <code>hg</code>, <code>svn</code>, and <code>p4</code>.</li>
 <li>Traditional Bash clear screen (<kbd>Ctrl</kbd>-<kbd>L</kbd>) and exit shortcuts (<kbd>Ctrl</kbd>-<kbd>D</kbd>).</li>
@@ -9690,31 +10286,28 @@ <h4 id="v02"><a class="wlink" href="#v02"><svg width=16 height=16><use href="#wi
 <li>Improved hooking so Clink can be shared with other thirdparty utilities that
 also hook cmd.exe (ConEmu, ANSICon, etc.).</li>
 </ul>
-<h4 id="v011"><a class="wlink" href="#v011"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.1.1</h4>
+<h4 id="v011"><a class="wlink" href="#v011"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.1.1 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Fixed <kbd>AltGr</kbd>+<kbd>&lt;key&gt;</kbd> on international keyboards.</li>
 <li>Fixed broken completion when directories have a <code>-</code> in their name (Mark Hammond)</li>
 <li>The check for single match scenarios now correctly handles case-insensitivity.</li>
 </ul>
-<h4 id="v01"><a class="wlink" href="#v01"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.1</h4>
+<h4 id="v01"><a class="wlink" href="#v01"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v0.1 <span class="uplinks"><a href="#releases-from-mridgersclink-original-repo">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Initial release.</li>
 </ul>
-<!-- vim: wrap nolist ft=markdown
--->
-
         </div>
         <div class="section" id="credits">
-<h1 id="license"><a class="wlink" href="#license"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>License</h1>
+<h1 id="license"><a class="wlink" href="#license"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>License <span class="uplinks"><a href="#toc">top</a></span></h1>
 <p>Clink is distributed under the terms of the <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License, version 3</a>.</p>
-<h1 id="credits"><a class="wlink" href="#credits"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Credits</h1>
-<h3 id="credits_clink"><a class="wlink" href="#credits_clink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Clink</h3>
+<h1 id="credits"><a class="wlink" href="#credits"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Credits <span class="uplinks"><a href="#toc">top</a></span></h1>
+<h3 id="credits_clink"><a class="wlink" href="#credits_clink"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Clink <span class="uplinks"><a href="#credits">up</a> <a href="#toc">top</a></span></h3>
 
 <p>Clink was originally built by Martin Ridgers (<a href="https://github.com/mridgers/clink">https://github.com/mridgers/clink</a>).<br/>
 Copyright (c) 2012-2018 by Martin Ridgers.</p>
 <p>Clink has been forked and renovated by Christopher Antos (<a href="https://github.com/chrisant996/clink">https://github.com/chrisant996/clink</a>).<br/>
 Portions Copyright (c) 2020-2023 by Christopher Antos.</p>
-<h3 id="credits_libraries"><a class="wlink" href="#credits_libraries"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Libraries</h3>
+<h3 id="credits_libraries"><a class="wlink" href="#credits_libraries"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Libraries <span class="uplinks"><a href="#credits">up</a> <a href="#toc">top</a></span></h3>
 
 <p>GNU Readline library version 8.1 (<a href="https://tiswww.case.edu/php/chet/readline/rltop.html">https://tiswww.case.edu/php/chet/readline/rltop.html</a>).<br/>
 GNU Readline is distributed under the terms of the <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License, version 3</a>.</p>
