diff --git a/_config.yml b/_config.yml
index afd700f22..aba73e247 100644
--- a/_config.yml
+++ b/_config.yml
@@ -1,6 +1,6 @@
 theme: jekyll-theme-cayman
 title: Clink
 github:
-  version: v1.6.21
-  download_url: https://github.com/chrisant996/clink/releases/download/v1.6.21/clink.1.6.21.f97375.zip
-  install_url:  https://github.com/chrisant996/clink/releases/download/v1.6.21/clink.1.6.21.f97375_setup.exe
+  version: v1.7.0
+  download_url: https://github.com/chrisant996/clink/releases/download/v1.7.0/clink.1.7.0.dddef9.zip
+  install_url:  https://github.com/chrisant996/clink/releases/download/v1.7.0/clink.1.7.0.dddef9_setup.exe
diff --git a/clink.html b/clink.html
index 851048604..db5f2ef5c 100644
--- a/clink.html
+++ b/clink.html
@@ -3,7 +3,7 @@
 
 <!-- ----------------------------------------------------- -->
 <head>
-<title>Clink v1.6.21</title>
+<title>Clink v1.7.0</title>
 <style>
 @import url('https://fonts.googleapis.com/css2?family=Rambla:wght@400;700&family=Roboto&family=Fira+Mono&display=swap');
 html {
@@ -233,6 +233,7 @@
 .color_suggestion { color: #808080 }
 .color_unexpected { color: #c0c0c0 }
 .color_unrecognized { color: #ff5f5f }
+.color_comment_row { color: #00ffff; background-color: #000080; }
 
 .right_gray {
     color: #d7d7d7;
@@ -276,7 +277,15 @@
 #header #title {
     font: 2.5rem Rambla,Roboto,Calibri,Arial,Helvetica,sans-serif;
     font-weight: bold;
-    margin-bottom: 0.4rem;
+}
+
+#header #branch {
+    font: 1.5rem Rambla,Roboto,Calibri,Arial,Helvetica,sans-serif;
+    font-style: italic;
+}
+
+#header #url {
+    margin-top: 0.5rem;
 }
 
 #content {
@@ -906,6 +915,7 @@
 <div><a class="h1" href="#configuring-clink">Configuring Clink</a></div>
 <div><a class="h2" href="#clink-settings">Clink Settings</a></div>
 <div><a class="h2" href="#color-settings">Color Settings</a></div>
+<div><a class="h2" href="#custom-prompts">Custom Prompts</a></div>
 <div><a class="h2" href="#file-locations">File Locations</a></div>
 <div><a class="h2" href="#command-line-options">Command Line Options</a></div>
 <div><a class="h2" href="#automatic-updates">Automatic Updates</a></div>
@@ -924,6 +934,7 @@
 <div><a class="h2" href="#coloring-the-input-text">Coloring the Input Text</a></div>
 <div><a class="h2" href="#customizing-the-prompt">Customizing the Prompt</a></div>
 <div><a class="h2" href="#customizing-suggestions">Customizing Suggestions</a></div>
+<div><a class="h2" href="#showing-input-hints">Showing Input Hints</a></div>
 <div><a class="h1" href="#miscellaneous">Miscellaneous</a></div>
 <div><a class="h2" href="#customizing-key-bindings">Customizing Key Bindings</a></div>
 <div><a class="h2" href="#saved-command-history">Saved Command History</a></div>
@@ -942,7 +953,8 @@
         </td>
         <td style="text-align:right">
             <div id="header">
-                <div id="title">Clink v1.6.21</div>
+                <div id="title">Clink v1.7.0</div>
+                <div id="branch"></div>
                 <div id="url">
                     <a href="https://github.com/chrisant996/clink">
                         https://github.com/chrisant996/clink
@@ -969,10 +981,10 @@ <h3 id="feature-highlights"><a class="wlink" href="#features"><svg width=16 heig
 
 <p><strong>Auto-Suggestions</strong></p>
 <p>Clink offers suggestions as you type based on history, files, and completions.</p>
-<pre style="border-radius:initial;border:initial;background-color:black"><code class="plaintext" style="background-color:black"><span class="color_default">C:\dir></span><span class="color_executable">findstr</span><span class="cursor">_</span><span class="color_suggestion">/s needle haystack\*</span></span>
+<pre style="border-radius:initial;border:initial;background-color:black"><code class="plaintext" style="background-color:black"><span class="color_default">C:\dir><span class="color_executable">findstr</span><span class="cursor">_</span><span class="color_suggestion">/s needle haystack\*</span></span>
 </code></pre>
 
-<p>Press <kbd>Right</kbd> or <kbd>End</kbd> to accept a suggestion (shown in a muted color).</p>
+<p>Press <kbd>Right</kbd> or <kbd>End</kbd> to insert a suggestion (shown in a muted color).</p>
 <p>See <a href="#gettingstarted_autosuggest">Auto-Suggest</a> to learn more.</p>
 </div>
 <div class="promo_block">
@@ -1063,7 +1075,7 @@ <h1 id="getting-started"><a class="wlink" href="#getting-started"><svg width=16
 <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>
-<li><a href="#gettingstarted_autosuggest">Suggestions</a> are automatically offered as you type; press <kbd>Right</kbd> or <kbd>End</kbd> to accept a suggestion.</li>
+<li><a href="#gettingstarted_autosuggest">Suggestions</a> are automatically offered as you type; press <kbd>Right</kbd> or <kbd>End</kbd> to insert a suggestion.</li>
 <li><kbd>Tab</kbd> and <kbd>Ctrl</kbd>-<kbd>Space</kbd> provide match <a href="#how-completion-works">completion</a> two different ways.</li>
 <li>Press <kbd>Alt</kbd>-<kbd>H</kbd> to see a list of the current key bindings.</li>
 <li>Press <kbd>Alt</kbd>-<kbd>Shift</kbd>-<kbd>/</kbd> followed by another key to see what command is bound to the key.</li>
@@ -1072,7 +1084,7 @@ <h1 id="getting-started"><a class="wlink" href="#getting-started"><svg width=16
 <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 <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>&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 insert 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>
@@ -1212,7 +1224,7 @@ <h3 id="bash-vs-windows"><a class="wlink" href="#gettingstarted_defaultbindings"
 <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>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 insert the whole suggestion with the <kbd>Right</kbd> arrow or <kbd>End</kbd> key, insert the next word of the suggestion with <kbd>Ctrl</kbd>-<kbd>Right</kbd>, or insert 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>
 <pre style="border-radius:initial;border:initial;background-color:black"><code class="plaintext" style="background-color:black"><span class="color_default">C:\dir&gt;<span class="color_executable">findstr</span>&nbsp; <span class="color_input">/s needle haystack\*</span></span>
 </code></pre>
@@ -1221,9 +1233,9 @@ <h3 id="auto-suggest"><a class="wlink" href="#gettingstarted_autosuggest"><svg w
 <pre style="border-radius:initial;border:initial;background-color:black"><code class="plaintext" style="background-color:black"><span class="color_default">C:\dir&gt;<span class="color_executable">findstr</span>&nbsp;<span class="cursor">_</span><span class="color_suggestion">/s needle haystack\*</span></span>
 </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>The muted text shows a suggestion that might be what you intend to type.  You can insert 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 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_hint"><code>autosuggest.hint</code></a> setting controls whether to show the <code>[Right]=Insert 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 <span class="uplinks"><a href="#common-configuration">up</a> <a href="#toc">top</a></span></h3>
@@ -1358,6 +1370,11 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 </tr>
 </thead>
 <tbody><tr>
+<td align="center"><a class="wlink" href="#argmatcher_show_hints"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="argmatcher_show_hints"></a><code>argmatcher.show_hints</code></td>
+<td align="center">True</td>
+<td>When both the <a href="#comment_row_show_hints"><code>comment_row.show_hints</code></a> and <code>argmatcher.show_hints</code> settings are enabled, <a href="#argumentcompletion">argmatchers</a> can show usage hints in the comment row (below the input line).</td>
+</tr>
+<tr>
 <td align="center"><a class="wlink" href="#autosuggest_async"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="autosuggest_async"></a><code>autosuggest.async</code></td>
 <td align="center">True</td>
 <td>When this is <code>true</code> matches are generated asynchronously for suggestions.  This helps to keep typing responsive.</td>
@@ -1365,17 +1382,17 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 <tr>
 <td align="center"><a class="wlink" href="#autosuggest_enable"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="autosuggest_enable"></a><code>autosuggest.enable</code></td>
 <td align="center">True</td>
-<td>When this is <code>true</code> a suggested command may appear in <a href="#color_suggestion"><code>color.suggestion</code></a> color after the cursor.  If the suggestion isn&#39;t what you want, just ignore it.  Or 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>.  The <a href="#autosuggest_strategy"><code>autosuggest.strategy</code></a> setting determines how a suggestion is chosen.</td>
+<td>When this is <code>true</code> a suggested command may appear in <a href="#color_suggestion"><code>color.suggestion</code></a> color after the cursor.  If the suggestion isn&#39;t what you want, just ignore it.  Or insert the whole suggestion with the <kbd>Right</kbd> arrow or <kbd>End</kbd> key, insert the next word of the suggestion with <kbd>Ctrl</kbd>-<kbd>Right</kbd>, or insert the next full word of the suggestion up to a space with <kbd>Shift</kbd>-<kbd>Right</kbd>.  The <a href="#autosuggest_strategy"><code>autosuggest.strategy</code></a> setting determines how a suggestion is chosen.</td>
 </tr>
 <tr>
 <td align="center"><a class="wlink" href="#autosuggest_hint"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="autosuggest_hint"></a><code>autosuggest.hint</code></td>
 <td align="center">True</td>
-<td>The default is <code>true</code>.  When this and <a href="#autosuggest_enable"><code>autosuggest.enable</code></a> are both <code>true</code> and a suggestion is available, show a usage hint <code>[Right]=Accept Suggestion</code> to help make the feature more discoverable and easy to use.  Set this to <code>false</code> to hide the usage hint.</td>
+<td>The default is <code>true</code>.  When this and <a href="#autosuggest_enable"><code>autosuggest.enable</code></a> are both <code>true</code> and a suggestion is available, show a usage hint <code>[Right]=Insert Suggestion</code> to help make the feature more discoverable and easy to use.  Set this to <code>false</code> to hide the usage hint.</td>
 </tr>
 <tr>
 <td align="center"><a class="wlink" href="#autosuggest_original_case"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="autosuggest_original_case"></a><code>autosuggest.original_case</code></td>
 <td align="center">True</td>
-<td>When this is enabled (the default), accepting a suggestion uses the original capitalization from the suggestion.</td>
+<td>When this is enabled (the default), inserting a suggestion uses the original capitalization from the suggestion.</td>
 </tr>
 <tr>
 <td align="center"><a class="wlink" href="#autosuggest_strategy"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="autosuggest_strategy"></a><code>autosuggest.strategy</code></td>
@@ -1398,6 +1415,11 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 <td>Enables context sensitive coloring for the input text (see <a href="#classifywords">Coloring the Input Text</a>).</td>
 </tr>
 <tr>
+<td align="center"><a class="wlink" href="#clink_customprompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="clink_customprompt"></a><code>clink.customprompt</code></td>
+<td align="center"></td>
+<td>*.clinkprompt files contain customizations for the prompt.  Setting this to the name of a .clinkprompt file causes it to be loaded and used for displaying the prompt (see <a href="#customisingtheprompt">Customizing the Prompt</a>).</td>
+</tr>
+<tr>
 <td align="center"><a class="wlink" href="#default_bindings"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="default_bindings"><a name="clink_default_bindings"></a></a><code>clink.default_bindings</code></td>
 <td align="center"><code>bash</code> <a href="#alternatedefault">*</a></td>
 <td>Clink uses bash key bindings when this is set to <code>bash</code> (the default).  When this is set to <code>windows</code> Clink overrides some of the bash defaults with familiar Windows key bindings for <kbd>Tab</kbd>, <kbd>Ctrl</kbd>-<kbd>A</kbd>, <kbd>Ctrl</kbd>-<kbd>F</kbd>, <kbd>Ctrl</kbd>-<kbd>M</kbd>, and <kbd>Right</kbd>.</td>
@@ -1563,11 +1585,36 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 <td>When set, this is used as the color for popup lists and messages.  If no color is set, then the console&#39;s popup colors are used (see the Properties dialog box for the console window).</td>
 </tr>
 <tr>
+<td align="center"><a class="wlink" href="#color_popup_border"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="color_popup_border"></a><code>color.popup_border</code></td>
+<td align="center"></td>
+<td>When set, this is used as the color popup list borders.  If no color is set, then the color from <code>color.popup</code> is used.</td>
+</tr>
+<tr>
 <td align="center"><a class="wlink" href="#color_popup_desc"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="color_popup_desc"></a><code>color.popup_desc</code></td>
 <td align="center"></td>
 <td>When set, this is used as the color for description column(s) in popup lists.  If no color is set, then a color is chosen to complement the console&#39;s popup colors (see the Properties dialog box for the console window).</td>
 </tr>
 <tr>
+<td align="center"><a class="wlink" href="#color_popup_footer"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="color_popup_footer"></a><code>color.popup_footer</code></td>
+<td align="center"></td>
+<td>When set, this is used as the color for popup list footer message text.  If no color is set, then the color from <code>color.popup_border</code> is used.</td>
+</tr>
+<tr>
+<td align="center"><a class="wlink" href="#color_popup_header"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="color_popup_header"></a><code>color.popup_header</code></td>
+<td align="center"></td>
+<td>When set, this is used as the color for popup list title text.  If no color is set, then the color from <code>color.popup_border</code> is used.</td>
+</tr>
+<tr>
+<td align="center"><a class="wlink" href="#color_popup_select"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="color_popup_select"></a><code>color.popup_select</code></td>
+<td align="center"></td>
+<td>When set, this is used as the color for the selected popup list item.  If no color is set, a color is chosen by swapping the foreground and background colors from <code>color.popup</code>.</td>
+</tr>
+<tr>
+<td align="center"><a class="wlink" href="#color_popup_selectdesc"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="color_popup_selectdesc"></a><code>color.popup_selectdesc</code></td>
+<td align="center"></td>
+<td>When set, this is used as the color for the selected popup list item&#39;s description text.  If no color is set, a color is chosen by swapping the foreground and background colors from <code>color.popup</code>.</td>
+</tr>
+<tr>
 <td align="center"><a class="wlink" href="#color_prompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="color_prompt"></a><code>color.prompt</code></td>
 <td align="center"></td>
 <td>When set, this is used as the default color for the prompt.  But it&#39;s overridden by any colors set by <a href="#customisingtheprompt">Customizing The Prompt</a>.</td>
@@ -1603,6 +1650,21 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 <td>When set, this is the color in the input line for a command word that is not recognized as a command, doskey macro, directory, argmatcher, or executable file.</td>
 </tr>
 <tr>
+<td align="center"><a class="wlink" href="#comment_row_hint_delay"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="comment_row_hint_delay"></a><code>comment_row.hint_delay</code></td>
+<td align="center"><code>500</code></td>
+<td>Specifies a delay in milliseconds before showing input hints (see <a href="#showinginputhints">Showing Input Hints</a>).  The delay can be up to 3000 milliseconds, or 0 for no delay.</td>
+</tr>
+<tr>
+<td align="center"><a class="wlink" href="#comment_row_show_hints"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="comment_row_show_hints"></a><code>comment_row.show_hints</code></td>
+<td align="center">False</td>
+<td>Allow showing input hints in the comment row (see <a href="#showinginputhints">Showing Input Hints</a>).</td>
+</tr>
+<tr>
+<td align="center"><a class="wlink" href="#debug_log_output_callstacks"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="debug_log_output_callstacks"></a><code>debug.log_output_callstacks</code></td>
+<td align="center">False</td>
+<td>Include callstack when logging output.  This has no effect unless <code>debug.log_terminal</code> is enabled.  This is intended for diagnostic purposes only, and can make the log file grow significantly.</td>
+</tr>
+<tr>
 <td align="center"><a class="wlink" href="#debug_log_terminal"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="debug_log_terminal"></a><code>debug.log_terminal</code></td>
 <td align="center">False</td>
 <td>Logs all terminal input and output to the clink.log file.  This is intended for diagnostic purposes only, and can make the log file grow significantly.</td>
@@ -1753,11 +1815,6 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 <td>Value to append to the <a href="https://www.lua.org/manual/5.2/manual.html#pdf-package.path"><code>package.path</code></a> Lua variable. Used to search for Lua scripts specified in <code>require()</code> statements.</td>
 </tr>
 <tr>
-<td align="center"><a class="wlink" href="#lua_reload_scripts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="lua_reload_scripts"></a><code>lua.reload_scripts</code></td>
-<td align="center">False</td>
-<td>When false, Lua scripts are loaded once and are only reloaded if forced (see <a href="#lua-scripts-location">The Location of Lua Scripts</a> for details).  When true, Lua scripts are loaded each time the edit prompt is activated.</td>
-</tr>
-<tr>
 <td align="center"><a class="wlink" href="#lua_strict"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><a name="lua_strict"></a><code>lua.strict</code></td>
 <td align="center">True</td>
 <td>When enabled, argument errors cause Lua scripts to fail.  This may expose bugs in some older scripts, causing them to fail where they used to succeed. In that case you can try turning this off, but please alert the script owner about the issue so they can fix the script.</td>
@@ -1906,7 +1963,10 @@ <h2 id="clink-settings"><a class="wlink" href="#clinksettings"><svg width=16 hei
 <p/>
 
 <p><a name="alternatedefault"></a></p>
-<p><strong>&ast;</strong> Some settings have alternative default values when Clink is installed with &quot;Use enhanced default settings&quot; checked in the setup program.  This enables more of Clink&#39;s enhancements by default.</p>
+<blockquote>
+<p><strong>Note:</strong></p>
+<p>Some settings have alternative default values when Clink is installed with &quot;Use enhanced default settings&quot; checked in the setup program.  This enables more of Clink&#39;s enhancements by default.</p>
+</blockquote>
 <blockquote>
 <p><strong>Compatibility Notes:</strong></p>
 <ul>
@@ -1923,25 +1983,87 @@ <h3 id="friendly-color-names"><a class="wlink" href="#friendly-color-names"><svg
 <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>
 <ul>
-<li><code>bold</code> or <code>nobold</code> adds or removes boldface (usually represented by forcing the color to use high intensity if it doesn&#39;t already).</li>
-<li><code>underline</code> or <code>nounderline</code> adds or removes an underline.</li>
+<li><code>bold</code> or <code>nobold</code> adds or removes boldface (usually represented by forcing the color to use high intensity if it doesn&#39;t already; some terminal programs may also/instead use a bolder font weight).</li>
+<li><code>underline</code> adds an underline (some terminal programs cannot display underlines).</li>
+<li><code>italic</code> adds italics (some terminal programs cannot display italics).  This keyword requires Clink v1.7.0 or newer; in older versions you can use the <code>sgr</code> keyword with the corresponding escape code sequence such as <code>sgr 3</code>.</li>
+<li><code>reverse</code> swaps the foreground and background colors.  This keyword requires Clink v1.7.0 or newer; in older versions you can use the <code>sgr</code> keyword with the corresponding escape code sequence such as <code>sgr 7</code>.</li>
 </ul>
 <p>Optional colors for <span class="arg">foreground_color</span> and <span class="arg">background_color</span> (can be abbreviated to 3 letters):</p>
 <ul>
 <li><code>default</code> or <code>normal</code> uses the default color as defined by the current color theme in the console window.</li>
 <li><code>black</code>, <code>red</code>, <code>green</code>, <code>yellow</code>, <code>blue</code>, <code>cyan</code>, <code>magenta</code>, <code>white</code> are the basic colors names.</li>
 <li><code>bright</code> can be combined with any of the other color names to make them bright (high intensity).</li>
+<li><code>#XXXXXX</code> specifies a color using 24-bit RGB hex format; the first two digits are the red value, the next two digits are the green value, and the last two digits are the blue value (some terminal programs cannot display 24-bit colors, and will try to instead use the closest supported color).  Requires Clink v1.7.0 or newer; in older versions you can use the <code>sgr</code> keyword with the corresponding escape code sequence such as <code>sgr 38;2;255;80;160</code>.</li>
+<li><code>#XXX</code> specifies a color using a short RGB hex format; each digit is doubled so <code>#3fc</code> means <code>#33ffcc</code>.  Requires Clink v1.7.0 or newer; in older versions you can use the <code>sgr</code> keyword with the corresponding escape code sequence such as <code>sgr 38;2;255;80;160</code>.</li>
 </ul>
 <p>Examples (specific results may depend on the console host program):</p>
 <ul>
 <li><code>bri yel</code> for bright yellow foreground on default background color.</li>
 <li><code>bold</code> for bright default foreground on default background color.</li>
-<li><code>underline bright black on white</code> for dark gray (bright black) foreground on light gray (white) background.</li>
+<li><code>underline bright black on white</code> for dark gray (bright black) foreground with underline on light gray (white) background.</li>
 <li><code>default on blue</code> for default foreground color on blue background.</li>
+<li><code>bold underline green on #222</code> for bright green with underline on a dark gray 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 <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>It&#39;s also possible to set any ANSI <a href="https://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>
+<h3 id="color-themes"><a class="wlink" href="#color-themes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Color Themes <span class="uplinks"><a href="#colorsettings">up</a> <a href="#toc">top</a></span></h3>
+<p>Clink has many <a href="#color_arg">color settings</a> which can be set with <code>clink set color.<span class="arg">setting_name</span> <span class="arg"><a href="#friendly-color-names">color_value</a></span></code>.</p>
+<p>Predefined color setting values can be grouped into a .clinktheme file to make it easy to save, apply, and share different color themes for Clink.  These color theme files require Clink v1.7.0 or newer.</p>
+<p>Clink looks for color theme files in these directories:</p>
+<ol>
+<li>Any directories listed in the <code>%CLINK_THEMES_DIR%</code> environment variable (multiple directories may be separated by semicolons).</li>
+<li>A <code>themes\</code> subdirectory under each scripts directory listed by <code>clink info</code> (see <a href="#lua-scripts-location">Location of Lua Scripts</a>).</li>
+<li>Or you can provide a full path name to a file, such as <code>c:\mythemes\Colorful.clinktheme</code>.</li>
+</ol>
+<p>To apply a color theme, run <code>clink config theme use <span class="arg">theme_name</span></code> which will apply the named theme and use it to replace color settings in the current Clink profile.  Or set the <code>CLINK_COLORTHEME</code> environment variable to the name or full path and filename of a .clinktheme file.  The environment variable causes the named theme to override color settings from the profile&#39;s settings file, which allows multiple concurrent Clink sessions to use different color themes.</p>
+<blockquote>
+<p><strong>Note:</strong> The <code>clink config theme use</code> command first saves the current color theme as &quot;Previous Theme&quot; to help avoid accidentally losing color settings.</p>
+</blockquote>
+<p>To list available color themes, run <code>clink config theme list</code>.  Clink includes a few theme files, and you can find more shared online by Clink users.  One place to find more color themes for Clink is the <a href="https://github.com/chrisant996/clink-themes">clink-themes</a> repo.</p>
+<p>To show a demo of a what a color theme will look like, run <code>clink config theme show <span class="arg">theme_name</span></code>.</p>
+<p>To save the current profile&#39;s color settings into a .clinktheme file, run <code>clink config theme save <span class="arg">theme_name</span></code>.  The color settings are saved into a file named <code>themes\<span class="arg">theme_name</span>.clinktheme</code> under the current Clink profile directory.</p>
+<p>See <a href="#coloring-the-input-text">Coloring the Input Text</a> for information on specific color settings.</p>
+<blockquote>
+<p><strong>Note:</strong>  The .clinktheme files are Clink color themes for Clink-specific color settings.  They are not terminal color themes and don&#39;t affect other programs or the terminal in general.  Consult your terminal program&#39;s documentation for how to set terminal color themes for it.</p>
+</blockquote>
+<fieldset><legend>Warning</legend>
+If you want to change a .clinktheme file that came with Clink, make a copy of the file and edit the copy.  Don't edit the original .clinktheme file directly, because any changes in a file that came with Clink will be reverted the next time a Clink update is installed.
+</fieldset>
+
+<h2 id="custom-prompts"><a class="wlink" href="#custom-prompts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Custom Prompts <span class="uplinks"><a href="#configclink">up</a> <a href="#toc">top</a></span></h2>
+<p>You can choose a custom prompt to use, or you can <a href="#customizing-the-prompt">make your own prompt</a>.</p>
+<p>A custom prompt can be packaged into a .clinkprompt file to make it easy to choose which prompt to use, and easy to share custom prompts with other users.</p>
+<p>Clink looks for custom prompt files in these directories:</p>
+<ol>
+<li>Any directories listed in the <code>%CLINK_THEMES_DIR%</code> environment variable (multiple directories may be separated by semicolons).</li>
+<li>A <code>themes\</code> subdirectory under each scripts directory listed by <code>clink info</code> (see <a href="#lua-scripts-location">Location of Lua Scripts</a>).</li>
+<li>Or you can provide a full path name to a file, such as <code>c:\mythemes\Fancy Prompt.clinkprompt</code>.</li>
+</ol>
+<p>To activate a custom prompt, run <code>clink config prompt use <span class="arg">prompt_name</span></code> which will load and use the named prompt, as well as update the settings accordingly in the current Clink profile.  Or set the <code>CLINK_CUSTOMPROMPT</code> environment variable to the name or full path and filename of a .clinkprompt file.  The environment variable causes the named prompt to override the profile&#39;s settings file, and allows multiple concurrent Clink sessions to use different custom prompts.</p>
+<p>To list available custom prompts, run <code>clink config prompt list</code>.  Clink includes a few custom prompt files, and you can find more shared online by Clink users.  Some places you can find more custom prompts for Clink are <a href="https://github.com/chrisant996/clink-flex-prompt">clink-flex-prompt</a>, <a href="https://github.com/chrisant996/clink-themes">clink-themes</a>, and <a href="https://ohmyposh.dev">oh-my-posh</a>.  Check <a href="#oh-my-posh">here</a> for quick info on using oh-my-posh prompt themes with Clink.</p>
+<p>To show a demo of what a custom prompt will look like, run <code>clink config prompt show <span class="arg">prompt_name</span></code>.</p>
+<p>See <a href="#customisingtheprompt">Customizing the Prompt</a> for information on writing your own custom prompts, and see <a href="#sharing-custom-prompts">Sharing Custom Prompts</a> for information on optionally packaging them as &quot;*.clinkprompt&quot; files.</p>
+<fieldset><legend>Warning</legend>
+If you want to change a .clinkprompt file that came with Clink, make a copy of the file and edit the copy.  Don't edit the original .clinkprompt theme file directly, because any changes in a file that came with Clink will be reverted the next time a Clink update is installed.
+</fieldset>
+
+<h3 id="compatibility-between-clinkprompt-versus-lua-files"><a class="wlink" href="#compatibility-between-clinkprompt-versus-lua-files"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Compatibility Between .clinkprompt Versus .lua Files <span class="uplinks"><a href="#custom-prompts">up</a> <a href="#toc">top</a></span></h3>
+<p>When you activate a .clinkprompt file via <code>clink config prompt use</code> you might see a garbled prompt, or still see your old prompt.</p>
+<p>That can happen because activating a .clinkprompt file deactivates other .clinkprompt files, but it doesn&#39;t deactivate prompt filters registered from .lua files (it could break other things if it did).</p>
+<p>So, if you have a custom prompt in a .lua file then you may need to update the .lua file to disable itself while a .clinkprompt file is active.</p>
+<p>For most .lua custom prompts, you can simply rename its file to change the file extension from &quot;.lua&quot; to &quot;.clinkprompt&quot;, and then it won&#39;t interfere with other .clinkprompt files.</p>
+<p>Or, you can modify any prompt filter to automatically disable itself like this:</p>
+<pre><code class="language-lua">local your_prompt_filter = clink.promptfilter()
+
+function your_prompt_filter:filter()
+    -- Insert the following if..end line at the beginning of any .lua prompt filter to automatically
+    -- disable it while a .clinkprompt file is active (but don&#39;t insert it in a .clinkprompt file).
+    if clink.getclinkprompt and clink.getclinkprompt() then return end
+
+    -- The rest of your prompt filter goes here...
+end
+</code></pre>
 <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 <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>
@@ -1951,6 +2073,7 @@ <h2 id="file-locations"><a class="wlink" href="#filelocations"><svg width=16 hei
 </ul>
 <p>All of the above locations can be overridden using the <code>--profile <span class="arg">path</span></code> command line option which is specified when injecting Clink into cmd.exe using <code>clink inject</code>.  Or with the <code>%CLINK_PROFILE%</code> environment variable if it is already present when Clink is injected (this envvar takes precedence over any other mechanism of specifying a profile directory, if more than one was used).</p>
 <p>You can use <code>clink info</code> to find the directories and configuration files for the current Clink session.</p>
+<p>Also see <a href="#lua-scripts-location">Location of Lua Scripts</a> for details on where Clink looks for Lua scripts, and <a href="#themes-directories">Themes Directories</a> for details on where Clink looks for color theme files (*.clinktheme) and custom prompt files (*.clinkprompt).</p>
 <blockquote>
 <p><strong>Notes:</strong></p>
 <ul>
@@ -2044,6 +2167,20 @@ <h2 id="command-line-options"><a class="wlink" href="#command-line-options"><svg
 <code>clink set <span class="arg">setting_name</span> <span class="arg">value</span></code> sets the setting to the specified value.</dd>
 </p>
 
+<p>
+<dt>clink config prompt</dt>
+<dd>
+Configures Clink to use a custom prompt module.<br/>
+See <code>clink config prompt --help</code> or [Custom Prompts](#custom-prompts) for more information.</dd>
+</p>
+
+<p>
+<dt>clink config theme</dt>
+<dd>
+Configures Clink to use a color theme.<br/>
+See <code>clink config theme --help</code> or [Color Themes](#color-themes) for more information.</dd>
+</p>
+
 <p>
 <dt>clink installscripts</dt>
 <dd>
@@ -2114,6 +2251,8 @@ <h2 id="automatic-updates"><a class="wlink" href="#automatic-updates"><svg width
 <td>Clink periodically checks for updates and also attempts to automatically install an update.  If elevation is needed then it pops up a prompt window, otherwise it automatically installs the update.</td>
 </tr>
 </tbody></table>
+<br/>
+
 <blockquote>
 <p><strong>Notes:</strong></p>
 <ul>
@@ -2669,7 +2808,7 @@ <h4 id="readline-key-bindings"><a class="wlink" href="#readline-key-bindings"><s
 <td>The series of five keys <kbd>S</kbd> <kbd>p</kbd> <kbd>a</kbd> <kbd>c</kbd> <kbd>e</kbd>.</td>
 </tr>
 </tbody></table>
-<p>Special keys like <kbd>Up</kbd> are represented by VT220 escape codes such as<code>&quot;\e[A&quot;</code>.  See <a href="#discovering-clink-key-sequences">Discovering Clink key sequences</a> and <a href="#specialkeys">Binding special keys</a> for how to find the <span class="arg">keyname</span> for the key you want to bind.</p>
+<p>Special keys like <kbd>Up</kbd> are represented by VT220 escape codes such as <code>&quot;\e[A&quot;</code>.  See <a href="#discovering-clink-key-sequences">Discovering Clink key sequences</a> and <a href="#specialkeys">Binding special keys</a> for how to find the <span class="arg">keyname</span> for the key you want to bind.</p>
 <p>
 <dt>Key bindings</dt>
 Key bindings can be either functions or macros (literal text).  Functions are not quoted, and macros are quoted.
@@ -3794,7 +3933,9 @@ <h3 id="clink-commands"><a class="wlink" href="#clink-commands"><svg width=16 he
 </tr>
 </tbody></table>
 <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>
+<blockquote>
+<p><strong>Note:</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>
+</blockquote>
 <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 <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>
@@ -4055,7 +4196,8 @@ <h1 id="extending-clink-with-lua"><a class="wlink" href="#extending-clink"><svg
 <tr><td><a href="#matchgenerators">Match Generators</a></td><td>How to write match generators, or custom completion providers.</td></tr>
 <tr><td><a href="#classifywords">Coloring the Input Text</a></td><td>How to make a match generator or argument matcher override the input coloring.</td></tr>
 <tr><td><a href="#customisingtheprompt">Customizing the Prompt</a></td><td>How to write custom prompt filters.</td></tr>
-<tr><td><a href="#customisingsuggestions">Customizing Suggestions</a></td><td>How to write custom suggestion generators.</td></tr>
+<tr><td><a href="#customisingsuggestions">Customizing Suggestions</a></td><td>How to write custom [suggestion](#auto-suggest) generators.</td></tr>
+<tr><td><a href="#showinginputhints">Showing Input Hints</a></td><td>How to write custom input hint providers (input hints can be displayed below the input line).</td></tr>
 </table>
 
 <p><a name="lua-scripts-location"></a></p>
@@ -4067,7 +4209,7 @@ <h2 id="location-of-lua-scripts"><a class="wlink" href="#lua-scripts-location"><
 <li>All directories listed in the <code>%CLINK_PATH%</code> environment variable, separated by semicolons.</li>
 <li>All directories registered by the <code>clink installscripts</code> command.</li>
 </ol>
-<p>Lua scripts are loaded once and are only reloaded if forced because the scripts locations change, the <a href="#rlcmd-clink-reload"><code>clink-reload</code></a> command is invoked (<kbd>Ctrl</kbd>-<kbd>X</kbd>,<kbd>Ctrl</kbd>-<kbd>R</kbd>), or the <a href="#lua_reload_scripts"><code>lua.reload_scripts</code></a> setting changes (or is True).</p>
+<p>Lua scripts are loaded once and are only reloaded if forced because the scripts locations change or the <a href="#rlcmd-clink-reload"><code>clink-reload</code></a> command is invoked (<kbd>Ctrl</kbd>-<kbd>X</kbd>,<kbd>Ctrl</kbd>-<kbd>R</kbd>).</p>
 <p>Run <code>clink info</code> to see the script paths for the current session.</p>
 <blockquote>
 <p><strong>Notes:</strong></p>
@@ -4120,6 +4262,7 @@ <h2 id="argument-completion"><a class="wlink" href="#argumentcompletion"><svg wi
 <tr><td style="padding-top: 0.5rem"><em>More Advanced Stuff</em></td><td></td></tr>
 <tr><td style="padding-left: 2rem"><a href="#argmatcher_linking">Linking Parsers</a></td><td>How to link a parser to a word or flag.</td></tr>
 <tr><td style="padding-left: 2rem"><a href="#argmatcher_functions">Functions As Argument Options</a></td><td>Using a function to provide completions.</td></tr>
+<tr><td style="padding-left: 2rem"><a href="#addarg_hint">Show a Usage Hint</a></td><td>How to show a usage hint for the argument under the cursor.</td></tr>
 <tr><td style="padding-left: 2rem"><a href="#addarg_fromhistory">Generate Matches From History</a></td><td>Providing completions from the history.</td></tr>
 <tr><td style="padding-left: 2rem"><a href="#addarg_nosort">Disable Sorting Matches</a></td><td>How to disable auto-sorted completions.</td></tr>
 <tr><td style="padding-left: 2rem"><a href="#argmatcher_fullyqualified">Fully Qualified Pathnames</a></td><td>How to make different argmatchers for programs with the same name.</td></tr>
@@ -4283,6 +4426,42 @@ <h4 id="functions-as-argument-options"><a class="wlink" href="#argmatcher_functi
 <td>Generates file matches.</td>
 </tr>
 </tbody></table>
+<p><a name="addarg_hint"></a></p>
+<h4 id="show-a-usage-hint"><a class="wlink" href="#addarg_hint"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Show a Usage Hint <span class="uplinks"><a href="#more-advanced-stuff">up</a> <a href="#toc">top</a></span></h4>
+<p>A usage hint can be shown in the comment row (below the input line).  Usage hints for argmatchers are only shown if both <a href="#comment_row_show_hints">comment_row.show_hints</a> (off by default) and <a href="#argmatcher_show_hints">argmatcher.show_hints</a> (on by default) are enabled.</p>
+<p>To use this, Clink v1.7.0 or higher is required.</p>
+<p>Argmatchers can automatically supply input hints based on <code>arginfo</code> fields from match completions.</p>
+<p>To supply a custom usage hint, an argmatcher can include either <code>hint=&quot;text&quot;</code> or <code>hint=<em>function_name</em></code> in the argument table.</p>
+<pre><code class="language-lua">clink.argmatcher(&quot;foo&quot;)
+:addarg({ clink.filematches, hint=&quot;Argument expected:  filename&quot; })
+</code></pre>
+<pre style="border-radius:initial;border:initial;background-color:black"><code class="plaintext" style="background-color:black"><span class="color_default">C:\dir><span class="color_argmatcher">foo</span> <span class="cursor">_</span></span>
+<span class="color_comment_row">Argument expected:  filename</span>
+</code></pre>
+
+<p>If a function name is supplied, then the function is passed five arguments:</p>
+<ul>
+<li><code>arg_index</code> is the argument index in the argmatcher, corresponding to the argument being parsed.  0 means it is a flag, rather than an argument.</li>
+<li><code>word</code> is a string containing the word being parsed.  <strong>Note:</strong> when the cursor is between words or after the last word then <code>word</code> is an empty string.</li>
+<li><code>word_index</code> is the word index in <code>line_state</code>, corresponding to the word being parsed.  <strong>Note:</strong> when the cursor is between words then <code>word_index</code> is the index of the <em>next</em> word after the cursor, or when the cursor is after the last word then <code>word_index</code> is greater than <code>line_state:getwordcount()</code>.</li>
+<li><code>line_state</code> is a <a href="#line_state">line_state</a> object that contains the words for the associated command line.</li>
+<li><code>user_data</code> is a table that the argmatcher can use to help it parse the input line.  See <a href="#responsive-argmatchers">Responding to Arguments in Argmatchers</a> for more information about the <code>user_data</code> table.</li>
+</ul>
+<p>The function returns a hint string, and an optional position in the line text where the hint refers to.  If the position is omitted, then the offset to the beginning of the word is assumed.</p>
+<pre><code class="language-lua">local function foo_hint_func(arg_index, word, word_index, line_state, user_data)
+    local hint = &quot;Argument expected for &#39;&quot;..line_state:getword(word_index - 1)..&quot;&#39;:  filename&quot;
+    local pos = line_state:getwordinfo(word_index).offset   -- Shown for completeness, but this is automatically assumed if omitted.
+    return hint, pos
+end
+
+clink.argmatcher(&quot;foo&quot;)
+:addarg({ &quot;add&quot;, &quot;remove&quot; })
+:addarg({ clink.filematches, hint=foo_hint_func })
+</code></pre>
+<pre style="border-radius:initial;border:initial;background-color:black"><code class="plaintext" style="background-color:black"><span class="color_default">C:\dir><span class="color_argmatcher">foo</span> <span class="color_arg">add</span> <span class="cursor">_</span></span>
+<span class="color_comment_row">Argument expected for 'add':  filename</span>
+</code></pre>
+
 <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 <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>
@@ -4565,8 +4744,7 @@ <h5 id="the-on-link-function"><a class="wlink" href="#the-on-link-function"><svg
 <p>The function may return any of the following:</p>
 <ul>
 <li>Return an argmatcher to override subsequent parsing and use the specified argmatcher.</li>
-<li>Return <code>false</code> to override subsequent parsing and continue using the current argmatcher.</li>
-<li>Return <code>nil</code> to allow parsing to behave normally.</li>
+<li>Return <code>false</code> or <code>nil</code> to allow parsing to continue normally.</li>
 </ul>
 <blockquote>
 <p><strong>Note:</strong> Avoid creating new argmatchers in &quot;on link&quot; functions; instead return cached argmatchers that were previously created.  The &quot;on link&quot; functions may be called frequently, and creating new argmatchers every time can create responsiveness problems while typing.</p>
@@ -4687,7 +4865,8 @@ <h4 id="the-generate-function"><a class="wlink" href="#the-generate-function"><s
 </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 <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>The function takes a <span class="arg">line_state</span> argument which is a <a href="#line_state">line_state</a> object that has information about the current line.</p>
+<p>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>
 <p>When the environment variable match generator&#39;s <code>:getwordbreakinfo()</code> function sees the end word is <code>abc%USER</code> it returns <code>3,1</code> so that the last two words become &quot;abc&quot; and &quot;%&quot; so that its generator knows it can do environment variable matching.  But when it sees <code>abc%FOO%def</code> it returns <code>8,0</code> so that the last two words become &quot;abc%FOO%&quot; and &quot;&quot; so that its generator won&#39;t do environment variable matching, and also so other generators can produce matches for what follows, since &quot;%FOO%&quot; is an already-completed environment variable and therefore should behave like a word break.  In other words, it breaks the end word differently depending on whether the number of percent signs is odd or even, to account for environent variable syntax rules.</p>
 <p>And when an argmatcher sees the end word begins with a flag character it returns <code>0,1</code> so the end word contains only the flag character in order to switch from argument matching to flag matching.</p>
@@ -4867,8 +5046,8 @@ <h4 id="filtering-the-match-display"><a class="wlink" href="#filteringthematchdi
 <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>
 <p>A <a href="#matchgenerators">match generator</a> or <a href="#argumentcompletion">argmatcher</a> or <a href="#luakeybindings">luafunc: key binding</a> can alternatively use <a href="#clink.ondisplaymatches">clink.ondisplaymatches()</a> to register a function that will be called before matches are displayed (this is reset every time match generation is invoked).</p>
-<p>The function receives a table argument containing the matches to be displayed, and a boolean argument indicating whether they&#39;ll be displayed in a popup window. 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>. The return value is a table with the input matches filtered as required by the match generator.</p>
-<p>The returned table can also optionally include a <code>display</code> string field and a <code>description</code> string field. When present, <code>display</code> will be displayed instead of the <code>match</code> field, and <code>description</code> will be displayed next to the match. Putting the description in a separate field enables Clink to align the descriptions in a column.</p>
+<p>The function receives a table argument containing the matches to be displayed, and a boolean argument indicating whether they&#39;ll be displayed in a popup window. 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 return value is a table with the input matches filtered as required by the match generator.  The returned table can also optionally include a <code>display</code> string field and a <code>description</code> string field. When present, <code>display</code> will be displayed instead of the <code>match</code> field, and <code>description</code> will be displayed next to the match. Putting the description in a separate field enables Clink to align the descriptions in a column.</p>
 <p>Filtering the match display can affect completing matches: the <code>match</code> field is what gets inserted.  It can also affect displaying matches: the <code>display</code> field is displayed if present, otherwise the <code>match</code> field is displayed.</p>
 <p>If a match&#39;s <code>type</code> is &quot;none&quot; or its <code>match</code> field is different from its <code>display</code> field then the match is displayed using the color specified by the <a href="#color_filtered">color.filtered</a> Clink setting, otherwise normal completion coloring is applied.  The <code>display</code> and <code>description</code> fields can include ANSI escape codes to apply other colors if desired.</p>
 <pre><code class="language-lua">local function my_filter(matches, popup)
@@ -4904,6 +5083,7 @@ <h4 id="filtering-the-match-display"><a class="wlink" href="#filteringthematchdi
 <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 <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>
+<p>See <a href="#color-themes">Color Themes</a> for information on loading and saving color theme files (whose names end with &quot;.clinktheme&quot;).</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>
 <tr><td><a href="#inputcolor_redir">Coloring Command Separators and Redirection</a></td><td>How special characters are colored.</td></tr>
@@ -4965,7 +5145,7 @@ <h3 id="coloring-other-input-text"><a class="wlink" href="#inputcolor_other"><sv
 <tr><td class="color_default">c:\dir><span class="color_argmatcher">clink</span> <span class="color_arg">set</span> <span class="color_arg">color.arg</span></td><td class="right_gray">'color.arg' is defined as an argument for 'clink set'</td></tr>
 <tr><td class="color_default">c:\dir><span class="color_argmatcher">clink</span> <span class="color_arg">set</span> <span class="color_unexpected">abc.xyz</span></td><td class="right_gray">'abc.xyz' is not a recognized argument for 'clink set'</td></tr>
 <tr><td class="color_default">c:\dir><span class="color_executable">findstr</span> <span class="color_input">/s needle haystack\*</span></td><td class="right_gray">if 'findstr' has no argmatcher, all words use 'color.input'</td></tr>
-<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>
+<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 insert 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 <span class="uplinks"><a href="#classifywords">up</a> <a href="#toc">top</a></span></h3>
@@ -5099,9 +5279,11 @@ <h4 id="setting-a-classifier-function-for-the-whole-input-line"><a class="wlink"
 <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 <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>
+<p>See <a href="#custom-prompts">Custom Prompts</a> for information on loading custom prompt files (whose names end with &quot;.clinkprompt&quot;).</p>
 <table class="linkmenu">
 <tr><td><a href="#promptfilter_basics">The Basics</a></td><td>A quick example to show the basics.</td></tr>
 <tr><td><a href="#escapecodes">ANSI escape codes in the prompt string</a></td><td>How special characters are colored.</td></tr>
+<tr><td><a href="#sharing-custom-prompts">Sharing Custom Prompts</a></td><td>How to share your custom prompt with other people as a *.clinkprompt file.</td></tr>
 <tr><td style="padding-top: 0.5rem"><em>More Advanced Stuff</em></td><td></td></tr>
 <tr><td style="padding-left: 2rem"><a href="#rightprompt">Right Side Prompt</a></td><td>How to add prompt text at the right edge of the terminal.</td></tr>
 <tr><td style="padding-left: 2rem"><a href="#asyncpromptfiltering">Asynchronous Prompt Filtering</a></td><td>How to make the prompt show up instantly.</td></tr>
@@ -5115,7 +5297,8 @@ <h3 id="the-basics-3"><a class="wlink" href="#promptfilter_basics"><svg width=16
 <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>
 <li>Define a <code>:filter()</code> function on the returned prompt filter.</li>
 </ol>
-<p>The 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>The filter function takes a string argument that contains the filtered prompt so far.</p>
+<p>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>
 <pre><code class="language-lua">local p = clink.promptfilter(30)
 function p:filter(prompt)
     return &quot;new prefix &quot;..prompt..&quot; new suffix&quot; -- Add ,false to stop filtering.
@@ -5189,13 +5372,144 @@ <h3 id="ansi-escape-codes-in-the-prompt-string"><a class="wlink" href="#escapeco
 <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="sharing-custom-prompts"><a class="wlink" href="#sharing-custom-prompts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Sharing Custom Prompts <span class="uplinks"><a href="#customisingtheprompt">up</a> <a href="#toc">top</a></span></h3>
+<p>Custom prompts can be shared in Clink v1.7.0 and newer.</p>
+<p>To make a custom prompt shareable, put it in a file whose name ends with &quot;.clinkprompt&quot; instead of &quot;.lua&quot;.</p>
+<p>For many custom prompts, it&#39;s as simple as that!  Some prompts may want additional capabilities, which are described further below.</p>
+<p>A .clinkprompt file can be shared and installed on other computers.  If it&#39;s in a &quot;themes&quot; subdirectory under any of the script directories, then Clink can find it automatically (run <code>clink info</code> and look for the &quot;scripts&quot; line in the output).  If the file in some other directory, then you can use it by telling Clink the full path to the file.</p>
+<p>Any <a href="#clink.promptfilter">prompt filters</a> or registered event handlers (such as <a href="#clink.onbeginedit">clink.onbeginedit</a>) in a .clinkprompt file are only called while the prompt is active.  Running <code>clink config prompt use <span class="arg">prompt_file</span></code> select a custom prompt which gets activated in each Clink session using the current profile directory.  Only one .clinkprompt file at a time can be active.</p>
+<h4 id="the-exports-table-in-a-clinkprompt-file"><a class="wlink" href="#the-exports-table-in-a-clinkprompt-file"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>The &quot;exports table&quot; in a .clinkprompt file <span class="uplinks"><a href="#sharing-custom-prompts">up</a> <a href="#toc">top</a></span></h4>
+<p>A .clinkprompt file can return a table with certain fields which gain additional capabilities.  Each field is optional, as is the table itself.</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody><tr>
+<td><code>onactivate = <span class="arg">function_name</span></code></td>
+<td>If <span class="arg">function_name</span> is not nil, then it&#39;s called when the prompt is loaded and activated.</td>
+</tr>
+<tr>
+<td><code>ondeactivate = <span class="arg">function_name</span></code></td>
+<td>If <span class="arg">function_name</span> is not nil, then it&#39;s called when the prompt is deactivated.</td>
+</tr>
+<tr>
+<td><code>demo = <span class="arg">function_name</span></code></td>
+<td>If <span class="arg">function_name</span> is not nil, then it&#39;s called when <code>clink config prompt show</code> is run.</td>
+</tr>
+<tr>
+<td><code>dependson = <span class="arg">string</span></code></td>
+<td>If the string is not empty, then it is a list of clinkprompt names upon which this clinkprompt depends.  When this clinkprompt file is loaded and activated, the other files are also loaded, and their prompt filters and event handlers are allowed to run even though they aren&#39;t part of the current active clinkprompt file.</td>
+</tr>
+</tbody></table>
+<pre><code class="language-lua">--------------------------------------------------------------------------------
+-- This is a sample clinkprompt module.  It shows how (easy it is) to write a
+-- clinkprompt module.
+--
+-- While a clinkprompt module is deactivated, it stops receiving calls to any
+-- prompt filters or events it may have registered until the clinkprompt module
+-- is reactivated later.
+
+local norm = &quot;\x1b[m&quot;
+local bold = &quot;\x1b[1m&quot;
+local reverse = &quot;\x1b[0;7m&quot;
+local red = &quot;\x1b[91m&quot;
+local green = &quot;\x1b[92m&quot;
+local darkgray = &quot;\x1b[90m&quot;
+
+local symbol = &quot;&gt;&quot;
+
+--------------------------------------------------------------------------------
+-- Normal prompt filter stuff...
+
+local function cwdstring()
+    local cwd = os.getcwd()
+    return rl.collapsetilde(cwd, true)
+end
+
+local function errorlevelcolor()
+    return (os.geterrorlevel() == 0) and green or red
+end
+
+local p = clink.promptfilter(25)
+
+function p:filter()
+    return bold..cwdstring()..norm..&quot; &quot;..errorlevelcolor()..symbol..norm..&quot; &quot;
+end
+
+function p:rightfilter()
+    return os.date(&quot;%a %H:%M&quot;, os.time())
+end
+
+function p:transientfilter()
+    return errorlevelcolor()..symbol..norm..&quot; &quot;
+end
+
+--------------------------------------------------------------------------------
+-- Some event handlers...
+
+local function onbeginedit()
+    print(darkgray..&quot;-- SAMPLEPROMPT: onbeginedit --&quot;..norm)
+end
+
+local function onendedit()
+    print(darkgray..&quot;-- SAMPLEPROMPT: onendedit --&quot;..norm)
+end
+
+clink.onbeginedit(onbeginedit)
+clink.onendedit(onendedit)
+
+--------------------------------------------------------------------------------
+-- Special clinkprompt module stuff...
+
+local function onactivate()
+    print(darkgray..&quot;-- SAMPLEPROMPT: onactivate --&quot;..norm)
+end
+
+local function ondeactivate()
+    print(darkgray..&quot;-- SAMPLEPROMPT: ondeactivate --&quot;..norm)
+end
+
+local function demo()
+    local left = bold..cwdstring()..norm..&quot; &quot;..green..symbol..norm..&quot; &quot;
+    local right = os.date(&quot;%a %H:%M&quot;, os.time())
+    left = left..reverse..&quot; &quot;..norm
+
+    local left_len = console.cellcount(left)
+    local right_len = console.cellcount(right)
+    local pad = &quot;&quot;
+    if left_len + 4 + right_len &gt;= console.getwidth() then
+        right = &quot;&quot;
+    else
+        pad = string.rep(&quot; &quot;, console.getwidth() - (left_len + right_len))
+    end
+
+    print(left..pad..right)
+end
+
+local exports =
+{
+    onactivate = onactivate,
+    ondeactivate = ondeactivate,
+    -- Uncomment this if you want to supply a custom demo function which will
+    -- be invoked by &#39;clink config prompt show Sample&#39;.
+    --demo = demo,
+}
+
+-- Returning an exports table is optional, but allows the clinkprompt module to
+-- print a custom demo from &#39;clink config prompt show Sample&#39;.
+return exports
+</code></pre>
 <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 <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>
-<p>The <code>:rightfilter()</code> function works the same as the <code>:filter()</code> function, except that it operates on the right side prompt.  It takes a string argument that contains the filtered right side prompt so far.  If the rightfilter function returns nil, it has no effect.  If the rightfilter function returns a string, that string is used as the new filtered right side prompt (and may be further modified by other prompt filters with higher priority ids).  If either the rightfilter function or the normal 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>The <code>:rightfilter()</code> function works the same as the <code>:filter()</code> function, except that it operates on the right side prompt.  It takes a string argument that contains the filtered right side prompt so far.</p>
+<p>If the rightfilter function returns nil, it has no effect.  If the rightfilter function returns a string, that string is used as the new filtered right side prompt (and may be further modified by other prompt filters with higher priority ids).  If either the rightfilter function or the normal 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>This example modifies the right side prompt by prepending the current date:</p>
 <pre><code class="language-lua">local p = clink.promptfilter(30)
 function p:filter(prompt)
@@ -5228,67 +5542,15 @@ <h4 id="asynchronous-prompt-filtering"><a class="wlink" href="#asyncpromptfilter
 <p><strong>Backward compatibility:</strong> A prompt filter must handle backward compatibility itself if it needs to run on versions of Clink that don&#39;t support asynchronous prompt filtering (v1.2.9 and lower).  E.g. you can use <code><span class="hljs-keyword">if</span> clink.promptcoroutine <span class="hljs-keyword">then</span></code> to test whether the API exists.</p>
 </blockquote>
 <p>The following example illustrates running <code>git status</code> in the background.  It also remembers the status from the previous input line, so that it can reduce flicker by using the color from last time until the background status operation completes.</p>
+<p><strong>Note:</strong>  This is for illustration purposes and works when no other custom prompt filters are installed.  If another custom prompt filter is present and runs earlier and chooses to halt further prompt filtering, then this example code might not get reached.</p>
 <pre><code class="language-lua">local prev_dir      -- Most recent git repo visited.
 local prev_info     -- Most recent info retrieved by the coroutine.
 
-local function get_git_dir(dir)
-    -- Check if the current directory is in a git repo.
-    local child
-    repeat
-        if os.isdir(path.join(dir, &quot;.git&quot;)) then
-            return dir
-        end
-        -- Walk up one level to the parent directory.
-        dir,child = path.toparent(dir)
-        -- If child is empty, we&#39;ve reached the top.
-    until (not child or child == &quot;&quot;)
-    return nil
-end
-
-local function get_git_branch()
-    -- Get the current git branch name.
-    local file = io.popen(&quot;git branch --show-current 2&gt;nul&quot;)
-    local branch = file:read(&quot;*a&quot;):match(&quot;(.+)\n&quot;)
-    file:close()
-    return branch
-end
-
-local function get_git_status()
-    -- The io.popenyield API is like io.popen, but it yields until the output is
-    -- ready to be read.
-    local file = io.popenyield(&quot;git --no-optional-locks status --porcelain 2&gt;nul&quot;)
-    local status = false
-    for line in file:lines() do
-        -- If there&#39;s any output, the status is not clean.  Since this example
-        -- doesn&#39;t analyze the details, it can stop once it knows there&#39;s any
-        -- output at all.
-        status = true
-        break
-    end
-    file:close()
-    return status
-end
-
-local function get_git_conflict()
-    -- The io.popenyield API is like io.popen, but it yields until the output is
-    -- ready to be read.
-    local file = io.popenyield(&quot;git diff --name-only --diff-filter=U 2&gt;nul&quot;)
-    local conflict = false
-    for line in file:lines() do
-        -- If there&#39;s any output, there&#39;s a conflict.
-        conflict = true
-        break
-    end
-    file:close()
-    return conflict
-end
-
 local function collect_git_info()
     -- This is run inside the coroutine, which happens while idle while waiting
     -- for keyboard input.
     local info = {}
-    info.status = get_git_status()
-    info.conflict = get_git_conflict()
+    info.status = git.getstatus()
     -- Until this returns, the call to clink.promptcoroutine() will keep
     -- returning nil.  After this returns, subsequent calls to
     -- clink.promptcoroutine() will keep returning this return value, until a
@@ -5297,24 +5559,28 @@ <h4 id="asynchronous-prompt-filtering"><a class="wlink" href="#asyncpromptfilter
 end
 
 local git_prompt = clink.promptfilter(55)
+
 function git_prompt:filter(prompt)
     -- Do nothing if not a git repo.
-    local dir = get_git_dir(os.getcwd())
+    local dir = git.getgitdir()
     if not dir then
         return
     end
+
     -- Reset the cached status if in a different repo.
     if prev_dir ~= dir then
         prev_info = nil
         prev_dir = dir
     end
+
     -- Do nothing if git branch not available.  Getting the branch name is fast,
     -- so it can run outside the coroutine.  That way the branch name is visible
     -- even while the coroutine is running.
-    local branch = get_git_branch()
+    local branch = git.getbranch()
     if not branch or branch == &quot;&quot; then
         return
     end
+
     -- Start a coroutine to collect various git info in the background.  The
     -- clink.promptcoroutine() call returns nil immediately, and the
     -- coroutine runs in the background.  After the coroutine finishes, prompt
@@ -5329,16 +5595,31 @@ <h4 id="asynchronous-prompt-filtering"><a class="wlink" href="#asyncpromptfilter
     else
         prev_info = info
     end
-    -- Choose color for the git branch name:  green if status is clean, yellow
+
+    -- Prefer using the branch name from git.getstatus(), once it&#39;s available.
+    if info.status and info.status.branch then
+        branch = info.status.branch
+    end
+
+    -- Choose color for the git branch name.:  green if status is clean, yellow
     -- if status is not clean, red if conflict is present, or default color if
     -- status isn&#39;t known yet.
-    local sgr = &quot;37;1&quot;
-    if info.conflict then
-        sgr = &quot;31;1&quot;
-    elseif info.status ~= nil then
-        sgr = info.status and &quot;33;1&quot; or &quot;32;1&quot;
+    local sgr
+    if not info.status then
+        sgr = &quot;39&quot;          -- Default color when status not available yet.
+    elseif info.status.conflict then
+        sgr = &quot;31;1&quot;        -- Red when conflict.
+    elseif info.status.dirty then
+        sgr = &quot;33;1&quot;        -- Yellow when dirty (changes are present).
+    else
+        sgr = &quot;32;1&quot;        -- Green when status is clean.
     end
+
     -- Prefix the prompt with &quot;[branch]&quot; using the status color.
+    -- NOTE:  This is for illustration purposes and works when no other custom
+    -- prompt filters are installed.  If another custom prompt filter is present
+    -- and runs earlier and chooses to halt further prompt filtering, then this
+    -- example code might not get reached.
     return &quot;\x1b[&quot;..sgr..&quot;m[&quot;..branch..&quot;]\x1b[m  &quot;..prompt
 end
 </code></pre>
@@ -5352,7 +5633,8 @@ <h4 id="transient-prompt"><a class="wlink" href="#transientprompts"><svg width=1
 <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>
 <li>Define a <code>:transientfilter()</code> function on the returned prompt filter.</li>
 </ol>
-<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>The transient filter function takes a string argument that contains the filtered prompt so far.</p>
+<p>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>
@@ -5367,6 +5649,7 @@ <h4 id="transient-prompt"><a class="wlink" href="#transientprompts"><svg width=1
 local cwd_color  = &quot;\x1b[0;1;37;44m&quot;
 local symbol_color = &quot;\x1b[0;1;34m&quot;
 local date_color = &quot;\x1b[0;36m&quot;
+local transient_date_color = &quot;\x1b[0;1;30m&quot;
 local normal = &quot;\x1b[m&quot;
 
 -- Create prompt filter.
@@ -5380,8 +5663,8 @@ <h4 id="transient-prompt"><a class="wlink" href="#transientprompts"><svg width=1
 
 -- Customize the normal right side prompt.
 function pf:rightfilter(prompt)
-    -- Returns false to stop filtering.
-    return date_color..os.date(), false
+    -- If you have want stop further filtering, this is where to add returning false.
+    return date_color..os.date()    --, false
 end
 
 -- Customize the transient prompt.
@@ -5393,7 +5676,7 @@ <h4 id="transient-prompt"><a class="wlink" href="#transientprompts"><svg width=1
 -- Customize the transient right side prompt.
 function pf:transientrightfilter(prompt)
     -- Returns false to stop filtering.
-    return &quot;&quot;, false
+    return transient_date_color..os.date(&quot;%c&quot;, os.time()), false
 end
 
 -- Show a reminder to turn on the transient prompt, to try out the example.
@@ -5436,14 +5719,14 @@ <h4 id="prefix-and-suffix-escape-codes"><a class="wlink" href="#pfxsfxesccodes">
 <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 <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>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.  Insert the whole suggestion with the <kbd>Right</kbd> arrow or <kbd>End</kbd> key, insert the next word of the suggestion with <kbd>Ctrl</kbd>-<kbd>Right</kbd>, or insert 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 insert them.</p>
 <p>Scripts can provide custom suggestion generators, in addition to the built-in options:</p>
 <ol>
 <li>Create a new suggestion generator by calling <a href="#clink.suggester">clink.suggester()</a> along with a name that identifies the suggestion generator, and can be added to the <code><a href="#autosuggest_strategy">autosuggest.strategy</a></code> setting.</li>
 <li>Define a <code>:suggest()</code> function on the returned suggestion generator.</li>
 </ol>
-<p>The function takes a <a href="#line_state">line_state</a> argument that contains the input line, and a <a href="#matches">matches</a> argument that contains the possible matches from the completion engine.  If the function returns nil, the next generator listed in the strategy is called.  If the function returns a string (even an empty string), then the string is used as the suggestion.</p>
-<p>The function can optionally return a string and an offset to where the suggestion begins in the input line.  This makes it easier to return suggestions in some cases, and also makes it possible to update the capitalization of the whole accepted suggestion (even the part that&#39;s already been typed).</p>
+<p>The function takes a <a href="#line_state">line_state</a> argument that contains the input line, and a <a href="#matches">matches</a> argument that contains the possible matches from the completion engine.</p>
+<p>If the function returns nil, the next generator listed in the strategy is called.  If the function returns a string (even an empty string), then the string is used as the suggestion.  The function can optionally return a string and an offset to where the suggestion begins in the input line.  This makes it easier to return suggestions in some cases, and also makes it possible to update the capitalization of the whole inserted suggestion (even the part that&#39;s already been typed).</p>
 <p>This example illustrates how to make a suggestion generator that returns the longest common prefix of the possible matches.</p>
 <pre><code class="language-lua">local prefix_suggestor = clink.suggester(&quot;completion_prefix&quot;)
 
@@ -5464,6 +5747,41 @@ <h2 id="customizing-suggestions"><a class="wlink" href="#customisingsuggestions"
     return prefix, info.offset
 end
 </code></pre>
+<p><a name="showinginputhints"></a></p>
+<h2 id="showing-input-hints"><a class="wlink" href="#showinginputhints"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>Showing Input Hints <span class="uplinks"><a href="#extending-clink">up</a> <a href="#toc">top</a></span></h2>
+<p>Clink can show contextual input hints while you type.  Lua scripts can provide input hints.  When a hint is available, it&#39;s shown in the comment row (below the input line).  For example:</p>
+<pre style="border-radius:initial;border:initial;background-color:black"><code class="plaintext" style="background-color:black"><span class="color_default">C:\dir><span class="color_argmatcher">foo</span> <span class="cursor">_</span></span>
+<span class="color_comment_row">Argument expected:  filename</span>
+</code></pre>
+
+<p>To use this, Clink v1.7.0 or higher is required.</p>
+<p>To turn on input hints, run <code>clink set <a href="#comment_row_show_hints">comment_row.show_hints</a> true</code>.  Lua scripts can add hinters to do things like show the value of an environment variable under the cursor, or show the value of a doskey macro, or show a hint about what kind of argument a command expects to be entered next, or other things.  The <a href="https://github.com/chrisant996/clink-gizmos">clink-gizmos</a> repo has some scripts that add hinters.</p>
+<p>Scripts can provide custom input hint generators:</p>
+<ol>
+<li>Create a new hint generator by calling <a href="#clink.hinter">clink.hinter()</a> along with an optional priority id which dictates the order in which hinters are called. Lower priority ids are called first.</li>
+<li>Define a <code>:gethint()</code> function on the returned hint generator.</li>
+</ol>
+<p>The function takes a <a href="#line_state">line_state</a> argument that contains the input line.</p>
+<p>If the function returns nil, the next hint generator is called.  If the function returns a string (even an empty string), then the string is used as a hint candidate.  The function can optionally return a string and a position in the line text where the hint refers to (for example, the offset to the beginning of a word).  The hint string with the highest position not exceeding the cursor position is used as the &quot;best hint&quot; (if a hint is returned without a position, then the beginning of the line is assumed).</p>
+<blockquote>
+<p><strong>Note:</strong> The <code>:gethint</code> callback function is called very often, so it needs to be very fast or it can cause responsiveness problems while typing.</p>
+</blockquote>
+<p>This example illustrates how to make an input hint generator that shows the offset of the start of the word under the cursor.</p>
+<pre><code class="language-lua">local hinter = clink.hinter()
+
+function hinter:gethint(line_state)
+    local h, p
+    local cursorpos = line_state:getcursor()
+    for i = 1, line_state:getwordcount() do
+        local info = line_state:getwordinfo(i)
+        if info.offset &lt;= cursorpos and cursorpos &lt;= info.offset + info.length then
+            h = string.format(&quot;word starts at %d&quot;, info.offset)
+            p = info.offset
+        end
+    end
+    return h, p
+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 <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">
@@ -6665,12 +6983,17 @@ <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="clink-themes"><a class="wlink" href="#clink-themes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>clink-themes <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-themes">clink-themes</a> repository contains some <a href="#color-themes">color themes</a> and <a href="#custom-prompts">custom prompts</a> which can be used with Clink.  If you have one you want to share, this can be a good place to share it.</p>
 <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>
+<p>The <a href="https://ohmyposh.dev">oh-my-posh</a> program can generate fancy prompts. Refer to its <a href="https://ohmyposh.dev">documentation</a> for installation instructions, sample themes, and more information.</p>
+<p>But in Clink v1.7.0 and newer, don&#39;t create a Lua script for oh-my-posh.</p>
+<p>Instead do the following:</p>
+<ol>
+<li>Run <code>clink config prompt use oh-my-posh</code> to activate oh-my-posh as the custom prompt.</li>
+<li>If the oh-my-posh.exe file is not in the system PATH, then run <code>clink set ohmyposh.exepath "<span class="arg">full_path_to_oh-my-posh.exe</span>"</code> to tell Clink where to find the oh-my-posh program file.</li>
+<li>To configure oh-my-posh to use a particular prompt theme, run <code>clink set ohmyposh.theme "<span class="arg">full_path_to_theme_file</span>.omp.json"</code> to select the theme file.</li>
+</ol>
 <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>
@@ -6733,12 +7056,12 @@ <h1 id="lua-api"><a class="wlink" href="#lua-api"><svg width=16 height=16><use h
 <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">
+<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="#git">git</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/>
+: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>hint=<span class="arg">string_or_function</span></code></td><td>See <a href="#addarg_hint">Show a Usage Hint</a>.</td><td class="version">v1.7.0 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>nowordbreakchars=true</code></td><td>See <a href="#addarg_nowordbreakchars">Overcoming Word Breaks</a>.</td><td class="version">v1.5.17 and newer</td></tr> <tr><td><code>onadvance=<span class="arg">function</span></code></td><td>See <a href="#responsive-argmatchers">Responding to Arguments in Argmatchers</a>.</td><td class="version">v1.5.14 and newer</td></tr> <tr><td><code>onalias=<span class="arg">function</span></code></td><td>See <a href="#responsive-argmatchers">Responding to Arguments in Argmatchers</a>.</td><td class="version">v1.6.18 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> <tr><td><code>onlink=<span class="arg">function</span></code></td><td>See <a href="#responsive-argmatchers">Responding to Arguments in Argmatchers</a>.</td><td class="version">v1.5.14 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 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/>
 
@@ -6882,7 +7205,9 @@ <h5 id="builder" class="group_name"><a class="wlink" href="#builder"><svg width=
 
 </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.onaftercommand">onaftercommand</a></td><td><a href="#clink.popuplist">popuplist</a></td><td><a href="#clink.setcoroutinename">setcoroutinename</a></td></tr><tr><td><a href="#clink.classifier">classifier</a></td><td><a href="#clink.onbeginedit">onbeginedit</a></td><td><a href="#clink.print">print</a></td><td><a href="#clink.suggester">suggester</a></td></tr><tr><td><a href="#clink.dirmatches">dirmatches</a></td><td><a href="#clink.oncommand">oncommand</a></td><td><a href="#clink.promptcoroutine">promptcoroutine</a></td><td><a href="#clink.translateslashes">translateslashes</a></td></tr><tr><td><a href="#clink.dirmatchesexact">dirmatchesexact</a></td><td><a href="#clink.ondisplaymatches">ondisplaymatches</a></td><td><a href="#clink.promptfilter">promptfilter</a></td><td><a href="#clink.upper">upper</a></td></tr><tr><td><a href="#clink.filematches">filematches</a></td><td><a href="#clink.onendedit">onendedit</a></td><td><a href="#clink.reclassifyline">reclassifyline</a></td><td><a href="#clink.version_commit">version_commit</a></td></tr><tr><td><a href="#clink.filematchesexact">filematchesexact</a></td><td><a href="#clink.onfilterinput">onfilterinput</a></td><td><a href="#clink.recognizecommand">recognizecommand</a></td><td><a href="#clink.version_encoded">version_encoded</a></td></tr><tr><td><a href="#clink.generator">generator</a></td><td><a href="#clink.onfiltermatches">onfiltermatches</a></td><td><a href="#clink.refilterafterterminalresize">refilterafterterminalresize</a></td><td><a href="#clink.version_major">version_major</a></td></tr><tr><td><a href="#clink.getansihost">getansihost</a></td><td><a href="#clink.onhistory">onhistory</a></td><td><a href="#clink.refilterprompt">refilterprompt</a></td><td><a href="#clink.version_minor">version_minor</a></td></tr><tr><td><a href="#clink.getargmatcher">getargmatcher</a></td><td><a href="#clink.oninject">oninject</a></td><td><a href="#clink.reload">reload</a></td><td><a href="#clink.version_patch">version_patch</a></td></tr><tr><td><a href="#clink.getpopuplistcolors">getpopuplistcolors</a></td><td><a href="#clink.oninputlinechanged">oninputlinechanged</a></td><td><a href="#clink.runcoroutineuntilcomplete">runcoroutineuntilcomplete</a></td></tr><tr><td><a href="#clink.getsession">getsession</a></td><td><a href="#clink.onprovideline">onprovideline</a></td><td><a href="#clink.runonmain">runonmain</a></td></tr><tr><td><a href="#clink.lower">lower</a></td><td><a href="#clink.parseline">parseline</a></td><td><a href="#clink.setcoroutineinterval">setcoroutineinterval</a></td></tr></table>
+<table class="grouplist"><tr><td><a href="#clink.applytheme">applytheme</a></td><td><a href="#clink.getsession">getsession</a></td><td><a href="#clink.oninputlinechanged">oninputlinechanged</a></td><td><a href="#clink.runcoroutineuntilcomplete">runcoroutineuntilcomplete</a></td></tr><tr><td><a href="#clink.argmatcher">argmatcher</a></td><td><a href="#clink.getthemes">getthemes</a></td><td><a href="#clink.onprovideline">onprovideline</a></td><td><a href="#clink.runonmain">runonmain</a></td></tr><tr><td><a href="#clink.classifier">classifier</a></td><td><a href="#clink.hinter">hinter</a></td><td><a href="#clink.parseline">parseline</a></td><td><a href="#clink.setcoroutineinterval">setcoroutineinterval</a></td></tr><tr><td><a href="#clink.dirmatches">dirmatches</a></td><td><a href="#clink.lower">lower</a></td><td><a href="#clink.popuplist">popuplist</a></td><td><a href="#clink.setcoroutinename">setcoroutinename</a></td></tr><tr><td><a href="#clink.dirmatchesexact">dirmatchesexact</a></td><td><a href="#clink.onaftercommand">onaftercommand</a></td><td><a href="#clink.print">print</a></td><td><a href="#clink.suggester">suggester</a></td></tr><tr><td><a href="#clink.filematches">filematches</a></td><td><a href="#clink.onbeginedit">onbeginedit</a></td><td><a href="#clink.promptcoroutine">promptcoroutine</a></td><td><a href="#clink.translateslashes">translateslashes</a></td></tr><tr><td><a href="#clink.filematchesexact">filematchesexact</a></td><td><a href="#clink.oncommand">oncommand</a></td><td><a href="#clink.promptfilter">promptfilter</a></td><td><a href="#clink.upper">upper</a></td></tr><tr><td><a href="#clink.generator">generator</a></td><td><a href="#clink.ondisplaymatches">ondisplaymatches</a></td><td><a href="#clink.readtheme">readtheme</a></td><td><a href="#clink.version_commit">version_commit</a></td></tr><tr><td><a href="#clink.getansihost">getansihost</a></td><td><a href="#clink.onendedit">onendedit</a></td><td><a href="#clink.reclassifyline">reclassifyline</a></td><td><a href="#clink.version_encoded">version_encoded</a></td></tr><tr><td><a href="#clink.getargmatcher">getargmatcher</a></td><td><a href="#clink.onfilterinput">onfilterinput</a></td><td><a href="#clink.recognizecommand">recognizecommand</a></td><td><a href="#clink.version_major">version_major</a></td></tr><tr><td><a href="#clink.getclinkprompt">getclinkprompt</a></td><td><a href="#clink.onfiltermatches">onfiltermatches</a></td><td><a href="#clink.refilterafterterminalresize">refilterafterterminalresize</a></td><td><a href="#clink.version_minor">version_minor</a></td></tr><tr><td><a href="#clink.getpopuplistcolors">getpopuplistcolors</a></td><td><a href="#clink.onhistory">onhistory</a></td><td><a href="#clink.refilterprompt">refilterprompt</a></td><td><a href="#clink.version_patch">version_patch</a></td></tr><tr><td><a href="#clink.getprompts">getprompts</a></td><td><a href="#clink.oninject">oninject</a></td><td><a href="#clink.reload">reload</a></td></tr></table>
+<div class="function"><div class="header"> <div id="clink.applytheme" class="name"><a class="wlink" href="#clink.applytheme"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.applytheme</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">theme</span>:string, [<span class="arg_name">clearall</span>:boolean], [<span class="arg_name">no_save</span>:boolean] ) : table, message<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Finds the <span class="arg">theme</span> and tries to apply its setting (which are saved in the current profile settings, which affects all Clink sessions using that profile directory).</p><p class="desc"> If successful, it returns true.  If unsuccessful, it returns nil followed by a message describing the failure.</p><p class="desc"> Applying a color theme clears the built-in color settings to their default values before loading the theme.  If the optional <span class="arg">clearall</span> argument is true, then it also clears any color settings added by Lua scripts.</p><p class="desc"> If the optional <span class="arg">no_save</span> argument is true, then the color theme is loaded into memory but is not saved back to the Clink settings file.</p><p class="desc"> Refer to <a href="#color-themes">Color Themes</a> for more information.</p></div></div><hr/>
+
 <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/>
@@ -6920,10 +7245,27 @@ <h5 id="clink" class="group_name"><a class="wlink" href="#clink"><svg width=16 h
 
 <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.getclinkprompt" class="name"><a class="wlink" href="#clink.getclinkprompt"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.getclinkprompt</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, string, string, table<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Returns four values related to the current clinkprompt module, if any:</p><p class="desc"> <ul> <li>A string containing the lowercase name (e.g. <code>"myprompt"</code>). <li>A string containing the full path name of the current clinkprompt module (e.g. <code>"C:\MyScripts\themes\MyPrompt.clinkprompt"</code>). <li>Lowercase full path name of the current clinkprompt module. <li>A table of other clinkprompt modules that the current module depends on.  The keys are the lowercase names (not full paths) of modules, and the values are all <code>true</code>. </ul></p><p class="desc"> If no clinkprompt module is currently active, then the return values are three empty strings and an empty table.</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/>
+&nbsp;   items      = "...",   -- The SGR parameters for the items color.
+&nbsp;   desc       = "...",   -- The SGR parameters for the description color.
+&nbsp;   -- Clink v1.7.0 adds the following colors to the table:
+&nbsp;   border     = "...",   -- The SGR parameters for the border color.
+&nbsp;   header     = "...",   -- The SGR parameters for the title color.
+&nbsp;   footer     = "...",   -- The SGR parameters for the footer message color.
+&nbsp;   select     = "...",   -- The SGR parameters for the selected item color.
+&nbsp;   selectdesc = "...",   -- The SGR parameters for the selected item description color.
+}</code></pre><p class="desc">See <a href="https://en.wikipedia.org/wiki/ANSI_escape_code#SGR">SGR parameters</a> for more information on ANSI escape codes for colors.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.getprompts" class="name"><a class="wlink" href="#clink.getprompts"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.getprompts</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] ) : (see remarks below)<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">This has two different behaviors, depending on whether the optional <span class="arg">name</span> argument is provided:</p><p class="desc"> If <span class="arg">name</span> is omitted, this returns two tables. The first table is an array of custom prompt names.  The second table is a map of lowercase names to their corresponding file paths.</p><pre class="language-lua"><code>local names, map = clink.getprompts()
+for _, name in ipairs(names) do
+&nbsp;   local file = map[clink.lower(name)]
+&nbsp;   print(string.format('"%s" -> "%s"', name, file))
+end</code></pre><p class="desc">If <span class="arg">name</span> is a string, this returns the file path of a matching custom prompt file.  If the ".clinkprompt" extension is not present, it is assumed.  If no matching prompt file is found, nil is returned.</p><pre class="language-lua"><code>clink.getprompt("My Prompt Name")
+-- Could return "My Prompt Name.clinkprompt" if that file exists in the current directory.
+-- Could return "c:\myclink\scripts\themes\My Prompt Name.clinkprompt" if that exists.
+-- Etc.</code></pre><p class="desc">Refer to <a href="#customisingtheprompt">Customizing the Prompt</a> for more information.</p></div></div><hr/>
 
 <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')
@@ -6934,6 +7276,17 @@ <h5 id="clink" class="group_name"><a class="wlink" href="#clink"><svg width=16 h
 &nbsp;   r:close()
 end</code></pre></div></div><hr/>
 
+<div class="function"><div class="header"> <div id="clink.getthemes" class="name"><a class="wlink" href="#clink.getthemes"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.getthemes</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] ) : (see remarks below)<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">This has two different behaviors, depending on whether the optional <span class="arg">name</span> argument is provided:</p><p class="desc"> If <span class="arg">name</span> is omitted, this returns two tables. The first table is an array of theme names.  The second table is a map of lowercase names to their corresponding file paths.</p><pre class="language-lua"><code>local names, map = clink.getthemes()
+for _, name in ipairs(names) do
+&nbsp;   local file = map[clink.lower(name)]
+&nbsp;   print(string.format('"%s" -> "%s"', name, file))
+end</code></pre><p class="desc">If <span class="arg">name</span> is a string, this returns the file path of a matching theme file.  If the ".clinktheme" extension is not present, it is assumed.  If no matching theme file is found, nil is returned.</p><pre class="language-lua"><code>clink.getthemes("My Theme Name")
+-- Could return "My Theme Name.clinktheme" if that file exists in the current directory.
+-- Could return "c:\myclink\scripts\themes\My Theme Name.clinktheme" if that exists.
+-- Etc.</code></pre><p class="desc">Refer to <a href="#color-themes">Color Themes</a> for more information.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="clink.hinter" class="name"><a class="wlink" href="#clink.hinter"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.hinter</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.6.22 and newer</div></div></div><div class="body"><p class="desc">Creates and returns a new hinter object.  Define on the object a <code>:gethint()</code> function which gets called in increasing <span class="arg">priority</span> order (low values to high values) when updating the input line display (e.g. while typing).  See <a href="#showinginputhints">Showing Input Hints</a> for more information.</p></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/>
 
@@ -7048,7 +7401,7 @@ <h5 id="clink" class="group_name"><a class="wlink" href="#clink"><svg width=16 h
 clink.print("world")
 -- Outputs "helloworld".</code></pre></div></div><hr/>
 
-<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.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, [<span class="arg_name">cookie</span>:string] ) : [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"> <fieldset><legend>Compatibility Note:</legend> Starting in v1.7.0, the optional <span class="arg">cookie</span> argument can be included to allow a prompt filter to have multiple different coroutines during a given input line session.  Subsequent calls for a given <span class="arg">cookie</span> value reuse the already-created coroutine associated with that cookie value.  This greatly simplifies the use of <a href="#asyncpromptfiltering">Asynchronous Prompt Filtering</a>.  When <span class="arg">cookie</span> is omitted, then <code>"default"</code> is assumed as the cookie value. </fieldset></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)
@@ -7056,13 +7409,15 @@ <h5 id="clink" class="group_name"><a class="wlink" href="#clink"><svg width=16 h
 &nbsp;   return os.date("%a %H:%M").." "..prompt
 end</code></pre></div></div><hr/>
 
+<div class="function"><div class="header"> <div id="clink.readtheme" class="name"><a class="wlink" href="#clink.readtheme"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>clink.readtheme</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">theme</span>:string ) : table, string<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Reads the specified theme and returns a table with its settings.  If unsuccessful, it returns nil followed by a message describing the failure.</p><p class="desc"> <span class="arg">theme</span> can be a filename or the title of an installed theme.</p><p class="desc"> Refer to <a href="#color-themes">Color Themes</a> for more information.</p></div></div><hr/>
+
 <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.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"> <strong>Note:</strong> 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/>
 
@@ -7089,7 +7444,7 @@ <h5 id="clink" class="group_name"><a class="wlink" href="#clink"><svg width=16 h
 &nbsp;   end
 end</code></pre></div></div><hr/>
 
-<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> <tr><td><code>4</code></td><td>Translate using the first kind of slash found in the word being completed, or the system path separator if there are no slashes yet.  (Only available in Clink v1.6.16 and higher.)</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> <tr><td><code>4</code></td><td>Translate using the first kind of slash found in the word being completed, or the system path separator if there are no slashes yet.  (Only available in Clink v1.6.16 and higher.)</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"> <strong>Note:</strong>  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.
@@ -7115,7 +7470,7 @@ <h5 id="clink" class="group_name"><a class="wlink" href="#clink"><svg width=16 h
 </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.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"> <strong>Note:</strong> 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.
@@ -7159,7 +7514,7 @@ <h5 id="console" class="group_name"><a class="wlink" href="#console"><svg width=
 
 <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.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"> <strong>Note:</strong> 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/>
 
@@ -7171,6 +7526,102 @@ <h5 id="console" class="group_name"><a class="wlink" href="#console"><svg width=
 
 <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="git" class="group_name"><a class="wlink" href="#git"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>git. <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="#git.getaction">getaction</a></td><td><a href="#git.getgitdir">getgitdir</a></td><td><a href="#git.hasstash">hasstash</a></td></tr><tr><td><a href="#git.getaheadbehind">getaheadbehind</a></td><td><a href="#git.getremote">getremote</a></td><td><a href="#git.isgitdir">isgitdir</a></td></tr><tr><td><a href="#git.getbranch">getbranch</a></td><td><a href="#git.getstashcount">getstashcount</a></td><td><a href="#git.loadconfig">loadconfig</a></td></tr><tr><td><a href="#git.getcommondir">getcommondir</a></td><td><a href="#git.getstatus">getstatus</a></td><td><a href="#git.makecommand">makecommand</a></td></tr><tr><td><a href="#git.getconflictstatus">getconflictstatus</a></td><td><a href="#git.getsystemname">getsystemname</a></td></tr></table>
+<div class="function"><div class="header"> <div id="git.getaction" class="name"><a class="wlink" href="#git.getaction"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.getaction</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string, number, number | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">This checks for git actions in progress, and returns the action name.  For certain actions it may also return the current step number and the total number of steps.</p><p class="desc"> If unsuccessful, this returns nil.</p><p class="desc"> The possible returned actions are: <ul> <li><code>"rebase-i"</code>: a rebase -i is in progress (includes step and total). <li><code>"rebase-m"</code>: a rebase -m is in progress (includes step and total). <li><code>"rebase"</code>: a rebase is in progress (includes step and total). <li><code>"am"</code>: a "git am" is in progress (includes step and total). <li><code>"am/rebase"</code>: a "git am" is in progress (includes step and total). <li><code>"merge"</code>: a merge is in progress. <li><code>"cherry-pick"</code>: a cherry-pick is in progress. <li><code>"revert"</code>: a revert is in progress. <li><code>"bisect"</code>: a bisect is in progress. </ul></p><p class="desc"></p><pre class="language-lua"><code>local action, step, total = git.getaction()
+if action then
+&nbsp;   print("current git action is '"..action.."'")
+&nbsp;   if step and total then
+&nbsp;       print(string.format("... step %d of %d", step, total))
+&nbsp;   end
+else
+&nbsp;   print("no git action currently in progress")
+end</code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.getaheadbehind" class="name"><a class="wlink" href="#git.getaheadbehind"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.getaheadbehind</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : string, string | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Gets the number of commits ahead/behind from upstream.</p><p class="desc"> In a git repo, it returns two strings: <ol> <li>A string with the number commits ahead of upstream. <li>A string with the number commits behind upstream. </ol></p><p class="desc"> Or when unsuccessful it returns nil.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.getbranch" class="name"><a class="wlink" href="#git.getbranch"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.getbranch</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">git_dir</span>:string] ) : string, boolean | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Returns the current git branch for <span class="arg">git_dir</span>, or for the current working directory if <span class="arg">git_dir</span> is omitted.</p><p class="desc"> If the workspace has a detached HEAD, then this returns two values:  the short hash of the current HEAD commit, and true.</p><p class="desc"> If unable to get the branch info, then nil is returned.</p><pre class="language-lua"><code>local branch, detached = git.getbranch()</code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.getcommondir" class="name"><a class="wlink" href="#git.getcommondir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.getcommondir</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">start_dir</span>:string] ) : string | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Returns the common git dir for <span class="arg">start_dir</span>, or for the current working directory if <span class="arg">git_dir</span> is omitted.</p><p class="desc"> When in a worktree, this returns the git dir for the main repo, rather than the git dir of the worktree itself.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.getconflictstatus" class="name"><a class="wlink" href="#git.getconflictstatus"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.getconflictstatus</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : boolean<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Gets the conflict status for the repo or worktree associated with the current working directory.</p><p class="desc"> Returns false if there are no conflicts, otherwise it returns true.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.getgitdir" class="name"><a class="wlink" href="#git.getgitdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.getgitdir</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">dir</span>:string] ) : string, string, string | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Tests whether <span class="arg">dir</span> is part of a git repo.  If <span class="arg">dir</span> is omitted then it assumes the current working directory.</p><p class="desc"> In a git repo, it returns three strings: <ol> <li>The git dir. <li>The workspace dir.  If not in a workspace, then this matches the git dir. <li>The original input <span class="arg">dir</span>. </ol></p><p class="desc"> Or when not in a git repo it returns nil.</p><p class="desc"> See <a href="#git.isgitdir">git.isgitdir()</a> for examples (they return the same strings).</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.getremote" class="name"><a class="wlink" href="#git.getremote"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.getremote</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">git_dir</span>:string] ) : string | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Gets the remote for the current branch for <span class="arg">start_dir</span>, or for the current working directory if <span class="arg">git_dir</span> is omitted.</p><p class="desc"> Returns nil if the current branch cannot be found.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.getstashcount" class="name"><a class="wlink" href="#git.getstashcount"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.getstashcount</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : number | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Returns the number of stashes that exist for the repo or worktree associated with the current working directory.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.getstatus" class="name"><a class="wlink" href="#git.getstatus"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.getstatus</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">no_untracked</span>:boolean], [<span class="arg_name">include_submodules</span>:boolean] ) : table | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">This runs <code>git status</code> to collect status information for the repo or worktree associated with the current working directory.</p><p class="desc"> If unsuccessful, this returns nil.</p><p class="desc"> Otherwise it returns a table with the following scheme:</p><pre class="language-lua"><code>{
+&nbsp;   branch = ...                -- branch name, or commit hash if detached
+&nbsp;   HEAD = ...                  -- HEAD commit hash, or "(initial)"
+&nbsp;   detached = ...              -- true if HEAD is detached, otherwise nil
+&nbsp;   upstream = ...              -- upstream name, other nil
+&nbsp;   dirty = ...                 -- true if working and/or staged changes, otherwise nil
+&nbsp;   ahead = ...                 -- number of commits ahead, otherwise nil
+&nbsp;   behind = ...                -- number of commits behind, otherwise nil
+&nbsp;   unpublished = ...           -- true if unpublished, otherwise nil
+&nbsp;   submodule = ...             -- true if in a submodule, otherwise nil
+&nbsp;   onlystaged = ...            -- number of changes only in staged files not in working files, otherwise nil
+&nbsp;   tracked = ...               -- number of changes in tracked working files, otherwise nil
+&nbsp;   untracked = ...             -- number of untracked files or directories, otherwise nil
+&nbsp;   conflict = ...              -- number of conflicted files, otherwise nil
+&nbsp;   working = {                 -- nil if no working changes
+&nbsp;       add = ...               -- number of added files
+&nbsp;       modify = ...            -- number of modified files
+&nbsp;       delete = ...            -- number of deleted files
+&nbsp;       conflict = ...          -- number of conflicted files
+&nbsp;       untracked = ...         -- number of untracked files or directories
+&nbsp;   }
+&nbsp;   staged = {                  -- nil if no staged changes
+&nbsp;       add = ...               -- number of added files
+&nbsp;       modify = ...            -- number of modified files
+&nbsp;       delete = ...            -- number of deleted files
+&nbsp;       rename = ...            -- number of renamed files
+&nbsp;   }
+&nbsp;   total = {                   -- nil if neither working nor staged
+&nbsp;       -- This counts files uniquely; if a file "foo" is deleted in working and
+&nbsp;       -- also in staged, it counts as only 1 deleted file.  Etc.
+&nbsp;       add = ...               -- total added files
+&nbsp;       modify = ...            -- total modified files
+&nbsp;       delete = ...            -- total deleted files
+&nbsp;   }
+}</code></pre><p class="desc">Example of checking whether the workspace is clean (no changes):</p><pre class="language-lua"><code>local status = git.getstatus()
+if not status then
+&nbsp;   print("failed")
+elseif status.dirty then
+&nbsp;   print("dirty (has changes)")
+else
+&nbsp;   print("clean (no changes)")
+end</code></pre><p class="desc">**Compatibility Note:** This requires a version of git that supports <code>git status --porcelain=v2</code>.  Porcelain v2 format has existed for a long time, so that isn't expected to be a limitation in practice.</p><p class="desc"> <fieldset><legend>Warning</legend> This runs slowly.  To keep a custom prompt responsive, run this in a coroutine so that it runs in the background (the prompt will automatically refresh when the background operation finishes).  See <a href="#asyncpromptfiltering">Asynchronous Prompt Filtering</a> for more information. </fieldset> luacheck: pop</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.getsystemname" class="name"><a class="wlink" href="#git.getsystemname"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.getsystemname</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">dir</span>:string] ) : string | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Checks whether <span class="arg">dir</span> is under git source control, and returns <code>"git"</code> if it is.  Otherwise returns nil.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.hasstash" class="name"><a class="wlink" href="#git.hasstash"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.hasstash</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">() : boolean | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Returns whether any stashes exist for the repo or worktree associated with the current working directory.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.isgitdir" class="name"><a class="wlink" href="#git.isgitdir"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.isgitdir</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">dir</span>:string] ) : string, string, string | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Tests whether <span class="arg">dir</span> is a git repo root, or a workspace dir, or a submodule dir.  If <span class="arg">dir</span> is omitted then it assumes the current working directory.</p><p class="desc"> In a git repo, it returns three strings: <ol> <li>The git dir. <li>The workspace dir.  If not in a workspace, then this matches the git dir. <li>The original input <span class="arg">dir</span>. </ol></p><p class="desc"> Or when not in a git repo it returns nil.</p><p class="desc"> Examples:</p><pre class="language-lua"><code>-- In a repo c:\repo:
+git.isgitdir("c:/repo")
+-- Returns:  "c:\repo\.git", "c:\repo\.git", "c:\repo"
+
+-- In a submodule under c:\repo:
+git.isgitdir("c:/repo/submodule")
+-- Returns:  "c:\repo\.git\modules\submodule", "c:\repo\.git", "c:\repo\submodule"
+
+-- In a worktree under c:\repo:
+git.isgitdir("c:/repo/worktree")
+-- Returns:  "c:\repo\.git\worktrees\worktree", "c:\repo\worktree\.git", "c:\repo\worktree"
+
+-- In a worktree outside c:\repo:
+git.isgitdir("c:/worktree")
+-- Returns:  "c:\repo\.git\worktrees\worktree", "c:\worktree\.git", "c:\worktree"</code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.loadconfig" class="name"><a class="wlink" href="#git.loadconfig"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.loadconfig</span> <span class="uplinks"><a href="#git">up</a> <a href="#lua-api">apis</a> <a href="#toc">top</a></span></div> <div class="signature">( [<span class="arg_name">git_dir</span>:string | system:boolean] ) : table | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Loads a git config file and returns a table containing the data, or returns nil if unable to load the config file.</p><p class="desc"> The function accepts either a git dir string or a boolean indicating whether to load the system config file.  If neither is provided then it loads the repo config file.</p><p class="desc"> The returned table has a <code>:get(section, param)</code> function to make it convenient to look up config parameters.</p><pre class="language-lua"><code>local config = git.loadconfig()
+print(config:get("core", "autocrlf"))
+print(config:get("user", "name"))</code></pre></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="git.makecommand" class="name"><a class="wlink" href="#git.makecommand"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>git.makecommand</span> <span class="uplinks"><a href="#git">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">include_stderr</span>:boolean] ) : string | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Returns a command line for running the specified git command.  The command line automatically prepends <code>git</code> to the input <span class="arg">command</span> string, plus disables git's optional locks and advice messages.  Unless <span class="arg">include_stderr</span> is true, it also includes <code>2>nul</code> to hide stderr output.</p><p class="desc"> If <span class="arg">command</span> is missing or empty, it returns nil.</p><pre class="language-lua"><code>git.makecommand("rev-parse HEAD")</code></pre></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>
@@ -7258,7 +7709,7 @@ <h5 id="line_state" class="group_name"><a class="wlink" href="#line_state"><svg
 
 <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)
+<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"> <strong>Note:</strong>  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.
@@ -7286,7 +7737,7 @@ <h5 id="matches" class="group_name"><a class="wlink" href="#matches"><svg width=
 
 </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.getpid">getpid</a></td><td><a href="#os.mkdir">mkdir</a></td></tr><tr><td><a href="#os.chdir">chdir</a></td><td><a href="#os.getclipboardtext">getclipboardtext</a></td><td><a href="#os.getpushddepth">getpushddepth</a></td><td><a href="#os.move">move</a></td></tr><tr><td><a href="#os.clock">clock</a></td><td><a href="#os.getcwd">getcwd</a></td><td><a href="#os.getscreeninfo">getscreeninfo</a></td><td><a href="#os.resolvealias">resolvealias</a></td></tr><tr><td><a href="#os.copy">copy</a></td><td><a href="#os.getdrivetype">getdrivetype</a></td><td><a href="#os.getshortpathname">getshortpathname</a></td><td><a href="#os.rmdir">rmdir</a></td></tr><tr><td><a href="#os.createtmpfile">createtmpfile</a></td><td><a href="#os.getenv">getenv</a></td><td><a href="#os.gettemppath">gettemppath</a></td><td><a href="#os.setalias">setalias</a></td></tr><tr><td><a href="#os.debugprint">debugprint</a></td><td><a href="#os.getenvnames">getenvnames</a></td><td><a href="#os.globdirs">globdirs</a></td><td><a href="#os.setclipboardtext">setclipboardtext</a></td></tr><tr><td><a href="#os.enumshares">enumshares</a></td><td><a href="#os.geterrorlevel">geterrorlevel</a></td><td><a href="#os.globfiles">globfiles</a></td><td><a href="#os.setenv">setenv</a></td></tr><tr><td><a href="#os.expandabbreviatedpath">expandabbreviatedpath</a></td><td><a href="#os.getfileversion">getfileversion</a></td><td><a href="#os.globmatch">globmatch</a></td><td><a href="#os.sleep">sleep</a></td></tr><tr><td><a href="#os.expandenv">expandenv</a></td><td><a href="#os.getfullpathname">getfullpathname</a></td><td><a href="#os.isdir">isdir</a></td><td><a href="#os.touch">touch</a></td></tr><tr><td><a href="#os.findfiles">findfiles</a></td><td><a href="#os.gethost">gethost</a></td><td><a href="#os.isfile">isfile</a></td><td><a href="#os.unlink">unlink</a></td></tr><tr><td><a href="#os.getalias">getalias</a></td><td><a href="#os.getlongpathname">getlongpathname</a></td><td><a href="#os.issignaled">issignaled</a></td></tr><tr><td><a href="#os.getaliases">getaliases</a></td><td><a href="#os.getnetconnectionname">getnetconnectionname</a></td><td><a href="#os.isuseradmin">isuseradmin</a></td></tr></table>
+<table class="grouplist"><tr><td><a href="#os.abbreviatepath">abbreviatepath</a></td><td><a href="#os.getaliases">getaliases</a></td><td><a href="#os.getnetconnectionname">getnetconnectionname</a></td><td><a href="#os.isuseradmin">isuseradmin</a></td></tr><tr><td><a href="#os.chdir">chdir</a></td><td><a href="#os.getbatterystatus">getbatterystatus</a></td><td><a href="#os.getpid">getpid</a></td><td><a href="#os.mkdir">mkdir</a></td></tr><tr><td><a href="#os.clock">clock</a></td><td><a href="#os.getclipboardtext">getclipboardtext</a></td><td><a href="#os.getpushddepth">getpushddepth</a></td><td><a href="#os.move">move</a></td></tr><tr><td><a href="#os.copy">copy</a></td><td><a href="#os.getcwd">getcwd</a></td><td><a href="#os.getscreeninfo">getscreeninfo</a></td><td><a href="#os.resolvealias">resolvealias</a></td></tr><tr><td><a href="#os.createguid">createguid</a></td><td><a href="#os.getdrivetype">getdrivetype</a></td><td><a href="#os.getshortpathname">getshortpathname</a></td><td><a href="#os.rmdir">rmdir</a></td></tr><tr><td><a href="#os.createtmpfile">createtmpfile</a></td><td><a href="#os.getenv">getenv</a></td><td><a href="#os.gettemppath">gettemppath</a></td><td><a href="#os.setalias">setalias</a></td></tr><tr><td><a href="#os.debugprint">debugprint</a></td><td><a href="#os.getenvnames">getenvnames</a></td><td><a href="#os.globdirs">globdirs</a></td><td><a href="#os.setclipboardtext">setclipboardtext</a></td></tr><tr><td><a href="#os.enumshares">enumshares</a></td><td><a href="#os.geterrorlevel">geterrorlevel</a></td><td><a href="#os.globfiles">globfiles</a></td><td><a href="#os.setenv">setenv</a></td></tr><tr><td><a href="#os.expandabbreviatedpath">expandabbreviatedpath</a></td><td><a href="#os.getfileversion">getfileversion</a></td><td><a href="#os.globmatch">globmatch</a></td><td><a href="#os.sleep">sleep</a></td></tr><tr><td><a href="#os.expandenv">expandenv</a></td><td><a href="#os.getfullpathname">getfullpathname</a></td><td><a href="#os.isdir">isdir</a></td><td><a href="#os.touch">touch</a></td></tr><tr><td><a href="#os.findfiles">findfiles</a></td><td><a href="#os.gethost">gethost</a></td><td><a href="#os.isfile">isfile</a></td><td><a href="#os.unlink">unlink</a></td></tr><tr><td><a href="#os.getalias">getalias</a></td><td><a href="#os.getlongpathname">getlongpathname</a></td><td><a href="#os.issignaled">issignaled</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
@@ -7344,6 +7795,8 @@ <h5 id="os" class="group_name"><a class="wlink" href="#os"><svg width=16 height=
 
 <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.createguid" class="name"><a class="wlink" href="#os.createguid"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.createguid</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">faster</span>:boolean] ) : string, boolean<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Generates a 128-bit unique ID represented as 32 hexadecimal characters.</p><p class="desc"> By default, this uses the OS `UuidCreate()` API to create a unique ID.</p><p class="desc"> When the optional <span class="arg">faster</span> argument is <code>true</code> then this uses `UuidCreateSequential()` instead, which is faster but can potentially be traced back to the ethernet address of the computer.</p><p class="desc"> If successful, this returns a 32 digit hexadecimal string and a boolean value.  When the boolean value is true then the ID is only locally unique, and cannot safely be used to uniquely identify an object that is not strictly local to your computer.</p><p class="desc"> If an error occurs, this returns nil.</p><p class="desc"> <strong>IMPORTANT:</strong> Not all of the 128 bits necessarily have the same degree of entropy on each computer.  If you discard any bits from the string then you could accidentally greatly reduce the uniqueness of the ID (even on the same computer), or even completely remove all entropy.</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/>
@@ -7390,9 +7843,9 @@ <h5 id="os" class="group_name"><a class="wlink" href="#os"><svg width=16 height=
 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 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.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"> <strong>Note:</strong> 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.findfiles" class="name"><a class="wlink" href="#os.findfiles"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.findfiles</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] ) : object<br/><div class="version">v1.6.13 and newer</div></div></div><div class="body"><p class="desc">Returns an object that can be used to get files and/or directories matching <span class="arg">pattern</span>.</p><p class="desc"> <strong>Note:</strong> any quotation marks (<code>"</code>) in <span class="arg">pattern</span> are stripped.</p><p class="desc"> Unlike <a href="#os.globfiles">os.globfiles</a>, this only collects matching files or directories one at a time, instead of collecting all matches in a table.</p><p class="desc"> The returned object has the following functions: <ul> <li><strong>next()</strong> - Returns the next file or directory, or nil where there are no more. <li><strong>files()</strong> - Returns a Lua iterator function which can be used in a <strong>for</strong> loop, returning the next file or directory each time. <li><strong>close()</strong> - Releases the OS resources used for the search.  This is automatically called by the Lua garbage collector, but that may not happen quickly enough to avoid interfering with operations such as deleting a parent directory, so it's good to call <code>:close()</code> directly. </ul></p><pre class="language-lua"><code>-- Print the first matching file, without wasting time collecting
+<div class="function"><div class="header"> <div id="os.findfiles" class="name"><a class="wlink" href="#os.findfiles"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>os.findfiles</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] ) : object<br/><div class="version">v1.6.13 and newer</div></div></div><div class="body"><p class="desc">Returns an object that can be used to get files and/or directories matching <span class="arg">pattern</span>.</p><p class="desc"> <strong>Note:</strong> Any quotation marks (<code>"</code>) in <span class="arg">pattern</span> are stripped.</p><p class="desc"> Unlike <a href="#os.globfiles">os.globfiles</a>, this only collects matching files or directories one at a time, instead of collecting all matches in a table.</p><p class="desc"> The returned object has the following functions: <ul> <li><strong>next()</strong> - Returns the next file or directory, or nil where there are no more. <li><strong>files()</strong> - Returns a Lua iterator function which can be used in a <strong>for</strong> loop, returning the next file or directory each time. <li><strong>close()</strong> - Releases the OS resources used for the search.  This is automatically called by the Lua garbage collector, but that may not happen quickly enough to avoid interfering with operations such as deleting a parent directory, so it's good to call <code>:close()</code> directly. </ul></p><pre class="language-lua"><code>-- Print the first matching file, without wasting time collecting
 -- the rest of the files, since they aren't needed here.
 local ff = os.findfiles(pattern)
 local name = ff:next()
@@ -7439,7 +7892,7 @@ <h5 id="os" class="group_name"><a class="wlink" href="#os"><svg width=16 height=
 &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 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.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"> <strong>Note:</strong> 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.
@@ -7465,7 +7918,7 @@ <h5 id="os" class="group_name"><a class="wlink" href="#os"><svg width=16 height=
 -- info.productname         Microsoft® Windows® Operating System
 -- info.productversion      10.0.19041.1
 -- info.privatebuild
--- info.specialbuild</code></pre><p class="desc">Note:  The <span class="arg">fileflags</span> field may be nil (omitted), or it may contain a table with additional fields.</p><pre class="language-lua"><code>if info.fileflags then
+-- info.specialbuild</code></pre><p class="desc"><strong>Note:</strong>  The <span class="arg">fileflags</span> field may be nil (omitted), or it may contain a table with additional fields.</p><pre class="language-lua"><code>if info.fileflags then
 -- info.fileflags.debug
 -- info.fileflags.prerelease
 -- info.fileflags.patched
@@ -7499,7 +7952,7 @@ <h5 id="os" class="group_name"><a class="wlink" href="#os"><svg width=16 height=
 
 <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)
+<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).
@@ -7513,7 +7966,7 @@ <h5 id="os" class="group_name"><a class="wlink" href="#os"><svg width=16 height=
 }
 local t = os.globdirs("*", true, flags)</code></pre></div></div><hr/>
 
-<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)
+<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).
@@ -7615,6 +8068,7 @@ <h5 id="path" class="group_name"><a class="wlink" href="#path"><svg width=16 hei
 path.join("/foo", "/bar/xyz")   -- returns "/bar/xyz"</code></pre></div></div><hr/>
 
 <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("./foo/../bar")  -- returns "bar"
 path.normalise("")              -- returns ""</code></pre></div></div><hr/>
 
 <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
@@ -7713,7 +8167,7 @@ <h5 id="rl" class="group_name"><a class="wlink" href="#rl"><svg width=16 height=
 
 <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/>
+-- 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 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/>
 
@@ -7750,7 +8204,7 @@ <h5 id="rl" class="group_name"><a class="wlink" href="#rl"><svg width=16 height=
 
 <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()
+<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"> <strong>Note:</strong> 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.
@@ -7878,7 +8332,7 @@ <h5 id="rl_buffer" class="group_name"><a class="wlink" href="#rl_buffer"><svg wi
 
 <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: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"> <strong>Note:</strong>  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/>
 
@@ -7898,25 +8352,40 @@ <h5 id="rl_buffer" class="group_name"><a class="wlink" href="#rl_buffer"><svg wi
 
 <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: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"> <strong>Note:</strong>  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 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"> <strong>Note:</strong> 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>
+<table class="grouplist"><tr><td><a href="#settings.add">add</a></td><td><a href="#settings.get">get</a></td></tr><tr><td><a href="#settings.clear">clear</a></td><td><a href="#settings.parsecolor">parsecolor</a></td></tr><tr><td><a href="#settings.formatcolor">formatcolor</a></td><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 id="settings.clear" class="name"><a class="wlink" href="#settings.clear"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>settings.clear</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 ) : nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Clears the <span class="arg">name</span> Clink setting and reverts to its default value.</p><p class="desc"> <strong>Note:</strong> This updates the settings file.</p></div></div><hr/>
+
+<div class="function"><div class="header"> <div id="settings.formatcolor" class="name"><a class="wlink" href="#settings.formatcolor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>settings.formatcolor</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">code</span>:string, [<span class="arg_name">compat</span>:boolean] ) : string | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Formats an ANSI color code <span class="arg">code</span> into a color setting string suitable for use with <code>clink set color.foo</code>.</p><p class="desc"> Returns the formatted color setting string if successful, or nil if unsuccessful.</p><p class="desc"> If <span class="arg">compat</span> is true, then the formatted string uses the most compatible format.  This can be useful if the string needs to be usable by older versions of Clink.</p><p class="desc"> See <a href="#color-settings">Color Settings</a> for more information.</p><pre class="language-lua"><code>-- Fully defined color codes:
+settings.formatcolor("0;1")                 -- Returns "bold"
+settings.formatcolor("0;4;32")              -- Returns "underline green"
+settings.formatcolor("0;97;44")             -- Returns "bright white on blue"
+-- Partial color codes:
+settings.formatcolor("1")                   -- Returns "sgr 1"
+settings.formatcolor("4;32")                -- Returns "sgr 4;32"
+settings.formatcolor("97;44")               -- Returns "sgr 97;44"</code></pre></div></div><hr/>
+
 <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 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 class="function"><div class="header"> <div id="settings.parsecolor" class="name"><a class="wlink" href="#settings.parsecolor"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a><span>settings.parsecolor</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">color</span>:string ) : string | nil<br/><div class="version">v1.7.0 and newer</div></div></div><div class="body"><p class="desc">Parses a color setting string <span class="arg">color</span> into an ANSI color code, suitable for use in an ANSI escape sequence.  The string is parsed the same way as <code>clink set color.foo <em>string</em></code> would parse it.</p><p class="desc"> Returns the ANSI color code if successful, or nil if unsuccessful.</p><p class="desc"> See <a href="#color-settings">Color Settings</a> for more information.</p><pre class="language-lua"><code>settings.parsecolor("bold")                 -- Returns "0;1"
+settings.parsecolor("underline green")      -- Returns "0;4;32"
+settings.parsecolor("bri whi on blu")       -- Returns "0;97;44"</code></pre></div></div><hr/>
+
+<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"> <strong>Note:</strong> 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>
@@ -7995,7 +8464,7 @@ <h5 id="unicode" class="group_name"><a class="wlink" href="#unicode"><svg width=
 </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: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"> <strong>Note:</strong> 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/>
 
@@ -8153,6 +8622,53 @@ <h5 id="Deprecated" class="group_name"><a class="wlink" href="#Deprecated"><svg
         <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 <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="v170"><a class="wlink" href="#v170"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.7.0 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
+<p>Clink now supports color theme files and custom prompt files.  These enable packaging Clink color settings or Clink custom prompts into shareable files.  This finally makes it easy to download and apply themes or prompts shared by other people, or copy them and modify them.  The new <a href="https://github.com/chrisant996/clink-themes">clink-themes</a> repo is a site where .clinktheme and .clinkprompt files can be shared (see <a href="https://github.com/chrisant996/clink-themes#contributing">Contributing</a> for details on how to contribute your own themes and prompts).</p>
+<ul>
+<li>Added support for <code>*.clinktheme</code> color theme files; see <a href="#color-themes">Color Themes</a> for more information.<ul>
+<li>Added several <code>clink config theme</code> commands for color themes (run <code>clink config theme --help</code>).</li>
+<li>The famous <a href="https://draculatheme.com">Dracula</a>, <a href="https://github.com/altercation/solarized">Solarized</a> (light and dark), and <a href="https://github.com/chriskempson/tomorrow-theme">Tomorrow</a> (1 light, 4 dark) themes are included.</li>
+<li>Use <code>clink config theme use <span class="arg">name</span></code> to apply a color theme, or set the <code>CLINK_COLORTHEME</code> environment variable to the color theme name.</li>
+</ul>
+</li>
+<li>Added support for <code>*.clinkprompt</code> custom prompt files; see <a href="#custom-prompts">Custom Prompts</a> for more information.  This makes it easy to share custom prompts, and to have a library of many different custom prompts and switch between them quickly and easily.  One .clinkprompt can be active at a time; activating one deactivates any others.<ul>
+<li>Added several <code>clink config prompt</code> commands for custom prompts (run <code>clink config prompt --help</code>).</li>
+<li><a href="#oh-my-posh">Oh-My-Posh</a> support is included.</li>
+<li>Also included are ports of <a href="https://github.com/agnoster/agnoster-zsh-theme">Agnoster</a>, <a href="https://github.com/sindresorhus/pure">Pure</a>, <a href="https://github.com/Moarram/headline">Headline</a>, <a href="https://github.com/elB4RTO/zsh-themes/tree/master/antares">Antares</a>, and a few others (all ported from zsh to Clink).</li>
+<li>Use <code>clink config prompt use <span class="arg">name</span></code> to activate a custom prompt module, or set the <code>CLINK_CUSTOMPROMPT</code> environment variable to the custom prompt name.</li>
+</ul>
+</li>
+<li>Added the ability to show input hints in the comment row (below the input line).<ul>
+<li>Input hints are off by default, and can be enabled with <code>clink set comment_row.show_hints true</code>.</li>
+<li>Argmatchers can provide input hints; see <a href="#addarg_hint">Show a Usage Hint</a> for more information.</li>
+<li>Lua scripts can create custom hinters; see <a href="#showinginputhints">Showing Input Hints</a> for more information.</li>
+</ul>
+</li>
+<li>Enhanced the syntax for setting colors; added <code>italic</code> and <code>reverse</code>, and added <code>#XXXXXX</code> and <code>#XXX</code> shortcuts for specifying 24-bit color values.</li>
+<li>Added more popup list colors:  <code>color.popup_border</code>, <code>color.popup_header</code>, <code>color.popup_footer</code>, <code>color.popup_select</code>, and <code>color.popup_selectdesc</code>.</li>
+<li>Changed phrasing from &quot;Accept Suggestion&quot; to &quot;Insert Suggestion&quot; in the documentation and in the auto-suggestions usage hint text.</li>
+<li>Changed the Lua <code>print()</code> function to support UTF8 output and terminal escape codes.  Now the only reasons for a script to use <code>clink.print()</code> instead of <code>print()</code> are (1) background compatibility or (2) using <code>NONL</code> to suppress printing a line ending.</li>
+<li>Improved terminal output logging when the <code>debug.log_terminal</code> setting is enabled (the setting is only for diagnostic use).<ul>
+<li>Now it captures all WriteConsoleW and WriteFile output sent to stdout or stderr (instead of only capturing output from the Readline library).</li>
+<li>Added a <code>debug.log_output_callstacks</code> setting which includes callstacks for each output reported by the <code>debug.log_terminal</code> setting.</li>
+</ul>
+</li>
+<li>Added a workaround for Unicode limitations in legacy console windows and legacy terminals (improves cursor position accuracy when Unicode surrogate pairs are present).</li>
+<li>Added several new Lua APIs for color themes and custom prompts:  <a href="#clink.getprompts">clink.getprompts()</a>, <a href="#clink.applyprompt">clink.applyprompt()</a>, <a href="#clink.getclinkprompt">clink.getclinkprompt()</a>, <a href="#clink.getthemes">clink.getthemes()</a>, <a href="#clink.readtheme">clink.readtheme()</a>, <a href="#clink.applytheme">clink.applytheme()</a>, <a href="#settings.clear">settings.clear()</a>, <a href="#settings.parsecolor">settings.parsecolor()</a>, <a href="#settings.formatcolor">settings.formatcolor()</a>, <a href="#os.createguid">os.createguid()</a>.</li>
+<li>Added <a href="#git">git Lua APIs</a> for use by custom prompts.</li>
+<li>Added optional <code>cookie</code> argument to <a href="#clink.promptcoroutine">clink.promptcoroutine()</a> to make it simple for *.clinkprompt files to allow customization that makes use of asynchronous prompt filtering without needing modifications to the main *.clinkprompt file.</li>
+<li>Fixed detecting file associations (some file extensions weren&#39;t detected as having file associations, causing executable completion to omit them, and causing input line coloring to be inaccurate).</li>
+<li>Fixed a case where updating the right side prompt could leave stray characters behind.</li>
+<li>Fixed a case where the <code>match.coloring_rules</code> setting could have no effect.</li>
+<li>Fixed delay when typing <code>X:</code> and it&#39;s a remote drive.</li>
+<li>Fixed coloring <code>2&gt;&amp;1</code>; the <code>1</code> wasn&#39;t colored.</li>
+<li>Fixed color of leading blank lines in a prompt string (use the terminal&#39;s default color, not the <code>color.prompt</code> color).</li>
+<li>Fixed <code>rl.collapsetilde()</code> which just didn&#39;t do its job.</li>
+<li>Fixed <code>%clink_dummy_capture_env%</code> to stop accidentally leaking into the environment variables collection.</li>
+<li>Fixed an infinite loop when <code>prompt.async</code> was false.</li>
+<li>Fixed <kbd>F9</kbd> to stop jumping one past the actual entered history number.</li>
+<li>Fixed various edge case bugs in the input line display, which were uncovered while adding the ability to show input hints.</li>
+</ul>
 <h4 id="v1621"><a class="wlink" href="#v1621"><svg width=16 height=16><use href="#wicon"/></svg><span class="wfix">.</span></a>v1.6.21 <span class="uplinks"><a href="#releases-from-chrisant996clink-fork">up</a> <a href="#toc">top</a></span></h4>
 <ul>
 <li>Reduced the performance overhead of hooked APIs from about 20 microseconds to about 2 microseconds.</li>
@@ -10708,6 +11224,17 @@ <h3 id="credits_libraries"><a class="wlink" href="#credits_libraries"><svg width
 Licensed under the <a href="https://github.com/microsoft/Detours/blob/e5400b4ec59478cb0f435cf3b1338226bcbe28f6/LICENSE.txt">MIT License</a>.</p>
 <p>Match completion display uses column width calculations from GNU coreutils <a href="https://github.com/coreutils/coreutils/blob/master/src/ls.c">ls.c</a>.<br/>
 Licensed under the terms of the <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License, version 3</a>.</p>
+<p>The Dracula color theme (<a href="https://draculatheme.com">https://draculatheme.com</a>).<br/>
+Copyright (c) 2018 Dracula Theme.<br/>
+Licensed under the <a href="https://github.com/dracula/fish/blob/master/LICENSE">MIT License</a>.</p>
+<p>The Solarized color theme (<a href="https://ethanschoonover.com/solarized">https://ethanschoonover.com/solarized</a>).<br/>
+Copyright (c) 2011 Ethan Schoonover.<br/>
+Licensed under the <a href="https://github.com/altercation/solarized/blob/master/LICENSE">MIT License</a>.</p>
+<p>The Tomorrow color theme (<a href="https://github.com/chriskempson/tomorrow-theme">https://github.com/chriskempson/tomorrow-theme</a>).<br/>
+Copyright (C) 2011 <a href="https://github.com/chriskempson">Chris Kempson</a>.<br/>
+Licensed under the <a href="https://github.com/chriskempson/tomorrow-theme/blob/master/LICENSE.md">MIT License</a>.</p>
+<p><a href="https://github.com/chrisant996/clink/tree/master/clink/app/themes">Custom prompts included with Clink</a> are based on some custom prompt themes for the zsh shell.<br/>
+For details about the original prompt implementation for each one, refer to information at the top of each .clinkprompt file.</p>
 <p>Clink documentation embeds the highlight.js library (<a href="https://highlightjs.org">https://highlightjs.org</a>).<br/>
 Highlight.js is released under the <a href="https://github.com/highlightjs/highlight.js/blob/master/LICENSE">BSD License</a>.</p>
 <p>Clink documentation embeds SVG artwork for a link icon from <a href="https://github.com/twbs/icons">Bootstrap</a>.<br/>
