<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>CHANGELOG.rst - fork/fish-shell @ master</title>
<meta name="description" content="CHANGELOG.rst in fork/fish-shell at master.">
<meta property="og:title" content="CHANGELOG.rst - fork/fish-shell @ master">
<meta property="og:description" content="CHANGELOG.rst in fork/fish-shell at master.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="master" data-tip="605c466379a074cf1b5cdb2b62bc8071aab8b47b">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/fish-shell</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/fish-shell</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Johannes Altmanninger</span><span class="commit-message" data-commit="2a28107be769cd79b28793889f440ba19da78c3e">Skip OSC 133 for Konsole only if omit-term-workarounds is not set</span><span class="snapshot-sha sha" data-commit="2a28107be769cd79b28793889f440ba19da78c3e">2a28107be</span><time datetime="2026-07-09T12:29:52+02:00" title="2026-07-09 12:29:52 +0200">2026-07-09</time></p>
<header class="topbar"><details class="switcher"><summary>master</summary><div class="menu"><strong>branches</strong><a class="current" href="/fork/fish-shell/ref/master/">master</a><a class="all" href="/fork/fish-shell/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/fish-shell/">fish-shell</a> / <span class="cur">CHANGELOG.rst</span></nav>
<span class="view-stats"><span>294.1 KiB</span><span>4966 lines</span></span><span class="actions"><a class="raw" href="/fork/fish-shell/raw/359bd6e74f7eff7943536de6dcca085365870b90/CHANGELOG.rst">raw</a></span></header>
<pre class="code src"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text">fish ?.?.? (released ???)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text">=========================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text">- Builtin and function commands can now be colored separately via new variables :envvar:`fish_color_builtin` and :envvar:`fish_color_function` (:issue:`12837`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text">- On non-macOS platforms, :kbd:`alt-backspace`, :kbd:`alt-left` and :kbd:`alt-right` operate on words again instead of tokens (:issue:`12122`) eliminating cross-platform differences in input handling.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text">- Add ``fish_darcs_prompt`` for `Darcs &lt;https://darcs.net/&gt;`_ repository status.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text">- Since prompt marking (via :ref:`osc 133 &lt;term-compat-osc-133&gt;`) causes an issue in Konsole's default configuration, prompt marking had been disabled for Konsole in 4.8.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text">  Now the ``omit-term-workarounds`` :ref:`feature flag &lt;featureflags&gt;` can be enabled to enable prompt marking on Konsole again.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text">Regression fixes:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text">-----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text">- ``abbr --position=anywhere`` completions are no longer offered in argument position, to avoid cluttering the completion pager (:issue:`12838`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text">- ``pacman -Q`` short option completions (:issue:`12857`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text">fish 4.8.0 (released June 24, 2026)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text">===================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text">- Translatable messages defined in Rust source code can and should now be translated using `Fluent &lt;https://projectfluent.org/&gt;`__ instead of GNU gettext.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text">  For now, GNU gettext continues to be used for translating messages defined in fish scripts.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text">  To make Fluent easy to work with, we have added tooling based on the new `fluent-ftl-tools &lt;https://codeberg.org/danielrainer/fluent-ftl-tools&gt;`__ library.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text">  See :ref:`Contributing Translations &lt;localization&gt;` (:issue:`11928`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text">- Builtin :doc:`complete's &lt;cmds/complete&gt;` ``--command`` and ``--path`` options no longer unescape their argument.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text">- History search would sometimes forget about commands after those were re-run in concurrent sessions. This has been fixed (:issue:`10300`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text">- ``fish_hg_prompt``, ``fish_git_prompt`` and ``fish_fossil_prompt`` now strip control characters from VCS state read off disk, matching ``prompt_pwd``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text">- Abbreviations with ``--position=anywhere`` can now be completed in argument position, not just in command position (:issue:`12630`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text">- Path component movement (:kbd:`ctrl-w`) skips escaped characters.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text">- Completion of short option groups will now handle ``--condition`` correctly (:issue:`12821`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text">- Fixed an issue where :kbd:`ctrl-c` might fail to cancel certain functions (:issue:`12802`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text">- On the first run after upgrading from an older version, fish will try harder to check if the current theme matches a historical default.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text">  If it does match, fish won't create ``~/.config/fish/conf.d/fish_frozen_theme.fish`` when upgrading from fish &lt; 4.3.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text">  In particular, on systems where fish version 3.x was installed originally, fish will now avoid creating that file on upgrade (:issue:`12725`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text">- ``cd`` supports the ``-L`` and ``-P`` options, like other shells, to allow specifying whether symbolic links (symlinks) are resolved when changing directories (:issue:`7206`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text">- ``cd`` with a relative path will now retry using the real current directory, if ``$PWD`` has been moved (:issue:`12700`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text">- Nested brace expansions now strip unquoted leading and trailing spaces from entries consistently (:issue:`12794`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text">- :doc:`bind &lt;cmds/bind&gt;` shows the files where bindings were defined (:issue:`12504`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text">Other improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text">------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text">- fish no longer creates the ``__fish_initialized`` universal variable on startup.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text">  If you don't expect to need to downgrade to earlier versions, you can remove it with ``set --erase __fish_initialized``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text">  This means that fish now only creates universal variables if instructed by the user.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text">For distributors and developers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text">- With the exception of the ``$CMAKE_INSTALL_PREFIX/share/fish/man`` directory, fish no longer installs files to ``$CMAKE_INSTALL_PREFIX/share/fish``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text">  In particular, this means that both</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text">  ``$CMAKE_INSTALL_PREFIX/share/fish/completions`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text">  ``$CMAKE_INSTALL_PREFIX/share/fish/functions``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text">  should no longer exist.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text">  These directories have been ignored since fish 4.2.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text">  If another package installs fish scripts there, they should be corrected to install to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text">  ``extra_completionsdir`` (typically ``$CMAKE_INSTALL_PREFIX/share/fish/vendor_completions.d``),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text">  ``extra_functionsdir`` (typically ``$CMAKE_INSTALL_PREFIX/share/fish/vendor_functions.d``) or</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text">  ``extra_confdir`` (typically ``$CMAKE_INSTALL_PREFIX/share/fish/vendor_functions.d``) instead.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text">  See also the output of ``for var in completions functions conf; pkgconf fish --variable=&quot;$var&quot;dir; end``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text">Regression fixes:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text">-----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text">- (from 4.4.0) Vi mode ``c,W`` key binding wrongly deleted trailing spaces (:issue:`12790`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text">- (from 4.4.0) Vi mode ``x`` in :doc:`builtin read &lt;cmds/read&gt;` (:issue:`12724`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text">- (from 4.3.3) Repeated tab would sometimes insert smartcase completions redundantly.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text">- (from 4.3.0) Pressing escape during command execution could insert garbage text into the command line (:issue:`12379`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text">fish 4.7.1 (released May 08, 2026)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text">==================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text">This release fixes a regression in 4.7.0 that caused the web config (``fish_config``) to fail to start (:issue:`12717`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text">fish 4.7.0 (released May 05, 2026)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text">==================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text">- The default theme (i.e. the ``fish_color_*`` variables) is no longer set in non-interactive shells.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text">- :doc:`prompt_pwd &lt;cmds/prompt_pwd&gt;` now strips control characters.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text">- Repaint events (as triggered by changes to color variables or by event handlers running ``commandline -f repaint``) no longer reset the completion pager and other transient UI states (:issue:`12683`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text">- :envvar:`fish_color_valid_path` now respects background and underline colors (:issue:`12622`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text">- :doc:`funced &lt;cmds/funced&gt;` will no longer lose work if there are parse errors multiple times without new changes to the file.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text">- Fixed a case where directory completions were sorted in a surprising order (:issue:`12695`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text">- When at the command token, the :kbd:`alt-o` binding will now open read-only files too (:issue:`12671`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text">- Private mode in-memory history (``set fish_history``) is no longer shared with :doc:`builtin read &lt;cmds/read&gt;` (:issue:`12662`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text">Other improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text">------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text">- History is no longer corrupted with NUL bytes when fish receives SIGTERM or SIGHUP (:issue:`10300`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text">- :doc:`fish_update_completions &lt;cmds/fish_update_completions&gt;` now handles groff ``\X'...'`` device control escapes, fixing completion generation for man pages produced by help2man 1.50 and later (such as coreutils 9.10).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text">- Removing history entries via the :doc:`web-based config &lt;cmds/fish_config&gt;` is more intuitive.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text">- If :envvar:`XDG_DATA_DIRS` is empty, the default value is assumed, which means that fish will now also use configuration from paths like ``$PREFIX/share/fish/vendor_completions.d`` (:issue:`11349`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text">- Some internal file descriptors were moved to number 10 or higher, to reduce risk of clashes with those used by the user in scripts.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text">- The wording of error messages has been made consistent, especially for builtin subcommands (:issue:`12556`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text">For distributors and developers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text">- When the default global config directory (``$PREFIX/etc/fish``) exists but has been overridden via ``-DCMAKE_INSTALL_SYSCONFDIR``, fish will now respect that override (:issue:`10748`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text">- ``build_tools/update_translations.fish`` has been replaced by ``cargo xtask gettext {check,new,update}`` (:issue:`12676`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text">- ``cargo xtask shellcheck`` to lint shell-scripts.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L113" href="#L113">113</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L114" href="#L114">114</a><span class="code-text">Regression fixes:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L115" href="#L115">115</a><span class="code-text">-----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text">- (from 4.6) Vi mode ``dl`` (:issue:`12461`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L117" href="#L117">117</a><span class="code-text">- (from 4.6) Backspace after newline (:issue:`12583`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L118" href="#L118">118</a><span class="code-text">- (from 4.3.3) Long options were spuriously completed after typing short options (85e76ba3561).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L119" href="#L119">119</a><span class="code-text">- (from 3.2) ``nosuchcommand || echo hello`` executes the right hand side again (:issue:`12654`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L120" href="#L120">120</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</a><span class="code-text">fish 4.6.0 (released March 28, 2026)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L122" href="#L122">122</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L123" href="#L123">123</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L124" href="#L124">124</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L125" href="#L125">125</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L126" href="#L126">126</a><span class="code-text">- New Spanish translations (:issue:`12489`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L127" href="#L127">127</a><span class="code-text">- New Japanese translations (:issue:`12499`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L128" href="#L128">128</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L129" href="#L129">129</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L131" href="#L131">131</a><span class="code-text">- The default width for emoji is switched from 1 to 2, improving the experience for users connecting to old systems from modern desktops. Users of old desktops who notice that lines containing emoji are misaligned can set ``$fish_emoji_width`` back to 1 (:issue:`12562`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L132" href="#L132">132</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L133" href="#L133">133</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L134" href="#L134">134</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L135" href="#L135">135</a><span class="code-text">- The tab completion pager now left-justifies the description of each column (:issue:`12546`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L136" href="#L136">136</a><span class="code-text">- fish now supports the ``SHELL_PROMPT_PREFIX``, ``SHELL_PROMPT_SUFFIX``, and ``SHELL_WELCOME`` environment variables. The prefix and suffix are automatically prepended and appended to the left prompt, and the welcome message is displayed on startup after the greeting.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L137" href="#L137">137</a><span class="code-text">  These variables are set by systemd's ``run0`` for example (:issue:`10924`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L138" href="#L138">138</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L139" href="#L139">139</a><span class="code-text">Improved terminal support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L140" href="#L140">140</a><span class="code-text">-------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L141" href="#L141">141</a><span class="code-text">- ``set_color`` is able to turn off italics, reverse mode, strikethrough and underline individually (e.g. ``--italics=off``).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L142" href="#L142">142</a><span class="code-text">- ``set_color`` learned the foreground (``--foreground`` or ``-f``) and reset (``--reset``) options.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L143" href="#L143">143</a><span class="code-text">- An error caused by slow terminal responses at macOS startup has been addressed (:issue:`12571`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L144" href="#L144">144</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L145" href="#L145">145</a><span class="code-text">Other improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L146" href="#L146">146</a><span class="code-text">------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L147" href="#L147">147</a><span class="code-text">- Signals like ``SIGWINCH`` (as sent on terminal resize) no longer interrupt builtin output (:issue:`12496`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L148" href="#L148">148</a><span class="code-text">- For compatibility with Bash, fish now accepts ``|&amp;`` as alternate spelling of ``&amp;|``, for piping both standard output and standard error (:issue:`11516`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L149" href="#L149">149</a><span class="code-text">- ``fish_indent`` now preserves comments and newlines immediately preceding a brace block (``{ }``) (:issue:`12505`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L150" href="#L150">150</a><span class="code-text">- A crash when suspending certain pipelines with :kbd:`ctrl-z` has been fixed (:issue:`12301`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L151" href="#L151">151</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L152" href="#L152">152</a><span class="code-text">For distributors and developers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L153" href="#L153">153</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L154" href="#L154">154</a><span class="code-text">- ``cargo xtask`` subcommands no longer panic on test failures.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L155" href="#L155">155</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L156" href="#L156">156</a><span class="code-text">Regression fixes:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L157" href="#L157">157</a><span class="code-text">-----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L158" href="#L158">158</a><span class="code-text">- (from 4.5.0) Intermediate ``⏎`` artifact when redrawing prompt (:issue:`12476`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L159" href="#L159">159</a><span class="code-text">- (from 4.4.0) ``history`` honors explicitly specified ``--color=`` again (:issue:`12512`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L160" href="#L160">160</a><span class="code-text">- (from 4.4.0) Vi mode ``dl`` and ``dh`` (:issue:`12461`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L161" href="#L161">161</a><span class="code-text">- (from 4.3.0) Error completing of commands starting with ``-`` (:issue:`12522`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L162" href="#L162">162</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L163" href="#L163">163</a><span class="code-text">fish 4.5.0 (released February 17, 2026)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L164" href="#L164">164</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L165" href="#L165">165</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L166" href="#L166">166</a><span class="code-text">This is mostly a patch release for Vi mode regressions in 4.4.0 but other minor behavior changes are included as well.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L167" href="#L167">167</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L168" href="#L168">168</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L169" href="#L169">169</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L170" href="#L170">170</a><span class="code-text">- :kbd:`ctrl-l` no longer cancels history search (:issue:`12436`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L171" href="#L171">171</a><span class="code-text">- History search cursor positioning now works correctly with characters of arbitrary width.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L172" href="#L172">172</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L173" href="#L173">173</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L174" href="#L174">174</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L175" href="#L175">175</a><span class="code-text">- fish no longer reads the terminfo database to alter behaviour based on the :envvar:`TERM` environment variable, and does not depend on ncurses or terminfo. The ``ignore-terminfo`` feature flag, introduced and enabled by default in fish 4.1, is now permanently enabled. fish may no longer work correctly on Data General Dasher D220 and Wyse WY-350 terminals, but should continue to work on all known terminal emulators released in the 21st century.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L176" href="#L176">176</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L177" href="#L177">177</a><span class="code-text">Regression fixes:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L178" href="#L178">178</a><span class="code-text">-----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L179" href="#L179">179</a><span class="code-text">- (from 4.4.0) Vi mode ``d,f`` key binding did not work (:issue:`12417`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L180" href="#L180">180</a><span class="code-text">- (from 4.4.0) Vi mode ``c,w`` key binding wrongly deleted trailing spaces (:issue:`12443`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L181" href="#L181">181</a><span class="code-text">- (from 4.4.0) Vi mode crash on ``c,i,w`` after accepting autosuggestion (:issue:`12430`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L182" href="#L182">182</a><span class="code-text">- (from 4.4.0) ``fish_vi_key_bindings`` called with a mode argument produced an error (:issue:`12413`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L183" href="#L183">183</a><span class="code-text">- (from 4.0.0) Build on Illumos (:issue:`12410`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L184" href="#L184">184</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L185" href="#L185">185</a><span class="code-text">fish 4.4.0 (released February 03, 2026)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L186" href="#L186">186</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L187" href="#L187">187</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L188" href="#L188">188</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L189" href="#L189">189</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L190" href="#L190">190</a><span class="code-text">- The default fossil prompt has been disabled (:issue:`12342`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L191" href="#L191">191</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L192" href="#L192">192</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L193" href="#L193">193</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L194" href="#L194">194</a><span class="code-text">- The ``bind`` builtin lists mappings from all modes if ``--mode`` is not provided (:issue:`12214`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L195" href="#L195">195</a><span class="code-text">- Line-wise autosuggestions that don't start a command are no longer shown (739b82c34db, 58e7a50de8a).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L196" href="#L196">196</a><span class="code-text">- Builtin ``history`` now assumes that :envvar:`PAGER` supports ANSI color sequences.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L197" href="#L197">197</a><span class="code-text">- fish now clears the terminal's ``FLUSHO`` flag when acquiring control of the terminal, to fix an issue caused by pressing :kbd:`ctrl-o` on macOS (:issue:`12304`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L198" href="#L198">198</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L199" href="#L199">199</a><span class="code-text">New or improved bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L200" href="#L200">200</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L201" href="#L201">201</a><span class="code-text">- Vi mode word movements (``w``, ``W``, ``e``, and ``E``) are now largely in line with Vim. The only exception is that underscores are treated as word separators (:issue:`12269`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L202" href="#L202">202</a><span class="code-text">- New special input functions to support these movements: ``forward-word-vi``, ``kill-word-vi``, ``forward-bigword-vi``, ``kill-bigword-vi``, ``forward-word-end``, ``backward-word-end``, ``forward-bigword-end``, ``backward-bigword-end``, ``kill-a-word``, ``kill-inner-word``, ``kill-a-bigword``, and ``kill-inner-bigword``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L203" href="#L203">203</a><span class="code-text">- Vi mode key bindings now support counts for movement and deletion commands (e.g. `d3w` or `3l`), via a new operator mode (:issue:`2192`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L204" href="#L204">204</a><span class="code-text">- New ``catppuccin-*`` color themes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L205" href="#L205">205</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L206" href="#L206">206</a><span class="code-text">Improved terminal support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L207" href="#L207">207</a><span class="code-text">-------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L208" href="#L208">208</a><span class="code-text">- ``set_color`` learned the strikethrough (``--strikethrough`` or ``-s``) modifier.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L209" href="#L209">209</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L210" href="#L210">210</a><span class="code-text">For distributors and developers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L211" href="#L211">211</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L212" href="#L212">212</a><span class="code-text">- The CMake option ``WITH_GETTEXT`` has been renamed to ``WITH_MESSAGE_LOCALIZATION``, to reflect that it toggles localization independently of the backend used in the implementation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L213" href="#L213">213</a><span class="code-text">- New ``cargo xtask`` commands can replace some CMake workflows.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L214" href="#L214">214</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L215" href="#L215">215</a><span class="code-text">Regression fixes:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L216" href="#L216">216</a><span class="code-text">-----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L217" href="#L217">217</a><span class="code-text">- (from 4.1.0) Crash when autosuggesting Unicode characters with nontrivial lowercase mapping (:issue:`12326`, 78f4541116e).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L218" href="#L218">218</a><span class="code-text">- (from 4.3.0) Glitch on ``read --prompt-str &quot;&quot;`` (:issue:`12296`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L219" href="#L219">219</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L220" href="#L220">220</a><span class="code-text">fish 4.3.3 (released January 07, 2026)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L221" href="#L221">221</a><span class="code-text">======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L222" href="#L222">222</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L223" href="#L223">223</a><span class="code-text">This release fixes the following problems identified in fish 4.3.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L224" href="#L224">224</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L225" href="#L225">225</a><span class="code-text">- Selecting a completion could insert only part of the token (:issue:`12249`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L226" href="#L226">226</a><span class="code-text">- Glitch with soft-wrapped autosuggestions and :doc:`fish_right_prompt &lt;cmds/fish_right_prompt&gt;` (:issue:`12255`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L227" href="#L227">227</a><span class="code-text">- Spurious echo in tmux when typing a command really fast (:issue:`12261`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L228" href="#L228">228</a><span class="code-text">- ``tomorrow`` theme always using the light variant (:issue:`12266`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L229" href="#L229">229</a><span class="code-text">- ``fish_config theme choose`` sometimes not shadowing themes set by e.g. webconfig (:issue:`12278`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L230" href="#L230">230</a><span class="code-text">- The sample prompts and themes are correctly installed (:issue:`12241`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L231" href="#L231">231</a><span class="code-text">- Last line of command output could be hidden when missing newline (:issue:`12246`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L232" href="#L232">232</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L233" href="#L233">233</a><span class="code-text">Other improvements include:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L234" href="#L234">234</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L235" href="#L235">235</a><span class="code-text">- The ``abbr``, ``bind``, ``complete``, ``functions``, ``history`` and ``type`` commands now support a ``--color`` option to control syntax highlighting in their output. Valid values are ``auto`` (default), ``always``, or ``never``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L236" href="#L236">236</a><span class="code-text">- Existing file paths in redirection targets such as ``&gt; file.txt`` are now highlighted using :envvar:`fish_color_valid_path`, indicating that ``file.txt`` will be clobbered (:issue:`12260`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L237" href="#L237">237</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L238" href="#L238">238</a><span class="code-text">fish 4.3.2 (released December 30, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L239" href="#L239">239</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L240" href="#L240">240</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L241" href="#L241">241</a><span class="code-text">This release fixes the following problems identified in 4.3.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L242" href="#L242">242</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L243" href="#L243">243</a><span class="code-text">- Pre-built macOS packages failed to start due to a ``Malformed Mach-O file`` error (:issue:`12224`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L244" href="#L244">244</a><span class="code-text">- ``extra_functionsdir`` (usually ``vendor_functions.d``) and friends were not used (:issue:`12226`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L245" href="#L245">245</a><span class="code-text">- Sample config file ``~/.config/fish/config.fish/`` and config directories ``~/.config/fish/conf.d/``, ``~/.config/fish/completions/`` and ``~/.config/fish/functions/`` were recreated on every startup instead of only the first time fish runs on a system (:issue:`12230`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L246" href="#L246">246</a><span class="code-text">- Spurious echo of ``^[[I`` in some scenarios (:issue:`12232`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L247" href="#L247">247</a><span class="code-text">- Infinite prompt redraw loop on some prompts (:issue:`12233`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L248" href="#L248">248</a><span class="code-text">- The removal of pre-built HTML docs from tarballs revealed that cross compilation is broken because we use ``${CMAKE_BINARY_DIR}/fish_indent`` for building HTML docs.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L249" href="#L249">249</a><span class="code-text">  As a workaround, the new CMake build option ``FISH_INDENT_FOR_BUILDING_DOCS`` can be set to the path of a runnable ``fish_indent`` binary.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L250" href="#L250">250</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L251" href="#L251">251</a><span class="code-text">fish 4.3.1 (released December 28, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L252" href="#L252">252</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L253" href="#L253">253</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L254" href="#L254">254</a><span class="code-text">This release fixes the following problem identified in 4.3.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L255" href="#L255">255</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L256" href="#L256">256</a><span class="code-text">- Possible crash after expanding an abbreviation (:issue:`12223`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L257" href="#L257">257</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L258" href="#L258">258</a><span class="code-text">fish 4.3.0 (released December 28, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L259" href="#L259">259</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L260" href="#L260">260</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L261" href="#L261">261</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L262" href="#L262">262</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L263" href="#L263">263</a><span class="code-text">- fish no longer sets user-facing :ref:`universal variables &lt;variables-universal&gt;` by default, making the configuration easier to understand.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L264" href="#L264">264</a><span class="code-text">  Specifically, the ``fish_color_*``, ``fish_pager_color_*`` and ``fish_key_bindings`` variables are now set in the global scope by default.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L265" href="#L265">265</a><span class="code-text">  After upgrading to 4.3.0, fish will (once and never again) migrate these universals to globals set at startup in the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L266" href="#L266">266</a><span class="code-text">  ``~/.config/fish/conf.d/fish_frozen_theme.fish`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L267" href="#L267">267</a><span class="code-text">  ``~/.config/fish/conf.d/fish_frozen_key_bindings.fish`` files.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L268" href="#L268">268</a><span class="code-text">  We suggest that you delete those files and :ref:`set your theme &lt;syntax-highlighting&gt;` in ``~/.config/fish/config.fish``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L269" href="#L269">269</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L270" href="#L270">270</a><span class="code-text">  - You can still configure fish to propagate theme changes instantly; see :ref:`here &lt;syntax-highlighting-instant-update&gt;` for an example.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L271" href="#L271">271</a><span class="code-text">  - You can still opt into storing color variables in the universal scope</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L272" href="#L272">272</a><span class="code-text">    via ``fish_config theme save`` though unlike ``fish_config theme choose``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L273" href="#L273">273</a><span class="code-text">    it does not support dynamic theme switching based on the terminal's color theme (see below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L274" href="#L274">274</a><span class="code-text">- In addition to setting the variables which are explicitly defined in the given theme,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L275" href="#L275">275</a><span class="code-text">  ``fish_config theme choose`` now clears only color variables that were set by earlier invocations of a ``fish_config theme choose`` command</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L276" href="#L276">276</a><span class="code-text">  (which is how fish's default theme is set).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L277" href="#L277">277</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L278" href="#L278">278</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L279" href="#L279">279</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L280" href="#L280">280</a><span class="code-text">- New :ref:`status language &lt;status-language&gt;` command allows showing and modifying language settings for fish messages without having to modify environment variables.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L281" href="#L281">281</a><span class="code-text">- When using a noninteractive fish instance to compute completions, ``commandline --cursor`` works as expected instead of throwing an error (:issue:`11993`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L282" href="#L282">282</a><span class="code-text">- :envvar:`fish_trace` can now be set to ``all`` to also trace execution of key bindings, event handlers as well as prompt and title functions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L283" href="#L283">283</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L284" href="#L284">284</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L285" href="#L285">285</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L286" href="#L286">286</a><span class="code-text">- When typing immediately after starting fish, the first prompt is now rendered correctly.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L287" href="#L287">287</a><span class="code-text">- Completion accuracy was improved for file paths containing ``=`` or ``:`` (:issue:`5363`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L288" href="#L288">288</a><span class="code-text">- Prefix-matching completions are now shown even if they don't match the case typed by the user (:issue:`7944`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L289" href="#L289">289</a><span class="code-text">- On Cygwin/MSYS, command name completion will favor the non-exe name (``foo``) unless the user started typing the extension.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L290" href="#L290">290</a><span class="code-text">- When using the exe name (``foo.exe``), fish will use the description and completions for ``foo`` if there are none for ``foo.exe``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L291" href="#L291">291</a><span class="code-text">- Autosuggestions now also show soft-wrapped portions (:issue:`12045`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L292" href="#L292">292</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L293" href="#L293">293</a><span class="code-text">New or improved bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L294" href="#L294">294</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L295" href="#L295">295</a><span class="code-text">- :kbd:`ctrl-w` (``backward-kill-path-component``) also deletes escaped spaces (:issue:`2016`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L296" href="#L296">296</a><span class="code-text">- New special input functions ``backward-path-component``, ``forward-path-component`` and ``kill-path-component`` (:issue:`12127`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L297" href="#L297">297</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L298" href="#L298">298</a><span class="code-text">Improved terminal support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L299" href="#L299">299</a><span class="code-text">-------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L300" href="#L300">300</a><span class="code-text">- Themes can now be made color-theme-aware by including both ``[light]`` and ``[dark]`` sections in the :ref:`theme file &lt;fish-config-theme-files&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L301" href="#L301">301</a><span class="code-text">  Some default themes have been made color-theme-aware, meaning they dynamically adjust as your terminal's background color switches between light and dark colors (:issue:`11580`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L302" href="#L302">302</a><span class="code-text">- The working directory is now reported on every fresh prompt (via OSC 7), fixing scenarios where a child process (like ``ssh``) left behind a stale working directory (:issue:`12191`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L303" href="#L303">303</a><span class="code-text">- OSC 133 prompt markers now also mark the prompt end, which improves shell integration with terminals like iTerm2 (:issue:`11837`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L304" href="#L304">304</a><span class="code-text">- Operating-system-specific key bindings are now decided based on the :ref:`terminal's host OS &lt;status-terminal-os&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L305" href="#L305">305</a><span class="code-text">- New :ref:`feature flag &lt;featureflags&gt;` ``omit-term-workarounds`` can be turned on to prevent fish from trying to work around some incompatible terminals.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L306" href="#L306">306</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L307" href="#L307">307</a><span class="code-text">For distributors and developers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L308" href="#L308">308</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L309" href="#L309">309</a><span class="code-text">- Tarballs no longer contain prebuilt documentation,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L310" href="#L310">310</a><span class="code-text">  so building and installing documentation requires Sphinx.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L311" href="#L311">311</a><span class="code-text">  To avoid users accidentally losing docs, the ``BUILD_DOCS`` and ``INSTALL_DOCS`` configuration options have been replaced with a new ``WITH_DOCS`` option.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L312" href="#L312">312</a><span class="code-text">- ``fish_key_reader`` and ``fish_indent`` are now installed as hardlinks to ``fish``, to save some space.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L313" href="#L313">313</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L314" href="#L314">314</a><span class="code-text">Regression fixes:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L315" href="#L315">315</a><span class="code-text">-----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L316" href="#L316">316</a><span class="code-text">- (from 4.1.0) Crash on incorrectly-set color variables (:issue:`12078`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L317" href="#L317">317</a><span class="code-text">- (from 4.1.0) Crash when autosuggesting Unicode characters with nontrivial lowercase mapping.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L318" href="#L318">318</a><span class="code-text">- (from 4.2.0) Incorrect emoji width computation on macOS.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L319" href="#L319">319</a><span class="code-text">- (from 4.2.0) Mouse clicks and :kbd:`ctrl-l` edge cases in multiline command lines (:issue:`12121`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L320" href="#L320">320</a><span class="code-text">- (from 4.2.0) Completions for Git remote names on some non-glibc systems.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L321" href="#L321">321</a><span class="code-text">- (from 4.2.0) Expansion of ``~$USER``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L322" href="#L322">322</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L323" href="#L323">323</a><span class="code-text">fish 4.2.1 (released November 13, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L324" href="#L324">324</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L325" href="#L325">325</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L326" href="#L326">326</a><span class="code-text">This release fixes the following problems identified in 4.2.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L327" href="#L327">327</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L328" href="#L328">328</a><span class="code-text">- When building from a tarball without Sphinx (that is, with ``-DBUILD_DOCS=OFF`` or when ``sphinx-build`` is not found),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L329" href="#L329">329</a><span class="code-text">  builtin man pages and help files were missing, which has been fixed (:issue:`12052`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L330" href="#L330">330</a><span class="code-text">- ``fish_config``'s theme selector (the &quot;colors&quot; tab) was broken, which has been fixed (:issue:`12053`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L331" href="#L331">331</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L332" href="#L332">332</a><span class="code-text">fish 4.2.0 (released November 10, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L333" href="#L333">333</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L334" href="#L334">334</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L335" href="#L335">335</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L336" href="#L336">336</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L337" href="#L337">337</a><span class="code-text">- History-based autosuggestions now include multi-line commands.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L338" href="#L338">338</a><span class="code-text">- A :ref:`transient prompt &lt;transient-prompt&gt;` containing more lines than the final prompt will now be cleared properly (:issue:`11875`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L339" href="#L339">339</a><span class="code-text">- Taiwanese Chinese translations have been added.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L340" href="#L340">340</a><span class="code-text">- French translations have been supplemented (:issue:`11842`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L341" href="#L341">341</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L342" href="#L342">342</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L343" href="#L343">343</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L344" href="#L344">344</a><span class="code-text">- fish now assumes UTF-8 for character encoding even if the system does not have a UTF-8 locale.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L345" href="#L345">345</a><span class="code-text">  Input bytes which are not valid UTF-8 are still round-tripped correctly.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L346" href="#L346">346</a><span class="code-text">  For example, file paths using legacy encodings can still be used,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L347" href="#L347">347</a><span class="code-text">  but may be rendered differently on the command line.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L348" href="#L348">348</a><span class="code-text">- On systems where no multi-byte locale is available,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L349" href="#L349">349</a><span class="code-text">  fish will no longer fall back to using ASCII replacements for :ref:`Unicode characters &lt;term-compat-unicode-codepoints&gt;` such as &quot;…&quot;.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L350" href="#L350">350</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L351" href="#L351">351</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L352" href="#L352">352</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L353" href="#L353">353</a><span class="code-text">- The title of the terminal tab can now be set separately from the window title by defining the :doc:`fish_tab_title &lt;cmds/fish_tab_title&gt;` function (:issue:`2692`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L354" href="#L354">354</a><span class="code-text">- fish now hides the portion of a multiline prompt that is scrolled out of view due to a huge command line. This prevents duplicate lines after repainting with partially visible prompt (:issue:`11911`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L355" href="#L355">355</a><span class="code-text">- :doc:`fish_config prompt &lt;cmds/fish_config&gt;`'s ``choose`` and ``save`` subcommands have been taught to reset :doc:`fish_mode_prompt &lt;cmds/fish_mode_prompt&gt;` in addition to the other prompt functions (:issue:`11937`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L356" href="#L356">356</a><span class="code-text">- fish no longer force-disables mouse capture (DECSET/DECRST 1000),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L357" href="#L357">357</a><span class="code-text">  so you can use those commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L358" href="#L358">358</a><span class="code-text">  to let mouse clicks move the cursor or select completions items (:issue:`4918`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L359" href="#L359">359</a><span class="code-text">- The :kbd:`alt-p` binding no longer adds a redundant space to the command line.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L360" href="#L360">360</a><span class="code-text">- When run as a login shell on macOS, fish now sets :envvar:`MANPATH` correctly when that variable was already present in the environment (:issue:`10684`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L361" href="#L361">361</a><span class="code-text">- A Windows-specific case of the :doc:`web-based config &lt;cmds/fish_config&gt;` failing to launch has been fixed (:issue:`11805`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L362" href="#L362">362</a><span class="code-text">- A MSYS2-specific workaround for Konsole and WezTerm has been added,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L363" href="#L363">363</a><span class="code-text">  to prevent them from using the wrong working directory when opening new tabs (:issue:`11981`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L364" href="#L364">364</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L365" href="#L365">365</a><span class="code-text">For distributors and developers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L366" href="#L366">366</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L367" href="#L367">367</a><span class="code-text">- Release tags and source code tarballs are GPG-signed again (:issue:`11996`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L368" href="#L368">368</a><span class="code-text">- Documentation in release tarballs is now built with the latest version of Sphinx,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L369" href="#L369">369</a><span class="code-text">  which means that pre-built man pages include :ref:`OSC 8 hyperlinks &lt;term-compat-osc-8&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L370" href="#L370">370</a><span class="code-text">- The Sphinx dependency is now specified in ``pyproject.toml``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L371" href="#L371">371</a><span class="code-text">  which allows you to use `uv &lt;https://github.com/astral-sh/uv&gt;`__ to provide Sphinx for building documentation (e.g. ``uv run cargo install --path .``).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L372" href="#L372">372</a><span class="code-text">- The minimum supported Rust version (MSRV) has been updated to 1.85.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L373" href="#L373">373</a><span class="code-text">- The standalone build mode has been made the default.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L374" href="#L374">374</a><span class="code-text">  This means that the files in ``$CMAKE_INSTALL_PREFIX/share/fish`` will not be used anymore, except for HTML docs.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L375" href="#L375">375</a><span class="code-text">  As a result, future upgrades will no longer break running shells</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L376" href="#L376">376</a><span class="code-text">  if one of fish's internal helper functions has been changed in the updated version.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L377" href="#L377">377</a><span class="code-text">  For now, the data files are still installed redundantly,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L378" href="#L378">378</a><span class="code-text">  to prevent upgrades from breaking already-running shells (:issue:`11921`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L379" href="#L379">379</a><span class="code-text">  To reverse this change (which should not be necessary),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L380" href="#L380">380</a><span class="code-text">  patch out the ``embed-data`` feature from ``cmake/Rust.cmake``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L381" href="#L381">381</a><span class="code-text">  This option will be removed in future.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L382" href="#L382">382</a><span class="code-text">- OpenBSD 7.8 revealed an issue with fish's approach for displaying builtin man pages, which has been fixed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L383" href="#L383">383</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L384" href="#L384">384</a><span class="code-text">Regression fixes:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L385" href="#L385">385</a><span class="code-text">-----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L386" href="#L386">386</a><span class="code-text">- (from 4.1.0) Fix the :doc:`web-based config &lt;cmds/fish_config&gt;` for Python 3.9 and older (:issue:`12039`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L387" href="#L387">387</a><span class="code-text">- (from 4.1.0) Correct wrong terminal modes set by ``fish -c 'read; cat`` (:issue:`12024`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L388" href="#L388">388</a><span class="code-text">- (from 4.1.0) On VTE-based terminals, stop redrawing the prompt on resize again, to avoid glitches.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L389" href="#L389">389</a><span class="code-text">- (from 4.1.0) On MSYS2, fix saving/loading of universal variables (:issue:`11948`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L390" href="#L390">390</a><span class="code-text">- (from 4.1.0) Fix error using ``man`` for the commands ``!`` ``.`` ``:`` ``[`` ``{`` (:issue:`11955`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L391" href="#L391">391</a><span class="code-text">- (from 4.1.0) Fix build issues on illumos systems (:issue:`11982`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L392" href="#L392">392</a><span class="code-text">- (from 4.1.0) Fix crash on invalid :doc:`function &lt;cmds/function&gt;` command (:issue:`11912`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L393" href="#L393">393</a><span class="code-text">- (from 4.0.0) Fix build on SPARC and MIPS Linux by disabling ``SIGSTKFLT``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L394" href="#L394">394</a><span class="code-text">- (from 4.0.0) Fix crash when passing negative PIDs to builtin :doc:`wait &lt;cmds/wait&gt;` (:issue:`11929`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L395" href="#L395">395</a><span class="code-text">- (from 4.0.0) On Linux, fix :doc:`status fish-path &lt;cmds/status&gt;` output when fish has been reinstalled since it was started.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L396" href="#L396">396</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L397" href="#L397">397</a><span class="code-text">fish 4.1.2 (released October 7, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L398" href="#L398">398</a><span class="code-text">=====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L399" href="#L399">399</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L400" href="#L400">400</a><span class="code-text">This release fixes the following regressions identified in 4.1.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L401" href="#L401">401</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L402" href="#L402">402</a><span class="code-text">- Fixed spurious error output when completing remote file paths for ``scp`` (:issue:`11860`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L403" href="#L403">403</a><span class="code-text">- Fixed the :kbd:`alt-l` binding not formatting ``ls`` output correctly (one entry per line, no colors) (:issue:`11888`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L404" href="#L404">404</a><span class="code-text">- Fixed an issue where focus events (currently only enabled in ``tmux``) would cause multiline prompts to be redrawn in the wrong line (:issue:`11870`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L405" href="#L405">405</a><span class="code-text">- Stopped printing output that would cause a glitch on old versions of Midnight Commander (:issue:`11869`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L406" href="#L406">406</a><span class="code-text">- Added a fix for some configurations of Zellij where :kbd:`escape` key processing was delayed (:issue:`11868`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L407" href="#L407">407</a><span class="code-text">- Fixed a case where the :doc:`web-based configuration tool &lt;cmds/fish_config&gt;` would generate invalid configuration (:issue:`11861`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L408" href="#L408">408</a><span class="code-text">- Fixed a case where pasting into ``fish -c read`` would fail with a noisy error (:issue:`11836`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L409" href="#L409">409</a><span class="code-text">- Fixed a case where upgrading fish would break old versions of fish that were still running.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L410" href="#L410">410</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L411" href="#L411">411</a><span class="code-text">  In general, fish still needs to be restarted after it is upgraded,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L412" href="#L412">412</a><span class="code-text">  except for `standalone builds &lt;https://github.com/fish-shell/fish-shell/?tab=readme-ov-file#building-fish-with-embedded-data-experimental&gt;`__.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L413" href="#L413">413</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L414" href="#L414">414</a><span class="code-text">fish 4.1.1 (released September 30, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L415" href="#L415">415</a><span class="code-text">========================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L416" href="#L416">416</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L417" href="#L417">417</a><span class="code-text">This release fixes the following regressions identified in 4.1.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L418" href="#L418">418</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L419" href="#L419">419</a><span class="code-text">- Many of our new Chinese translations were more confusing than helpful; they have been fixed or removed (:issue:`11833`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L420" href="#L420">420</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L421" href="#L421">421</a><span class="code-text">  Note that you can work around this type of issue by configuring fish's :doc:`message localization &lt;cmds/_&gt;`:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L422" href="#L422">422</a><span class="code-text">  if your environment contains something like ``LANG=zh_CN.UTF-8``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L423" href="#L423">423</a><span class="code-text">  you can use ``set -g LC_MESSAGES en`` to use English messages inside fish.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L424" href="#L424">424</a><span class="code-text">  This will not affect fish's child processes unless ``LC_MESSAGES`` was already exported.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L425" href="#L425">425</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L426" href="#L426">426</a><span class="code-text">- Some :doc:`fish_config &lt;cmds/fish_config&gt;` subcommands for showing prompts and themes had been broken in standalone Linux builds (those using the ``embed-data`` cargo feature), which has been fixed (:issue:`11832`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L427" href="#L427">427</a><span class="code-text">- On Windows Terminal, we observed an issue where fish would fail to read the terminal's response to our new startup queries, causing noticeable lags and a misleading error message. A workaround has been added (:issue:`11841`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L428" href="#L428">428</a><span class="code-text">- A WezTerm `issue breaking shifted key input &lt;https://github.com/wezterm/wezterm/issues/6087&gt;`__ has resurfaced on some versions of WezTerm; our workaround has been extended to cover all versions for now (:issue:`11204`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L429" href="#L429">429</a><span class="code-text">- Fixed a crash in :doc:`the web-based configuration tool &lt;cmds/fish_config&gt;` when using the new underline styles (:issue:`11840`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L430" href="#L430">430</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L431" href="#L431">431</a><span class="code-text">fish 4.1.0 (released September 27, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L432" href="#L432">432</a><span class="code-text">========================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L433" href="#L433">433</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L434" href="#L434">434</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L435" href="#L435">435</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L436" href="#L436">436</a><span class="code-text">- Compound commands (``begin; echo 1; echo 2; end``) can now be written using braces (``{ echo1; echo 2 }``), like in other shells.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L437" href="#L437">437</a><span class="code-text">- fish now supports transient prompts: if :envvar:`fish_transient_prompt` is set to 1, fish will reexecute prompt functions with the ``--final-rendering`` argument before running a commandline (:issue:`11153`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L438" href="#L438">438</a><span class="code-text">- Tab completion results are truncated up to the common directory path, instead of somewhere inside that path. E.g. if you complete &quot;share/functions&quot;, and it includes the files &quot;foo.fish&quot; and &quot;bar.fish&quot;,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L439" href="#L439">439</a><span class="code-text">  the completion pager will now show &quot;…/foo.fish&quot; and &quot;…/bar.fish&quot; (:issue:`11250`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L440" href="#L440">440</a><span class="code-text">- Self-installing builds as created by e.g. ``cargo install`` no longer install other files, see :ref:`below &lt;changelog-4.1-embedded&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L441" href="#L441">441</a><span class="code-text">- Our gettext-based message-localization has been reworked,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L442" href="#L442">442</a><span class="code-text">  adding translations to self-installing builds; see :ref:`below &lt;changelog-4.1-gettext&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L443" href="#L443">443</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L444" href="#L444">444</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L445" href="#L445">445</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L446" href="#L446">446</a><span class="code-text">- ``set_color --background=COLOR`` no longer implicitly activates bold mode.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L447" href="#L447">447</a><span class="code-text">  If your theme is stored in universal variables (the historical default), some bold formatting might be lost.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L448" href="#L448">448</a><span class="code-text">  To fix this, we suggest updating to the latest version of our theme, to explicitly activate bold mode,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L449" href="#L449">449</a><span class="code-text">  for example use ``fish_config theme save &quot;fish default&quot;``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L450" href="#L450">450</a><span class="code-text">- ``{echo,echo}`` or ``{ echo, echo }`` are no longer interpreted as brace expansion tokens but as :doc:`compound commands &lt;cmds/begin&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L451" href="#L451">451</a><span class="code-text">- Terminfo-style key names (``bind -k nul``) are no longer supported. They had been superseded by fish's :doc:`own key names &lt;cmds/bind&gt;` since 4.0 (:issue:`11342`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L452" href="#L452">452</a><span class="code-text">- fish no longer reads the terminfo database, so its behavior is generally no longer affected by the :envvar:`TERM` environment variable (:issue:`11344`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L453" href="#L453">453</a><span class="code-text">  For the time being, this change can be reversed via the ``ignore-terminfo`` :ref:`feature flag &lt;featureflags&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L454" href="#L454">454</a><span class="code-text">  To do so, run the following once and restart fish::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L455" href="#L455">455</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L456" href="#L456">456</a><span class="code-text">    set -Ua fish_features no-ignore-terminfo</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L457" href="#L457">457</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L458" href="#L458">458</a><span class="code-text">- The ``--install`` option when fish is built as self-installing is removed, see :ref:`below &lt;changelog-4.1-embedded&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L459" href="#L459">459</a><span class="code-text">- ``set_color ff0000`` now outputs 24-bit RGB true-color even if :envvar:`COLORTERM` is unset.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L460" href="#L460">460</a><span class="code-text">  One can override this by setting :envvar:`fish_term24bit` to 0 (:issue:`11372`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L461" href="#L461">461</a><span class="code-text">- fish now requires the terminal to respond to queries for the :ref:`Primary Device Attribute &lt;term-compat-primary-da&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L462" href="#L462">462</a><span class="code-text">  For now, this can be reversed via a :ref:`feature flag &lt;featureflags&gt;`,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L463" href="#L463">463</a><span class="code-text">  by running (once) ``set -Ua fish_features no-query-term`` and restarting fish.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L464" href="#L464">464</a><span class="code-text">- Users of GNU screen may experience :ref:`minor glitches &lt;term-compat-dcs-gnu-screen&gt;` when starting fish.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L465" href="#L465">465</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L466" href="#L466">466</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L467" href="#L467">467</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L468" href="#L468">468</a><span class="code-text">- The :doc:`argparse &lt;cmds/argparse&gt;` builtin has seen many improvements, see :ref:`below &lt;changelog-4.1-argparse&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L469" href="#L469">469</a><span class="code-text">- The :doc:`string pad &lt;cmds/string-pad&gt;` command now has a ``-C/--center`` option.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L470" href="#L470">470</a><span class="code-text">- The :doc:`psub &lt;cmds/psub&gt;` command now allows combining ``--suffix`` with ``--fifo`` (:issue:`11729`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L471" href="#L471">471</a><span class="code-text">- The :doc:`read &lt;cmds/read&gt;` builtin has learned the ``--tokenize-raw`` option to tokenize without quote removal (:issue:`11084`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L472" href="#L472">472</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L473" href="#L473">473</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L474" href="#L474">474</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L475" href="#L475">475</a><span class="code-text">- Autosuggestions are now also provided in multi-line command lines. Like :kbd:`ctrl-r`, these operate only on the current line.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L476" href="#L476">476</a><span class="code-text">- Autosuggestions used to not suggest multi-line command-lines from history; now autosuggestions include individual lines from multi-line command-lines.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L477" href="#L477">477</a><span class="code-text">- The history pager search now preserves ordering between :kbd:`ctrl-s` forward and :kbd:`ctrl-r` backward searches.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L478" href="#L478">478</a><span class="code-text">- Instead of highlighting events by flashing *all text to the left of the cursor*,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L479" href="#L479">479</a><span class="code-text">  failing history token search (:kbd:`alt-.`) flashes the associated token,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L480" href="#L480">480</a><span class="code-text">  failing tab-completion flashes the to-be-completed token (:issue:`11050`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L481" href="#L481">481</a><span class="code-text">  deleting an autosuggestion (:kbd:`shift-delete`) flashes the suggestion,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L482" href="#L482">482</a><span class="code-text">  and all other scenarios flash the full command line.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L483" href="#L483">483</a><span class="code-text">- Pasted commands are now stripped of any :code:`$\ ` command prefixes, to help pasting code snippets.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L484" href="#L484">484</a><span class="code-text">- Builtin help options (e.g. ``abbr --help``) now use ``man`` directly, meaning that variables like :envvar:`MANWIDTH` are respected (:issue:`11786`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L485" href="#L485">485</a><span class="code-text">- ``funced`` will now edit copied functions directly, instead of the file where ``function --copy`` was invoked. (:issue:`11614`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L486" href="#L486">486</a><span class="code-text">- Added a simple ``fish_jj_prompt`` which reduces visual noise in the prompt inside `Jujutsu &lt;https://jj-vcs.github.io/jj/latest/&gt;`__ repositories that are colocated with Git.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L487" href="#L487">487</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L488" href="#L488">488</a><span class="code-text">New or improved bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L489" href="#L489">489</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L490" href="#L490">490</a><span class="code-text">- On non-macOS systems, :kbd:`alt-left`, :kbd:`alt-right`, :kbd:`alt-backspace` and :kbd:`alt-delete` no longer operate on punctuation-delimited words but on whole arguments, possibly including special characters like ``/`` and quoted spaces.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L491" href="#L491">491</a><span class="code-text">  On macOS, the corresponding :kbd:`ctrl-` prefixed keys operate on whole arguments.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L492" href="#L492">492</a><span class="code-text">  Word operations are still available via the other respective modifier, just like in most web browsers.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L493" href="#L493">493</a><span class="code-text">- :kbd:`ctrl-z` (undo) after executing a command will restore the previous cursor position instead of placing the cursor at the end of the command line.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L494" href="#L494">494</a><span class="code-text">- The :kbd:`alt-s` binding will now also use ``run0`` if available.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L495" href="#L495">495</a><span class="code-text">- Some mouse support has been added: the OSC 133 prompt marking feature has learned about kitty's ``click_events=1`` flag, which allows moving fish's cursor by clicking in the command line,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L496" href="#L496">496</a><span class="code-text">  and selecting pager items (:issue:`10932`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L497" href="#L497">497</a><span class="code-text">- Before clearing the screen and redrawing, :kbd:`ctrl-l` now pushes all text located above the prompt to the terminal's scrollback,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L498" href="#L498">498</a><span class="code-text">  via a new special input function :ref:`scrollback-push &lt;special-input-functions-scrollback-push&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L499" href="#L499">499</a><span class="code-text">  For compatibility with terminals that do not implement ECMA-48's :ref:`SCROLL UP &lt;term-compat-indn&gt;` command,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L500" href="#L500">500</a><span class="code-text">  this function is only used if the terminal advertises support for that via :ref:`XTGETTCAP &lt;term-compat-xtgettcap&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L501" href="#L501">501</a><span class="code-text">- Vi mode has learned :kbd:`ctrl-a` (increment) and :kbd:`ctrl-x` (decrement) (:issue:`11570`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L502" href="#L502">502</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L503" href="#L503">503</a><span class="code-text">Completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L504" href="#L504">504</a><span class="code-text">^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L505" href="#L505">505</a><span class="code-text">- ``git`` completions now show the remote URL as description when completing remotes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L506" href="#L506">506</a><span class="code-text">- ``systemctl`` completions no longer print escape codes if ``SYSTEMD_COLORS`` happens to be set (:issue:`11465`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L507" href="#L507">507</a><span class="code-text">- Added and improved many completion scripts, notably ``tmux``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L508" href="#L508">508</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L509" href="#L509">509</a><span class="code-text">Improved terminal support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L510" href="#L510">510</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L511" href="#L511">511</a><span class="code-text">- Support for double, curly, dotted and dashed underlines, for use in ``fish_color_*`` variables and the :doc:`set_color builtin &lt;cmds/set_color&gt;` (:issue:`10957`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L512" href="#L512">512</a><span class="code-text">- Underlines can now be colored independent of text (:issue:`7619`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L513" href="#L513">513</a><span class="code-text">- New documentation page :doc:`Terminal Compatibility &lt;terminal-compatibility&gt;` (also accessible via ``man fish-terminal-compatibility``) lists the terminal control sequences used by fish.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L514" href="#L514">514</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L515" href="#L515">515</a><span class="code-text">Other improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L516" href="#L516">516</a><span class="code-text">------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L517" href="#L517">517</a><span class="code-text">- Updated Chinese and German translations.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L518" href="#L518">518</a><span class="code-text">- ``fish_indent --dump-parse-tree`` now emits simple metrics about the tree including its memory consumption.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L519" href="#L519">519</a><span class="code-text">- We added some tools to improve development workflows, for example ``build_tools/{check,update_translations,release}.sh`` and ``tests/test_driver.py``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L520" href="#L520">520</a><span class="code-text">  In conjunction with ``cargo``, these enable almost all day-to-day development tasks without using CMake.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L521" href="#L521">521</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L522" href="#L522">522</a><span class="code-text">For distributors</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L523" href="#L523">523</a><span class="code-text">----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L524" href="#L524">524</a><span class="code-text">- Builtin commands that support the ``--help`` option now require the ``man`` program.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L525" href="#L525">525</a><span class="code-text">  The direct dependency on ``mandoc`` and ``nroff`` has been removed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L526" href="#L526">526</a><span class="code-text">- fish no longer uses gettext MO files, see :ref:`below &lt;changelog-4.1-gettext&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L527" href="#L527">527</a><span class="code-text">  If you have use cases which are incompatible with our new approach, please let us know.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L528" href="#L528">528</a><span class="code-text">- The :doc:`fish_indent &lt;cmds/fish_indent&gt;` and :doc:`fish_key_reader &lt;cmds/fish_key_reader&gt;` programs are now also available as builtins.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L529" href="#L529">529</a><span class="code-text">  If fish is invoked via e.g. a symlink with one of these names,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L530" href="#L530">530</a><span class="code-text">  it will act like the given tool (i.e. it's a multi-call binary).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L531" href="#L531">531</a><span class="code-text">  This allows truly distributing fish as a single file (:issue:`10876`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L532" href="#L532">532</a><span class="code-text">- The CMake build configuration has been simplified and no longer second-guesses rustup.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L533" href="#L533">533</a><span class="code-text">  It will run rustc and cargo via :envvar:`PATH` or in ~/.cargo/bin/.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L534" href="#L534">534</a><span class="code-text">  If that doesn't match your setup, set the Rust_COMPILER and Rust_CARGO CMake variables (:issue:`11328`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L535" href="#L535">535</a><span class="code-text">- Cygwin support has been reintroduced, since `Rust gained a Cygwin target &lt;https://github.com/rust-lang/rust/pull/134999&gt;`__ (:issue:`11238`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L536" href="#L536">536</a><span class="code-text">- CMake 3.15 is now required.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L537" href="#L537">537</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L538" href="#L538">538</a><span class="code-text">.. _changelog-4.1-embedded:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L539" href="#L539">539</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L540" href="#L540">540</a><span class="code-text">Changes to self-installing builds</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L541" href="#L541">541</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L542" href="#L542">542</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L543" href="#L543">543</a><span class="code-text">The self-installing build type introduced in fish 4.0 has been changed (:issue:`11143`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L544" href="#L544">544</a><span class="code-text">Now fish built with embedded data will just read the data straight from its own binary or write it out to temporary files when necessary, instead of requiring an installation step on start.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L545" href="#L545">545</a><span class="code-text">That means it is now possible to build fish as a single file and copy it to any system with a compatible CPU architecture, including as a different user, without extracting any files.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L546" href="#L546">546</a><span class="code-text">As before, this is the default when building via ``cargo``, and disabled when building via CMake.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L547" href="#L547">547</a><span class="code-text">For packagers we continue to recommend CMake.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L548" href="#L548">548</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L549" href="#L549">549</a><span class="code-text">Note: When fish is built like this, the :envvar:`__fish_data_dir` variable will be empty because that directory no longer has meaning.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L550" href="#L550">550</a><span class="code-text">You should generally not need these files.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L551" href="#L551">551</a><span class="code-text">For example, if you want to make sure that completions for &quot;foo&quot; are loaded, use ``complete -C&quot;foo &quot; &gt;/dev/null``  instead).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L552" href="#L552">552</a><span class="code-text">The raw files are still exposed via :ref:`status subcommands &lt;status-get-file&gt;`, mainly for fish's internal use, but you can also use them as a last resort.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L553" href="#L553">553</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L554" href="#L554">554</a><span class="code-text">Remaining benefits of a full installation (as currently done by CMake) are:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L555" href="#L555">555</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L556" href="#L556">556</a><span class="code-text">- man pages like ``fish(1)`` in standard locations, easily accessible from outside fish.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L557" href="#L557">557</a><span class="code-text">- a local copy of the HTML documentation, typically accessed via the :doc:`help &lt;cmds/help&gt;` function.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L558" href="#L558">558</a><span class="code-text">  In builds with embedded data, ``help`` will redirect to e.g. `&lt;https://fishshell.com/docs/current/&gt;`__</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L559" href="#L559">559</a><span class="code-text">- ``fish_indent`` and ``fish_key_reader`` as separate files, making them easily accessible outside fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L560" href="#L560">560</a><span class="code-text">- an (empty) ``/etc/fish/config.fish`` as well as empty directories ``/etc/fish/{functions,completions,conf.d}``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L561" href="#L561">561</a><span class="code-text">- ``$PREFIX/share/pkgconfig/fish.pc``, which defines directories for configuration-snippets, like ``vendor_completions.d``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L562" href="#L562">562</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L563" href="#L563">563</a><span class="code-text">.. _changelog-4.1-gettext:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L564" href="#L564">564</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L565" href="#L565">565</a><span class="code-text">Changes to gettext localization</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L566" href="#L566">566</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L567" href="#L567">567</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L568" href="#L568">568</a><span class="code-text">We replaced several parts of the gettext functionality with custom implementations (:issue:`11726`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L569" href="#L569">569</a><span class="code-text">Most notably, message extraction, which should now work reliably, and the runtime implementation, where we no longer dynamically link to gettext, but instead use our own implementation, whose behavior is similar to GNU gettext, with some :doc:`minor deviations &lt;cmds/_&gt;`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L570" href="#L570">570</a><span class="code-text">Our implementation now fully respects fish variables, so locale variables do not have to be exported for fish localizations to work.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L571" href="#L571">571</a><span class="code-text">They still have to be exported to inform other programs about language preferences.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L572" href="#L572">572</a><span class="code-text">The :envvar:`LANGUAGE` environment variable is now treated as a path variable, meaning it is an implicitly colon-separated list.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L573" href="#L573">573</a><span class="code-text">While we no longer have any runtime dependency on gettext, we still need gettext tools for building, most notably ``msgfmt``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L574" href="#L574">574</a><span class="code-text">When building without ``msgfmt`` available, localization will not work with the resulting executable.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L575" href="#L575">575</a><span class="code-text">Localization data is no longer sourced at runtime from MO files on the file system, but instead built into the executable.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L576" href="#L576">576</a><span class="code-text">This is always done, independently of the other data embedding, so all fish executables will have access to all message catalogs, regardless of the state of the file system.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L577" href="#L577">577</a><span class="code-text">Disabling our new ``localize-messages`` cargo feature will cause fish to be built without localization support.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L578" href="#L578">578</a><span class="code-text">CMake builds can continue to use the ``WITH_GETTEXT`` option, with the same semantics as the ``localize-messages`` feature.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L579" href="#L579">579</a><span class="code-text">The current implementation does not provide any configuration options for controlling which language catalogs are built into the executable (other than disabling them all).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L580" href="#L580">580</a><span class="code-text">As a workaround, you can delete files in the ``po`` directory before building to exclude unwanted languages.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L581" href="#L581">581</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L582" href="#L582">582</a><span class="code-text">.. _changelog-4.1-argparse:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L583" href="#L583">583</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L584" href="#L584">584</a><span class="code-text">Changes to the :doc:`argparse &lt;cmds/argparse&gt;` builtin</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L585" href="#L585">585</a><span class="code-text">------------------------------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L586" href="#L586">586</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L587" href="#L587">587</a><span class="code-text">- ``argparse`` now saves recognised options, including option-arguments in :envvar:`argv_opts`, allowing them to be forwarded to other commands (:issue:`6466`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L588" href="#L588">588</a><span class="code-text">- ``argparse`` options can now be marked to be deleted from :envvar:`argv_opts` (by adding a ``&amp;`` at the end of the option spec, before a ``!`` if present). There is now also a corresponding ``-d`` / ``--delete`` option to ``fish_opt``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L589" href="#L589">589</a><span class="code-text">- ``argparse --ignore-unknown`` now removes preceding known short options from groups containing unknown options (e.g. when parsing ``-abc``, if ``a`` is known but ``b`` is not, then :envvar:`argv` will contain ``-bc``).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L590" href="#L590">590</a><span class="code-text">- ``argparse`` now has an ``-u`` / ``--move-unknown`` option that works like ``--ignore-unknown`` but preserves unknown options in :envvar:`argv`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L591" href="#L591">591</a><span class="code-text">- ``argparse`` now has an ``-S`` / ``--strict-longopts`` option that forbids abbreviating long options or passing them with a single dash (e.g. if there is a long option called ``foo``, ``--fo`` and ``--foo`` won't match it).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L592" href="#L592">592</a><span class="code-text">- ``argparse`` now has a ``-U`` / ``--unknown-arguments`` option to specify how to parse unknown option's arguments.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L593" href="#L593">593</a><span class="code-text">- ``argparse`` now allows specifying options that take multiple optional values by using ``=*`` in the option spec (:issue:`8432`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L594" href="#L594">594</a><span class="code-text">  In addition, ``fish_opt`` has been modified to support such options by using the ``--multiple-vals`` together with ``-o`` / ``--optional-val``; ``-m`` is also now acceptable as an abbreviation for ``--multiple-vals``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L595" href="#L595">595</a><span class="code-text">- ``fish_opt`` no longer requires you give a short flag name when defining options, provided you give it a long flag name with more than one character.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L596" href="#L596">596</a><span class="code-text">- ``argparse`` option specifiers for long-only options can now start with ``/``, allowing the definition of long options with a single letter. Due to this change, the ``--long-only`` option to ``fish_opt`` is now no longer necessary and is deprecated.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L597" href="#L597">597</a><span class="code-text">- ``fish_opt`` now has a ``-v`` / ``--validate`` option you can use to give a fish script to validate values of the option.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L598" href="#L598">598</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L599" href="#L599">599</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L600" href="#L600">600</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L601" href="#L601">601</a><span class="code-text">fish 4.0.9 (released September 27, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L602" href="#L602">602</a><span class="code-text">========================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L603" href="#L603">603</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L604" href="#L604">604</a><span class="code-text">This release fixes:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L605" href="#L605">605</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L606" href="#L606">606</a><span class="code-text">- a regression in 4.0.6 causing shifted keys to not be inserted on some terminals (:issue:`11813`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L607" href="#L607">607</a><span class="code-text">- a regression in 4.0.6 causing the build to fail on systems where ``char`` is unsigned (:issue:`11804`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L608" href="#L608">608</a><span class="code-text">- a regression in 4.0.0 causing a crash on an invalid :doc:`bg &lt;cmds/bg&gt;` invocation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L609" href="#L609">609</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L610" href="#L610">610</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L611" href="#L611">611</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L612" href="#L612">612</a><span class="code-text">fish 4.0.8 (released September 18, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L613" href="#L613">613</a><span class="code-text">========================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L614" href="#L614">614</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L615" href="#L615">615</a><span class="code-text">This release fixes a regression in 4.0.6 that caused user bindings to be shadowed by either fish's or a plugin's bindings (:issue:`11803`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L616" href="#L616">616</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L617" href="#L617">617</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L618" href="#L618">618</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L619" href="#L619">619</a><span class="code-text">fish 4.0.6 (released September 12, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L620" href="#L620">620</a><span class="code-text">========================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L621" href="#L621">621</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L622" href="#L622">622</a><span class="code-text">This release of fish fixes a number of issues identified in fish 4.0.2:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L623" href="#L623">623</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L624" href="#L624">624</a><span class="code-text">- fish now properly inherits $PATH under Windows WSL2 (:issue:`11354`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L625" href="#L625">625</a><span class="code-text">- Remote filesystems are detected properly again on non-Linux systems.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L626" href="#L626">626</a><span class="code-text">- the :doc:`printf &lt;cmds/printf&gt;` builtin no longer miscalculates width of multi-byte characters (:issue:`11412`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L627" href="#L627">627</a><span class="code-text">- For many years, fish has been &quot;relocatable&quot; -- it was possible to move the entire ``CMAKE_INSTALL_PREFIX`` and fish would use paths relative to its binary.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L628" href="#L628">628</a><span class="code-text">  Only gettext locale paths were still determined purely at compile time, which has been fixed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L629" href="#L629">629</a><span class="code-text">- the :doc:`commandline &lt;cmds/commandline&gt;` builtin failed to print the commandline set by a ``commandline -C`` invocation, which broke some completion scripts.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L630" href="#L630">630</a><span class="code-text">  This has been corrected (:issue:`11423`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L631" href="#L631">631</a><span class="code-text">- To work around terminals that fail to parse Operating System Command (OSC) sequences, a temporary feature flag has been added.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L632" href="#L632">632</a><span class="code-text">  It allows you to disable prompt marking (OSC 133) by running (once) ``set -Ua fish_features no-mark-prompt`` and restarting fish (:issue:`11749`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L633" href="#L633">633</a><span class="code-text">- The routines to save history and universal variables have seen some robustness improvements.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L634" href="#L634">634</a><span class="code-text">- builtin :doc:`status current-command &lt;cmds/status&gt;` no longer prints a trailing blank line.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L635" href="#L635">635</a><span class="code-text">- A crash displaying multi-line quoted command substitutions has been fixed (:issue:`11444`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L636" href="#L636">636</a><span class="code-text">- Commands like ``set fish_complete_path ...`` accidentally disabled completion autoloading, which has been corrected.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L637" href="#L637">637</a><span class="code-text">- ``nmcli`` completions have been fixed to query network information dynamically instead of only when completing the first time.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L638" href="#L638">638</a><span class="code-text">- Git completions no longer print an error when no `git-foo` executable is in :envvar:`PATH`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L639" href="#L639">639</a><span class="code-text">- Custom completions like ``complete foo -l long -xa ...`` that use the output of ``commandline -t``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L640" href="#L640">640</a><span class="code-text">  on a command-line like ``foo --long=`` have been invalidated by a change in 4.0; the completion scripts have been adjusted accordingly (:issue:`11508`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L641" href="#L641">641</a><span class="code-text">- Some completions were misinterpreted, which caused garbage to be displayed in the completion list. This has been fixed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L642" href="#L642">642</a><span class="code-text">- fish no longer interprets invalid control sequences from the terminal as if they were :kbd:`alt-[` or :kbd:`alt-o` key strokes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L643" href="#L643">643</a><span class="code-text">- :doc:`bind &lt;cmds/bind&gt;` has been taught about the :kbd:`printscreen` and :kbd:`menu` keys.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L644" href="#L644">644</a><span class="code-text">- :kbd:`alt-delete` now deletes the word right of the cursor.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L645" href="#L645">645</a><span class="code-text">- :kbd:`ctrl-alt-h` erases the last word again (:issue:`11548`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L646" href="#L646">646</a><span class="code-text">- :kbd:`alt-left` :kbd:`alt-right` were misinterpreted because they send unexpected sequences on some terminals; a workaround has been added.  (:issue:`11479`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L647" href="#L647">647</a><span class="code-text">- Key bindings like ``bind shift-A`` are no longer accepted; use ``bind shift-a`` or ``bind A``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L648" href="#L648">648</a><span class="code-text">- Key bindings like ``bind shift-a`` take precedence over ``bind A`` when the key event included the shift modifier.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L649" href="#L649">649</a><span class="code-text">- Bindings using shift with non-ASCII letters (such as :kbd:`ctrl-shift-ä`) are now supported.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L650" href="#L650">650</a><span class="code-text">- Bindings with modifiers such as ``bind ctrl-w`` work again on non-Latin keyboard layouts such as a Russian one.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L651" href="#L651">651</a><span class="code-text">  This is implemented by allowing key events such as :kbd:`ctrl-ц` to match bindings of the corresponding Latin key, using the kitty keyboard protocol's base layout key (:issue:`11520`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L652" href="#L652">652</a><span class="code-text">- Vi mode: The cursor position after pasting via :kbd:`p` has been corrected.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L653" href="#L653">653</a><span class="code-text">- Vi mode: Trying to replace the last character via :kbd:`r` no longer replaces the last-but-one character (:issue:`11484`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L654" href="#L654">654</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L655" href="#L655">655</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L656" href="#L656">656</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L657" href="#L657">657</a><span class="code-text">fish 4.0.2 (released April 20, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L658" href="#L658">658</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L659" href="#L659">659</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L660" href="#L660">660</a><span class="code-text">This release of fish fixes a number of issues identified in fish 4.0.1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L661" href="#L661">661</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L662" href="#L662">662</a><span class="code-text">- Completions are quoted, rather than backslash-escaped, only if the completion is unambiguous. Continuing to edit the token is therefore easier (:issue:`11271`). This changes the behavior introduced in 4.0.0 where all completions were quoted.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L663" href="#L663">663</a><span class="code-text">- The warning when the terminfo database can't be found has been downgraded to a log message. fish will act as if the terminal behaves like xterm-256color, which is correct for the vast majority of cases (:issue:`11277`, :issue:`11290`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L664" href="#L664">664</a><span class="code-text">- Key combinations using the super (Windows/command) key can now (actually) be bound using the :kbd:`super-` prefix (:issue:`11217`). This was listed in the release notes for 4.0.1 but did not work correctly.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L665" href="#L665">665</a><span class="code-text">- :doc:`function &lt;cmds/function&gt;` is stricter about argument parsing, rather than allowing additional parameters to be silently ignored (:issue:`11295`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L666" href="#L666">666</a><span class="code-text">- Using parentheses in the :doc:`test &lt;cmds/test&gt;` builtin works correctly, following a regression in 4.0.0 where they were not recognized (:issue:`11387`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L667" href="#L667">667</a><span class="code-text">- :kbd:`delete` in Vi mode when Num Lock is active will work correctly (:issue:`11303`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L668" href="#L668">668</a><span class="code-text">- Abbreviations cannot alter the command-line contents, preventing a crash (:issue:`11324`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L669" href="#L669">669</a><span class="code-text">- Improvements to various completions, including new completions for ``wl-randr`` (:issue:`11301`), performance improvements for ``cargo`` completions by avoiding network requests (:issue:`11347`), and other improvements for  ``btrfs`` (:issue:`11320`), ``cryptsetup`` (:issue:`11315`), ``git`` (:issue:`11319`, :issue:`11322`, :issue:`11323`), ``jj`` (:issue:`11046`), and ``systemd-analyze`` (:issue:`11314`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L670" href="#L670">670</a><span class="code-text">- The Mercurial (``hg``) prompt can handle working directories that contain an embedded newline, rather than producing errors (:issue:`11348`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L671" href="#L671">671</a><span class="code-text">- A number of crashes have been fixed. Triggers include prompts containing backspace characters (:issue:`11280`), history pager search (:issue:`11355`), invalid UTF-8 in :doc:`read &lt;cmds/read&gt;` (:issue:`11383`), and the ``kill-selection`` binding (:issue:`11367`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L672" href="#L672">672</a><span class="code-text">- A race condition in the test suite has been fixed (:issue:`11254`), and a test for fish versioning relaxed to support downstream distributors' modifications (:issue:`11173`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L673" href="#L673">673</a><span class="code-text">- Small improvements to the documentation (:issue:`11264`, :issue:`11329`, :issue:`11361`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L674" href="#L674">674</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L675" href="#L675">675</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L676" href="#L676">676</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L677" href="#L677">677</a><span class="code-text">fish 4.0.1 (released March 12, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L678" href="#L678">678</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L679" href="#L679">679</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L680" href="#L680">680</a><span class="code-text">This release of fish includes the following improvements compared to fish 4.0.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L681" href="#L681">681</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L682" href="#L682">682</a><span class="code-text">- Key combinations using the super (Windows/command) key can be bound using the :kbd:`super-` prefix (:issue:`11217`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L683" href="#L683">683</a><span class="code-text">- Konsole's menu shows the &quot;Open folder with&quot; option again (:issue:`11198`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L684" href="#L684">684</a><span class="code-text">- ``$fish_color_search_match`` will now only be applied to the foreground color if it has an explicit foreground. For example, this allows setting::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L685" href="#L685">685</a><span class="code-text">    set -g fish_color_search_match --reverse</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L686" href="#L686">686</a><span class="code-text">- Cursor shape commands (``\e[2 q``) are no longer sent in non-interactive shells or in redirections (:issue:`11255`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L687" href="#L687">687</a><span class="code-text">- :doc:`status &lt;cmds/status&gt;` gained a ``is-interactive-read`` subcommand, to check whether the script is being called from an interactive :doc:`read &lt;cmds/read&gt;` invocation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L688" href="#L688">688</a><span class="code-text">- fish's background tasks are now started in a way that avoids an error on macOS Terminal.app (:issue:`11181`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L689" href="#L689">689</a><span class="code-text">- Using key combinations within qemu should work correctly.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L690" href="#L690">690</a><span class="code-text">- Prompts containing control characters no longer cause incorrect display of command lines (:issue:`11252`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L691" href="#L691">691</a><span class="code-text">- Cancelling the command-line in Vi mode displays correctly again (:issue:`11261`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L692" href="#L692">692</a><span class="code-text">- The acidhub prompt properly displays the git branch again (:issue:`11179`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L693" href="#L693">693</a><span class="code-text">- Completions for ``wine`` correctly include files again (:issue:`11202`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L694" href="#L694">694</a><span class="code-text">- On macOS, paths from ``/etc/paths`` and ``/etc/manpaths`` containing colons are handled correctly (:issue:`10684`). This functionality was included in the 4.0.0 release notes but was missing from the source code.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L695" href="#L695">695</a><span class="code-text">- The XTerm ``modifyOtherKeys`` keyboard encoding is no longer used under WezTerm, as it does not work correctly in all layouts (:issue:`11204`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L696" href="#L696">696</a><span class="code-text">- :kbd:`option-left` and other similar keys should now work in iTerm versions before 3.5.12; the kitty keyboard protocol is now disabled on these versions (:issue:`11192`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L697" href="#L697">697</a><span class="code-text">- The kitty keyboard protocol is no longer used under Midnight Commander, as it does not work correctly (:issue:`10640`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L698" href="#L698">698</a><span class="code-text">- fish now sends the commandline along with the OSC 133 semantic prompt command start sequence. This fixes a test in the kitty terminal (:issue:`11203`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L699" href="#L699">699</a><span class="code-text">- Git completions for third-party commands like &quot;git-absorb&quot; are completed correctly again (:issue:`11205`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L700" href="#L700">700</a><span class="code-text">- Completions for ``diskutil`` no longer produce an error (:issue:`11201`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L701" href="#L701">701</a><span class="code-text">- The output of certain error messages no longer prints newlines to standard output (:issue:`11248`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L702" href="#L702">702</a><span class="code-text">- A number of crashes have been fixed, including file names longer than 255 bytes (:issue:`11221`), using fish on a btrfs filesystem (:issue:`11219`), history files that do not have the expected format (:issue:`11236`), and pasting into an empty command line (:issue:`11256`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L703" href="#L703">703</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L704" href="#L704">704</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L705" href="#L705">705</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L706" href="#L706">706</a><span class="code-text">fish 4.0.0 (released February 27, 2025)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L707" href="#L707">707</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L708" href="#L708">708</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L709" href="#L709">709</a><span class="code-text">fish's core code has been ported from C++ to Rust (:issue:`9512`). This means a large change in dependencies and how to build fish. However, there should be no direct impact on users. Packagers should see the :ref:`For Distributors &lt;rust-packaging&gt;` section at the end.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L710" href="#L710">710</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L711" href="#L711">711</a><span class="code-text">Notable backwards-incompatible changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L712" href="#L712">712</a><span class="code-text">--------------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L713" href="#L713">713</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L714" href="#L714">714</a><span class="code-text">- As part of a larger binding rework, ``bind`` gained a new key notation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L715" href="#L715">715</a><span class="code-text">  In most cases the old notation should keep working, but in rare cases you may have to change a ``bind`` invocation to use the new notation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L716" href="#L716">716</a><span class="code-text">  See :ref:`below &lt;changelog-4.0-new-bindings&gt;` for details.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L717" href="#L717">717</a><span class="code-text">- :kbd:`ctrl-c` now calls a new bind function called ``clear-commandline``. The old behavior, which leaves a &quot;^C&quot; marker, is available as ``cancel-commandline`` (:issue:`10935`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L718" href="#L718">718</a><span class="code-text">- ``random`` will produce different values from previous versions of fish when used with the same seed, and will work more sensibly with small seed numbers.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L719" href="#L719">719</a><span class="code-text">  The seed was never guaranteed to give the same result across systems,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L720" href="#L720">720</a><span class="code-text">  so we do not expect this to have a large impact (:issue:`9593`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L721" href="#L721">721</a><span class="code-text">- Variables in command position that expand to a subcommand keyword are now forbidden to fix a likely user error.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L722" href="#L722">722</a><span class="code-text">  For example, ``set editor command emacs; $editor`` is no longer allowed (:issue:`10249`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L723" href="#L723">723</a><span class="code-text">- ``functions --handlers`` will now list handlers in a different order.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L724" href="#L724">724</a><span class="code-text">  Now it is definition order, first to last, where before it was last to first.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L725" href="#L725">725</a><span class="code-text">  This was never specifically defined, and we recommend not relying on a specific order (:issue:`9944`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L726" href="#L726">726</a><span class="code-text">- The ``qmark-noglob`` feature, introduced in fish 3.0, is enabled by default. That means ``?`` will no longer act as a single-character glob.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L727" href="#L727">727</a><span class="code-text">  You can, for the time being, turn it back on by adding ``no-qmark-noglob`` to :envvar:`fish_features` and restarting fish::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L728" href="#L728">728</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L729" href="#L729">729</a><span class="code-text">    set -Ua fish_features no-qmark-noglob</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L730" href="#L730">730</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L731" href="#L731">731</a><span class="code-text">  The flag will eventually be made read-only, making it impossible to turn off.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L732" href="#L732">732</a><span class="code-text">- Terminals that fail to ignore unrecognized OSC or CSI sequences may display garbage. We know cool-retro-term and emacs' ansi-term are affected, but most mainstream terminals are not.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L733" href="#L733">733</a><span class="code-text">- fish no longer searches directories from the Windows system/user ``$PATH`` environment variable for Linux executables. To execute Linux binaries by name (i.e. not with a relative or absolute path) from a Windows folder, make sure the ``/mnt/c/...`` path is explicitly added to ``$fish_user_paths`` and not just automatically appended to ``$PATH`` by ``wsl.exe`` (:issue:`10506`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L734" href="#L734">734</a><span class="code-text">- Under Microsoft Windows Subsystem for Linux 1 (not WSL 2), backgrounded jobs that have not been disowned and do not terminate on their own after a ``SIGHUP`` + ``SIGCONT`` sequence will be explicitly killed by fish on exit (after the usual prompt to close or disown them) to work around a WSL 1 deficiency that sees backgrounded processes that run into ``SIGTTOU`` remain in a suspended state indefinitely (:issue:`5263`). The workaround is to explicitly ``disown`` processes you wish to outlive the shell session.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L735" href="#L735">735</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L736" href="#L736">736</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L737" href="#L737">737</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L738" href="#L738">738</a><span class="code-text">.. _changelog-4.0-new-bindings:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L739" href="#L739">739</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L740" href="#L740">740</a><span class="code-text">-  fish now requests XTerm's ``modifyOtherKeys`` keyboard encoding and `kitty keyboard protocol's &lt;https://sw.kovidgoyal.net/kitty/keyboard-protocol/&gt;`_ progressive enhancements (:issue:`10359`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L741" href="#L741">741</a><span class="code-text">   Depending on terminal support, this allows to binding more key combinations, including arbitrary combinations of modifiers :kbd:`ctrl`, :kbd:`alt` and :kbd:`shift`, and distinguishing (for example) :kbd:`ctrl-i` from :kbd:`tab`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L742" href="#L742">742</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L743" href="#L743">743</a><span class="code-text">   Additionally, ``bind`` now supports a human-readable syntax in addition to byte sequences.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L744" href="#L744">744</a><span class="code-text">   This includes modifier names, and names for keys like :kbd:`enter` and :kbd:`backspace`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L745" href="#L745">745</a><span class="code-text">   For example</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L746" href="#L746">746</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L747" href="#L747">747</a><span class="code-text">   - ``bind up 'do something'`` binds the up-arrow key instead of a two-key sequence (&quot;u&quot; and then &quot;p&quot;)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L748" href="#L748">748</a><span class="code-text">   - ``bind ctrl-x,alt-c 'do something'`` binds a sequence of two keys.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L749" href="#L749">749</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L750" href="#L750">750</a><span class="code-text">   Any key argument that starts with an ASCII control character (like ``\e`` or ``\cX``) or is up to 3 characters long, not a named key, and does not contain ``,`` or ``-`` will be interpreted in the old syntax to keep compatibility for the majority of bindings.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L751" href="#L751">751</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L752" href="#L752">752</a><span class="code-text">   Keyboard protocols can be turned off by disabling the &quot;keyboard-protocols&quot; feature flag::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L753" href="#L753">753</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L754" href="#L754">754</a><span class="code-text">     set -Ua fish_features no-keyboard-protocols</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L755" href="#L755">755</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L756" href="#L756">756</a><span class="code-text">   This is a temporary measure to work around buggy terminals (:issue:`11056`), which appear to be relatively rare.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L757" href="#L757">757</a><span class="code-text">   Use this if something like &quot;=0&quot; or &quot;=5u&quot; appears in your commandline mysteriously.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L758" href="#L758">758</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L759" href="#L759">759</a><span class="code-text">- fish can now be built as a self-installing binary (:issue:`10367`). That means it can be easily built on one system and copied to another, where it can extract supporting files.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L760" href="#L760">760</a><span class="code-text">  To do this, run::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L761" href="#L761">761</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L762" href="#L762">762</a><span class="code-text">    cargo install --path . # in a clone of the fish repository</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L763" href="#L763">763</a><span class="code-text">    # or `cargo build --release` and copy target/release/fish{,_indent,_key_reader} wherever you want</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L764" href="#L764">764</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L765" href="#L765">765</a><span class="code-text">  The first time it runs interactively, it will extract all the data files to  ``~/.local/share/fish/install/``. A specific path can be used for the data files with ``fish --install=PATH`` To uninstall, remove the fish binaries and that directory.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L766" href="#L766">766</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L767" href="#L767">767</a><span class="code-text">  This build system is experimental; the main build system, using ``cmake``, remains the recommended approach for packaging and installation to a prefix.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L768" href="#L768">768</a><span class="code-text">- A new function ``fish_should_add_to_history`` can be overridden to decide whether a command should be added to the history (:issue:`10302`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L769" href="#L769">769</a><span class="code-text">- Bindings can now mix special input functions and shell commands, so ``bind ctrl-g expand-abbr &quot;commandline -i \n&quot;`` works as expected (:issue:`8186`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L770" href="#L770">770</a><span class="code-text">- Special input functions run from bindings via ``commandline -f`` are now applied immediately, instead of after the currently executing binding (:issue:`3031`, :issue:`10126`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L771" href="#L771">771</a><span class="code-text">  For example, ``commandline -i foo; commandline | grep foo`` succeeds now.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L772" href="#L772">772</a><span class="code-text">- Undo history is no longer truncated after every command, but kept for the lifetime of the shell process.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L773" href="#L773">773</a><span class="code-text">- The :kbd:`ctrl-r` history search now uses glob syntax (:issue:`10131`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L774" href="#L774">774</a><span class="code-text">- The :kbd:`ctrl-r` history search now operates only on the line or command substitution at cursor, making it easier to combine commands from history (:issue:`9751`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L775" href="#L775">775</a><span class="code-text">- Abbreviations can now be restricted to specific commands. For instance::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L776" href="#L776">776</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L777" href="#L777">777</a><span class="code-text">    abbr --add --command git back 'reset --hard HEAD^'</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L778" href="#L778">778</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L779" href="#L779">779</a><span class="code-text">  will expand &quot;back&quot; to ``reset --hard HEAD^``, but only when the command is ``git`` (:issue:`9411`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L780" href="#L780">780</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L781" href="#L781">781</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L782" href="#L782">782</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L783" href="#L783">783</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L784" href="#L784">784</a><span class="code-text">- ``commandline --tokenize`` (short option ``-o``) has been deprecated in favor of ``commandline --tokens-expanded`` (short option ``-x``) which expands variables and other shell syntax, removing the need to use :doc:`eval &lt;cmds/eval&gt;` in completion scripts (:issue:`10212`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L785" href="#L785">785</a><span class="code-text">- Two new feature flags:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L786" href="#L786">786</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L787" href="#L787">787</a><span class="code-text">  - ``remove-percent-self`` (see ``status features``) disables PID expansion of ``%self``, which has been supplanted by ``$fish_pid`` (:issue:`10262`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L788" href="#L788">788</a><span class="code-text">  - ``test-require-arg`` disables ``test``'s one-argument mode. That means ``test -n`` without an additional argument will return false, ``test -z`` will keep returning true. Any other option without an argument, anything that is not an option and no argument will be an error. This also goes for ``[``, test's alternate name.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L789" href="#L789">789</a><span class="code-text">    This is a frequent source of confusion and so we are breaking with POSIX explicitly in this regard.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L790" href="#L790">790</a><span class="code-text">    In addition to the feature flag, there is a debug category &quot;deprecated-test&quot;. Running fish with ``fish -d deprecated-test`` will show warnings whenever a ``test`` invocation that would change is used. (:issue:`10365`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L791" href="#L791">791</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L792" href="#L792">792</a><span class="code-text">  These can be enabled with::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L793" href="#L793">793</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L794" href="#L794">794</a><span class="code-text">    set -Ua fish_features remove-percent-self test-require-arg</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L795" href="#L795">795</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L796" href="#L796">796</a><span class="code-text">  We intend to enable them by default in future, and after that eventually make them read-only.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L797" href="#L797">797</a><span class="code-text">- Specifying key names as terminfo names (using the ``bind -k`` syntax) is deprecated and may be removed in a future version.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L798" href="#L798">798</a><span class="code-text">- When a terminal pastes text into fish using bracketed paste, fish used to switch to a special ``paste`` bind mode.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L799" href="#L799">799</a><span class="code-text">  This bind mode has been removed. The behavior on paste is no longer configurable.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L800" href="#L800">800</a><span class="code-text">- When an interactive fish is stopped or terminated by a signal that cannot be caught (SIGSTOP or SIGKILL), it may leave the terminal in a state where keypresses with modifiers are sent as CSI u sequences, instead of traditional control characters or escape sequences that are recognized by Readline and compatible programs, such as bash and python.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L801" href="#L801">801</a><span class="code-text">  If this happens, you can use the ``reset`` command from ``ncurses`` to restore the terminal state.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L802" href="#L802">802</a><span class="code-text">- ``fish_key_reader --verbose`` no longer shows timing information.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L803" href="#L803">803</a><span class="code-text">- Terminal information is no longer read from hashed terminfo databases, or termcap databases (:issue:`10269`). The vast majority of systems use a non-hashed terminfo database, which is still supported.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L804" href="#L804">804</a><span class="code-text">- ``source`` returns an error if used without a filename or pipe/redirection (:issue:`10774`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L805" href="#L805">805</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L806" href="#L806">806</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L807" href="#L807">807</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L808" href="#L808">808</a><span class="code-text">- ``for`` loops will no longer remember local variables from the previous iteration (:issue:`10525`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L809" href="#L809">809</a><span class="code-text">- A new ``history append`` subcommand appends a command to the history, without executing it (:issue:`4506`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L810" href="#L810">810</a><span class="code-text">- A new redirection: ``&lt;? /path/to/file`` will try opening the file as input, and if it doesn't succeed silently uses ``/dev/null`` instead.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L811" href="#L811">811</a><span class="code-text">  This can help with checks like ``test -f /path/to/file; and string replace foo bar &lt; /path/to/file``. (:issue:`10387`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L812" href="#L812">812</a><span class="code-text">- A new option ``commandline --tokens-raw`` prints a list of tokens without any unescaping (:issue:`10212`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L813" href="#L813">813</a><span class="code-text">- A new option ``commandline --showing-suggestion`` tests whether an autosuggestion is currently displayed (:issue:`10586`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L814" href="#L814">814</a><span class="code-text">- ``functions`` and ``type`` now show that a function was copied and its source, rather than solely ``Defined interactively`` (:issue:`6575`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L815" href="#L815">815</a><span class="code-text">- Stack trace now shows line numbers for copied functions (:issue:`6575`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L816" href="#L816">816</a><span class="code-text">- ``foo &amp; &amp;&amp; bar`` is now a syntax error, like in other shells (:issue:`9911`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L817" href="#L817">817</a><span class="code-text">- ``if -e foo; end`` now prints a more accurate error (:issue:`10000`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L818" href="#L818">818</a><span class="code-text">- ``cd`` into a directory that is not readable but accessible (permissions ``--x``) is now possible (:issue:`10432`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L819" href="#L819">819</a><span class="code-text">- An integer overflow in ``string repeat`` leading to a near-infinite loop has been fixed (:issue:`9899`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L820" href="#L820">820</a><span class="code-text">- ``string shorten`` behaves better in the presence of non-printable characters, including fixing an integer overflow that shortened strings more than intended (:issue:`9854`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L821" href="#L821">821</a><span class="code-text">- ``string pad`` no longer allows non-printable characters as padding (:issue:`9854`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L822" href="#L822">822</a><span class="code-text">- ``string repeat`` now allows omission of ``-n`` when the first argument is an integer (:issue:`10282`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L823" href="#L823">823</a><span class="code-text">- ``string match`` and ``replace`` have a new ``--max-matches`` option to return as soon as the specified number of matches have been identified, which can improve performance in scripts (:issue:`10587`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L824" href="#L824">824</a><span class="code-text">- ``functions --handlers-type caller-exit`` once again lists functions defined as ``function --on-job-exit caller``, rather than them being listed by ``functions --handlers-type process-exit``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L825" href="#L825">825</a><span class="code-text">- A new ``set --no-event`` option sets or erases variables without triggering a variable event. This can be useful to change a variable in an event handler (:issue:`10480`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L826" href="#L826">826</a><span class="code-text">- Commas in command substitution output are no longer used as separators in brace expansion, preventing a surprising expansion in some cases (:issue:`5048`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L827" href="#L827">827</a><span class="code-text">- Universal variables can now store strings containing invalid UTF-8 (:issue:`10313`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L828" href="#L828">828</a><span class="code-text">- A new ``path basename -E`` option that causes it to return the basename (&quot;filename&quot; with the directory prefix removed) with the final extension (if any) also removed. This is a shorter version of ``path change-extension &quot;&quot; (path basename $foo)`` (:issue:`10521`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L829" href="#L829">829</a><span class="code-text">- A new ``math --scale-mode`` option to select ``truncate``, ``round``, ``floor``, ``ceiling`` as you wish; the default value is ``truncate``. (:issue:`9117`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L830" href="#L830">830</a><span class="code-text">- ``random`` is now less strict about its arguments, allowing a start larger or equal to the end. (:issue:`10879`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L831" href="#L831">831</a><span class="code-text">- ``function --argument-names`` now produces an error if a read-only variable name is used, rather than simply ignoring it (:issue:`10842`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L832" href="#L832">832</a><span class="code-text">- Tilde expansion in braces (that is, ``{~,}``) works correctly (:issue:`10610`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L833" href="#L833">833</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L834" href="#L834">834</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L835" href="#L835">835</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L836" href="#L836">836</a><span class="code-text">- Autosuggestions were sometimes not shown after recalling a line from history, which has been fixed (:issue:`10287`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L837" href="#L837">837</a><span class="code-text">- Up-arrow search matches -- which are highlighted in reverse colors -- are no longer syntax-highlighted, to fix bad contrast with the search match highlighting.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L838" href="#L838">838</a><span class="code-text">- Command abbreviations (those with ``--position command`` or without a ``--position``) now also expand after decorators like ``command`` (:issue:`10396`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L839" href="#L839">839</a><span class="code-text">- Abbreviations now expand after process separators like ``;`` and ``|``. This fixes a regression in version 3.6 (:issue:`9730`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L840" href="#L840">840</a><span class="code-text">- When exporting interactively defined functions (using ``type``, ``functions`` or ``funcsave``) the function body is now indented, to match the interactive command line editor (:issue:`8603`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L841" href="#L841">841</a><span class="code-text">- :kbd:`ctrl-x` (``fish_clipboard_copy``) on multiline commands now includes indentation (:issue:`10437`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L842" href="#L842">842</a><span class="code-text">- :kbd:`ctrl-v` (``fish_clipboard_paste``) now strips ASCII control characters from the pasted text.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L843" href="#L843">843</a><span class="code-text">  This is consistent with normal keyboard input (:issue:`5274`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L844" href="#L844">844</a><span class="code-text">- When a command like ``fg %2`` fails to find the given job, it no longer behaves as if no job spec was given (:issue:`9835`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L845" href="#L845">845</a><span class="code-text">- Redirection in command position like ``&gt;echo`` is now highlighted as error (:issue:`8877`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L846" href="#L846">846</a><span class="code-text">- ``fish_vi_cursor`` now works properly inside the prompt created by builtin ``read`` (:issue:`10088`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L847" href="#L847">847</a><span class="code-text">- fish no longer fails to open a FIFO if interrupted by a terminal resize signal (:issue:`10250`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L848" href="#L848">848</a><span class="code-text">- ``read --help`` and friends no longer ignore redirections. This fixes a regression in version 3.1 (:issue:`10274`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L849" href="#L849">849</a><span class="code-text">- Measuring a command with ``time`` now considers the time taken for command substitution (:issue:`9100`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L850" href="#L850">850</a><span class="code-text">- ``fish_add_path`` now automatically enables verbose mode when used interactively (in the command line), in an effort to be clearer about what it does (:issue:`10532`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L851" href="#L851">851</a><span class="code-text">- fish no longer adopts TTY modes of failed commands (:issue:`10603`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L852" href="#L852">852</a><span class="code-text">- ``complete -e cmd`` now prevents autoloading completions for ``cmd`` (:issue:`6716`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L853" href="#L853">853</a><span class="code-text">- fish's default color scheme no longer uses the color &quot;blue&quot;, as it has bad contrast against the background in a few terminal's default palettes (:issue:`10758`, :issue:`10786`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L854" href="#L854">854</a><span class="code-text">  The color scheme will not be upgraded for existing installs. If you want, you should select it again via ``fish_config``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L855" href="#L855">855</a><span class="code-text">- Command lines which are larger than the terminal are now displayed correctly, instead of multiple blank lines being displayed (:issue:`7296`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L856" href="#L856">856</a><span class="code-text">- Prompts that use external commands will no longer produce an infinite loop if the command crashes (:issue:`9796`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L857" href="#L857">857</a><span class="code-text">- The output of ``jobs`` shows &quot;-&quot; for jobs that have the same process group ID as the fish process, rather than &quot;-2&quot; (:issue:`10833`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L858" href="#L858">858</a><span class="code-text">- Job expansion (``%1`` syntax) works properly for jobs that are a mixture of external commands and functions (:issue:`10832`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L859" href="#L859">859</a><span class="code-text">- Command lines which have more lines than the terminal can be displayed and edited correctly (:issue:`10827`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L860" href="#L860">860</a><span class="code-text">- Functions that have been erased are no longer highlighted as valid commands (:issue:`10866`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L861" href="#L861">861</a><span class="code-text">- ``not``, ``time``, and variable assignments (that is ``not time a=b env``) is correctly recognized as valid syntax (:issue:`10890`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L862" href="#L862">862</a><span class="code-text">- The Web-based configuration removes old right-hand-side prompts again, fixing a regression in fish 3.4.0 (:issue:`10675`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L863" href="#L863">863</a><span class="code-text">- Further protection against programs which crash and leave the terminal in an inconsistent state (:issue:`10834`, :issue:`11038`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L864" href="#L864">864</a><span class="code-text">- A workaround for git being very slow on macOS has been applied, improving performance after a fresh boot (:issue:`10535`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L865" href="#L865">865</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L866" href="#L866">866</a><span class="code-text">New or improved bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L867" href="#L867">867</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L868" href="#L868">868</a><span class="code-text">- When the cursor is on a command that resolves to an executable script, :kbd:`alt-o` will now open that script in your editor (:issue:`10266`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L869" href="#L869">869</a><span class="code-text">- During up-arrow history search, :kbd:`shift-delete` will delete the current search item and move to the next older item. Previously this was only supported in the history pager.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L870" href="#L870">870</a><span class="code-text">- :kbd:`shift-delete` will also remove the currently-displayed autosuggestion from history, and remove it as a suggestion.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L871" href="#L871">871</a><span class="code-text">- :kbd:`ctrl-Z` (also known as :kbd:`ctrl-shift-z`) is now bound to redo.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L872" href="#L872">872</a><span class="code-text">- Some improvements to the :kbd:`alt-e` binding which edits the command line in an external editor:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L873" href="#L873">873</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L874" href="#L874">874</a><span class="code-text">  - The editor's cursor position is copied back to fish. This is currently supported for Vim and Kakoune.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L875" href="#L875">875</a><span class="code-text">  - Cursor position synchronization is only supported for a set of known editors, which are now also detected in aliases which use ``complete --wraps``. For example, use ``complete --wraps my-vim vim`` to synchronize cursors when ``EDITOR=my-vim``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L876" href="#L876">876</a><span class="code-text">  - Multiline commands are indented before being sent to the editor, which matches how they are displayed in fish.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L877" href="#L877">877</a><span class="code-text">- The ``...-path-component`` bindings, like ``backward-kill-path-component``, now treat ``#`` as part of a path component (:issue:`10271`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L878" href="#L878">878</a><span class="code-text">- Bindings like :kbd:`alt-l` that print output in between prompts now work correctly with multiline commandlines.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L879" href="#L879">879</a><span class="code-text">- :kbd:`alt-d` on an empty command line lists the directory history again. This restores the behavior of version 2.1.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L880" href="#L880">880</a><span class="code-text">- ``history-prefix-search-backward`` and ``-forward`` now maintain the cursor position, instead of moving the cursor to the end of the command line (:issue:`10430`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L881" href="#L881">881</a><span class="code-text">- The following keys have refined behavior if the terminal supports :ref:`the new keyboard encodings &lt;changelog-4.0-new-bindings&gt;`:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L882" href="#L882">882</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L883" href="#L883">883</a><span class="code-text">  - :kbd:`shift-enter` now inserts a newline instead of executing the command line.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L884" href="#L884">884</a><span class="code-text">  - :kbd:`ctrl-backspace` now deletes the last word instead of only one character (:issue:`10741`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L885" href="#L885">885</a><span class="code-text">  - :kbd:`ctrl-delete` deletes the next word (same as :kbd:`alt-d`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L886" href="#L886">886</a><span class="code-text">- New special input functions:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L887" href="#L887">887</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L888" href="#L888">888</a><span class="code-text">  - ``forward-char-passive`` and ``backward-char-passive`` are like their non-passive variants but do not accept autosuggestions or move focus in the completion pager (:issue:`10398`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L889" href="#L889">889</a><span class="code-text">  - ``forward-token``, ``backward-token``, ``kill-token``, and ``backward-kill-token`` are similar to the ``*-bigword`` variants but for the whole argument token (which includes escaped spaces) (:issue:`2014`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L890" href="#L890">890</a><span class="code-text">  - ``clear-commandline``, which merely clears the command line, as an alternative to ``cancel-commandline`` which prints ``^C`` and a new prompt (:issue:`10213`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L891" href="#L891">891</a><span class="code-text">- The ``accept-autosuggestion`` special input function now returns false when there was nothing to accept (:issue:`10608`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L892" href="#L892">892</a><span class="code-text">- Vi mode has seen some improvements but continues to suffer from the lack of people working on it.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L893" href="#L893">893</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L894" href="#L894">894</a><span class="code-text">  - New default cursor shapes for insert and replace mode.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L895" href="#L895">895</a><span class="code-text">  - :kbd:`ctrl-n` in insert mode accepts autosuggestions (:issue:`10339`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L896" href="#L896">896</a><span class="code-text">  - Outside insert mode, the cursor will no longer be placed beyond the last character on the commandline.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L897" href="#L897">897</a><span class="code-text">  - When the cursor is at the end of the commandline, a single :kbd:`l` will accept an autosuggestion (:issue:`10286`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L898" href="#L898">898</a><span class="code-text">  - The cursor position after pasting (:kbd:`p`) has been corrected.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L899" href="#L899">899</a><span class="code-text">  - Added an additional binding, :kbd:`_`, for moving to the beginning of the line (:issue:`10720`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L900" href="#L900">900</a><span class="code-text">  - When the cursor is at the start of a line, escaping from insert mode no longer moves the cursor to the previous line.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L901" href="#L901">901</a><span class="code-text">  - Added bindings for clipboard interaction, like :kbd:`&quot;,+,p` and :kbd:`&quot;,+,y,y`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L902" href="#L902">902</a><span class="code-text">  - Deleting in visual mode now moves the cursor back, matching vi (:issue:`10394`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L903" href="#L903">903</a><span class="code-text">  - The :kbd:`;`, :kbd:`,`, :kbd:`v`, :kbd:`V`, :kbd:`I`, and :kbd:`gU` bindings work in visual mode (:issue:`10601`, :issue:`10648`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L904" href="#L904">904</a><span class="code-text">  - Support :kbd:`%` motion (:issue:`10593`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L905" href="#L905">905</a><span class="code-text">  - :kbd:`ctrl-k` to remove the contents of the line beyond the cursor in all modes (:issue:`10648`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L906" href="#L906">906</a><span class="code-text">  - Support `ab` and `ib` vi text objects. New input functions are introduced ``jump-{to,till}-matching-bracket`` (:issue:`1842`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L907" href="#L907">907</a><span class="code-text">  - The :kbd:`E` binding now correctly handles the last character of the word, by jumping to the next word (:issue:`9700`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L908" href="#L908">908</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L909" href="#L909">909</a><span class="code-text">Completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L910" href="#L910">910</a><span class="code-text">^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L911" href="#L911">911</a><span class="code-text">- Command-specific tab completions may now offer results whose first character is a period. For example, it is now possible to tab-complete ``git add`` for files with leading periods. The default file completions hide these files, unless the token itself has a leading period (:issue:`3707`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L912" href="#L912">912</a><span class="code-text">- Option completion now uses fuzzy subsequence filtering, just like non-option completion (:issue:`830`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L913" href="#L913">913</a><span class="code-text">  This means that ``--fb`` may be completed to ``--foobar`` if there is no better match.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L914" href="#L914">914</a><span class="code-text">- Completions that insert an entire token now use quotes instead of backslashes to escape special characters (:issue:`5433`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L915" href="#L915">915</a><span class="code-text">- Normally, file name completions start after the last ``:``  or ``=`` in a token.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L916" href="#L916">916</a><span class="code-text">  This helps commands like ``rsync --files-from=``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L917" href="#L917">917</a><span class="code-text">  This special meaning can now disabled by escaping these separators as ``\:`` and ``\=``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L918" href="#L918">918</a><span class="code-text">  This matches Bash's behavior.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L919" href="#L919">919</a><span class="code-text">  Note that this escaping is usually not necessary since the completion engine already tries</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L920" href="#L920">920</a><span class="code-text">  to guess whether the separator is actually part of a file name.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L921" href="#L921">921</a><span class="code-text">- Various new completion scripts and numerous updates to existing ones.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L922" href="#L922">922</a><span class="code-text">- Completions could hang if the ``PAGER`` environment variable was sent to certain editors on macOS, FreeBSD and some other platforms. This has been fixed (:issue:`10820`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L923" href="#L923">923</a><span class="code-text">- Generated completions are now stored in ``$XDG_CACHE_HOME/fish`` or ``~/.cache/fish`` by default (:issue:`10369`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L924" href="#L924">924</a><span class="code-text">- A regression in fish 3.1, where completing a command line could change it completely, has been fixed (:issue:`10904`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L925" href="#L925">925</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L926" href="#L926">926</a><span class="code-text">Improved terminal support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L927" href="#L927">927</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L928" href="#L928">928</a><span class="code-text">- fish now marks the prompt and command-output regions (via OSC 133) to enable terminal shell integration (:issue:`10352`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L929" href="#L929">929</a><span class="code-text">  Shell integration shortcuts can scroll to the next/previous prompt or show the last command output in a pager.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L930" href="#L930">930</a><span class="code-text">- fish now reports the working directory (via OSC 7) unconditionally instead of only for some terminals (:issue:`9955`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L931" href="#L931">931</a><span class="code-text">- fish now sets the terminal window title (via OSC 0) unconditionally instead of only for some terminals (:issue:`10037`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L932" href="#L932">932</a><span class="code-text">- Focus reporting in tmux is no longer disabled on the first prompt.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L933" href="#L933">933</a><span class="code-text">- Focus reporting is now disabled during commands run inside key bindings (:issue:`6942`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L934" href="#L934">934</a><span class="code-text">- Cursor changes are applied to all terminals that support them, and the list of specifically-supported terminals has been removed (:issue:`10693`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L935" href="#L935">935</a><span class="code-text">- If it cannot find the terminfo entry given by :envvar:`TERM` environment variable, fish will now use an included ``xterm-256color`` definition to match the vast majority of current terminal emulators (:issue:`10905`). If you need to have a specific terminfo profile for your terminal's ``TERM`` variable, install it into the terminfo database.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L936" href="#L936">936</a><span class="code-text">- Further improvements to the correct display of prompts which fill the width of the terminal (:issue:`8164`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L937" href="#L937">937</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L938" href="#L938">938</a><span class="code-text">Other improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L939" href="#L939">939</a><span class="code-text">------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L940" href="#L940">940</a><span class="code-text">- ``status`` gained a ``build-info`` subcommand, to print information on how fish was built, to help with debugging (:issue:`10896`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L941" href="#L941">941</a><span class="code-text">- ``fish_indent`` will now collapse multiple empty lines into one (:issue:`10325`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L942" href="#L942">942</a><span class="code-text">- ``fish_indent`` now preserves the modification time of files if there were no changes (:issue:`10624`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L943" href="#L943">943</a><span class="code-text">- Performance in launching external processes has been improved for many cases (:issue:`10869`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L944" href="#L944">944</a><span class="code-text">- Performance and interactivity under Windows Subsystem for Linux has been improved, with a workaround for Windows-specific locations being appended to ``$PATH`` by default (:issue:`10506`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L945" href="#L945">945</a><span class="code-text">- On macOS, paths from ``/etc/paths`` and ``/etc/manpaths`` containing colons are handled correctly (:issue:`10684`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L946" href="#L946">946</a><span class="code-text">- Additional filesystems such as AFS are properly detected as remote, which avoids certain hangs due to expensive filesystem locks (:issue:`10818`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L947" href="#L947">947</a><span class="code-text">- A spurious error when launching multiple instances of fish for the first time has been removed (:issue:`10813`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L948" href="#L948">948</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L949" href="#L949">949</a><span class="code-text">.. _rust-packaging:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L950" href="#L950">950</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L951" href="#L951">951</a><span class="code-text">For distributors</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L952" href="#L952">952</a><span class="code-text">----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L953" href="#L953">953</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L954" href="#L954">954</a><span class="code-text">fish has been ported to Rust. This means a significant change in dependencies, which are listed in the README. In short, Rust 1.70 or greater is required, and a C++ compiler is no longer needed (although a C compiler is still required, for some C glue code and the tests).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L955" href="#L955">955</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L956" href="#L956">956</a><span class="code-text">CMake remains the recommended build system, because of cargo's limited support for installing support files. Version 3.5 remains the minimum supported version. The Xcode generator for CMake is not supported any longer (:issue:`9924`). CMake builds default to optimized release builds (:issue:`10799`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L957" href="#L957">957</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L958" href="#L958">958</a><span class="code-text">fish no longer depends on the ncurses library, but still uses a terminfo database. When packaging fish, please add a dependency on the package containing your terminfo database instead of curses.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L959" href="#L959">959</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L960" href="#L960">960</a><span class="code-text">The ``test`` target was removed as it can no longer be defined in new CMake versions. Use ``make fish_run_tests``. Any existing test target will not print output if it fails (:issue:`11116`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L961" href="#L961">961</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L962" href="#L962">962</a><span class="code-text">The Web-based configuration has been rewritten to use Alpine.js (:issue:`9554`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L963" href="#L963">963</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L964" href="#L964">964</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L965" href="#L965">965</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L966" href="#L966">966</a><span class="code-text">fish 4.0b1 (released December 17, 2024)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L967" href="#L967">967</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L968" href="#L968">968</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L969" href="#L969">969</a><span class="code-text">A number of improvements were included in fish 4.0.0 following the beta release of 4.0b1. These include fixes for regressions, improvements to completions and documentation, and the removal of a small number of problematic changes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L970" href="#L970">970</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L971" href="#L971">971</a><span class="code-text">The full list of fixed issues can be found on the `GitHub milestone page for 4.0-final &lt;https://github.com/fish-shell/fish-shell/milestone/43&gt;`_.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L972" href="#L972">972</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L973" href="#L973">973</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L974" href="#L974">974</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L975" href="#L975">975</a><span class="code-text">fish 3.7.1 (released March 19, 2024)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L976" href="#L976">976</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L977" href="#L977">977</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L978" href="#L978">978</a><span class="code-text">This release of fish fixes the following problems identified in fish 3.7.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L979" href="#L979">979</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L980" href="#L980">980</a><span class="code-text">- Deleting the last history entry via ``history delete`` works again (:issue:`10190`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L981" href="#L981">981</a><span class="code-text">- Wildcards (``*``) will no longer sometimes generate paths that did not exist (:issue:`10205`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L982" href="#L982">982</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L983" href="#L983">983</a><span class="code-text">This release also contains some improvements:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L984" href="#L984">984</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L985" href="#L985">985</a><span class="code-text">- A crash when trying to run an ELF program with a missing interpreter has been fixed. This crashed in the process after fork, so did not affect the fish process that tried to start the program (:issue:`10199`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L986" href="#L986">986</a><span class="code-text">- ``funced`` will now always ``source`` the file after it has written it, even if the contents did not change. This prevents issues if the file was otherwise modified (:issue:`10318`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L987" href="#L987">987</a><span class="code-text">- The warning for when a builtin returns a negative exit code was improved, now mentioning the original status (:issue:`10187`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L988" href="#L988">988</a><span class="code-text">- Added completions for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L989" href="#L989">989</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L990" href="#L990">990</a><span class="code-text">  - ``cobra-cli`` (:issue:`10293`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L991" href="#L991">991</a><span class="code-text">  - ``dmidecode`` (:issue:`10368`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L992" href="#L992">992</a><span class="code-text">  - ``mycli`` (:issue:`10309`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L993" href="#L993">993</a><span class="code-text">  - ``ollama`` (:issue:`10327`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L994" href="#L994">994</a><span class="code-text">  - ``pstree`` (:issue:`10317`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L995" href="#L995">995</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L996" href="#L996">996</a><span class="code-text">- Some improvements to documentation and completions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L997" href="#L997">997</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L998" href="#L998">998</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L999" href="#L999">999</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1000" href="#L1000">1000</a><span class="code-text">fish 3.7.0 (released January 1, 2024)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1001" href="#L1001">1001</a><span class="code-text">=====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1002" href="#L1002">1002</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1003" href="#L1003">1003</a><span class="code-text">This release of fish includes a number of improvements over fish 3.6.4, detailed below. Although work continues on the porting of fish internals to the Rust programming language, that work is not included in this release. fish 3.7.0 and any future releases in the 3.7 series remain C++ programs.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1004" href="#L1004">1004</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1005" href="#L1005">1005</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1006" href="#L1006">1006</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1007" href="#L1007">1007</a><span class="code-text">- Improvements to the history pager, including:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1008" href="#L1008">1008</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1009" href="#L1009">1009</a><span class="code-text">  - The history pager will now also attempt subsequence matches (:issue:`9476`), so you can find a command line like ``git log 3.6.1..Integration_3.7.0`` by searching for ``gitInt``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1010" href="#L1010">1010</a><span class="code-text">  - Opening the history pager will now fill the search field with a search string if you're already in a search (:issue:`10005`). This makes it nicer to search something with :kbd:`up` and then later decide to switch to the full pager.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1011" href="#L1011">1011</a><span class="code-text">  - Closing the history pager with enter will now copy the search text to the commandline if there was no match, so you can continue editing the command you tried to find right away (:issue:`9934`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1012" href="#L1012">1012</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1013" href="#L1013">1013</a><span class="code-text">- Performance improvements for command completions and globbing, where supported by the operating system, especially on slow filesystems such as NFS (:issue:`9891`, :issue:`9931`, :issue:`10032`, :issue:`10052`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1014" href="#L1014">1014</a><span class="code-text">- fish can now be configured to wait a specified amount of time for a multi-key sequence to be completed,  instead of waiting indefinitely. For example, this makes binding ``kj`` to switching modes in vi mode possible.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1015" href="#L1015">1015</a><span class="code-text">  The timeout can be set via the new :envvar:`fish_sequence_key_delay_ms` variable (:issue:`7401`), and may be set by default in future versions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1016" href="#L1016">1016</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1017" href="#L1017">1017</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1018" href="#L1018">1018</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1019" href="#L1019">1019</a><span class="code-text">- ``LS_COLORS`` is no longer set automatically by the ``ls`` function (:issue:`10080`). Users</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1020" href="#L1020">1020</a><span class="code-text">  that set ``.dircolors`` should manually import it using other means. Typically this would be ``set -gx LS_COLORS (dircolors -c .dircolors | string split ' ')[3]``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1021" href="#L1021">1021</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1022" href="#L1022">1022</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1023" href="#L1023">1023</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1024" href="#L1024">1024</a><span class="code-text">- Running ``exit`` with a negative number no longer crashes fish (:issue:`9659`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1025" href="#L1025">1025</a><span class="code-text">- ``fish --command`` will now return a non-zero status if parsing failed (:issue:`9888`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1026" href="#L1026">1026</a><span class="code-text">- The ``jobs`` builtin will now escape the commands it prints (:issue:`9808`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1027" href="#L1027">1027</a><span class="code-text">- ``string repeat`` no longer overflows if the count is a multiple of the chunk size (:issue:`9900`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1028" href="#L1028">1028</a><span class="code-text">- The ``builtin`` builtin will now properly error out with invalid arguments instead of doing nothing and returning true (:issue:`9942`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1029" href="#L1029">1029</a><span class="code-text">- ``command time`` in a pipeline is allowed again, as is ``command and`` and ``command or`` (:issue:`9985`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1030" href="#L1030">1030</a><span class="code-text">- ``exec`` will now also apply variable overrides, so ``FOO=bar exec`` will now set ``$FOO`` correctly (:issue:`9995`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1031" href="#L1031">1031</a><span class="code-text">- ``umask`` will now handle empty symbolic modes correctly, like ``umask u=,g=rwx,o=`` (:issue:`10177`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1032" href="#L1032">1032</a><span class="code-text">- Improved error messages for errors occurring in command substitutions (:issue:`10054`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1033" href="#L1033">1033</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1034" href="#L1034">1034</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1035" href="#L1035">1035</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1036" href="#L1036">1036</a><span class="code-text">- ``read`` no longer enables bracketed paste so it doesn't stay enabled in combined commandlines like ``mysql -p(read --silent)`` (:issue:`8285`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1037" href="#L1037">1037</a><span class="code-text">- Vi mode now uses :envvar:`fish_cursor_external` to set the cursor shape for external commands (:issue:`4656`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1038" href="#L1038">1038</a><span class="code-text">- Opening the history search in vi mode switches to insert mode correctly (:issue:`10141`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1039" href="#L1039">1039</a><span class="code-text">- Vi mode cursor shaping is now enabled in iTerm2 (:issue:`9698`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1040" href="#L1040">1040</a><span class="code-text">- Completing commands as root includes commands not owned by root, fixing a regression introduced in fish 3.2.0 (:issue:`9699`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1041" href="#L1041">1041</a><span class="code-text">- Selection uses ``fish_color_selection`` for the foreground and background colors, as intended, rather than just the background (:issue:`9717`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1042" href="#L1042">1042</a><span class="code-text">- The completion pager will no longer sometimes skip the last entry when moving through a long list (:issue:`9833`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1043" href="#L1043">1043</a><span class="code-text">- The interactive ``history delete`` interface now allows specifying index ranges like &quot;1..5&quot; (:issue:`9736`), and ``history delete --exact`` now properly saves the history (:issue:`10066`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1044" href="#L1044">1044</a><span class="code-text">- Command completion will now call the stock ``manpath`` on macOS, instead of a potential Homebrew version. This prevents awkward error messages (:issue:`9817`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1045" href="#L1045">1045</a><span class="code-text">- the ``redo`` special input function restores the pre-undo cursor position.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1046" href="#L1046">1046</a><span class="code-text">- A new bind function ``history-pager-delete``, bound to :kbd:`shift-delete` by default, will delete the currently-selected history pager item from history (:issue:`9454`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1047" href="#L1047">1047</a><span class="code-text">- ``fish_key_reader`` will now use printable characters as-is, so pressing &quot;ö&quot; no longer leads to it telling you to bind ``\u00F6`` (:issue:`9986`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1048" href="#L1048">1048</a><span class="code-text">- ``open`` can be used to launch terminal programs again, as an ``xdg-open`` bug has been fixed and a workaround has been removed  (:issue:`10045`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1049" href="#L1049">1049</a><span class="code-text">- The ``repaint-mode`` binding will now only move the cursor if there is repainting to be done. This fixes :kbd:`alt` combination bindings in vi mode (:issue:`7910`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1050" href="#L1050">1050</a><span class="code-text">- A new ``clear-screen`` bind function is used for :kbd:`ctrl-l` by default. This clears the screen and repaints the existing prompt at first,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1051" href="#L1051">1051</a><span class="code-text">  so it eliminates visible flicker unless the terminal is very slow (:issue:`10044`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1052" href="#L1052">1052</a><span class="code-text">- The ``alias`` convenience function has better support for commands with unusual characters, like ``+`` (:issue:`8720`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1053" href="#L1053">1053</a><span class="code-text">- A longstanding issue where items in the pager would sometimes display without proper formatting has been fixed (:issue:`9617`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1054" href="#L1054">1054</a><span class="code-text">- The :kbd:`alt-l` binding, which lists the directory of the token under the cursor, correctly expands tilde (``~``) to the home directory (:issue:`9954`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1055" href="#L1055">1055</a><span class="code-text">- Various fish utilities that use an external pager will now try a selection of common pagers if the :envvar:`PAGER` environment variable is not set, or write the output to the screen without a pager if there is not one available (:issue:`10074`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1056" href="#L1056">1056</a><span class="code-text">- Command-specific tab completions may now offer results whose first character is a period. For example, it is now possible to tab-complete ``git add`` for files with leading periods. The default file completions hide these files, unless the token itself has a leading period (:issue:`3707`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1057" href="#L1057">1057</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1058" href="#L1058">1058</a><span class="code-text">Improved prompts</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1059" href="#L1059">1059</a><span class="code-text">^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1060" href="#L1060">1060</a><span class="code-text">- The default theme now only uses named colors, so it will track the terminal's palette (:issue:`9913`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1061" href="#L1061">1061</a><span class="code-text">- The Dracula theme has now been synced with upstream (:issue:`9807`); use ``fish_config`` to re-apply it to pick up the changes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1062" href="#L1062">1062</a><span class="code-text">- ``fish_vcs_prompt`` now also supports fossil (:issue:`9497`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1063" href="#L1063">1063</a><span class="code-text">- Prompts which display the working directory using the ``prompt_pwd`` function correctly display directories beginning with dashes (:issue:`10169`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1064" href="#L1064">1064</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1065" href="#L1065">1065</a><span class="code-text">Completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1066" href="#L1066">1066</a><span class="code-text">^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1067" href="#L1067">1067</a><span class="code-text">- Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1068" href="#L1068">1068</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1069" href="#L1069">1069</a><span class="code-text">  - ``age`` and ``age-keygen`` (:issue:`9813`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1070" href="#L1070">1070</a><span class="code-text">  - ``airmon-ng`` (:issue:`10116`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1071" href="#L1071">1071</a><span class="code-text">  - ``ar`` (:issue:`9720`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1072" href="#L1072">1072</a><span class="code-text">  - ``blender`` (:issue:`9905`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1073" href="#L1073">1073</a><span class="code-text">  - ``bws`` (:issue:`10165`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1074" href="#L1074">1074</a><span class="code-text">  - ``calendar`` (:issue:`10138`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1075" href="#L1075">1075</a><span class="code-text">  - ``checkinstall`` (:issue:`10106`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1076" href="#L1076">1076</a><span class="code-text">  - ``crc`` (:issue:`10034`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1077" href="#L1077">1077</a><span class="code-text">  - ``doctl``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1078" href="#L1078">1078</a><span class="code-text">  - ``gimp`` (:issue:`9904`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1079" href="#L1079">1079</a><span class="code-text">  - ``gojq`` (:issue:`9740`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1080" href="#L1080">1080</a><span class="code-text">  - ``horcrux`` (:issue:`9922`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1081" href="#L1081">1081</a><span class="code-text">  - ``ibmcloud`` (:issue:`10004`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1082" href="#L1082">1082</a><span class="code-text">  - ``iwctl`` (:issue:`6884`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1083" href="#L1083">1083</a><span class="code-text">  - ``java_home`` (:issue:`9998`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1084" href="#L1084">1084</a><span class="code-text">  - ``krita`` (:issue:`9903`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1085" href="#L1085">1085</a><span class="code-text">  - ``oc`` (:issue:`10034`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1086" href="#L1086">1086</a><span class="code-text">  - ``qjs`` (:issue:`9723`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1087" href="#L1087">1087</a><span class="code-text">  - ``qjsc`` (:issue:`9731`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1088" href="#L1088">1088</a><span class="code-text">  - ``rename`` (:issue:`10136`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1089" href="#L1089">1089</a><span class="code-text">  - ``rpm-ostool`` (:issue:`9669`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1090" href="#L1090">1090</a><span class="code-text">  - ``smerge`` (:issue:`10135`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1091" href="#L1091">1091</a><span class="code-text">  - ``userdel`` (:issue:`10056`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1092" href="#L1092">1092</a><span class="code-text">  - ``watchexec`` (:issue:`10027`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1093" href="#L1093">1093</a><span class="code-text">  - ``wpctl`` (:issue:`10043`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1094" href="#L1094">1094</a><span class="code-text">  - ``xxd`` (:issue:`10137`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1095" href="#L1095">1095</a><span class="code-text">  - ``zabbix`` (:issue:`9647`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1096" href="#L1096">1096</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1097" href="#L1097">1097</a><span class="code-text">- The ``zfs`` completions no longer print errors about setting a read-only variable (:issue:`9705`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1098" href="#L1098">1098</a><span class="code-text">- The ``kitty`` completions have been removed in favor of keeping them upstream (:issue:`9750`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1099" href="#L1099">1099</a><span class="code-text">- ``git`` completions now support aliases that reference other aliases (:issue:`9992`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1100" href="#L1100">1100</a><span class="code-text">- The ``gw`` and ``gradlew`` completions are loaded properly (:issue:`10127`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1101" href="#L1101">1101</a><span class="code-text">- Improvements to many other completions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1102" href="#L1102">1102</a><span class="code-text">- Improvements to the manual page completion generator (:issue:`9787`, :issue:`9814`, :issue:`9961`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1103" href="#L1103">1103</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1104" href="#L1104">1104</a><span class="code-text">Other improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1105" href="#L1105">1105</a><span class="code-text">------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1106" href="#L1106">1106</a><span class="code-text">- Improvements and corrections to the documentation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1107" href="#L1107">1107</a><span class="code-text">- The Web-based configuration now uses a more readable style when printed, such as for a keybinding reference (:issue:`9828`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1108" href="#L1108">1108</a><span class="code-text">- Updates to the German translations (:issue:`9824`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1109" href="#L1109">1109</a><span class="code-text">- The colors of the Nord theme better match their official style (:issue:`10168`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1110" href="#L1110">1110</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1111" href="#L1111">1111</a><span class="code-text">For distributors</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1112" href="#L1112">1112</a><span class="code-text">----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1113" href="#L1113">1113</a><span class="code-text">- The licensing information for some of the derived code distributed with fish was incomplete. Though the license information was present in the source distribution, it was not present in the documentation. This has been corrected (:issue:`10162`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1114" href="#L1114">1114</a><span class="code-text">- The CMake configure step will now also look for libterminfo as an alternative name for libtinfo, as used in NetBSD curses (:issue:`9794`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1115" href="#L1115">1115</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1116" href="#L1116">1116</a><span class="code-text">----</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1117" href="#L1117">1117</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1118" href="#L1118">1118</a><span class="code-text">fish 3.6.4 (released December 5, 2023)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1119" href="#L1119">1119</a><span class="code-text">======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1120" href="#L1120">1120</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1121" href="#L1121">1121</a><span class="code-text">This release contains a complete fix for the test suite failure in fish 3.6.2 and 3.6.3.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1122" href="#L1122">1122</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1123" href="#L1123">1123</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1124" href="#L1124">1124</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1125" href="#L1125">1125</a><span class="code-text">fish 3.6.3 (released December 4, 2023)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1126" href="#L1126">1126</a><span class="code-text">======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1127" href="#L1127">1127</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1128" href="#L1128">1128</a><span class="code-text">This release contains a fix for a test suite failure in fish 3.6.2.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1129" href="#L1129">1129</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1130" href="#L1130">1130</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1131" href="#L1131">1131</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1132" href="#L1132">1132</a><span class="code-text">fish 3.6.2 (released December 4, 2023)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1133" href="#L1133">1133</a><span class="code-text">======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1134" href="#L1134">1134</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1135" href="#L1135">1135</a><span class="code-text">This release of fish contains a security fix for CVE-2023-49284, a minor security problem identified</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1136" href="#L1136">1136</a><span class="code-text">in fish 3.6.1 and previous versions (thought to affect all released versions of fish).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1137" href="#L1137">1137</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1138" href="#L1138">1138</a><span class="code-text">fish uses certain Unicode non-characters internally for marking wildcards and expansions. It</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1139" href="#L1139">1139</a><span class="code-text">incorrectly allowed these markers to be read on command substitution output, rather than</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1140" href="#L1140">1140</a><span class="code-text">transforming them into a safe internal representation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1141" href="#L1141">1141</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1142" href="#L1142">1142</a><span class="code-text">For example, ``echo \UFDD2HOME`` has the same output as ``echo $HOME``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1143" href="#L1143">1143</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1144" href="#L1144">1144</a><span class="code-text">While this may cause unexpected behavior with direct input, this may become a minor security problem</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1145" href="#L1145">1145</a><span class="code-text">if the output is being fed from an external program into a command substitution where this output</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1146" href="#L1146">1146</a><span class="code-text">may not be expected.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1147" href="#L1147">1147</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1148" href="#L1148">1148</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1149" href="#L1149">1149</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1150" href="#L1150">1150</a><span class="code-text">fish 3.6.1 (released March 25, 2023)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1151" href="#L1151">1151</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1152" href="#L1152">1152</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1153" href="#L1153">1153</a><span class="code-text">This release of fish contains a number of fixes for problems identified in fish 3.6.1, as well as some enhancements.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1154" href="#L1154">1154</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1155" href="#L1155">1155</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1156" href="#L1156">1156</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1157" href="#L1157">1157</a><span class="code-text">- ``abbr --erase`` now also erases the universal variables used by the old abbr function. That means::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1158" href="#L1158">1158</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1159" href="#L1159">1159</a><span class="code-text">    abbr --erase (abbr --list)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1160" href="#L1160">1160</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1161" href="#L1161">1161</a><span class="code-text">  can now be used to clean out all old abbreviations (:issue:`9468`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1162" href="#L1162">1162</a><span class="code-text">- ``abbr --add --universal`` now warns about ``--universal`` being non-functional, to make it easier to detect old-style ``abbr`` calls (:issue:`9475`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1163" href="#L1163">1163</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1164" href="#L1164">1164</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1165" href="#L1165">1165</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1166" href="#L1166">1166</a><span class="code-text">- The Web-based configuration for abbreviations has been removed, as it was not functional with the changes abbreviations introduced in 3.6.0 (:issue:`9460`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1167" href="#L1167">1167</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1168" href="#L1168">1168</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1169" href="#L1169">1169</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1170" href="#L1170">1170</a><span class="code-text">- ``abbr --list`` no longer escapes the abbr name, which is necessary to be able to pass it to ``abbr --erase`` (:issue:`9470`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1171" href="#L1171">1171</a><span class="code-text">- ``read`` will now print an error if told to set a read-only variable, instead of silently doing nothing (:issue:`9346`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1172" href="#L1172">1172</a><span class="code-text">- ``set_color -v`` no longer crashes fish (:issue:`9640`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1173" href="#L1173">1173</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1174" href="#L1174">1174</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1175" href="#L1175">1175</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1176" href="#L1176">1176</a><span class="code-text">- Using ``fish_vi_key_bindings`` in combination with fish's ``--no-config`` mode works without locking up the shell (:issue:`9443`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1177" href="#L1177">1177</a><span class="code-text">- The history pager now uses more screen space, usually half the screen (:issue:`9458`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1178" href="#L1178">1178</a><span class="code-text">- Variables that were set while the locale was C (the default ASCII-only locale) will now properly be encoded if the locale is switched (:issue:`2613`, :issue:`9473`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1179" href="#L1179">1179</a><span class="code-text">- Escape during history search restores the original command line again (fixing a regression in 3.6.0).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1180" href="#L1180">1180</a><span class="code-text">- Using ``--help`` on builtins now respects the ``$MANPAGER`` variable, in preference to ``$PAGER`` (:issue:`9488`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1181" href="#L1181">1181</a><span class="code-text">- :kbd:`ctrl-g` closes the history pager, like other shells (:issue:`9484`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1182" href="#L1182">1182</a><span class="code-text">- The documentation for the ``:``, ``[`` and ``.`` builtin commands can now be looked up with ``man`` (:issue:`9552`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1183" href="#L1183">1183</a><span class="code-text">- fish no longer crashes when searching history for non-ASCII codepoints case-insensitively (:issue:`9628`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1184" href="#L1184">1184</a><span class="code-text">- The :kbd:`alt-s` binding will now also use ``please`` if available (:issue:`9635`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1185" href="#L1185">1185</a><span class="code-text">- Themes that don't specify every color option can be installed correctly in the Web-based configuration (:issue:`9590`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1186" href="#L1186">1186</a><span class="code-text">- Compatibility with Midnight Commander's prompt integration has been improved (:issue:`9540`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1187" href="#L1187">1187</a><span class="code-text">- A spurious error, noted when using fish in Google Drive directories under WSL 2, has been silenced (:issue:`9550`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1188" href="#L1188">1188</a><span class="code-text">- Using ``read`` in ``fish_greeting`` or similar functions will not trigger an infinite loop (:issue:`9564`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1189" href="#L1189">1189</a><span class="code-text">- Compatibility when upgrading from old versions of fish (before 3.4.0) has been improved (:issue:`9569`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1190" href="#L1190">1190</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1191" href="#L1191">1191</a><span class="code-text">Improved prompts</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1192" href="#L1192">1192</a><span class="code-text">^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1193" href="#L1193">1193</a><span class="code-text">- The git prompt will compute the stash count to be used independently of the informative status (:issue:`9572`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1194" href="#L1194">1194</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1195" href="#L1195">1195</a><span class="code-text">Completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1196" href="#L1196">1196</a><span class="code-text">^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1197" href="#L1197">1197</a><span class="code-text">- Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1198" href="#L1198">1198</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1199" href="#L1199">1199</a><span class="code-text">  - ``apkanalyzer`` (:issue:`9558`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1200" href="#L1200">1200</a><span class="code-text">  - ``neovim`` (:issue:`9543`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1201" href="#L1201">1201</a><span class="code-text">  - ``otool``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1202" href="#L1202">1202</a><span class="code-text">  - ``pre-commit`` (:issue:`9521`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1203" href="#L1203">1203</a><span class="code-text">  - ``proxychains`` (:issue:`9486`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1204" href="#L1204">1204</a><span class="code-text">  - ``scrypt`` (:issue:`9583`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1205" href="#L1205">1205</a><span class="code-text">  - ``stow`` (:issue:`9571`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1206" href="#L1206">1206</a><span class="code-text">  - ``trash`` and helper utilities ``trash-empty``, ``trash-list``, ``trash-put``, ``trash-restore`` (:issue:`9560`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1207" href="#L1207">1207</a><span class="code-text">  - ``ssh-copy-id`` (:issue:`9675`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1208" href="#L1208">1208</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1209" href="#L1209">1209</a><span class="code-text">- Improvements to many completions, including the speed of completing directories in WSL 2 (:issue:`9574`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1210" href="#L1210">1210</a><span class="code-text">- Completions using ``__fish_complete_suffix`` are now offered in the correct order, fixing a regression in 3.6.0 (:issue:`8924`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1211" href="#L1211">1211</a><span class="code-text">- ``git`` completions for ``git-foo``-style commands was restored, fixing a regression in 3.6.0 (:issue:`9457`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1212" href="#L1212">1212</a><span class="code-text">- File completion now offers ``../`` and ``./`` again, fixing a regression in 3.6.0 (:issue:`9477`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1213" href="#L1213">1213</a><span class="code-text">- The behaviour of completions using ``__fish_complete_path`` matches standard path completions (:issue:`9285`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1214" href="#L1214">1214</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1215" href="#L1215">1215</a><span class="code-text">Other improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1216" href="#L1216">1216</a><span class="code-text">------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1217" href="#L1217">1217</a><span class="code-text">- Improvements and corrections to the documentation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1218" href="#L1218">1218</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1219" href="#L1219">1219</a><span class="code-text">For distributors</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1220" href="#L1220">1220</a><span class="code-text">----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1221" href="#L1221">1221</a><span class="code-text">- fish 3.6.1 builds correctly on Cygwin (:issue:`9502`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1222" href="#L1222">1222</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1223" href="#L1223">1223</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1224" href="#L1224">1224</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1225" href="#L1225">1225</a><span class="code-text">fish 3.6.0 (released January 7, 2023)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1226" href="#L1226">1226</a><span class="code-text">=====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1227" href="#L1227">1227</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1228" href="#L1228">1228</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1229" href="#L1229">1229</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1230" href="#L1230">1230</a><span class="code-text">- By default, :kbd:`ctrl-r` now opens the command history in the pager (:issue:`602`). This is fully searchable and syntax-highlighted, as an alternative to the incremental search seen in other shells. The new special input function ``history-pager`` has been added for custom bindings.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1231" href="#L1231">1231</a><span class="code-text">- Abbreviations are more flexible (:issue:`9313`, :issue:`5003`, :issue:`2287`):</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1232" href="#L1232">1232</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1233" href="#L1233">1233</a><span class="code-text">  - They may optionally replace tokens anywhere on the command line, instead of only commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1234" href="#L1234">1234</a><span class="code-text">  - Matching tokens may be described using a regular expression instead of a literal word</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1235" href="#L1235">1235</a><span class="code-text">  - The replacement text may be produced by a fish function, instead of a literal word</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1236" href="#L1236">1236</a><span class="code-text">  - They may position the cursor anywhere in the expansion, instead of at the end</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1237" href="#L1237">1237</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1238" href="#L1238">1238</a><span class="code-text">  For example::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1239" href="#L1239">1239</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1240" href="#L1240">1240</a><span class="code-text">    function multicd</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1241" href="#L1241">1241</a><span class="code-text">        echo cd (string repeat -n (math (string length -- $argv[1]) - 1) ../)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1242" href="#L1242">1242</a><span class="code-text">    end</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1243" href="#L1243">1243</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1244" href="#L1244">1244</a><span class="code-text">    abbr --add dotdot --regex '^\.\.+$' --function multicd</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1245" href="#L1245">1245</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1246" href="#L1246">1246</a><span class="code-text">  This expands ``..`` to ``cd ../``, ``...`` to ``cd ../../`` and ``....`` to ``cd ../../../`` and so on.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1247" href="#L1247">1247</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1248" href="#L1248">1248</a><span class="code-text">  Or::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1249" href="#L1249">1249</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1250" href="#L1250">1250</a><span class="code-text">    function last_history_item; echo $history[1]; end</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1251" href="#L1251">1251</a><span class="code-text">    abbr -a !! --position anywhere --function last_history_item</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1252" href="#L1252">1252</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1253" href="#L1253">1253</a><span class="code-text">  which expands ``!!`` to the last history item, anywhere on the command line, mimicking other shells' history expansion.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1254" href="#L1254">1254</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1255" href="#L1255">1255</a><span class="code-text">  See :doc:`the documentation &lt;cmds/abbr&gt;` for more.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1256" href="#L1256">1256</a><span class="code-text">- ``path`` gained a new ``mtime`` subcommand to print the modification time stamp for files. For example, this can be used to handle cache file ages (:issue:`9057`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1257" href="#L1257">1257</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1258" href="#L1258">1258</a><span class="code-text">    &gt; touch foo</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1259" href="#L1259">1259</a><span class="code-text">    &gt; sleep 10</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1260" href="#L1260">1260</a><span class="code-text">    &gt; path mtime --relative foo</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1261" href="#L1261">1261</a><span class="code-text">    10</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1262" href="#L1262">1262</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1263" href="#L1263">1263</a><span class="code-text">- ``string`` gained a new ``shorten`` subcommand to shorten strings to a given visible width (:issue:`9156`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1264" href="#L1264">1264</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1265" href="#L1265">1265</a><span class="code-text">    &gt; string shorten --max 10 &quot;Hello this is a long string&quot;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1266" href="#L1266">1266</a><span class="code-text">    Hello thi…</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1267" href="#L1267">1267</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1268" href="#L1268">1268</a><span class="code-text">- ``test`` (aka ``[``) gained ``-ot`` (older than) and ``-nt`` (newer than) operators to compare file modification times, and ``-ef`` to compare whether the arguments are the same file (:issue:`3589`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1269" href="#L1269">1269</a><span class="code-text">- fish will now mark the extent of many errors with a squiggly line, instead of just a caret (``^``) at the beginning (:issue:`9130`). For example::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1270" href="#L1270">1270</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1271" href="#L1271">1271</a><span class="code-text">    checks/set.fish (line 471): for: a,b: invalid variable name. See `help identifiers`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1272" href="#L1272">1272</a><span class="code-text">    for a,b in y 1 z 3</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1273" href="#L1273">1273</a><span class="code-text">        ^~^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1274" href="#L1274">1274</a><span class="code-text">- A new function, ``fish_delta``, shows changes that have been made in fish's configuration from the defaults (:issue:`9255`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1275" href="#L1275">1275</a><span class="code-text">- ``set --erase`` can now be used with multiple scopes at once, like ``set -efglU foo`` (:issue:`7711`, :issue:`9280`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1276" href="#L1276">1276</a><span class="code-text">- ``status`` gained a new subcommand, ``current-commandline``, which retrieves the entirety of the currently-executing command line when called from a function during execution. This allows easier job introspection (:issue:`8905`, :issue:`9296`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1277" href="#L1277">1277</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1278" href="#L1278">1278</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1279" href="#L1279">1279</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1280" href="#L1280">1280</a><span class="code-text">- The ``\x`` and ``\X`` escape syntax is now equivalent. ``\xAB`` previously behaved the same as ``\XAB``, except that it would error if the value &quot;AB&quot; was larger than &quot;7f&quot; (127 in decimal, the highest ASCII value) (:issue:`9247`, :issue:`9245`, :issue:`1352`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1281" href="#L1281">1281</a><span class="code-text">- The ``fish_git_prompt`` will now only turn on features if the appropriate variable has been set to a true value (of &quot;1&quot;, &quot;yes&quot; or &quot;true&quot;) instead of just checking if it is defined. This allows specifically turning features *off* without having to erase variables, such as via universal variables. If you have defined a variable to a different value and expect it to count as true, you need to change it (:issue:`9274`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1282" href="#L1282">1282</a><span class="code-text">  For example, ``set -g __fish_git_prompt_show_informative_status 0`` previously would have enabled informative status (because any value would have done so), but now it turns it off.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1283" href="#L1283">1283</a><span class="code-text">- Abbreviations are no longer stored in universal variables. Existing universal abbreviations are still imported, but new abbreviations should be added to ``config.fish``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1284" href="#L1284">1284</a><span class="code-text">- The short option ``-r`` for abbreviations has changed from ``rename`` to ``regex``, for consistency with ``string``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1285" href="#L1285">1285</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1286" href="#L1286">1286</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1287" href="#L1287">1287</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1288" href="#L1288">1288</a><span class="code-text">- ``argparse`` can now be used without option specifications, to allow using ``--min-args``, ``--max-args`` or for commands that take no options (but might in future) (:issue:`9006`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1289" href="#L1289">1289</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1290" href="#L1290">1290</a><span class="code-text">    function my_copy</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1291" href="#L1291">1291</a><span class="code-text">        argparse --min-args 2 -- $argv</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1292" href="#L1292">1292</a><span class="code-text">        or return</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1293" href="#L1293">1293</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1294" href="#L1294">1294</a><span class="code-text">        cp $argv</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1295" href="#L1295">1295</a><span class="code-text">    end</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1296" href="#L1296">1296</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1297" href="#L1297">1297</a><span class="code-text">- ``set --show`` now shows when a variable was inherited from fish's parent process, which should help with debugging (:issue:`9029`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1298" href="#L1298">1298</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1299" href="#L1299">1299</a><span class="code-text">    &gt; set --show XDG_DATA_DIRS</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1300" href="#L1300">1300</a><span class="code-text">    $XDG_DATA_DIRS: set in global scope, exported, a path variable with 4 elements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1301" href="#L1301">1301</a><span class="code-text">    $XDG_DATA_DIRS[1]: |/home/alfa/.local/share/flatpak/exports/share|</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1302" href="#L1302">1302</a><span class="code-text">    $XDG_DATA_DIRS[2]: |/var/lib/flatpak/exports/share|</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1303" href="#L1303">1303</a><span class="code-text">    $XDG_DATA_DIRS[3]: |/usr/local/share|</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1304" href="#L1304">1304</a><span class="code-text">    $XDG_DATA_DIRS[4]: |/usr/share|</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1305" href="#L1305">1305</a><span class="code-text">    $XDG_DATA_DIRS: originally inherited as |/home/alfa/.local/share/flatpak/exports/share:/var/lib/flatpak/exports/share:/usr/local/share/:/usr/share/|</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1306" href="#L1306">1306</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1307" href="#L1307">1307</a><span class="code-text">- The read limit is now restored to the default when :envvar:`fish_read_limit` is unset (:issue:`9129`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1308" href="#L1308">1308</a><span class="code-text">- ``math`` produces an error for division-by-zero, as well as augmenting some errors with their extent (:issue:`9190`). This changes behavior in some limited cases, such as::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1309" href="#L1309">1309</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1310" href="#L1310">1310</a><span class="code-text">    math min 1 / 0, 5</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1311" href="#L1311">1311</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1312" href="#L1312">1312</a><span class="code-text">  which would previously print &quot;5&quot; (because in floating point division &quot;1 / 0&quot; yields infinite, and 5 is smaller than infinite) but will now return an error.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1313" href="#L1313">1313</a><span class="code-text">- ``fish_clipboard_copy`` and ``fish_clipboard_paste`` can now be used in pipes (:issue:`9271`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1314" href="#L1314">1314</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1315" href="#L1315">1315</a><span class="code-text">    git rev-list 3.5.1 | fish_clipboard_copy</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1316" href="#L1316">1316</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1317" href="#L1317">1317</a><span class="code-text">    fish_clipboard_paste | string join + | math</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1318" href="#L1318">1318</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1319" href="#L1319">1319</a><span class="code-text">- ``status fish-path`` returns a fully-normalised path, particularly noticeable on NetBSD (:issue:`9085`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1320" href="#L1320">1320</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1321" href="#L1321">1321</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1322" href="#L1322">1322</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1323" href="#L1323">1323</a><span class="code-text">- If the terminal definition for :envvar:`TERM` can't be found, fish now tries using the &quot;xterm-256color&quot; and &quot;xterm&quot; definitions before &quot;ansi&quot; and &quot;dumb&quot;. As the majority of terminal emulators in common use are now more or less xterm-compatible (often even explicitly claiming the xterm-256color entry), this should often result in a fully or almost fully usable terminal (:issue:`9026`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1324" href="#L1324">1324</a><span class="code-text">- A new variable, :envvar:`fish_cursor_selection_mode`, can be used to configure whether the command line selection includes the character under the cursor (``inclusive``) or not (``exclusive``). The new default is ``exclusive``; use ``set fish_cursor_selection_mode inclusive`` to get the previous behavior back (:issue:`7762`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1325" href="#L1325">1325</a><span class="code-text">- fish's completion pager now fills half the terminal on first tab press instead of only 4 rows, which should make results visible more often and save key presses, without constantly snapping fish to the top of the terminal (:issue:`9105`, :issue:`2698`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1326" href="#L1326">1326</a><span class="code-text">- The ``complete-and-search`` binding, used with :kbd:`shift-tab` by default, selects the first item in the results immediately (:issue:`9080`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1327" href="#L1327">1327</a><span class="code-text">- ``bind`` output is now syntax-highlighted when used interactively.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1328" href="#L1328">1328</a><span class="code-text">- :kbd:`alt-h` (the default ``__fish_man_page`` binding) does a better job of showing the manual page of the command under cursor (:issue:`9020`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1329" href="#L1329">1329</a><span class="code-text">- If :envvar:`fish_color_valid_path` contains an actual color instead of just modifiers, those will be used for valid paths even if the underlying color isn't &quot;normal&quot; (:issue:`9159`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1330" href="#L1330">1330</a><span class="code-text">- The key combination for the QUIT terminal sequence, often :kbd:`ctrl-\\` (``\x1c``), can now be used as a binding (:issue:`9234`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1331" href="#L1331">1331</a><span class="code-text">- fish's vi mode uses normal xterm-style sequences to signal cursor change, instead of using the iTerm's proprietary escape sequences. This allows for a blinking cursor and makes it work in complicated scenarios with nested terminals. (:issue:`3741`, :issue:`9172`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1332" href="#L1332">1332</a><span class="code-text">- When running fish on a remote system (such as inside SSH or a container), :kbd:`ctrl-x` now copies to the local client system's clipboard if the terminal supports OSC 52.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1333" href="#L1333">1333</a><span class="code-text">- ``commandline`` gained two new options, ``--selection-start`` and ``--selection-end``, to set the start/end of the current selection (:issue:`9197`, :issue:`9215`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1334" href="#L1334">1334</a><span class="code-text">- fish's builtins now handle keyboard interrupts (:kbd:`ctrl-c`) correctly (:issue:`9266`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1335" href="#L1335">1335</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1336" href="#L1336">1336</a><span class="code-text">Completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1337" href="#L1337">1337</a><span class="code-text">^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1338" href="#L1338">1338</a><span class="code-text">- Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1339" href="#L1339">1339</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1340" href="#L1340">1340</a><span class="code-text">  - ``ark``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1341" href="#L1341">1341</a><span class="code-text">  - ``asciinema`` (:issue:`9257`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1342" href="#L1342">1342</a><span class="code-text">  - ``clojure`` (:issue:`9272`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1343" href="#L1343">1343</a><span class="code-text">  - ``csh``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1344" href="#L1344">1344</a><span class="code-text">  - ``direnv`` (:issue:`9268`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1345" href="#L1345">1345</a><span class="code-text">  - ``dive`` (:issue:`9082`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1346" href="#L1346">1346</a><span class="code-text">  - ``dolphin``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1347" href="#L1347">1347</a><span class="code-text">  - ``dua`` (:issue:`9277`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1348" href="#L1348">1348</a><span class="code-text">  - ``efivar`` (:issue:`9318`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1349" href="#L1349">1349</a><span class="code-text">  - ``eg``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1350" href="#L1350">1350</a><span class="code-text">  - ``es`` (:issue:`9388`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1351" href="#L1351">1351</a><span class="code-text">  - ``firefox-developer-edition`` and ``firefox`` (:issue:`9090`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1352" href="#L1352">1352</a><span class="code-text">  - ``fortune`` (:issue:`9177`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1353" href="#L1353">1353</a><span class="code-text">  - ``kb``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1354" href="#L1354">1354</a><span class="code-text">  - ``kind`` (:issue:`9110`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1355" href="#L1355">1355</a><span class="code-text">  - ``konsole``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1356" href="#L1356">1356</a><span class="code-text">  - ``ksh``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1357" href="#L1357">1357</a><span class="code-text">  - ``loadkeys`` (:issue:`9312`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1358" href="#L1358">1358</a><span class="code-text">  - ``okular``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1359" href="#L1359">1359</a><span class="code-text">  - ``op`` (:issue:`9300`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1360" href="#L1360">1360</a><span class="code-text">  - ``ouch`` (:issue:`9405`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1361" href="#L1361">1361</a><span class="code-text">  - ``pix``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1362" href="#L1362">1362</a><span class="code-text">  - ``readelf`` (:issue:`8746`, :issue:`9386`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1363" href="#L1363">1363</a><span class="code-text">  - ``qshell``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1364" href="#L1364">1364</a><span class="code-text">  - ``rc``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1365" href="#L1365">1365</a><span class="code-text">  - ``sad`` (:issue:`9145`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1366" href="#L1366">1366</a><span class="code-text">  - ``tcsh``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1367" href="#L1367">1367</a><span class="code-text">  - ``toot``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1368" href="#L1368">1368</a><span class="code-text">  - ``tox`` (:issue:`9078`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1369" href="#L1369">1369</a><span class="code-text">  - ``wish``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1370" href="#L1370">1370</a><span class="code-text">  - ``xed``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1371" href="#L1371">1371</a><span class="code-text">  - ``xonsh`` (:issue:`9389`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1372" href="#L1372">1372</a><span class="code-text">  - ``xplayer``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1373" href="#L1373">1373</a><span class="code-text">  - ``xreader``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1374" href="#L1374">1374</a><span class="code-text">  - ``xviewer``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1375" href="#L1375">1375</a><span class="code-text">  - ``yash`` (:issue:`9391`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1376" href="#L1376">1376</a><span class="code-text">  - ``zig`` (:issue:`9083`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1377" href="#L1377">1377</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1378" href="#L1378">1378</a><span class="code-text">- Improvements to many completions, including making ``cd`` completion much faster (:issue:`9220`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1379" href="#L1379">1379</a><span class="code-text">- Completion of tilde (``~``) works properly even when the file name contains an escaped character (:issue:`9073`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1380" href="#L1380">1380</a><span class="code-text">- fish no longer loads completions if the command is used via a relative path and is not in :envvar:`PATH` (:issue:`9133`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1381" href="#L1381">1381</a><span class="code-text">- fish no longer completes inside of comments (:issue:`9320`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1382" href="#L1382">1382</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1383" href="#L1383">1383</a><span class="code-text">Improved terminal support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1384" href="#L1384">1384</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1385" href="#L1385">1385</a><span class="code-text">- Opening ``help`` on WSL now uses PowerShell to open the browser if available, removing some awkward UNC path errors (:issue:`9119`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1386" href="#L1386">1386</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1387" href="#L1387">1387</a><span class="code-text">Other improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1388" href="#L1388">1388</a><span class="code-text">------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1389" href="#L1389">1389</a><span class="code-text">- The Web-based configuration tool now works on systems with IPv6 disabled (:issue:`3857`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1390" href="#L1390">1390</a><span class="code-text">- Aliases can ignore arguments by ending them with ``#`` (:issue:`9199`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1391" href="#L1391">1391</a><span class="code-text">-  ``string`` is now faster when reading large strings from stdin (:issue:`9139`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1392" href="#L1392">1392</a><span class="code-text">- ``string repeat`` uses less memory and is faster. (:issue:`9124`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1393" href="#L1393">1393</a><span class="code-text">- Builtins are much faster when writing to a pipe or file. (:issue:`9229`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1394" href="#L1394">1394</a><span class="code-text">- Performance improvements to highlighting (:issue:`9180`) should make using fish more pleasant on slow systems.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1395" href="#L1395">1395</a><span class="code-text">- On 32-bit systems, globs like ``*`` will no longer fail to return some files, as large file support has been enabled.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1396" href="#L1396">1396</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1397" href="#L1397">1397</a><span class="code-text">Fixed bugs</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1398" href="#L1398">1398</a><span class="code-text">----------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1399" href="#L1399">1399</a><span class="code-text">- The history search text for a token search is now highlighted correctly if the line contains multiple instances of that text (:issue:`9066`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1400" href="#L1400">1400</a><span class="code-text">- ``process-exit`` and ``job-exit`` events are now generated for all background jobs, including those launched from event handlers (:issue:`9096`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1401" href="#L1401">1401</a><span class="code-text">- A crash when completing a token that contained both a potential glob and a quoted variable expansion was fixed (:issue:`9137`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1402" href="#L1402">1402</a><span class="code-text">- ``prompt_pwd`` no longer accidentally overwrites a global or universal ``$fish_prompt_pwd_full_dirs`` when called with the ``-d`` or ``--full-length-dirs`` option (:issue:`9123`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1403" href="#L1403">1403</a><span class="code-text">- A bug which caused fish to freeze or exit after running a command which does not preserve the foreground process group was fixed (:issue:`9181`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1404" href="#L1404">1404</a><span class="code-text">- The &quot;Disco&quot; sample prompt no longer prints an error in some working directories (:issue:`9164`). If you saved this prompt, you should run ``fish_config prompt save disco`` again.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1405" href="#L1405">1405</a><span class="code-text">- fish launches external commands via the given path again, rather than always using an absolute path. This behaviour was inadvertently changed in 3.5.0 and is visible, for example, when launching a bash script which checks ``$0`` (:issue:`9143`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1406" href="#L1406">1406</a><span class="code-text">- ``printf`` no longer tries to interpret the first argument as an option (:issue:`9132`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1407" href="#L1407">1407</a><span class="code-text">- Interactive ``read`` in scripts will now have the correct keybindings again (:issue:`9227`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1408" href="#L1408">1408</a><span class="code-text">- A possible stack overflow when recursively evaluating substitutions has been fixed (:issue:`9302`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1409" href="#L1409">1409</a><span class="code-text">- A crash with relative $CDPATH has been fixed (:issue:`9407`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1410" href="#L1410">1410</a><span class="code-text">- ``printf`` now properly fills extra ``%d`` specifiers with 0 even on macOS and BSD (:issue:`9321`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1411" href="#L1411">1411</a><span class="code-text">- ``fish_key_reader`` now correctly exits when receiving a SIGHUP (like after closing the terminal) (:issue:`9309`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1412" href="#L1412">1412</a><span class="code-text">- ``fish_config theme save`` now works as documented instead of erroring out (:issue:`9088`, :issue:`9273`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1413" href="#L1413">1413</a><span class="code-text">- fish no longer triggers prompts to install command line tools when first run on macOS (:issue:`9343`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1414" href="#L1414">1414</a><span class="code-text">- ``fish_git_prompt`` now quietly fails on macOS if the xcrun cache is not yet populated (:issue:`6625`), working around a potential hang.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1415" href="#L1415">1415</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1416" href="#L1416">1416</a><span class="code-text">For distributors</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1417" href="#L1417">1417</a><span class="code-text">----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1418" href="#L1418">1418</a><span class="code-text">- The vendored PCRE2 sources have been removed. It is recommended to declare PCRE2 as a dependency when packaging fish. If the CMake variable FISH_USE_SYSTEM_PCRE2 is false, fish will now download and build PCRE2 from the official repo (:issue:`8355`, :issue:`8363`). Note this variable defaults to true if PCRE2 is found installed on the system.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1419" href="#L1419">1419</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1420" href="#L1420">1420</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1421" href="#L1421">1421</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1422" href="#L1422">1422</a><span class="code-text">fish 3.5.1 (released July 20, 2022)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1423" href="#L1423">1423</a><span class="code-text">===================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1424" href="#L1424">1424</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1425" href="#L1425">1425</a><span class="code-text">This release of fish introduces the following small enhancements:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1426" href="#L1426">1426</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1427" href="#L1427">1427</a><span class="code-text">- Cursor shaping for Vi mode is enabled by default in tmux, and will be used if the outer terminal is capable (:issue:`8981`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1428" href="#L1428">1428</a><span class="code-text">- ``printf`` returns a better error when used with arguments interpreted as octal numbers (:issue:`9035`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1429" href="#L1429">1429</a><span class="code-text">- ``history merge`` when in private mode is now an error, rather than wiping out other sessions' history (:issue:`9050`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1430" href="#L1430">1430</a><span class="code-text">- The error message when launching a command that is built for the wrong architecture on macOS is more helpful (:issue:`9052`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1431" href="#L1431">1431</a><span class="code-text">- Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1432" href="#L1432">1432</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1433" href="#L1433">1433</a><span class="code-text">  - ``choose`` (:issue:`9065`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1434" href="#L1434">1434</a><span class="code-text">  - ``expect`` (:issue:`9060`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1435" href="#L1435">1435</a><span class="code-text">  - ``navi`` (:issue:`9064`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1436" href="#L1436">1436</a><span class="code-text">  - ``qdbus`` (:issue:`9031`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1437" href="#L1437">1437</a><span class="code-text">  - ``reflector`` (:issue:`9027`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1438" href="#L1438">1438</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1439" href="#L1439">1439</a><span class="code-text">- Improvements to some completions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1440" href="#L1440">1440</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1441" href="#L1441">1441</a><span class="code-text">This release also fixes a number of problems identified in fish 3.5.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1442" href="#L1442">1442</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1443" href="#L1443">1443</a><span class="code-text">- Completing ``git blame`` or ``git -C`` works correctly (:issue:`9053`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1444" href="#L1444">1444</a><span class="code-text">- On terminals that emit a ``CSI u`` sequence for :kbd:`shift-space`, fish inserts a space instead of printing an error. (:issue:`9054`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1445" href="#L1445">1445</a><span class="code-text">- ``status fish-path`` on Linux-based platforms could print the path with a &quot; (deleted)&quot; suffix (such as ``/usr/bin/fish (deleted)``), which is now removed (:issue:`9019`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1446" href="#L1446">1446</a><span class="code-text">- Cancelling an initial command (from fish's ``--init-command`` option) with :kbd:`ctrl-c` no longer prevents configuration scripts from running (:issue:`9024`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1447" href="#L1447">1447</a><span class="code-text">- The job summary contained extra blank lines if the prompt used multiple lines, which is now fixed (:issue:`9044`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1448" href="#L1448">1448</a><span class="code-text">- Using special input functions in bindings, in combination with ``and``/``or`` conditionals, no longer crashes (:issue:`9051`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1449" href="#L1449">1449</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1450" href="#L1450">1450</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1451" href="#L1451">1451</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1452" href="#L1452">1452</a><span class="code-text">fish 3.5.0 (released June 16, 2022)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1453" href="#L1453">1453</a><span class="code-text">===================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1454" href="#L1454">1454</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1455" href="#L1455">1455</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1456" href="#L1456">1456</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1457" href="#L1457">1457</a><span class="code-text">- A new ``path`` builtin command to filter and transform paths (:issue:`7659`, :issue:`8958`). For example, to list all the separate extensions used on files in /usr/share/man (after removing one extension, commonly a &quot;.gz&quot;)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1458" href="#L1458">1458</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1459" href="#L1459">1459</a><span class="code-text">    path filter -f /usr/share/man/** | path change-extension '' | path extension | path sort -u</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1460" href="#L1460">1460</a><span class="code-text">- Tab (or any key bound to ``complete``) now expands wildcards instead of invoking completions, if there is a wildcard in the path component under the cursor (:issue:`954`, :issue:`8593`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1461" href="#L1461">1461</a><span class="code-text">- Scripts can now catch and handle the SIGINT and SIGTERM signals, either via ``function --on-signal`` or with ``trap`` (:issue:`6649`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1462" href="#L1462">1462</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1463" href="#L1463">1463</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1464" href="#L1464">1464</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1465" href="#L1465">1465</a><span class="code-text">- The ``stderr-nocaret`` feature flag, introduced in fish 3.0 and enabled by default in fish 3.1, has been made read-only.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1466" href="#L1466">1466</a><span class="code-text">  That means it is no longer possible to disable it, and code supporting the ``^`` redirection has been removed (:issue:`8857`, :issue:`8865`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1467" href="#L1467">1467</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1468" href="#L1468">1468</a><span class="code-text">  To recap: fish used to support ``^`` to redirect stderr, so you could use commands like::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1469" href="#L1469">1469</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1470" href="#L1470">1470</a><span class="code-text">    test &quot;$foo&quot; -gt 8 ^/dev/null</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1471" href="#L1471">1471</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1472" href="#L1472">1472</a><span class="code-text">  to ignore error messages. This made the ``^`` symbol require escaping and quoting, and was a bit of a weird shortcut considering ``2&gt;`` already worked, which is only one character longer.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1473" href="#L1473">1473</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1474" href="#L1474">1474</a><span class="code-text">  So the above can simply become::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1475" href="#L1475">1475</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1476" href="#L1476">1476</a><span class="code-text">    test &quot;$foo&quot; -gt 8 2&gt;/dev/null</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1477" href="#L1477">1477</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1478" href="#L1478">1478</a><span class="code-text">- The following feature flags have been enabled by default:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1479" href="#L1479">1479</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1480" href="#L1480">1480</a><span class="code-text">  - ``regex-easyesc``, which makes ``string replace -r`` not do a superfluous round of unescaping in the replacement expression.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1481" href="#L1481">1481</a><span class="code-text">    That means e.g. to escape any &quot;a&quot; or &quot;b&quot; in an argument you can use ``string replace -ra '([ab])' '\\\\$1' foobar`` instead of needing 8 backslashes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1482" href="#L1482">1482</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1483" href="#L1483">1483</a><span class="code-text">    This only affects the *replacement* expression, not the *match* expression (the ``'([ab])'`` part in the example).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1484" href="#L1484">1484</a><span class="code-text">    A survey of plugins on GitHub did not turn up any affected code, so we do not expect this to affect many users.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1485" href="#L1485">1485</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1486" href="#L1486">1486</a><span class="code-text">    This flag was introduced in fish 3.1.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1487" href="#L1487">1487</a><span class="code-text">  - ``ampersand-nobg-in-token``, which means that ``&amp;`` will not create a background job if it occurs in the middle of a word. For example, ``echo foo&amp;bar`` will print &quot;foo&amp;bar&quot; instead of running ``echo foo`` in the background and then starting ``bar`` as a second job.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1488" href="#L1488">1488</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1489" href="#L1489">1489</a><span class="code-text">    Reformatting with ``fish_indent`` would already introduce spaces, turning ``echo foo&amp;bar`` into ``echo foo &amp; bar``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1490" href="#L1490">1490</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1491" href="#L1491">1491</a><span class="code-text">    This flag was introduced in fish 3.4.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1492" href="#L1492">1492</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1493" href="#L1493">1493</a><span class="code-text">  To turn off these flags, add ``no-regex-easyesc`` or ``no-ampersand-nobg-in-token`` to :envvar:`fish_features` and restart fish::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1494" href="#L1494">1494</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1495" href="#L1495">1495</a><span class="code-text">    set -Ua fish_features no-regex-easyesc</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1496" href="#L1496">1496</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1497" href="#L1497">1497</a><span class="code-text">  Like ``stderr-nocaret``, they will eventually be made read-only.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1498" href="#L1498">1498</a><span class="code-text">- Most ``string`` subcommands no longer append a newline to their input if the input didn't have one (:issue:`8473`, :issue:`3847`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1499" href="#L1499">1499</a><span class="code-text">- fish's escape sequence removal (like for ``string length --visible`` or to figure out how wide the prompt is) no longer has special support for non-standard color sequences like from Data General terminals, e.g. the Data General Dasher D220 from 1984. This removes a bunch of work in the common case, allowing ``string length --visible`` to be much faster with unknown escape sequences. We don't expect anyone to have ever used fish with such a terminal (:issue:`8769`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1500" href="#L1500">1500</a><span class="code-text">- Code to upgrade universal variables from fish before 3.0 has been removed. Users who upgrade directly from fish versions 2.7.1 or before will have to set their universal variables &amp; abbreviations again. (:issue:`8781`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1501" href="#L1501">1501</a><span class="code-text">- The meaning of an empty color variable has changed (:issue:`8793`). Previously, when a variable was set but empty, it would be interpreted as the &quot;normal&quot; color. Now, empty color variables cause the same effect as unset variables - the general highlighting variable for that type is used instead. For example::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1502" href="#L1502">1502</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1503" href="#L1503">1503</a><span class="code-text">    set -g fish_color_command blue</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1504" href="#L1504">1504</a><span class="code-text">    set -g fish_color_keyword</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1505" href="#L1505">1505</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1506" href="#L1506">1506</a><span class="code-text">  would previously make keywords &quot;normal&quot; (usually white in a dark terminal). Now it'll make them blue. To achieve the previous behavior, use the normal color explicitly: ``set -g fish_color_keyword normal``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1507" href="#L1507">1507</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1508" href="#L1508">1508</a><span class="code-text">  This makes it easier to make self-contained color schemes that don't accidentally use color that was set before.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1509" href="#L1509">1509</a><span class="code-text">  ``fish_config`` has been adjusted to set known color variables that a theme doesn't explicitly set to empty.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1510" href="#L1510">1510</a><span class="code-text">- ``eval`` is now a reserved keyword, so it can't be used as a function name. This follows ``set`` and ``read``, and is necessary because it can't be cleanly shadowed by a function - at the very least ``eval set -l argv foo`` breaks. fish will ignore autoload files for it, so left over ``eval.fish`` from previous fish versions won't be loaded.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1511" href="#L1511">1511</a><span class="code-text">- The git prompt in informative mode now defaults to skipping counting untracked files, as this was extremely slow. To turn it on, set :envvar:`__fish_git_prompt_showuntrackedfiles` or set the git config value &quot;bash.showuntrackedfiles&quot; to ``true`` explicitly (which can be done for individual repositories). The &quot;informative+vcs&quot; sample prompt already skipped display of untracked files, but didn't do so in a way that skipped the computation, so it should be quite a bit faster in many cases (:issue:`8980`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1512" href="#L1512">1512</a><span class="code-text">- The ``__terlar_git_prompt`` function, used by the &quot;Terlar&quot; sample prompt, has been rebuilt as a configuration of the normal ``fish_git_prompt`` to ease maintenance, improve performance and add features (like reading per-repo git configuration). Some slight changes remain; users who absolutely must have the same behavior are encouraged to copy the old function (:issue:`9011`, :issue:`7918`, :issue:`8979`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1513" href="#L1513">1513</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1514" href="#L1514">1514</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1515" href="#L1515">1515</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1516" href="#L1516">1516</a><span class="code-text">- Quoted command substitution that directly follow a variable expansion (like ``echo &quot;$var$(echo x)&quot;``) no longer affect the variable expansion (:issue:`8849`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1517" href="#L1517">1517</a><span class="code-text">- fish now correctly expands command substitutions that are preceded by an escaped dollar (like ``echo \$(echo)``). This regressed in version 3.4.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1518" href="#L1518">1518</a><span class="code-text">- ``math`` can now handle underscores (``_``) as visual separators in numbers (:issue:`8611`, :issue:`8496`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1519" href="#L1519">1519</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1520" href="#L1520">1520</a><span class="code-text">    math 5 + 2_123_252</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1521" href="#L1521">1521</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1522" href="#L1522">1522</a><span class="code-text">- ``math``'s ``min`` and ``max`` functions now take a variable number of arguments instead of always requiring 2 (:issue:`8644`, :issue:`8646`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1523" href="#L1523">1523</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1524" href="#L1524">1524</a><span class="code-text">    &gt; math min 8,2,4</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1525" href="#L1525">1525</a><span class="code-text">    2</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1526" href="#L1526">1526</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1527" href="#L1527">1527</a><span class="code-text">- ``read`` is now faster as the last process in a pipeline (:issue:`8552`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1528" href="#L1528">1528</a><span class="code-text">- ``string join`` gained a new ``--no-empty`` flag to skip empty arguments (:issue:`8774`, :issue:`8351`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1529" href="#L1529">1529</a><span class="code-text">- ``read`` now only triggers the ``fish_read`` event, not the ``fish_prompt`` event (:issue:`8797`). It was supposed to work this way in fish 3.2.0 and later, but both events were emitted.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1530" href="#L1530">1530</a><span class="code-text">- The TTY modes are no longer restored when non-interactive shells exit. This fixes wrong tty modes in pipelines with interactive commands. (:issue:`8705`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1531" href="#L1531">1531</a><span class="code-text">- Some functions shipped with fish printed error messages to standard output, but they now they rightly go to standard error (:issue:`8855`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1532" href="#L1532">1532</a><span class="code-text">- ``jobs`` now correctly reports CPU usage as a percentage, instead of as a number of clock ticks (:issue:`8919`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1533" href="#L1533">1533</a><span class="code-text">- ``process-exit`` events now fire when the process exits even if the job has not yet exited, fixing a regression in 3.4.1 (:issue:`8914`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1534" href="#L1534">1534</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1535" href="#L1535">1535</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1536" href="#L1536">1536</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1537" href="#L1537">1537</a><span class="code-text">- fish now reports a special error if a command wasn't found and there is a non-executable file by that name in :envvar:`PATH` (:issue:`8804`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1538" href="#L1538">1538</a><span class="code-text">- ``less`` and other interactive commands would occasionally be stopped when run in a pipeline with fish functions; this has been fixed (:issue:`8699`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1539" href="#L1539">1539</a><span class="code-text">- Case-changing autosuggestions generated mid-token now correctly append only the suffix, instead of duplicating the token (:issue:`8820`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1540" href="#L1540">1540</a><span class="code-text">- ``ulimit`` learned a number of new options for the resource limits available on Linux, FreeBSD ande NetBSD, and returns a specific warning if the limit specified is not available on the active operating system (:issue:`8823`, :issue:`8786`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1541" href="#L1541">1541</a><span class="code-text">- The ``vared`` command can now successfully edit variables named &quot;tmp&quot; or &quot;prompt&quot; (:issue:`8836`, :issue:`8837`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1542" href="#L1542">1542</a><span class="code-text">- ``time`` now emits an error if used after the first command in a pipeline (:issue:`8841`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1543" href="#L1543">1543</a><span class="code-text">- ``fish_add_path`` now prints a message for skipped non-existent paths when using the ``-v`` flag (:issue:`8884`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1544" href="#L1544">1544</a><span class="code-text">- Since fish 3.2.0, pressing :kbd:`ctrl-d` while a command is running would end up inserting a space into the next commandline, which has been fixed (:issue:`8871`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1545" href="#L1545">1545</a><span class="code-text">- A bug that caused multi-line prompts to be moved down a line when pasting or switching modes has been fixed (:issue:`3481`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1546" href="#L1546">1546</a><span class="code-text">- The Web-based configuration system no longer strips too many quotes in the abbreviation display (:issue:`8917`, :issue:`8918`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1547" href="#L1547">1547</a><span class="code-text">- fish started with ``--no-config`` will now use the default keybindings (:issue:`8493`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1548" href="#L1548">1548</a><span class="code-text">- When fish inherits a :envvar:`USER` environment variable value that doesn't correspond to the current effective user ID, it will now correct it in all cases (:issue:`8879`, :issue:`8583`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1549" href="#L1549">1549</a><span class="code-text">- fish sets a new :envvar:`EUID` variable containing the current effective user id (:issue:`8866`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1550" href="#L1550">1550</a><span class="code-text">- ``history search`` no longer interprets the search term as an option (:issue:`8853`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1551" href="#L1551">1551</a><span class="code-text">- The status message when a job terminates should no longer be erased by a multiline prompt (:issue:`8817`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1552" href="#L1552">1552</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1553" href="#L1553">1553</a><span class="code-text">New or improved bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1554" href="#L1554">1554</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1555" href="#L1555">1555</a><span class="code-text">- The :kbd:`alt-s` binding will now insert ``doas`` instead of ``sudo`` if necessary (:issue:`8942`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1556" href="#L1556">1556</a><span class="code-text">- The ``kill-whole-line`` special input function now kills the newline preceding the last line. This makes ``dd`` in vi-mode clear the last line properly.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1557" href="#L1557">1557</a><span class="code-text">- The new ``kill-inner-line`` special input function kills the line without any newlines, allowing ``cc`` in vi-mode to clear the line while preserving newlines (:issue:`8983`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1558" href="#L1558">1558</a><span class="code-text">- On terminals that emit special sequences for these combinations, :kbd:`shift-space` is bound like :kbd:`space`, and :kbd:`ctrl-enter` is bound like :kbd:`return` (:issue:`8874`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1559" href="#L1559">1559</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1560" href="#L1560">1560</a><span class="code-text">Improved prompts</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1561" href="#L1561">1561</a><span class="code-text">^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1562" href="#L1562">1562</a><span class="code-text">- A new ``Astronaut`` prompt (:issue:`8775`), a multi-line prompt using plain text reminiscent of the Starship.rs prompt.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1563" href="#L1563">1563</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1564" href="#L1564">1564</a><span class="code-text">Completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1565" href="#L1565">1565</a><span class="code-text">^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1566" href="#L1566">1566</a><span class="code-text">- Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1567" href="#L1567">1567</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1568" href="#L1568">1568</a><span class="code-text">  - ``archlinux-java`` (:issue:`8911`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1569" href="#L1569">1569</a><span class="code-text">  - ``apk`` (:issue:`8951`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1570" href="#L1570">1570</a><span class="code-text">  - ``brightnessctl`` (:issue:`8758`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1571" href="#L1571">1571</a><span class="code-text">  - ``efibootmgr`` (:issue:`9010`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1572" href="#L1572">1572</a><span class="code-text">  - ``fastboot`` (:issue:`8904`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1573" href="#L1573">1573</a><span class="code-text">  - ``optimus-manager`` (:issue:`8913`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1574" href="#L1574">1574</a><span class="code-text">  - ``rclone`` (:issue:`8819`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1575" href="#L1575">1575</a><span class="code-text">  - ``sops`` (:issue:`8821`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1576" href="#L1576">1576</a><span class="code-text">  - ``tuned-adm`` (:issue:`8760`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1577" href="#L1577">1577</a><span class="code-text">  - ``wg-quick`` (:issue:`8687`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1578" href="#L1578">1578</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1579" href="#L1579">1579</a><span class="code-text">- ``complete`` can now be given multiple ``--condition`` options. They will be attempted in the order they were given, and only if all succeed will the completion be made available (as if they were connected with ``&amp;&amp;``). This helps with caching - fish's complete system stores the return value of each condition as long as the commandline doesn't change, so this can reduce the number of conditions that need to be evaluated (:issue:`8536`, :issue:`8967`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1580" href="#L1580">1580</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1581" href="#L1581">1581</a><span class="code-text">Improved terminal support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1582" href="#L1582">1582</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1583" href="#L1583">1583</a><span class="code-text">- Working directory reporting is enabled for kitty (:issue:`8806`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1584" href="#L1584">1584</a><span class="code-text">- Changing the cursor shape is now enabled by default in iTerm2 (:issue:`3696`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1585" href="#L1585">1585</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1586" href="#L1586">1586</a><span class="code-text">For distributors</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1587" href="#L1587">1587</a><span class="code-text">----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1588" href="#L1588">1588</a><span class="code-text">- libatomic is now correctly detected as necessary when building on RISC-V (:issue:`8850`, :issue:`8851`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1589" href="#L1589">1589</a><span class="code-text">- In some cases, the build process found the wrong libintl on macOS. This has been corrected (:issue:`5244`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1590" href="#L1590">1590</a><span class="code-text">- The paths for completions, functions, and configuration snippets now include</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1591" href="#L1591">1591</a><span class="code-text">  subdirectories ``fish/vendor_completions.d``, ``fish/vendor_functions.d``, and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1592" href="#L1592">1592</a><span class="code-text">  ``fish/vendor_conf.d`` (respectively) within ``XDG_DATA_HOME`` (or ``~/.local/share``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1593" href="#L1593">1593</a><span class="code-text">  if not defined) (:issue:`8887`, :issue:`7816`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1594" href="#L1594">1594</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1595" href="#L1595">1595</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1596" href="#L1596">1596</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1597" href="#L1597">1597</a><span class="code-text">fish 3.4.1 (released March 25, 2022)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1598" href="#L1598">1598</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1599" href="#L1599">1599</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1600" href="#L1600">1600</a><span class="code-text">This release of fish fixes the following problems identified in fish 3.4.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1601" href="#L1601">1601</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1602" href="#L1602">1602</a><span class="code-text">- An error printed after upgrading, where old instances could pick up a newer version of the ``fish_title`` function, has been fixed (:issue:`8778`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1603" href="#L1603">1603</a><span class="code-text">- fish builds correctly on NetBSD (:issue:`8788`) and OpenIndiana (:issue:`8780`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1604" href="#L1604">1604</a><span class="code-text">- ``nextd-or-forward-word``, bound to :kbd:`alt-right` by default, was inadvertently changed to move like ``forward-bigword``. This has been corrected (:issue:`8790`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1605" href="#L1605">1605</a><span class="code-text">- ``funcsave -q`` and ``funcsave --quiet`` now work correctly (:issue:`8830`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1606" href="#L1606">1606</a><span class="code-text">- Issues with the ``csharp`` and ``nmcli`` completions were corrected.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1607" href="#L1607">1607</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1608" href="#L1608">1608</a><span class="code-text">If you are upgrading from version 3.3.1 or before, please also review the release notes for 3.4.0 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1609" href="#L1609">1609</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1610" href="#L1610">1610</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1611" href="#L1611">1611</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1612" href="#L1612">1612</a><span class="code-text">fish 3.4.0 (released March 12, 2022)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1613" href="#L1613">1613</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1614" href="#L1614">1614</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1615" href="#L1615">1615</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1616" href="#L1616">1616</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1617" href="#L1617">1617</a><span class="code-text">- fish's command substitution syntax has been extended: ``$(cmd)`` now has the same meaning as ``(cmd)`` but it can be used inside double quotes, to prevent line splitting of the results (:issue:`159`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1618" href="#L1618">1618</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1619" href="#L1619">1619</a><span class="code-text">    foo (bar | string collect)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1620" href="#L1620">1620</a><span class="code-text">    # can now be written as</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1621" href="#L1621">1621</a><span class="code-text">    foo &quot;$(bar)&quot;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1622" href="#L1622">1622</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1623" href="#L1623">1623</a><span class="code-text">    # and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1624" href="#L1624">1624</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1625" href="#L1625">1625</a><span class="code-text">    foo (bar)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1626" href="#L1626">1626</a><span class="code-text">    # can now be written as</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1627" href="#L1627">1627</a><span class="code-text">    foo $(bar)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1628" href="#L1628">1628</a><span class="code-text">    # this will still split on newlines only.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1629" href="#L1629">1629</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1630" href="#L1630">1630</a><span class="code-text">- Complementing the ``prompt`` command in 3.3.0, ``fish_config`` gained a ``theme`` subcommand to show and pick from the sample themes (meaning color schemes) directly in the terminal, instead of having to open a Web browser. For example ``fish_config theme choose Nord`` loads the Nord theme in the current session (:issue:`8132`). The current theme can be saved with ``fish_config theme dump``, and custom themes can be added by saving them in ``~/.config/fish/themes/``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1631" href="#L1631">1631</a><span class="code-text">- ``set`` and ``read`` learned a new option, ``--function``, to set a variable in the function's top scope. This should be a more familiar way of scoping variables and avoids issues with ``--local``, which is actually block-scoped (:issue:`565`, :issue:`8145`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1632" href="#L1632">1632</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1633" href="#L1633">1633</a><span class="code-text">    function demonstration</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1634" href="#L1634">1634</a><span class="code-text">        if true</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1635" href="#L1635">1635</a><span class="code-text">            set --function foo bar</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1636" href="#L1636">1636</a><span class="code-text">            set --local baz banana</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1637" href="#L1637">1637</a><span class="code-text">        end</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1638" href="#L1638">1638</a><span class="code-text">        echo $foo # prints &quot;bar&quot; because $foo is still valid</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1639" href="#L1639">1639</a><span class="code-text">        echo $baz # prints nothing because $baz went out of scope</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1640" href="#L1640">1640</a><span class="code-text">    end</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1641" href="#L1641">1641</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1642" href="#L1642">1642</a><span class="code-text">- ``string pad`` now excludes escape sequences like colors that fish knows about, and a new ``--visible`` flag to ``string length`` makes it use that kind of visible width. This is useful to get the number of terminal cells an already colored string would occupy, like in a prompt. (:issue:`8182`, :issue:`7784`, :issue:`4012`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1643" href="#L1643">1643</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1644" href="#L1644">1644</a><span class="code-text">    &gt; string length --visible (set_color red)foo</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1645" href="#L1645">1645</a><span class="code-text">    3</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1646" href="#L1646">1646</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1647" href="#L1647">1647</a><span class="code-text">- Performance improvements to globbing, especially on systems using glibc. In some cases (large directories with files with many numbers in the names) this almost halves the time taken to expand the glob.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1648" href="#L1648">1648</a><span class="code-text">- Autosuggestions can now be turned off by setting ``$fish_autosuggestion_enabled`` to 0, and (almost) all highlighting can be turned off by choosing the new &quot;None&quot; theme. The exception is necessary colors, like those which distinguish autosuggestions from the actual command line. (:issue:`8376`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1649" href="#L1649">1649</a><span class="code-text">- The ``fish_git_prompt`` function, which is included in the default prompts, now overrides ``git`` to avoid running  commands set by per-repository configuration. This avoids a potential security issue in some circumstances, and has been assigned CVE-2022-20001 (:issue:`8589`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1650" href="#L1650">1650</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1651" href="#L1651">1651</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1652" href="#L1652">1652</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1653" href="#L1653">1653</a><span class="code-text">- A new feature flag, ``ampersand-nobg-in-token`` makes ``&amp;`` only act as background operator if followed by a separator. In combination with ``qmark-noglob``, this allows entering most URLs at the command line without quoting or escaping (:issue:`7991`). For example::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1654" href="#L1654">1654</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1655" href="#L1655">1655</a><span class="code-text">    &gt; echo foo&amp;bar # will print &quot;foo&amp;bar&quot;, instead of running &quot;echo foo&quot; in the background and executing &quot;bar&quot;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1656" href="#L1656">1656</a><span class="code-text">    &gt; echo foo &amp; bar # will still run &quot;echo foo&quot; in the background and then run &quot;bar&quot;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1657" href="#L1657">1657</a><span class="code-text">    # with both ampersand-nobg-in-token and qmark-noglob, this argument has no special characters anymore</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1658" href="#L1658">1658</a><span class="code-text">    &gt; open https://www.youtube.com/watch?v=dQw4w9WgXcQ&amp;feature=youtu.be</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1659" href="#L1659">1659</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1660" href="#L1660">1660</a><span class="code-text">  As a reminder, feature flags can be set on startup with ``fish --features ampersand-nobg-in-token,qmark-noglob`` or with a universal variable called ``fish_features``::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1661" href="#L1661">1661</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1662" href="#L1662">1662</a><span class="code-text">    &gt; set -Ua fish_features ampersand-nobg-in-token</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1663" href="#L1663">1663</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1664" href="#L1664">1664</a><span class="code-text">- ``$status`` is now forbidden as a command, to prevent a surprisingly common error among new users: Running ``if $status`` (:issue:`8171`). This applies *only* to ``$status``, other variables are still allowed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1665" href="#L1665">1665</a><span class="code-text">- ``set --query`` now returns an exit status of 255 if given no variable names. This means ``if set -q $foo`` will not enter the if-block if ``$foo`` is empty or unset. To restore the previous behavior, use ``if not set -q foo; or set -q $foo`` - but this is unlikely to be desirable (:issue:`8214`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1666" href="#L1666">1666</a><span class="code-text">- ``_`` is now a reserved keyword (:issue:`8342`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1667" href="#L1667">1667</a><span class="code-text">- The special input functions ``delete-or-exit``, ``nextd-or-forward-word`` and ``prevd-or-backward-word`` replace fish functions of the same names (:issue:`8538`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1668" href="#L1668">1668</a><span class="code-text">- Mac OS X 10.9 is no longer supported. The minimum Mac version is now 10.10 &quot;Yosemite.&quot;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1669" href="#L1669">1669</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1670" href="#L1670">1670</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1671" href="#L1671">1671</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1672" href="#L1672">1672</a><span class="code-text">- ``string collect`` supports a new ``--allow-empty`` option, which will output one empty argument in a command substitution that has no output (:issue:`8054`). This allows commands like ``test -n (echo -n | string collect --allow-empty)`` to work more reliably. Note this can also be written as ``test -n &quot;$(echo -n)&quot;`` (see above).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1673" href="#L1673">1673</a><span class="code-text">- ``string match`` gained a ``--groups-only`` option, which makes it only output capturing groups, excluding the full match. This allows ``string match`` to do simple transformations (:issue:`6056`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1674" href="#L1674">1674</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1675" href="#L1675">1675</a><span class="code-text">    &gt; string match -r --groups-only '(.*)fish' 'catfish' 'twofish' 'blue fish' | string escape</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1676" href="#L1676">1676</a><span class="code-text">    cat</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1677" href="#L1677">1677</a><span class="code-text">    two</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1678" href="#L1678">1678</a><span class="code-text">    'blue '</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1679" href="#L1679">1679</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1680" href="#L1680">1680</a><span class="code-text">- ``$fish_user_paths`` is now automatically deduplicated to fix a common user error of appending to it in config.fish when it is universal (:issue:`8117`). :doc:`fish_add_path &lt;cmds/fish_add_path&gt;` remains the recommended way to add to $PATH.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1681" href="#L1681">1681</a><span class="code-text">- ``return`` can now be used outside functions. In scripts, it does the same thing as ``exit``. In interactive mode,it sets ``$status`` without exiting (:issue:`8148`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1682" href="#L1682">1682</a><span class="code-text">- An oversight prevented all syntax checks from running on commands given to ``fish -c`` (:issue:`8171`). This includes checks such as ``exec`` not being allowed in a pipeline, and ``$$`` not being a valid variable. Generally, another error was generated anyway.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1683" href="#L1683">1683</a><span class="code-text">- ``fish_indent`` now correctly reformats tokens that end with a backslash followed by a newline (:issue:`8197`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1684" href="#L1684">1684</a><span class="code-text">- ``commandline`` gained an ``--is-valid`` option to check if the command line is syntactically valid and complete. This allows basic implementation of transient prompts (:issue:`8142`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1685" href="#L1685">1685</a><span class="code-text">- ``commandline`` gained a ``--paging-full-mode`` option to check if the pager is showing all the possible lines (no &quot;7 more rows&quot; message) (:issue:`8485`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1686" href="#L1686">1686</a><span class="code-text">- List expansion correctly reports an error when used with all zero indexes (:issue:`8213`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1687" href="#L1687">1687</a><span class="code-text">- Running ``fish`` with a directory instead of a script as argument (eg ``fish .``) no longer leads to an infinite loop. Instead it errors out immediately (:issue:`8258`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1688" href="#L1688">1688</a><span class="code-text">- Some error messages occurring after fork, like &quot;text file busy&quot; have been replaced by bespoke error messages for fish (like &quot;File is currently open for writing&quot;). This also restores error messages with current glibc versions that removed sys_errlist (:issue:`8234`, :issue:`4183`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1689" href="#L1689">1689</a><span class="code-text">- The ``realpath`` builtin now also squashes leading slashes with the ``--no-symlinks`` option (:issue:`8281`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1690" href="#L1690">1690</a><span class="code-text">- When trying to ``cd`` to a dangling (broken) symbolic link, fish will print an error noting that the target is a broken link (:issue:`8264`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1691" href="#L1691">1691</a><span class="code-text">- On MacOS terminals that are not granted permissions to access a folder, ``cd`` would print a spurious &quot;rotten symlink&quot; error, which has been corrected to &quot;permission denied&quot; (:issue:`8264`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1692" href="#L1692">1692</a><span class="code-text">- Since fish 3.0, ``for`` loops would trigger a variable handler function before the loop was entered. As the variable had not actually changed or been set, this was a spurious event and has been removed (:issue:`8384`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1693" href="#L1693">1693</a><span class="code-text">- ``math`` now correctly prints negative values and values larger than ``2**31`` when in hex or octal bases (:issue:`8417`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1694" href="#L1694">1694</a><span class="code-text">- ``dirs`` always produces an exit status of 0, instead of sometimes returning 1 (:issue:`8211`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1695" href="#L1695">1695</a><span class="code-text">- ``cd &quot;&quot;`` no longer crashes fish (:issue:`8147`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1696" href="#L1696">1696</a><span class="code-text">- ``set --query`` can now query whether a variable is a path variable via ``--path`` or ``--unpath`` (:issue:`8494`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1697" href="#L1697">1697</a><span class="code-text">- Tilde characters (``~``) produced by custom completions are no longer escaped when applied to the command line, making it easier to use the output of a recursive ``complete -C`` in completion scripts (:issue:`4570`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1698" href="#L1698">1698</a><span class="code-text">- ``set --show`` reports when a variable is read-only (:issue:`8179`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1699" href="#L1699">1699</a><span class="code-text">- Erasing ``$fish_emoji_width`` will reset fish to the default guessed emoji width (:issue:`8274`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1700" href="#L1700">1700</a><span class="code-text">- The ``la`` function no longer lists entries for &quot;.&quot; and &quot;..&quot;, matching other systems defaults (:issue:`8519`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1701" href="#L1701">1701</a><span class="code-text">- ``abbr -q`` returns the correct exit status when given multiple abbreviation names as arguments (:issue:`8431`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1702" href="#L1702">1702</a><span class="code-text">- ``command -v`` returns an exit status of 127 instead of 1 if no command was found (:issue:`8547`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1703" href="#L1703">1703</a><span class="code-text">- ``argparse`` with ``--ignore-unknown`` no longer breaks with multiple unknown options in a short option group (:issue:`8637`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1704" href="#L1704">1704</a><span class="code-text">- Comments inside command substitutions or brackets now correctly ignore parentheses, quotes, and brackets (:issue:`7866`, :issue:`8022`, :issue:`8695`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1705" href="#L1705">1705</a><span class="code-text">- ``complete -C`` supports a new ``--escape`` option, which turns on escaping in returned completion strings (:issue:`3469`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1706" href="#L1706">1706</a><span class="code-text">- Invalid byte or unicode escapes like ``\Utest`` or ``\xNotHex`` are now a tokenizer error instead of causing the token to be truncated (:issue:`8545`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1707" href="#L1707">1707</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1708" href="#L1708">1708</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1709" href="#L1709">1709</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1710" href="#L1710">1710</a><span class="code-text">- Vi mode cursors are now set properly after :kbd:`ctrl-c` (:issue:`8125`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1711" href="#L1711">1711</a><span class="code-text">- ``funced`` will try to edit the whole file containing a function definition, if there is one (:issue:`391`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1712" href="#L1712">1712</a><span class="code-text">- Running a command line consisting of just spaces now deletes an ephemeral (starting with space) history item again (:issue:`8232`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1713" href="#L1713">1713</a><span class="code-text">- Command substitutions no longer respect job control, instead running inside fish's own process group (:issue:`8172`). This more closely matches other shells, and improves :kbd:`ctrl-c` reliability inside a command substitution.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1714" href="#L1714">1714</a><span class="code-text">- ``history`` and ``__fish_print_help`` now properly support ``less`` before version 530, including the version that ships with macOS. (:issue:`8157`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1715" href="#L1715">1715</a><span class="code-text">- ``help`` now knows which section is in which document again (:issue:`8245`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1716" href="#L1716">1716</a><span class="code-text">- fish's highlighter will now color options (starting with ``-`` or ``--``) with the color given in the new $fish_color_option, up to the first ``--``. It falls back on $fish_color_param, so nothing changes for existing setups (:issue:`8292`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1717" href="#L1717">1717</a><span class="code-text">- When executing a command, abbreviations are no longer expanded when the cursor is separated from the command by spaces, making it easier to suppress abbreviation expansion of commands without arguments. (:issue:`8423`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1718" href="#L1718">1718</a><span class="code-text">- ``fish_key_reader``'s output was simplified. By default, it now only prints a bind statement. The previous per-character timing information can be seen with a new ``--verbose`` switch (:issue:`8467`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1719" href="#L1719">1719</a><span class="code-text">- Custom completions are now also loaded for commands that contain tildes or variables like ``~/bin/fish`` or ``$PWD/fish`` (:issue:`8442`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1720" href="#L1720">1720</a><span class="code-text">- Command lines spanning multiple lines will not be overwritten by the completion pager when it fills the entire terminal (:issue:`8509`, :issue:`8405`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1721" href="#L1721">1721</a><span class="code-text">- When redrawing a multiline prompt, the old prompt is now properly cleared (:issue:`8163`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1722" href="#L1722">1722</a><span class="code-text">- Interactive completion would occasionally ignore the last word on the command line due to a race condition. This has been fixed (:issue:`8175`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1723" href="#L1723">1723</a><span class="code-text">- Propagation of universal variables from a fish process that is closing is faster (:issue:`8209`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1724" href="#L1724">1724</a><span class="code-text">- The command line is drawn in the correct place if the prompt ends with a newline (:issue:`8298`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1725" href="#L1725">1725</a><span class="code-text">- ``history`` learned a new subcommand ``clear-session`` to erase all history from the current session (:issue:`5791`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1726" href="#L1726">1726</a><span class="code-text">- Pressing :kbd:`ctrl-c` in ``fish_key_reader`` will no longer print the incorrect &quot;Press [ctrl-C] again to exit&quot; message (:issue:`8510`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1727" href="#L1727">1727</a><span class="code-text">- The default command-not-found handler for Fedora/PackageKit now passes the whole command line, allowing for functionality such as running the suggested command directly (:issue:`8579`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1728" href="#L1728">1728</a><span class="code-text">- When looking for locale information, the Debian configuration is now used when available (:issue:`8557`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1729" href="#L1729">1729</a><span class="code-text">- Pasting text containing quotes from the clipboard trims spaces more appropriately (:issue:`8550`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1730" href="#L1730">1730</a><span class="code-text">- The clipboard bindings ignore X-based clipboard programs if the ``DISPLAY`` environment variable is not set, which helps prefer the Windows clipboard when it is available (such as on WSL).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1731" href="#L1731">1731</a><span class="code-text">- ``funcsave`` will remove a saved copy of a function that has been erased with ``functions --erase``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1732" href="#L1732">1732</a><span class="code-text">- The Web-based configuration tool gained a number of improvements, including the ability to set pager colors.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1733" href="#L1733">1733</a><span class="code-text">- The default ``fish_title`` prints a shorter title with shortened $PWD and no more redundant &quot;fish&quot; (:issue:`8641`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1734" href="#L1734">1734</a><span class="code-text">- Holding down an arrow key won't freeze the terminal with long periods of flashing (:issue:`8610`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1735" href="#L1735">1735</a><span class="code-text">- Multi-char bindings are no longer interrupted if a signal handler enqueues an event. (:issue:`8628`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1736" href="#L1736">1736</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1737" href="#L1737">1737</a><span class="code-text">New or improved bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1738" href="#L1738">1738</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1739" href="#L1739">1739</a><span class="code-text">- :kbd:`escape` can now bound without breaking arrow key bindings (:issue:`8428`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1740" href="#L1740">1740</a><span class="code-text">- The :kbd:`alt-h` binding (to open a command’s manual page) now also ignores ``command`` (:issue:`8447`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1741" href="#L1741">1741</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1742" href="#L1742">1742</a><span class="code-text">Improved prompts</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1743" href="#L1743">1743</a><span class="code-text">^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1744" href="#L1744">1744</a><span class="code-text">- The ``fish_status_to_signal`` helper function returns the correct signal names for the current platform, rather than Linux (:issue:`8530`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1745" href="#L1745">1745</a><span class="code-text">- The ``prompt_pwd`` helper function learned a ``--full-length-dirs N`` option to keep the last N directory components unshortened. In addition the number of characters to shorten each component should be shortened to can now be given as ``-d N`` or ``--dir-length N``. (:issue:`8208`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1746" href="#L1746">1746</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1747" href="#L1747">1747</a><span class="code-text">    &gt; prompt_pwd --full-length-dirs 2 -d 1 ~/dev/fish-shell/share/tools/web_config</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1748" href="#L1748">1748</a><span class="code-text">    ~/d/f/s/tools/web_config</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1749" href="#L1749">1749</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1750" href="#L1750">1750</a><span class="code-text">Completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1751" href="#L1751">1751</a><span class="code-text">^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1752" href="#L1752">1752</a><span class="code-text">- Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1753" href="#L1753">1753</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1754" href="#L1754">1754</a><span class="code-text">  - Apple's ``shortcuts``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1755" href="#L1755">1755</a><span class="code-text">  - ``argparse`` (:issue:`8434`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1756" href="#L1756">1756</a><span class="code-text">  - ``asd`` (:issue:`8759`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1757" href="#L1757">1757</a><span class="code-text">  - ``az`` (:issue:`8141`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1758" href="#L1758">1758</a><span class="code-text">  - ``black`` (:issue:`8123`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1759" href="#L1759">1759</a><span class="code-text">  - ``clasp`` (:issue:`8373`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1760" href="#L1760">1760</a><span class="code-text">  - ``cpupower`` (:issue:`8302`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1761" href="#L1761">1761</a><span class="code-text">  - ``dart`` (:issue:`8315`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1762" href="#L1762">1762</a><span class="code-text">  - ``dscacheutil``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1763" href="#L1763">1763</a><span class="code-text">  - ``elvish`` (:issue:`8416`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1764" href="#L1764">1764</a><span class="code-text">  - ``ethtool`` (:issue:`8283`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1765" href="#L1765">1765</a><span class="code-text">  - ``exif`` (:issue:`8246`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1766" href="#L1766">1766</a><span class="code-text">  - ``findstr`` (:issue:`8481`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1767" href="#L1767">1767</a><span class="code-text">  - ``git-sizer`` (:issue:`8156`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1768" href="#L1768">1768</a><span class="code-text">  - ``gnome-extensions`` (:issue:`8732`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1769" href="#L1769">1769</a><span class="code-text">  - ``gping`` (:issue:`8181`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1770" href="#L1770">1770</a><span class="code-text">  - ``isatty`` (:issue:`8609`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1771" href="#L1771">1771</a><span class="code-text">  - ``istioctl`` (:issue:`8343`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1772" href="#L1772">1772</a><span class="code-text">  - ``kmutil``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1773" href="#L1773">1773</a><span class="code-text">  - ``kubectl`` (:issue:`8734`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1774" href="#L1774">1774</a><span class="code-text">  - ``matlab`` (:issue:`8505`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1775" href="#L1775">1775</a><span class="code-text">  - ``mono`` (:issue:`8415`) and related tools ``csharp``, ``gacutil``, ``gendarme``, ``ikdasm``, ``ilasm``, ``mkbundle``, ``monodis``, ``monop``, ``sqlsharp`` and ``xsp`` (:issue:`8452`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1776" href="#L1776">1776</a><span class="code-text">  -  Angular's ``ng`` (:issue:`8111`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1777" href="#L1777">1777</a><span class="code-text">  - ``nodeenv`` (:issue:`8533`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1778" href="#L1778">1778</a><span class="code-text">  - ``octave`` (:issue:`8505`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1779" href="#L1779">1779</a><span class="code-text">  - ``pabcnet_clear`` (:issue:`8421`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1780" href="#L1780">1780</a><span class="code-text">  - ``qmk`` (:issue:`8180`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1781" href="#L1781">1781</a><span class="code-text">  - ``rakudo`` (:issue:`8113`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1782" href="#L1782">1782</a><span class="code-text">  - ``rc-status`` (:issue:`8757`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1783" href="#L1783">1783</a><span class="code-text">  - ``roswell`` (:issue:`8330`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1784" href="#L1784">1784</a><span class="code-text">  - ``sbcl`` (:issue:`8330`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1785" href="#L1785">1785</a><span class="code-text">  - ``starship`` (:issue:`8520`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1786" href="#L1786">1786</a><span class="code-text">  - ``topgrade`` (:issue:`8651`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1787" href="#L1787">1787</a><span class="code-text">  -  ``wine``, ``wineboot`` and ``winemaker`` (:issue:`8411`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1788" href="#L1788">1788</a><span class="code-text">  -  Windows Subsystem for Linux (WSL)'s ``wslpath`` (:issue:`8364`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1789" href="#L1789">1789</a><span class="code-text">  -  Windows' ``color`` (:issue:`8483`), ``attrib``, ``attributes``, ``choice``, ``clean``, ``cleanmgr``, ``cmd``, ``cmdkey``, ``comp``, ``forfiles``, ``powershell``, ``reg``, ``schtasks``, ``setx`` (:issue:`8486`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1790" href="#L1790">1790</a><span class="code-text">  - ``zef`` (:issue:`8114`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1791" href="#L1791">1791</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1792" href="#L1792">1792</a><span class="code-text">- Improvements to many completions, especially for ``git`` aliases (:issue:`8129`), subcommands (:issue:`8134`) and submodules (:issue:`8716`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1793" href="#L1793">1793</a><span class="code-text">- Many adjustments to complete correct options for system utilities on BSD and macOS.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1794" href="#L1794">1794</a><span class="code-text">- When evaluating custom completions, the command line state no longer includes variable overrides (``var=val``). This unbreaks completions that read ``commandline -op``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1795" href="#L1795">1795</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1796" href="#L1796">1796</a><span class="code-text">Improved terminal support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1797" href="#L1797">1797</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1798" href="#L1798">1798</a><span class="code-text">- Dynamic terminal titles are enabled on WezTerm (:issue:`8121`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1799" href="#L1799">1799</a><span class="code-text">- Directory history navigation works out of the box with Apple Terminal's default key settings (:issue:`2330`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1800" href="#L1800">1800</a><span class="code-text">- fish now assumes Unicode 9+ widths for emoji under iTerm 2 (:issue:`8200`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1801" href="#L1801">1801</a><span class="code-text">- Skin-tone emoji modifiers (U+1F3FB through U+1F3FF) are now measured as width 0 (:issue:`8275`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1802" href="#L1802">1802</a><span class="code-text">- fish's escape sequence removal now also knows Tmux's wrapped escapes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1803" href="#L1803">1803</a><span class="code-text">- Vi mode cursors are enabled in Apple Terminal.app (:issue:`8167`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1804" href="#L1804">1804</a><span class="code-text">- Vi cursor shaping and $PWD reporting is now also enabled on foot (:issue:`8422`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1805" href="#L1805">1805</a><span class="code-text">- ``ls`` will use colors also on newer versions of Apple Terminal.app (:issue:`8309`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1806" href="#L1806">1806</a><span class="code-text">- The :kbd:`delete` and :kbd:`shift-tab` keys work more reliably under ``st`` (:issue:`8352`, :issue:`8354`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1807" href="#L1807">1807</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1808" href="#L1808">1808</a><span class="code-text">Other improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1809" href="#L1809">1809</a><span class="code-text">------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1810" href="#L1810">1810</a><span class="code-text">- fish's test suite now uses ``ctest``, and has become much faster to run. It is now also possible to run only specific tests with targets named ``test_$filename`` - ``make test_set.fish`` only runs the set.fish test. (:issue:`7851`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1811" href="#L1811">1811</a><span class="code-text">- The HTML version of the documentation now includes copy buttons for code examples (:issue:`8218`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1812" href="#L1812">1812</a><span class="code-text">- The HTML version of the documentation and the web-based configuration tool now pick more modern system fonts instead of falling back to Arial and something like Courier New most of the time (:issue:`8632`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1813" href="#L1813">1813</a><span class="code-text">- The Debian &amp; Ubuntu package linked from fishshell.com is now a single package, rather than split into ``fish`` and ``fish-common`` (:issue:`7845`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1814" href="#L1814">1814</a><span class="code-text">- The macOS installer does not assert that Rosetta is required to install fish on machines with Apple Silicon (:issue:`8566`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1815" href="#L1815">1815</a><span class="code-text">- The macOS installer now cleans up previous .pkg installations when upgrading. (:issue:`2963`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1816" href="#L1816">1816</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1817" href="#L1817">1817</a><span class="code-text">For distributors</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1818" href="#L1818">1818</a><span class="code-text">----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1819" href="#L1819">1819</a><span class="code-text">- The minimum version of CMake required to build fish is now 3.5.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1820" href="#L1820">1820</a><span class="code-text">- The CMake installation supports absolute paths for ``CMAKE_INSTALL_DATADIR`` (:issue:`8150`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1821" href="#L1821">1821</a><span class="code-text">- Building using NetBSD curses works on any platform (:issue:`8087`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1822" href="#L1822">1822</a><span class="code-text">- The build system now uses the default linker instead of forcing use of the gold or lld linker (:issue:`8152`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1823" href="#L1823">1823</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1824" href="#L1824">1824</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1825" href="#L1825">1825</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1826" href="#L1826">1826</a><span class="code-text">fish 3.3.1 (released July 6, 2021)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1827" href="#L1827">1827</a><span class="code-text">==================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1828" href="#L1828">1828</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1829" href="#L1829">1829</a><span class="code-text">This release of fish fixes the following problems identified in fish 3.3.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1830" href="#L1830">1830</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1831" href="#L1831">1831</a><span class="code-text">- The prompt and command line are redrawn correctly in response to universal variable changes (:issue:`8088`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1832" href="#L1832">1832</a><span class="code-text">- A superfluous error that was produced when setting the ``PATH`` or ``CDPATH`` environment variables to include colon-delimited components that do not exist was removed (:issue:`8095`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1833" href="#L1833">1833</a><span class="code-text">- The Vi mode indicator in the prompt is repainted correctly after :kbd:`ctrl-c` cancels the current command (:issue:`8103`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1834" href="#L1834">1834</a><span class="code-text">- fish builds correctly on platforms that do not have a ``spawn.h`` header, such as old versions of OS X (:issue:`8097`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1835" href="#L1835">1835</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1836" href="#L1836">1836</a><span class="code-text">A number of improvements to the documentation, and fixes for completions, are included as well.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1837" href="#L1837">1837</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1838" href="#L1838">1838</a><span class="code-text">If you are upgrading from version 3.2.2 or before, please also review the release notes for 3.3.0 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1839" href="#L1839">1839</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1840" href="#L1840">1840</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1841" href="#L1841">1841</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1842" href="#L1842">1842</a><span class="code-text">fish 3.3.0 (released June 28, 2021)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1843" href="#L1843">1843</a><span class="code-text">===================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1844" href="#L1844">1844</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1845" href="#L1845">1845</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1846" href="#L1846">1846</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1847" href="#L1847">1847</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1848" href="#L1848">1848</a><span class="code-text">- ``fish_config`` gained a ``prompt`` subcommand to show and pick from the sample prompts directly in the terminal, instead of having to open a webbrowser. For example ``fish_config prompt choose default`` loads the default prompt in the current session (:issue:`7958`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1849" href="#L1849">1849</a><span class="code-text">- The documentation has been reorganized to be easier to understand (:issue:`7773`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1850" href="#L1850">1850</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1851" href="#L1851">1851</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1852" href="#L1852">1852</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1853" href="#L1853">1853</a><span class="code-text">- The ``$fish_history`` value &quot;default&quot; is no longer special. It used to be treated the same as &quot;fish&quot; (:issue:`7650`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1854" href="#L1854">1854</a><span class="code-text">- Redirection to standard error with the ``^`` character has been disabled by default. It can be turned back on using the ``stderr-nocaret`` feature flag, but will eventually be disabled completely (:issue:`7105`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1855" href="#L1855">1855</a><span class="code-text">- Specifying an initial tab to ``fish_config`` now only works with ``fish_config browse`` (eg ``fish_config browse variables``), otherwise it would interfere with the new ``prompt`` subcommand (see below) (:issue:`7958`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1856" href="#L1856">1856</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1857" href="#L1857">1857</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1858" href="#L1858">1858</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1859" href="#L1859">1859</a><span class="code-text">- ``math`` gained new functions ``log2`` (like the documentation claimed), ``max`` and ``min`` (:issue:`7856`). ``math`` functions can be used without the parentheses (eg ``math sin 2 + 6``), and functions have the lowest precedence in the order of operations (:issue:`7877`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1860" href="#L1860">1860</a><span class="code-text">- Shebang (``#!``) lines are no longer required within shell scripts, improving support for scripts with concatenated binary contents. If a file fails to execute and passes a (rudimentary) binary safety check, fish will re-invoke it using ``/bin/sh`` (:issue:`7802`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1861" href="#L1861">1861</a><span class="code-text">- Exit codes are better aligned with bash. A failed execution now reports ``$status`` of 127 if the file is not found, and 126 if it is not executable.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1862" href="#L1862">1862</a><span class="code-text">- ``echo`` no longer writes its output one byte at a time, improving performance and allowing use with Linux's special API files (``/proc``, ``/sys`` and such) (:issue:`7836`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1863" href="#L1863">1863</a><span class="code-text">- fish should now better handle ``cd`` on filesystems with broken ``stat(3)`` responses (:issue:`7577`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1864" href="#L1864">1864</a><span class="code-text">- Builtins now properly report a ``$status`` of 1 upon unsuccessful writes (:issue:`7857`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1865" href="#L1865">1865</a><span class="code-text">- ``string match`` with unmatched capture groups and without the ``--all`` flag now sets an empty variable instead of a variable containing the empty string. It also correctly imports the first match if multiple arguments are provided, matching the documentation. (:issue:`7938`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1866" href="#L1866">1866</a><span class="code-text">- fish produces more specific errors when a command in a command substitution wasn't found or is not allowed. This now prints something like &quot;Unknown command&quot; instead of &quot;Unknown error while evaluating command substitution&quot;.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1867" href="#L1867">1867</a><span class="code-text">- ``fish_indent`` allows inline variable assignments (``FOO=BAR command``) to use line continuation, instead of joining them into one line (:issue:`7955`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1868" href="#L1868">1868</a><span class="code-text">- fish gained a ``--no-config`` option to disable configuration files. This applies to user-specific and the systemwide ``config.fish`` (typically in ``/etc/fish/config.fish``), and configuration snippets (typically in ``conf.d`` directories). It also disables universal variables, history, and loading of functions from system or user configuration directories (:issue:`7921`, :issue:`1256`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1869" href="#L1869">1869</a><span class="code-text">- When universal variables are unavailable for some reason, setting a universal variable now sets a global variable instead (:issue:`7921`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1870" href="#L1870">1870</a><span class="code-text">- ``$last_pid`` now contains the process ID of the last process in the pipeline, allowing it to be used in scripts (:issue:`5036`, :issue:`5832`, :issue:`7721`). Previously, this value contained the process group ID, but in scripts this was the same as the running fish's process ID.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1871" href="#L1871">1871</a><span class="code-text">- ``process-exit`` event handlers now receive the same value as ``$status`` in all cases, instead of receiving -1 when the exit was due to a signal.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1872" href="#L1872">1872</a><span class="code-text">- ``process-exit`` event handlers for PID 0 also received ``JOB_EXIT`` events; this has been fixed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1873" href="#L1873">1873</a><span class="code-text">- ``job-exit`` event handlers may now be created with any of the PIDs from the job. The handler is passed the last PID in the job as its second argument, instead of the process group.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1874" href="#L1874">1874</a><span class="code-text">- Trying to set an empty variable name with ``set`` no longer works (these variables could not be used in expansions anyway).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1875" href="#L1875">1875</a><span class="code-text">- ``fish_add_path`` handles an undefined ``PATH`` environment variable correctly (:issue:`8082`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1876" href="#L1876">1876</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1877" href="#L1877">1877</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1878" href="#L1878">1878</a><span class="code-text">-------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1879" href="#L1879">1879</a><span class="code-text">- Commands entered before the previous command finishes will now be properly syntax highlighted.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1880" href="#L1880">1880</a><span class="code-text">- fish now automatically creates ``config.fish`` and the configuration directories in ``$XDG_CONFIG_HOME/fish`` (by default ``~/.config/fish``) if they do not already exist (:issue:`7402`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1881" href="#L1881">1881</a><span class="code-text">- ``$SHLVL`` is no longer incremented in non-interactive shells. This means it won't be set to values larger than 1 just because your environment happens to run some scripts in $SHELL in its startup path (:issue:`7864`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1882" href="#L1882">1882</a><span class="code-text">- fish no longer rings the bell when flashing the command line. The flashing should already be enough notification and the bell can be annoying (:issue:`7875`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1883" href="#L1883">1883</a><span class="code-text">- ``fish --help`` is more helpful if the documentation isn't installed (:issue:`7824`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1884" href="#L1884">1884</a><span class="code-text">- ``funced`` won't include an entry on where a function is defined, thanks to the new ``functions --no-details`` option (:issue:`7879`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1885" href="#L1885">1885</a><span class="code-text">- A new variable, ``fish_killring``, containing entries from the killring, is now available (:issue:`7445`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1886" href="#L1886">1886</a><span class="code-text">- ``fish --private`` prints a note on private mode on startup even if ``$fish_greeting`` is an empty list (:issue:`7974`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1887" href="#L1887">1887</a><span class="code-text">- fish no longer attempts to lock history or universal variable files on remote filesystems, including NFS and Samba mounts. In rare cases, updates to these files may be dropped if separate fish instances modify them simultaneously. (:issue:`7968`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1888" href="#L1888">1888</a><span class="code-text">- ``wait`` and ``on-process-exit`` work correctly with jobs that have already exited (:issue:`7210`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1889" href="#L1889">1889</a><span class="code-text">- ``__fish_print_help`` (used for ``--help`` output for fish's builtins) now respects the ``LESS`` environment variable, and if not set, uses better default pager settings (:issue:`7997`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1890" href="#L1890">1890</a><span class="code-text">- Errors from ``alias`` are now printed to standard error, matching other builtins and functions (:issue:`7925`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1891" href="#L1891">1891</a><span class="code-text">- ``ls`` output is colorized on OpenBSD if colorls utility is installed (:issue:`8035`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1892" href="#L1892">1892</a><span class="code-text">- The default pager color looks better in terminals with light backgrounds (:issue:`3412`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1893" href="#L1893">1893</a><span class="code-text">- Further robustness improvements to the bash history import (:issue:`7874`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1894" href="#L1894">1894</a><span class="code-text">- fish now tries to find a Unicode-aware locale for encoding (``LC_CTYPE``) if started without any locale information, improving the display of emoji and other non-ASCII text on misconfigured systems (:issue:`8031`). To allow a C locale, set the variable ``fish_allow_singlebyte_locale`` to 1.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1895" href="#L1895">1895</a><span class="code-text">- The Web-based configuration and documentation now feature a dark mode if the browser requests it (:issue:`8043`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1896" href="#L1896">1896</a><span class="code-text">- Color variables can now also be given like ``--background red`` and ``-b red``, not just ``--background=red`` (:issue:`8053`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1897" href="#L1897">1897</a><span class="code-text">- ``exit`` run within ``fish_prompt`` now exits properly (:issue:`8033`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1898" href="#L1898">1898</a><span class="code-text">- When attempting to execute the unsupported POSIX-style brace command group (``{ ... }``) fish will suggest its equivalent ``begin; ...; end`` commands (:issue:`6415`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1899" href="#L1899">1899</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1900" href="#L1900">1900</a><span class="code-text">New or improved bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1901" href="#L1901">1901</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1902" href="#L1902">1902</a><span class="code-text">- Pasting in Vi mode puts text in the right place in normal mode (:issue:`7847`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1903" href="#L1903">1903</a><span class="code-text">- Vi mode's :kbd:`u` is bound to ``undo`` instead of ``history-search-backward``, following GNU readline's behavior. Similarly, :kbd:`ctrl-r` is bound to ``redo`` instead of ``history-search-backward``, following Vim (:issue:`7908`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1904" href="#L1904">1904</a><span class="code-text">- :kbd:`s` in Vi visual mode now does the same thing as :kbd:`c` (:issue:`8039`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1905" href="#L1905">1905</a><span class="code-text">- The binding for :kbd:`&quot;,*,y` now uses ``fish_clipboard_copy``, allowing it to support more than just ``xsel``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1906" href="#L1906">1906</a><span class="code-text">- The :kbd:`ctrl-space` binding can be correctly customised (:issue:`7922`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1907" href="#L1907">1907</a><span class="code-text">- ``exit`` works correctly in bindings (:issue:`7967`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1908" href="#L1908">1908</a><span class="code-text">- The :kbd:`f1` binding, which opens the manual page for the current command, now works around a bug in certain ``less`` versions that fail to clear the screen (:issue:`7863`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1909" href="#L1909">1909</a><span class="code-text">- The binding for :kbd:`alt-s` now toggles whether ``sudo`` is prepended, even when it took the commandline from history instead of only adding it.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1910" href="#L1910">1910</a><span class="code-text">- The new functions ``fish_commandline_prepend`` and ``fish_commandline_append`` allow toggling the presence of a prefix/suffix on the current commandline. (:issue:`7905`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1911" href="#L1911">1911</a><span class="code-text">- ``backward-kill-path-component`` :kbd:`ctrl-w`) no longer erases parts of two tokens when the cursor is positioned immediately after ``/``. (:issue:`6258`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1912" href="#L1912">1912</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1913" href="#L1913">1913</a><span class="code-text">Improved prompts</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1914" href="#L1914">1914</a><span class="code-text">^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1915" href="#L1915">1915</a><span class="code-text">- The default Vi mode prompt now uses foreground instead of background colors, making it less obtrusive (:issue:`7880`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1916" href="#L1916">1916</a><span class="code-text">- Performance of the &quot;informative&quot; git prompt is improved somewhat (:issue:`7871`). This is still slower than the non-informative version by its very nature. In particular it is IO-bound, so it will be very slow on slow disks or network mounts.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1917" href="#L1917">1917</a><span class="code-text">- The sample prompts were updated. Some duplicated prompts, like the various classic variants, or less useful ones, like the &quot;justadollar&quot; prompt were removed, some prompts were cleaned up, and in some cases renamed. A new &quot;simple&quot; and &quot;disco&quot; prompt were added (:issue:`7884`, :issue:`7897`, :issue:`7930`). The new prompts will only take effect when selected and existing installed prompts will remain unchanged.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1918" href="#L1918">1918</a><span class="code-text">- A new ``prompt_login`` helper function to describe the kind of &quot;login&quot; (user, host and chroot status) for use in prompts. This replaces the old &quot;debian chroot&quot; prompt and has been added to the default and terlar prompts (:issue:`7932`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1919" href="#L1919">1919</a><span class="code-text">- The Web-based configuration's prompt picker now shows and installs right prompts (:issue:`7930`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1920" href="#L1920">1920</a><span class="code-text">- The git prompt now has the same symbol order in normal and &quot;informative&quot; mode, and it's customizable via ``$__fish_git_prompt_status_order`` (:issue:`7926`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1921" href="#L1921">1921</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1922" href="#L1922">1922</a><span class="code-text">Completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1923" href="#L1923">1923</a><span class="code-text">^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1924" href="#L1924">1924</a><span class="code-text">- Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1925" href="#L1925">1925</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1926" href="#L1926">1926</a><span class="code-text">  - ``firewall-cmd`` (:issue:`7900`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1927" href="#L1927">1927</a><span class="code-text">  - ``sv`` (:issue:`8069`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1928" href="#L1928">1928</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1929" href="#L1929">1929</a><span class="code-text">- Improvements to plenty of completions!</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1930" href="#L1930">1930</a><span class="code-text">- Commands that wrap ``cd`` (using ``complete --wraps cd``) get the same completions as ``cd`` (:issue:`4693`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1931" href="#L1931">1931</a><span class="code-text">- The ``--force-files`` option to ``complete`` works for bare arguments, not just options (:issue:`7920`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1932" href="#L1932">1932</a><span class="code-text">- Completion descriptions for functions don't include the function definition, making them more concise (:issue:`7911`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1933" href="#L1933">1933</a><span class="code-text">- The ``kill`` completions no longer error on MSYS2 (:issue:`8046`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1934" href="#L1934">1934</a><span class="code-text">- Completion scripts are now loaded when calling a command via a relative path (like ``./git``) (:issue:`6001`, :issue:`7992`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1935" href="#L1935">1935</a><span class="code-text">- When there are multiple completion candidates, fish inserts their shared prefix. This prefix was computed in a case-insensitive way, resulting in wrong case in the completion pager. This was fixed by only inserting prefixes with matching case (:issue:`7744`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1936" href="#L1936">1936</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1937" href="#L1937">1937</a><span class="code-text">Improved terminal support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1938" href="#L1938">1938</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1939" href="#L1939">1939</a><span class="code-text">- fish no longer tries to detect a missing new line during startup, preventing an erroneous ``⏎`` from appearing if the terminal is resized at the wrong time, which can happen in tiling window managers (:issue:`7893`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1940" href="#L1940">1940</a><span class="code-text">- fish behaves better when it disagrees with the terminal on the width of characters. In particular, staircase effects with right prompts should be gone in most cases (:issue:`8011`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1941" href="#L1941">1941</a><span class="code-text">- If the prompt takes up the entire line, the last character should no longer be chopped off in certain terminals (:issue:`8002`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1942" href="#L1942">1942</a><span class="code-text">- fish's reflow handling has been disabled by default for kitty (:issue:`7961`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1943" href="#L1943">1943</a><span class="code-text">- The default prompt no longer produces errors when used with a dumb terminal (:issue:`7904`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1944" href="#L1944">1944</a><span class="code-text">- Terminal size variables are updated for window size change signal handlers (``SIGWINCH``).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1945" href="#L1945">1945</a><span class="code-text">- Pasting within a multi-line command using a terminal that supports bracketed paste works correctly, instead of producing an error (:issue:`7782`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1946" href="#L1946">1946</a><span class="code-text">- ``set_color`` produces an error when used with invalid arguments, rather than empty output which interacts badly with Cartesian product expansion.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1947" href="#L1947">1947</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1948" href="#L1948">1948</a><span class="code-text">For distributors</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1949" href="#L1949">1949</a><span class="code-text">----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1950" href="#L1950">1950</a><span class="code-text">- fish runs correctly on platforms without the ``O_CLOEXEC`` flag for ``open(2)`` (:issue:`8023`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1951" href="#L1951">1951</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1952" href="#L1952">1952</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1953" href="#L1953">1953</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1954" href="#L1954">1954</a><span class="code-text">fish 3.2.2 (released April 7, 2021)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1955" href="#L1955">1955</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1956" href="#L1956">1956</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1957" href="#L1957">1957</a><span class="code-text">This release of fish fixes a number of additional issues identified in the fish 3.2 series:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1958" href="#L1958">1958</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1959" href="#L1959">1959</a><span class="code-text">- The command-not-found handler used suggestions from ``pacman`` on Arch Linux, but this caused major slowdowns on some systems and has been disabled (:issue:`7841`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1960" href="#L1960">1960</a><span class="code-text">- fish will no longer hang on exit if another process is in the foreground on macOS (:issue:`7901`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1961" href="#L1961">1961</a><span class="code-text">- Certain programs (such as ``lazygit``) could create situations where fish would not receive keystrokes correctly, but it is now more robust in these situations (:issue:`7853`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1962" href="#L1962">1962</a><span class="code-text">- Arguments longer than 1024 characters no longer trigger excessive CPU usage on macOS (:issue:`7837`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1963" href="#L1963">1963</a><span class="code-text">- fish builds correctly on macOS when using new versions of Xcode (:issue:`7838`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1964" href="#L1964">1964</a><span class="code-text">- Completions for ``aura`` (:issue:`7865`) and ``tshark`` (:issue:`7858`) should no longer produce errors.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1965" href="#L1965">1965</a><span class="code-text">- Background jobs no longer interfere with syntax highlighting (a regression introduced in fish 3.2.1, :issue:`7842`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1966" href="#L1966">1966</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1967" href="#L1967">1967</a><span class="code-text">If you are upgrading from version 3.1.2 or before, please also review the release notes for 3.2.1 and 3.2.0 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1968" href="#L1968">1968</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1969" href="#L1969">1969</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1970" href="#L1970">1970</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1971" href="#L1971">1971</a><span class="code-text">fish 3.2.1 (released March 18, 2021)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1972" href="#L1972">1972</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1973" href="#L1973">1973</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1974" href="#L1974">1974</a><span class="code-text">This release of fish fixes the following problems identified in fish 3.2.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1975" href="#L1975">1975</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1976" href="#L1976">1976</a><span class="code-text">-  Commands in key bindings are run with fish's internal terminal modes, instead of the terminal modes typically used for commands. This fixes a bug introduced in 3.2.0, where text would unexpectedly appear on the terminal, especially when pasting (:issue:`7770`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1977" href="#L1977">1977</a><span class="code-text">-  Prompts which use the internal ``__fish_print_pipestatus`` function will display correctly rather than carrying certain modifiers (such as bold) further than intended (:issue:`7771`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1978" href="#L1978">1978</a><span class="code-text">-  Redirections to internal file descriptors is allowed again, reversing the changes in 3.2.0. This fixes a problem with Midnight Commander (:issue:`7769`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1979" href="#L1979">1979</a><span class="code-text">-  Universal variables should be fully reliable regardless of operating system again (:issue:`7774`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1980" href="#L1980">1980</a><span class="code-text">-  ``fish_git_prompt`` no longer causes screen flickering in certain terminals (:issue:`7775`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1981" href="#L1981">1981</a><span class="code-text">-  ``fish_add_path`` manipulates the ``fish_user_paths`` variable correctly when moving multiple paths (:issue:`7776`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1982" href="#L1982">1982</a><span class="code-text">-  Pasting with a multi-line command no longer causes a ``__fish_tokenizer_state`` error (:issue:`7782`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1983" href="#L1983">1983</a><span class="code-text">-  ``psub`` inside event handlers cleans up temporary files properly (:issue:`7792`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1984" href="#L1984">1984</a><span class="code-text">-  Event handlers declared with ``--on-job-exit $fish_pid`` no longer run constantly (:issue:`7721`), although these functions should use ``--on-event fish_exit`` instead.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1985" href="#L1985">1985</a><span class="code-text">-  Changing terminal modes inside ``config.fish`` works (:issue:`7783`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1986" href="#L1986">1986</a><span class="code-text">-  ``set_color --print-colors`` no longer prints all colors in bold (:issue:`7805`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1987" href="#L1987">1987</a><span class="code-text">-  Completing commands starting with a ``-`` no longer prints an error (:issue:`7809`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1988" href="#L1988">1988</a><span class="code-text">-  Running ``fish_command_not_found`` directly no longer produces an error on macOS or other OSes which do not have a handler available (:issue:`7777`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1989" href="#L1989">1989</a><span class="code-text">-  The new ``type`` builtin now has the (deprecated) ``--quiet`` long form of ``-q`` (:issue:`7766`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1990" href="#L1990">1990</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1991" href="#L1991">1991</a><span class="code-text">It also includes some small enhancements:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1992" href="#L1992">1992</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1993" href="#L1993">1993</a><span class="code-text">-  ``help`` and ``fish_config`` work correctly when fish is running in a Chrome OS Crostini Linux VM (:issue:`7789`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1994" href="#L1994">1994</a><span class="code-text">-  The history file can be made a symbolic link without it being overwritten (:issue:`7754`), matching a similar improvement for the universal variable file in 3.2.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1995" href="#L1995">1995</a><span class="code-text">-  An unhelpful error (&quot;access: No error&quot;), seen on Cygwin, is no longer produced (:issue:`7785`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1996" href="#L1996">1996</a><span class="code-text">-  Improvements to the ``rsync`` completions (:issue:`7763`), some completion descriptions (:issue:`7788`), and completions that use IP address (:issue:`7787`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1997" href="#L1997">1997</a><span class="code-text">-  Improvements to the appearance of ``fish_config`` (:issue:`7811`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1998" href="#L1998">1998</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1999" href="#L1999">1999</a><span class="code-text">If you are upgrading from version 3.1.2 or before, please also review</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2000" href="#L2000">2000</a><span class="code-text">the release notes for 3.2.0 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2001" href="#L2001">2001</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2002" href="#L2002">2002</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2003" href="#L2003">2003</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2004" href="#L2004">2004</a><span class="code-text">fish 3.2.0 (released March 1, 2021)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2005" href="#L2005">2005</a><span class="code-text">===================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2006" href="#L2006">2006</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2007" href="#L2007">2007</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2008" href="#L2008">2008</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2009" href="#L2009">2009</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2010" href="#L2010">2010</a><span class="code-text">-  **Undo and redo support** for the command-line editor and pager search (:issue:`1367`). By default, undo is bound to Control+Z, and redo to Alt+/.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2011" href="#L2011">2011</a><span class="code-text">-  **Builtins can now output before all data is read**. For example, ``string replace`` no longer has to read all of stdin before it can begin to output.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2012" href="#L2012">2012</a><span class="code-text">   This makes it usable also for pipes where the previous command hasn't finished yet, like::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2013" href="#L2013">2013</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2014" href="#L2014">2014</a><span class="code-text">    # Show all dmesg lines related to &quot;usb&quot;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2015" href="#L2015">2015</a><span class="code-text">    dmesg -w | string match '*usb*'</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2016" href="#L2016">2016</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2017" href="#L2017">2017</a><span class="code-text">-  **Prompts will now be truncated** instead of replaced with ``&quot;&gt; &quot;`` if they are wider than the terminal (:issue:`904`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2018" href="#L2018">2018</a><span class="code-text">   For example::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2019" href="#L2019">2019</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2020" href="#L2020">2020</a><span class="code-text">     ~/dev/build/fish-shell-git/src/fish-shell/build (makepkg)&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2021" href="#L2021">2021</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2022" href="#L2022">2022</a><span class="code-text">   will turn into::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2023" href="#L2023">2023</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2024" href="#L2024">2024</a><span class="code-text">     …h-shell/build (makepkg)&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2025" href="#L2025">2025</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2026" href="#L2026">2026</a><span class="code-text">   It is still possible to react to the ``COLUMNS`` variable inside the prompt to implement smarter behavior.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2027" href="#L2027">2027</a><span class="code-text">-  **fish completes ambiguous completions** after pressing :kbd:`tab` even when they</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2028" href="#L2028">2028</a><span class="code-text">   have a common prefix, without the user having to press :kbd:`tab` again</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2029" href="#L2029">2029</a><span class="code-text">   (:issue:`6924`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2030" href="#L2030">2030</a><span class="code-text">-  fish is less aggressive about resetting terminal modes, such as flow control, after every command.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2031" href="#L2031">2031</a><span class="code-text">   Although flow control remains off by default, enterprising users can now enable it with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2032" href="#L2032">2032</a><span class="code-text">   ``stty`` (:issue:`2315`, :issue:`7704`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2033" href="#L2033">2033</a><span class="code-text">-  A new **&quot;fish_add_path&quot; helper function to add paths to $PATH** without producing duplicates,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2034" href="#L2034">2034</a><span class="code-text">   to be used interactively or in ``config.fish`` (:issue:`6960`, :issue:`7028`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2035" href="#L2035">2035</a><span class="code-text">   For example::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2036" href="#L2036">2036</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2037" href="#L2037">2037</a><span class="code-text">     fish_add_path /opt/mycoolthing/bin</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2038" href="#L2038">2038</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2039" href="#L2039">2039</a><span class="code-text">   will add /opt/mycoolthing/bin to the beginning of $fish_user_path without creating duplicates,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2040" href="#L2040">2040</a><span class="code-text">   so it can be called safely from config.fish or interactively, and the path will just be there, once.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2041" href="#L2041">2041</a><span class="code-text">-  **Better errors with &quot;test&quot;** (:issue:`6030`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2042" href="#L2042">2042</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2043" href="#L2043">2043</a><span class="code-text">    &gt; test 1 = 2 and echo true or false</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2044" href="#L2044">2044</a><span class="code-text">    test: Expected a combining operator like '-a' at index 4</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2045" href="#L2045">2045</a><span class="code-text">    1 = 2 and echo true or echo false</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2046" href="#L2046">2046</a><span class="code-text">          ^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2047" href="#L2047">2047</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2048" href="#L2048">2048</a><span class="code-text">   This includes numbering the index from 1 instead of 0, like fish lists.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2049" href="#L2049">2049</a><span class="code-text">-  **A new theme for the documentation and Web-based configuration** (:issue:`6500`, :issue:`7371`, :issue:`7523`), matching the design on fishshell.com.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2050" href="#L2050">2050</a><span class="code-text">-  ``fish --no-execute`` **will no longer complain about unknown commands**</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2051" href="#L2051">2051</a><span class="code-text">   or non-matching wildcards, as these could be defined differently at</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2052" href="#L2052">2052</a><span class="code-text">   runtime (especially for functions). This makes it usable as a static syntax checker (:issue:`977`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2053" href="#L2053">2053</a><span class="code-text">-  ``string match --regex`` now integrates **named PCRE2 capture groups as fish variables**, allowing variables to be set directly from ``string match`` (:issue:`7459`). To support this functionality, ``string`` is now a reserved word and can no longer be wrapped in a function.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2054" href="#L2054">2054</a><span class="code-text">-  Globs and other **expansions are limited to 512,288 results** (:issue:`7226`). Because operating systems limit the number of arguments to commands, larger values are unlikely to work anyway, and this helps to avoid hangs.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2055" href="#L2055">2055</a><span class="code-text">-  A new **&quot;fish for bash users&quot; documentation page** gives a quick overview of the scripting differences between bash and fish (:issue:`2382`), and the completion tutorial has also been moved out into its own document (:issue:`6709`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2056" href="#L2056">2056</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2057" href="#L2057">2057</a><span class="code-text">Syntax changes and new commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2058" href="#L2058">2058</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2059" href="#L2059">2059</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2060" href="#L2060">2060</a><span class="code-text">-  Range limits in index range expansions like ``$x[$start..$end]`` may be omitted: ``$start`` and ``$end`` default to 1 and -1 (the last item) respectively (:issue:`6574`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2061" href="#L2061">2061</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2062" href="#L2062">2062</a><span class="code-text">     echo $var[1..]</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2063" href="#L2063">2063</a><span class="code-text">     echo $var[..-1]</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2064" href="#L2064">2064</a><span class="code-text">     echo $var[..]</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2065" href="#L2065">2065</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2066" href="#L2066">2066</a><span class="code-text">   All print the full list ``$var``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2067" href="#L2067">2067</a><span class="code-text">-  When globbing, a segment which is exactly ``**`` may now match zero directories. For example ``**/foo`` may match ``foo`` in the current directory (:issue:`7222`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2068" href="#L2068">2068</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2069" href="#L2069">2069</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2070" href="#L2070">2070</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2071" href="#L2071">2071</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2072" href="#L2072">2072</a><span class="code-text">-  The ``type``, ``_`` (gettext), ``.`` (source) and ``:`` (no-op) functions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2073" href="#L2073">2073</a><span class="code-text">   are now implemented builtins for performance purposes (:issue:`7342`, :issue:`7036`, :issue:`6854`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2074" href="#L2074">2074</a><span class="code-text">-  ``set`` and backgrounded jobs no longer overwrite ``$pipestatus`` (:issue:`6820`), improving its use in command substitutions (:issue:`6998`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2075" href="#L2075">2075</a><span class="code-text">-  Computed (&quot;electric&quot;) variables such as ``status`` are now only global in scope, so ``set -Uq status`` returns false (:issue:`7032`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2076" href="#L2076">2076</a><span class="code-text">-  The output for ``set --show`` has been shortened, only mentioning the scopes in which a variable exists (:issue:`6944`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2077" href="#L2077">2077</a><span class="code-text">   In addition, it now shows if a variable is a path variable.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2078" href="#L2078">2078</a><span class="code-text">-  A new variable, ``fish_kill_signal``, is set to the signal that terminated the last foreground job, or ``0`` if the job exited normally (:issue:`6824`, :issue:`6822`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2079" href="#L2079">2079</a><span class="code-text">-  A new subcommand, ``string pad``, allows extending strings to a given width (:issue:`7340`, :issue:`7102`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2080" href="#L2080">2080</a><span class="code-text">-  ``string sub`` has a new ``--end`` option to specify the end index of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2081" href="#L2081">2081</a><span class="code-text">   a substring (:issue:`6765`, :issue:`5974`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2082" href="#L2082">2082</a><span class="code-text">-  ``string split`` has a new ``--fields`` option to specify fields to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2083" href="#L2083">2083</a><span class="code-text">   output, similar to ``cut -f`` (:issue:`6770`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2084" href="#L2084">2084</a><span class="code-text">-  ``string trim`` now also trims vertical tabs by default (:issue:`6795`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2085" href="#L2085">2085</a><span class="code-text">-  ``string replace`` no longer prints an error if a capturing group wasn't matched, instead treating it as empty (:issue:`7343`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2086" href="#L2086">2086</a><span class="code-text">-  ``string`` subcommands now quit early when used with ``--quiet`` (:issue:`7495`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2087" href="#L2087">2087</a><span class="code-text">-  ``string repeat`` now handles multiple arguments, repeating each one (:issue:`5988`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2088" href="#L2088">2088</a><span class="code-text">-  ``printf`` no longer prints an error if not given an argument (not</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2089" href="#L2089">2089</a><span class="code-text">   even a format string).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2090" href="#L2090">2090</a><span class="code-text">-  The ``true`` and ``false`` builtins ignore any arguments, like other shells (:issue:`7030`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2091" href="#L2091">2091</a><span class="code-text">-  ``fish_indent`` now removes unnecessary quotes in simple cases (:issue:`6722`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2092" href="#L2092">2092</a><span class="code-text">   and gained a ``--check`` option to just check if a file is indented correctly (:issue:`7251`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2093" href="#L2093">2093</a><span class="code-text">-  ``fish_indent`` indents continuation lines that follow a line ending in a backslash, ``|``, ``&amp;&amp;`` or ``||``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2094" href="#L2094">2094</a><span class="code-text">-  ``pushd`` only adds a directory to the stack if changing to it was successful (:issue:`6947`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2095" href="#L2095">2095</a><span class="code-text">-  A new ``fish_job_summary`` function is called whenever a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2096" href="#L2096">2096</a><span class="code-text">   background job stops or ends, or any job terminates from a signal (:issue:`6959`, :issue:`2727`, :issue:`4319`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2097" href="#L2097">2097</a><span class="code-text">   The default behaviour can now be customized by redefining it.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2098" href="#L2098">2098</a><span class="code-text">-  ``status`` gained new ``dirname`` and ``basename`` convenience subcommands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2099" href="#L2099">2099</a><span class="code-text">   to get just the directory to the running script or the name of it,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2100" href="#L2100">2100</a><span class="code-text">   to simplify common tasks such as running ``(dirname (status filename))`` (:issue:`7076`, :issue:`1818`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2101" href="#L2101">2101</a><span class="code-text">-  Broken pipelines are now handled more smoothly; in particular, bad redirection mid-pipeline</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2102" href="#L2102">2102</a><span class="code-text">   results in the job continuing to run but with the broken file descriptor replaced with a closed</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2103" href="#L2103">2103</a><span class="code-text">   file descriptor. This allows better error recovery and is more in line with other shells'</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2104" href="#L2104">2104</a><span class="code-text">   behaviour (:issue:`7038`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2105" href="#L2105">2105</a><span class="code-text">-  ``jobs --quiet PID`` no longer prints &quot;no suitable job&quot; if the job for PID does not exist (eg because it has finished) (:issue:`6809`, :issue:`6812`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2106" href="#L2106">2106</a><span class="code-text">-  ``jobs`` now shows continued child processes correctly (:issue:`6818`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2107" href="#L2107">2107</a><span class="code-text">-  ``disown`` should no longer create zombie processes when job control is off, such as in ``config.fish`` (:issue:`7183`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2108" href="#L2108">2108</a><span class="code-text">-  ``command``, ``jobs`` and ``type`` builtins support ``--query`` as the long form of ``-q``, matching other builtins.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2109" href="#L2109">2109</a><span class="code-text">   The long form ``--quiet`` is deprecated (:issue:`7276`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2110" href="#L2110">2110</a><span class="code-text">-  ``argparse`` no longer requires a short flag letter for long-only options (:issue:`7585`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2111" href="#L2111">2111</a><span class="code-text">   and only prints a backtrace with invalid options to argparse itself (:issue:`6703`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2112" href="#L2112">2112</a><span class="code-text">-  ``argparse`` now passes the validation variables (e.g. ``$_flag_value``) as local-exported variables,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2113" href="#L2113">2113</a><span class="code-text">   avoiding the need for ``--no-scope-shadowing`` in validation functions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2114" href="#L2114">2114</a><span class="code-text">-  ``complete`` takes the first argument as the name of the command if the ``--command``/``-c`` option is not used,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2115" href="#L2115">2115</a><span class="code-text">   so ``complete git`` is treated like ``complete --command git``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2116" href="#L2116">2116</a><span class="code-text">   and it can show the loaded completions for specific commands with ``complete COMMANDNAME`` (:issue:`7321`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2117" href="#L2117">2117</a><span class="code-text">-  ``set_color -b`` (without an argument) no longer prints an error message, matching other invalid invocations of this command (:issue:`7154`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2118" href="#L2118">2118</a><span class="code-text">-  ``exec`` no longer produces a syntax error when the command cannot be found (:issue:`6098`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2119" href="#L2119">2119</a><span class="code-text">-  ``set --erase`` and ``abbr --erase`` can now erase multiple things in one go, matching ``functions --erase`` (:issue:`7377`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2120" href="#L2120">2120</a><span class="code-text">-  ``abbr --erase`` no longer prints errors when used with no arguments or on an unset abbreviation (:issue:`7376`, :issue:`7732`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2121" href="#L2121">2121</a><span class="code-text">-  ``test -t``, for testing whether file descriptors are connected to a terminal, works for file descriptors 0, 1, and 2 (:issue:`4766`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2122" href="#L2122">2122</a><span class="code-text">   It can still return incorrect results in other cases (:issue:`1228`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2123" href="#L2123">2123</a><span class="code-text">-  Trying to execute scripts with Windows line endings (CRLF) produces a sensible error (:issue:`2783`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2124" href="#L2124">2124</a><span class="code-text">-  Trying to execute commands with arguments that exceed the operating system limit now produces a specific error (:issue:`6800`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2125" href="#L2125">2125</a><span class="code-text">-  An ``alias`` that delegates to a command with the same name no longer triggers an error about recursive completion (:issue:`7389`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2126" href="#L2126">2126</a><span class="code-text">-  ``math`` now has a ``--base`` option to output the result in hexadecimal or octal (:issue:`7496`) and produces more specific error messages (:issue:`7508`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2127" href="#L2127">2127</a><span class="code-text">-  ``math`` learned bitwise functions ``bitand``, ``bitor`` and ``bitxor``, used like ``math &quot;bitand(0xFE, 5)&quot;`` (:issue:`7281`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2128" href="#L2128">2128</a><span class="code-text">-  ``math`` learned tau for those who don't like typing &quot;2 * pi&quot;.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2129" href="#L2129">2129</a><span class="code-text">-  Failed redirections will now set ``$status`` (:issue:`7540`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2130" href="#L2130">2130</a><span class="code-text">-  fish sets exit status in a more consistent manner after errors, including invalid expansions like ``$foo[``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2131" href="#L2131">2131</a><span class="code-text">-  Using ``read --silent`` while fish is in private mode was adding these potentially-sensitive entries to the history; this has been fixed (:issue:`7230`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2132" href="#L2132">2132</a><span class="code-text">-  ``read`` can now read interactively from other files, and can be used to read from the terminal via ``read &lt;/dev/tty`` (if the operating system provides ``/dev/tty``) (:issue:`7358`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2133" href="#L2133">2133</a><span class="code-text">-  A new ``fish_status_to_signal`` function for transforming exit statuses to signal names has been added (:issue:`7597`, :issue:`7595`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2134" href="#L2134">2134</a><span class="code-text">-  The fallback ``realpath`` builtin supports the ``-s``/``--no-symlinks`` option, like GNU realpath (:issue:`7574`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2135" href="#L2135">2135</a><span class="code-text">-  ``functions`` and ``type`` now explain when a function was defined via ``source`` instead of just saying ``Defined in -``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2136" href="#L2136">2136</a><span class="code-text">-  Significant performance improvements when globbing, appending to variables or in ``math``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2137" href="#L2137">2137</a><span class="code-text">-  ``echo`` no longer interprets options at the beginning of an argument (eg ``echo &quot;-n foo&quot;``) (:issue:`7614`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2138" href="#L2138">2138</a><span class="code-text">-  fish now finds user configuration even if the ``HOME`` environment variable is not set (:issue:`7620`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2139" href="#L2139">2139</a><span class="code-text">-  fish no longer crashes when started from a Windows-style working directory (eg ``F:\path``) (:issue:`7636`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2140" href="#L2140">2140</a><span class="code-text">-  ``fish -c`` now reads the remaining arguments into ``$argv`` (:issue:`2314`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2141" href="#L2141">2141</a><span class="code-text">-  The ``pwd`` command supports the long options ``--logical`` and ``--physical``, matching other implementations (:issue:`6787`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2142" href="#L2142">2142</a><span class="code-text">-  ``fish --profile`` now only starts profiling after fish is ready to execute commands (all configuration is completed). There is a new ``--profile-startup`` option that only profiles the startup and configuration process (:issue:`7648`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2143" href="#L2143">2143</a><span class="code-text">-  Builtins return a maximum exit status of 255, rather than potentially overflowing. In particular, this affects ``exit``, ``return``, ``functions --query``, and ``set --query`` (:issue:`7698`, :issue:`7702`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2144" href="#L2144">2144</a><span class="code-text">- It is no longer an error to run builtin with closed stdin. For example ``count &lt;&amp;-`` now prints 0, instead of failing.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2145" href="#L2145">2145</a><span class="code-text">- Blocks, functions, and builtins no longer permit redirecting to file descriptors other than 0 (standard input), 1 (standard output) and 2 (standard error). For example, ``echo hello &gt;&amp;5`` is now an error. This prevents corruption of internal state (:issue:`3303`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2146" href="#L2146">2146</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2147" href="#L2147">2147</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2148" href="#L2148">2148</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2149" href="#L2149">2149</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2150" href="#L2150">2150</a><span class="code-text">-  fish will now always attempt to become process group leader in interactive mode (:issue:`7060`). This helps avoid hangs in certain circumstances, and allows tmux's current directory introspection to work (:issue:`5699`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2151" href="#L2151">2151</a><span class="code-text">-  The interactive reader now allows ending a line in a logical operators (``&amp;&amp;`` and ``||``) instead of complaining about a missing command. (This was already syntactically valid, but interactive sessions didn't know about it yet).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2152" href="#L2152">2152</a><span class="code-text">-  The prompt is reprinted after a background job exits (:issue:`1018`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2153" href="#L2153">2153</a><span class="code-text">-  fish no longer inserts a space after a completion ending in ``.``, ``,`` or ``-`` is accepted, improving completions for tools that provide dynamic completions (:issue:`6928`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2154" href="#L2154">2154</a><span class="code-text">-  If a filename is invalid when first pressing :kbd:`tab`, but becomes valid, it will be completed properly on the next attempt (:issue:`6863`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2155" href="#L2155">2155</a><span class="code-text">- ``help string match/replace/&lt;subcommand&gt;`` will show the help for string subcommands (:issue:`6786`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2156" href="#L2156">2156</a><span class="code-text">-  ``fish_key_reader`` sets the exit status to 0 when used with ``--help`` or ``--version`` (:issue:`6964`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2157" href="#L2157">2157</a><span class="code-text">-  ``fish_key_reader`` and ``fish_indent`` send output from ``--version`` to standard output, matching other fish binaries (:issue:`6964`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2158" href="#L2158">2158</a><span class="code-text">-  A new variable ``$status_generation`` is incremented only when the previous command produces an exit status (:issue:`6815`). This can be used, for example, to check whether a failure status is a holdover due to a background job, or actually produced by the last run command.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2159" href="#L2159">2159</a><span class="code-text">-  ``fish_greeting`` is now a function that reads a variable of the same name, and defaults to setting it globally.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2160" href="#L2160">2160</a><span class="code-text">   This removes a universal variable by default and helps with updating the greeting.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2161" href="#L2161">2161</a><span class="code-text">   However, to disable the greeting it is now necessary to explicitly specify universal scope (``set -U fish_greeting``) or to disable it in config.fish (:issue:`7265`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2162" href="#L2162">2162</a><span class="code-text">-  Events are properly emitted after a job is cancelled (:issue:`2356`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2163" href="#L2163">2163</a><span class="code-text">-  ``fish_preexec`` and ``fish_postexec`` events are no longer triggered for empty commands (:issue:`4829`, :issue:`7085`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2164" href="#L2164">2164</a><span class="code-text">-  Functions triggered by the ``fish_exit`` event are correctly run when the terminal is closed or the shell receives SIGHUP (:issue:`7014`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2165" href="#L2165">2165</a><span class="code-text">-  The ``fish_prompt`` event no longer fires when ``read`` is used. If</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2166" href="#L2166">2166</a><span class="code-text">   you need a function to run any time ``read`` is invoked by a script,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2167" href="#L2167">2167</a><span class="code-text">   use the new ``fish_read`` event instead (:issue:`7039`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2168" href="#L2168">2168</a><span class="code-text">-  A new ``fish_posterror`` event is emitted when attempting to execute a command with syntax errors (:issue:`6880`, :issue:`6816`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2169" href="#L2169">2169</a><span class="code-text">-  The debugging system has now fully switched from the old numbered level to the new named category system introduced in 3.1. A number of new debugging categories have been added, including ``config``, ``path``, ``reader`` and ``screen`` (:issue:`6511`). See the output of ``fish --print-debug-categories`` for the full list.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2170" href="#L2170">2170</a><span class="code-text">-  The warning about read-only filesystems has been moved to a new &quot;warning-path&quot; debug category</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2171" href="#L2171">2171</a><span class="code-text">   and can be disabled by setting a debug category of ``-warning-path`` (:issue:`6630`)::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2172" href="#L2172">2172</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2173" href="#L2173">2173</a><span class="code-text">     fish --debug=-warning-path</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2174" href="#L2174">2174</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2175" href="#L2175">2175</a><span class="code-text">-  The enabled debug categories are now printed on shell startup (:issue:`7007`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2176" href="#L2176">2176</a><span class="code-text">-  The ``-o`` short option to fish, for ``--debug-output``, works correctly instead of producing an</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2177" href="#L2177">2177</a><span class="code-text">   invalid option error (:issue:`7254`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2178" href="#L2178">2178</a><span class="code-text">-  fish's debugging can now also be enabled via ``FISH_DEBUG`` and ``FISH_DEBUG_OUTPUT`` environment variables.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2179" href="#L2179">2179</a><span class="code-text">   This helps with debugging when no commandline options can be passed, like when fish is called in a shebang (:issue:`7359`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2180" href="#L2180">2180</a><span class="code-text">-  Abbreviations are now expanded after all command terminators (eg ``;`` or ``|``), not just space,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2181" href="#L2181">2181</a><span class="code-text">   as in fish 2.7.1 and before (:issue:`6970`), and after closing a command substitution (:issue:`6658`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2182" href="#L2182">2182</a><span class="code-text">-  The history file is now created with user-private permissions,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2183" href="#L2183">2183</a><span class="code-text">   matching other shells (:issue:`6926`). The directory containing the history</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2184" href="#L2184">2184</a><span class="code-text">   file was already private, so there should not have been any private data</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2185" href="#L2185">2185</a><span class="code-text">   revealed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2186" href="#L2186">2186</a><span class="code-text">-  The output of ``time`` is now properly aligned in all cases (:issue:`6726`, :issue:`6714`) and no longer depends on locale (:issue:`6757`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2187" href="#L2187">2187</a><span class="code-text">-  The command-not-found handling has been simplified.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2188" href="#L2188">2188</a><span class="code-text">   When it can't find a command, fish now just executes a function called ``fish_command_not_found``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2189" href="#L2189">2189</a><span class="code-text">   instead of firing an event, making it easier to replace and reason about.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2190" href="#L2190">2190</a><span class="code-text">   Previously-defined ``__fish_command_not_found_handler`` functions with an appropriate event listener will still work (:issue:`7293`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2191" href="#L2191">2191</a><span class="code-text">-  :kbd:`ctrl-c` handling has been reimplemented in C++ and is therefore quicker (:issue:`5259`), no longer occasionally prints an &quot;unknown command&quot; error (:issue:`7145`) or overwrites multiline prompts (:issue:`3537`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2192" href="#L2192">2192</a><span class="code-text">-  :kbd:`ctrl-c` no longer kills background jobs for which job control is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2193" href="#L2193">2193</a><span class="code-text">   disabled, matching POSIX semantics (:issue:`6828`, :issue:`6861`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2194" href="#L2194">2194</a><span class="code-text">-  Autosuggestions work properly after :kbd:`ctrl-c` cancels the current command line (:issue:`6937`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2195" href="#L2195">2195</a><span class="code-text">-  History search is now case-insensitive unless the search string contains an uppercase character (:issue:`7273`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2196" href="#L2196">2196</a><span class="code-text">-  ``fish_update_completions`` gained a new ``--keep`` option, which improves speed by skipping completions that already exist (:issue:`6775`, :issue:`6796`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2197" href="#L2197">2197</a><span class="code-text">-  Aliases containing an embedded backslash appear properly in the output of ``alias`` (:issue:`6910`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2198" href="#L2198">2198</a><span class="code-text">-  ``open`` no longer hangs indefinitely on certain systems, as a bug in ``xdg-open`` has been worked around (:issue:`7215`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2199" href="#L2199">2199</a><span class="code-text">-  Long command lines no longer add a blank line after execution (:issue:`6826`) and behave better with :kbd:`backspace` (:issue:`6951`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2200" href="#L2200">2200</a><span class="code-text">-  ``functions -t`` works like the long option ``--handlers-type``, as documented, instead of producing an error (:issue:`6985`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2201" href="#L2201">2201</a><span class="code-text">-  History search now flashes when it found no more results (:issue:`7362`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2202" href="#L2202">2202</a><span class="code-text">-  fish now creates the path in the environment variable ``XDG_RUNTIME_DIR`` if it does not exist, before using it for runtime data storage (:issue:`7335`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2203" href="#L2203">2203</a><span class="code-text">-  ``set_color --print-colors`` now also respects the bold, dim, underline, reverse, italic and background modifiers, to better show their effect (:issue:`7314`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2204" href="#L2204">2204</a><span class="code-text">-  The fish Web configuration tool (``fish_config``) shows prompts correctly on Termux for Android (:issue:`7298`) and detects Windows Services for Linux 2 properly (:issue:`7027`). It no longer shows the ``history`` variable as it may be too large (one can use the History tab instead). It also starts the browser in another thread, avoiding hangs in some circumstances, especially with Firefox's Developer Edition (:issue:`7158`). Finally, a bug in the Source Code Pro font may cause browsers to hang, so this font is no longer chosen by default (:issue:`7714`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2205" href="#L2205">2205</a><span class="code-text">-  ``funcsave`` gained a new ``--directory`` option to specify the location of the saved function (:issue:`7041`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2206" href="#L2206">2206</a><span class="code-text">-  ``help`` works properly on MSYS2 (:issue:`7113`) and only uses ``cmd.exe`` if running on WSL (:issue:`6797`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2207" href="#L2207">2207</a><span class="code-text">-  Resuming a piped job by its number, like ``fg %1``, works correctly (:issue:`7406`). Resumed jobs show the correct title in the terminal emulator (:issue:`7444`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2208" href="#L2208">2208</a><span class="code-text">-  Commands run from key bindings now use the same TTY modes as normal commands (:issue:`7483`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2209" href="#L2209">2209</a><span class="code-text">-  Autosuggestions from history are now case-sensitive (:issue:`3978`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2210" href="#L2210">2210</a><span class="code-text">-  ``$status`` from completion scripts is no longer passed outside the completion, which keeps the status display in the prompt as the last command's status (:issue:`7555`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2211" href="#L2211">2211</a><span class="code-text">-  Updated localisations for pt_BR (:issue:`7480`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2212" href="#L2212">2212</a><span class="code-text">-  ``fish_trace`` output now starts with ``-&gt;`` (like ``fish --profile``), making the depth more visible (:issue:`7538`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2213" href="#L2213">2213</a><span class="code-text">-  Resizing the terminal window no longer produces a corrupted prompt (:issue:`6532`, :issue:`7404`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2214" href="#L2214">2214</a><span class="code-text">-  ``functions`` produces an error rather than crashing on certain invalid arguments (:issue:`7515`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2215" href="#L2215">2215</a><span class="code-text">-  A crash in completions with inline variable assignment (eg ``A= b``) has been fixed (:issue:`7344`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2216" href="#L2216">2216</a><span class="code-text">-  ``fish_private_mode`` may now be changed dynamically using ``set`` (:issue:`7589`), and history is kept in memory in private mode (but not stored permanently) (:issue:`7590`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2217" href="#L2217">2217</a><span class="code-text">-  Commands with leading spaces may be retrieved from history with up-arrow until a new command is run, matching zsh's ``HIST_IGNORE_SPACE`` (:issue:`1383`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2218" href="#L2218">2218</a><span class="code-text">-  Importing bash history or reporting errors with recursive globs (``**``) no longer hangs (:issue:`7407`, :issue:`7497`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2219" href="#L2219">2219</a><span class="code-text">-  ``bind`` now shows ``\x7f`` for the del key instead of a literal DEL character (:issue:`7631`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2220" href="#L2220">2220</a><span class="code-text">-  Paths containing variables or tilde expansion are only suggested when they are still valid (:issue:`7582`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2221" href="#L2221">2221</a><span class="code-text">-  Syntax highlighting can now color a command as invalid even if executed quickly (:issue:`5912`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2222" href="#L2222">2222</a><span class="code-text">-  Redirection targets are no longer highlighted as error if they contain variables which will likely be defined by the current commandline (:issue:`6654`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2223" href="#L2223">2223</a><span class="code-text">-  fish is now more resilient against broken terminal modes (:issue:`7133`, :issue:`4873`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2224" href="#L2224">2224</a><span class="code-text">-  fish handles being in control of the TTY without owning its own process group better, avoiding some hangs in special configurations (:issue:`7388`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2225" href="#L2225">2225</a><span class="code-text">-  Keywords can now be colored differently by setting the ``fish_color_keyword`` variable (``fish_color_command`` is used as a fallback) (:issue:`7678`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2226" href="#L2226">2226</a><span class="code-text">-  Just like ``fish_indent``, the interactive reader will indent continuation lines that follow a line ending in a backslash, ``|``, ``&amp;&amp;`` or ``||`` (:issue:`7694`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2227" href="#L2227">2227</a><span class="code-text">-  Commands with a trailing escaped space are saved in history correctly (:issue:`7661`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2228" href="#L2228">2228</a><span class="code-text">-  ``fish_prompt`` no longer mangles Unicode characters in the private-use range U+F600-U+F700. (:issue:`7723`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2229" href="#L2229">2229</a><span class="code-text">-  The universal variable file, ``fish_variables``, can be made a symbolic link without it being overwritten (:issue:`7466`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2230" href="#L2230">2230</a><span class="code-text">-  fish is now more resilient against ``mktemp`` failing (:issue:`7482`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2231" href="#L2231">2231</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2232" href="#L2232">2232</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2233" href="#L2233">2233</a><span class="code-text">New or improved bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2234" href="#L2234">2234</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2235" href="#L2235">2235</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2236" href="#L2236">2236</a><span class="code-text">-  As mentioned above, new special input functions ``undo`` (:kbd:`ctrl-_` or :kbd:`ctrl-z`) and ``redo`` (:kbd:`alt-/`) can be used to revert changes to the command line or the pager search field (:issue:`6570`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2237" href="#L2237">2237</a><span class="code-text">-  :kbd:`ctrl-z` is now available for binding (:issue:`7152`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2238" href="#L2238">2238</a><span class="code-text">-  Additionally, using the ``cancel`` special input function (bound to :kbd:`escape` by default) right after fish picked an unambiguous completion will undo that (:issue:`7433`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2239" href="#L2239">2239</a><span class="code-text">- ``fish_clipboard_paste`` (:kbd:`ctrl-v`) trims indentation from multiline commands, because fish already indents (:issue:`7662`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2240" href="#L2240">2240</a><span class="code-text">-  Vi mode bindings now support ``dh``, ``dl``, ``c0``, ``cf``, ``ct``, ``cF``, ``cT``, ``ch``, ``cl``, ``y0``, ``ci``, ``ca``, ``yi``, ``ya``, ``di``, ``da``, ``d;``, ``d,``, ``o``, ``O`` and Control+left/right keys to navigate by word (:issue:`6648`, :issue:`6755`, :issue:`6769`, :issue:`7442`, :issue:`7516`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2241" href="#L2241">2241</a><span class="code-text">-  Vi mode bindings support :kbd:`~` (tilde) to toggle the case of the selected character (:issue:`6908`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2242" href="#L2242">2242</a><span class="code-text">-  Functions ``up-or-search`` and ``down-or-search`` (:kbd:`up` and :kbd:`down`) can cross empty lines, and don't activate search mode if the search fails, which makes them easier to use to move between lines in some situations.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2243" href="#L2243">2243</a><span class="code-text">-  If history search fails to find a match, the cursor is no longer moved. This is useful when accidentally starting a history search on a multi-line commandline.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2244" href="#L2244">2244</a><span class="code-text">-  The special input function ``beginning-of-history`` (:kbd:`pageup`) now moves to the oldest search instead of the youngest - that's ``end-of-history`` (:kbd:`pagedown`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2245" href="#L2245">2245</a><span class="code-text">-  A new special input function ``forward-single-char`` moves one character to the right, and if an autosuggestion is available, only take a single character from it (:issue:`7217`, :issue:`4984`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2246" href="#L2246">2246</a><span class="code-text">-  Special input functions can now be joined with ``or`` as a modifier (adding to ``and``), though only some commands set an exit status (:issue:`7217`). This includes ``suppress-autosuggestion`` to reflect whether an autosuggestion was suppressed (:issue:`1419`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2247" href="#L2247">2247</a><span class="code-text">-  A new function ``__fish_preview_current_file``, bound to :kbd:`alt-o`, opens the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2248" href="#L2248">2248</a><span class="code-text">   current file at the cursor in a pager (:issue:`6838`, :issue:`6855`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2249" href="#L2249">2249</a><span class="code-text">-  ``edit_command_buffer`` (:kbd:`alt-e` and :kbd:`alt-v`) passes the cursor position</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2250" href="#L2250">2250</a><span class="code-text">   to the external editor if the editor is recognized (:issue:`6138`, :issue:`6954`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2251" href="#L2251">2251</a><span class="code-text">-  ``__fish_prepend_sudo`` (:kbd:`alt-s`) now toggles a ``sudo`` prefix (:issue:`7012`) and avoids shifting the cursor (:issue:`6542`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2252" href="#L2252">2252</a><span class="code-text">-  ``__fish_prepend_sudo`` (:kbd:`alt-s`) now uses the previous commandline if the current one is empty,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2253" href="#L2253">2253</a><span class="code-text">   to simplify rerunning the previous command with ``sudo`` (:issue:`7079`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2254" href="#L2254">2254</a><span class="code-text">-  ``__fish_toggle_comment_commandline`` (:kbd:`alt-#`) now uncomments and presents the last comment</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2255" href="#L2255">2255</a><span class="code-text">   from history if the commandline is empty (:issue:`7137`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2256" href="#L2256">2256</a><span class="code-text">-  ``__fish_whatis_current_token`` (:kbd:`alt-w`) prints descriptions for functions and builtins (:issue:`7191`, :issue:`2083`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2257" href="#L2257">2257</a><span class="code-text">-  The definition of &quot;word&quot; and &quot;bigword&quot; for movements was refined, fixing (eg) vi mode's behavior with :kbd:`e` on the second-to-last char, and bigword's behavior with single-character words and non-blank non-graphical characters (:issue:`7353`, :issue:`7354`, :issue:`4025`, :issue:`7328`, :issue:`7325`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2258" href="#L2258">2258</a><span class="code-text">-  fish's clipboard bindings now also support Windows Subsystem for Linux via PowerShell and clip.exe (:issue:`7455`, :issue:`7458`) and will properly copy newlines in multi-line commands.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2259" href="#L2259">2259</a><span class="code-text">-  Using the ``*-jump`` special input functions before typing anything else no longer crashes fish.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2260" href="#L2260">2260</a><span class="code-text">-  Completing variable overrides (``foo=bar``) could replace the entire thing with just the completion in some circumstances. This has been fixed (:issue:`7398`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2261" href="#L2261">2261</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2262" href="#L2262">2262</a><span class="code-text">Improved prompts</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2263" href="#L2263">2263</a><span class="code-text">^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2264" href="#L2264">2264</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2265" href="#L2265">2265</a><span class="code-text">-  The default and example prompts print the correct exit status for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2266" href="#L2266">2266</a><span class="code-text">   commands prefixed with ``not`` (:issue:`6566`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2267" href="#L2267">2267</a><span class="code-text">-  git prompts include all untracked files in the repository, not just those in the current</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2268" href="#L2268">2268</a><span class="code-text">   directory (:issue:`6086`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2269" href="#L2269">2269</a><span class="code-text">-  The git prompts correctly show stash states (:issue:`6876`, :issue:`7136`) and clean states (:issue:`7471`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2270" href="#L2270">2270</a><span class="code-text">-  The Mercurial prompt correctly shows untracked status (:issue:`6906`), and by default only shows the branch for performance reasons.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2271" href="#L2271">2271</a><span class="code-text">   A new variable ``$fish_prompt_hg_show_informative_status`` can be set to enable more information.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2272" href="#L2272">2272</a><span class="code-text">-  The ``fish_vcs_prompt`` passes its arguments to the various VCS prompts that it calls (:issue:`7033`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2273" href="#L2273">2273</a><span class="code-text">-  The Subversion prompt was broken in a number of ways in 3.1.0 and has been restored (:issue:`6715`, :issue:`7278`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2274" href="#L2274">2274</a><span class="code-text">-  A new helper function ``fish_is_root_user`` simplifies checking for superuser privilege (:issue:`7031`, :issue:`7123`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2275" href="#L2275">2275</a><span class="code-text">-  New colorschemes - ``ayu Light``, ``ayu Dark`` and ``ayu Mirage`` (:issue:`7596`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2276" href="#L2276">2276</a><span class="code-text">-  Bugs related to multiline prompts, including repainting (:issue:`5860`) or navigating directory history (:issue:`3550`) leading to graphical glitches have been fixed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2277" href="#L2277">2277</a><span class="code-text">-  The ``nim`` prompt now handles vi mode better (:issue:`6802`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2278" href="#L2278">2278</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2279" href="#L2279">2279</a><span class="code-text">Improved terminal support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2280" href="#L2280">2280</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2281" href="#L2281">2281</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2282" href="#L2282">2282</a><span class="code-text">-  A new variable, ``fish_vi_force_cursor``, can be set to force ``fish_vi_cursor`` to attempt changing the cursor</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2283" href="#L2283">2283</a><span class="code-text">   shape in vi mode, regardless of terminal (:issue:`6968`). The ``fish_vi_cursor`` option ``--force-iterm`` has been deprecated.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2284" href="#L2284">2284</a><span class="code-text">-  ``diff`` will now colourize output, if supported (:issue:`7308`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2285" href="#L2285">2285</a><span class="code-text">-  Autosuggestions appear when the cursor passes the right prompt (:issue:`6948`) or wraps to the next line (:issue:`7213`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2286" href="#L2286">2286</a><span class="code-text">-  The cursor shape in Vi mode changes properly in Windows Terminal (:issue:`6999`, :issue:`6478`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2287" href="#L2287">2287</a><span class="code-text">-  The spurious warning about terminal size in small terminals has been removed (:issue:`6980`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2288" href="#L2288">2288</a><span class="code-text">-  Dynamic titles are now enabled in Alacritty (:issue:`7073`) and emacs' vterm (:issue:`7122`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2289" href="#L2289">2289</a><span class="code-text">-  Current working directory updates are enabled in foot (:issue:`7099`) and WezTerm (:issue:`7649`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2290" href="#L2290">2290</a><span class="code-text">-  The width computation for certain emoji agrees better with terminals (especially flags). (:issue:`7237`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2291" href="#L2291">2291</a><span class="code-text">-  Long command lines are wrapped in all cases, instead of sometimes being put on a new line (:issue:`5118`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2292" href="#L2292">2292</a><span class="code-text">-  The pager is properly rendered with long command lines selected (:issue:`2557`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2293" href="#L2293">2293</a><span class="code-text">-  Sessions with right prompts can be resized correctly in terminals that handle reflow, like GNOME Terminal (and other VTE-based terminals), upcoming Konsole releases and Alacritty. This detection can be overridden with the new ``fish_handle_reflow`` variable (:issue:`7491`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2294" href="#L2294">2294</a><span class="code-text">-  fish now sets terminal modes sooner, which stops output from appearing before the greeting and prompt are ready (:issue:`7489`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2295" href="#L2295">2295</a><span class="code-text">-  Better detection of new Konsole versions for true color support and cursor shape changing.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2296" href="#L2296">2296</a><span class="code-text">-  fish no longer attempts to modify the terminal size via ``TIOCSWINSZ``, improving compatibility with Kitty (:issue:`6994`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2297" href="#L2297">2297</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2298" href="#L2298">2298</a><span class="code-text">Completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2299" href="#L2299">2299</a><span class="code-text">^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2300" href="#L2300">2300</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2301" href="#L2301">2301</a><span class="code-text">-  Added completions for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2302" href="#L2302">2302</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2303" href="#L2303">2303</a><span class="code-text">   -  ``7z``, ``7za`` and ``7zr`` (:issue:`7220`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2304" href="#L2304">2304</a><span class="code-text">   -  ``alias`` (:issue:`7035`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2305" href="#L2305">2305</a><span class="code-text">   -  ``alternatives`` (:issue:`7616`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2306" href="#L2306">2306</a><span class="code-text">   -  ``apk`` (:issue:`7108`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2307" href="#L2307">2307</a><span class="code-text">   -  ``asciidoctor`` (:issue:`7000`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2308" href="#L2308">2308</a><span class="code-text">   -  ``avifdec`` and ``avifenc`` (:issue:`7674`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2309" href="#L2309">2309</a><span class="code-text">   -  ``bluetoothctl`` (:issue:`7438`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2310" href="#L2310">2310</a><span class="code-text">   -  ``cjxl`` and ``djxl`` (:issue:`7673`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2311" href="#L2311">2311</a><span class="code-text">   -  ``cmark`` (:issue:`7000`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2312" href="#L2312">2312</a><span class="code-text">   -  ``create_ap`` (:issue:`7096`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2313" href="#L2313">2313</a><span class="code-text">   -  ``deno`` (:issue:`7138`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2314" href="#L2314">2314</a><span class="code-text">   -  ``dhclient`` (:issue:`6684`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2315" href="#L2315">2315</a><span class="code-text">   -  Postgres-related commands ``dropdb``, ``createdb``, ``pg_restore``, ``pg_dump`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2316" href="#L2316">2316</a><span class="code-text">      ``pg_dumpall`` (:issue:`6620`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2317" href="#L2317">2317</a><span class="code-text">   -  ``dotnet`` (:issue:`7558`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2318" href="#L2318">2318</a><span class="code-text">   -  ``downgrade`` (:issue:`6751`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2319" href="#L2319">2319</a><span class="code-text">   -  ``gapplication``, ``gdbus``, ``gio`` and ``gresource`` (:issue:`7300`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2320" href="#L2320">2320</a><span class="code-text">   -  ``gh`` (:issue:`7112`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2321" href="#L2321">2321</a><span class="code-text">   -  ``gitk``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2322" href="#L2322">2322</a><span class="code-text">   -  ``groups`` (:issue:`6889`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2323" href="#L2323">2323</a><span class="code-text">   -  ``hashcat`` (:issue:`7746`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2324" href="#L2324">2324</a><span class="code-text">   -  ``hikari`` (:issue:`7083`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2325" href="#L2325">2325</a><span class="code-text">   -  ``icdiff`` (:issue:`7503`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2326" href="#L2326">2326</a><span class="code-text">   -  ``imv`` (:issue:`6675`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2327" href="#L2327">2327</a><span class="code-text">   -  ``john`` (:issue:`7746`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2328" href="#L2328">2328</a><span class="code-text">   -  ``julia`` (:issue:`7468`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2329" href="#L2329">2329</a><span class="code-text">   -  ``k3d`` (:issue:`7202`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2330" href="#L2330">2330</a><span class="code-text">   -  ``ldapsearch`` (:issue:`7578`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2331" href="#L2331">2331</a><span class="code-text">   -  ``lightdm`` and ``dm-tool`` (:issue:`7624`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2332" href="#L2332">2332</a><span class="code-text">   -  ``losetup`` (:issue:`7621`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2333" href="#L2333">2333</a><span class="code-text">   -  ``micro`` (:issue:`7339`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2334" href="#L2334">2334</a><span class="code-text">   -  ``mpc`` (:issue:`7169`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2335" href="#L2335">2335</a><span class="code-text">   -  Metasploit's ``msfconsole``, ``msfdb`` and ``msfvenom`` (:issue:`6930`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2336" href="#L2336">2336</a><span class="code-text">   -  ``mtr`` (:issue:`7638`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2337" href="#L2337">2337</a><span class="code-text">   -  ``mysql`` (:issue:`6819`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2338" href="#L2338">2338</a><span class="code-text">   -  ``ncat``, ``nc.openbsd``, ``nc.traditional`` and ``nmap`` (:issue:`6873`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2339" href="#L2339">2339</a><span class="code-text">   -  ``openssl`` (:issue:`6845`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2340" href="#L2340">2340</a><span class="code-text">   -  ``prime-run`` (:issue:`7241`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2341" href="#L2341">2341</a><span class="code-text">   -  ``ps2pdf{12,13,14,wr}`` (:issue:`6673`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2342" href="#L2342">2342</a><span class="code-text">   -  ``pyenv`` (:issue:`6551`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2343" href="#L2343">2343</a><span class="code-text">   -  ``rst2html``, ``rst2html4``, ``rst2html5``, ``rst2latex``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2344" href="#L2344">2344</a><span class="code-text">      ``rst2man``, ``rst2odt``, ``rst2pseudoxml``, ``rst2s5``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2345" href="#L2345">2345</a><span class="code-text">      ``rst2xetex``, ``rst2xml`` and ``rstpep2html`` (:issue:`7019`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2346" href="#L2346">2346</a><span class="code-text">   -  ``spago`` (:issue:`7381`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2347" href="#L2347">2347</a><span class="code-text">   -  ``sphinx-apidoc``, ``sphinx-autogen``, ``sphinx-build`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2348" href="#L2348">2348</a><span class="code-text">      ``sphinx-quickstart`` (:issue:`7000`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2349" href="#L2349">2349</a><span class="code-text">   -  ``strace`` (:issue:`6656`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2350" href="#L2350">2350</a><span class="code-text">   -  systemd's ``bootctl``, ``coredumpctl``, ``hostnamectl`` (:issue:`7428`), ``homectl`` (:issue:`7435`), ``networkctl`` (:issue:`7668`) and ``userdbctl`` (:issue:`7667`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2351" href="#L2351">2351</a><span class="code-text">   -  ``tcpdump`` (:issue:`6690`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2352" href="#L2352">2352</a><span class="code-text">   -  ``tig``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2353" href="#L2353">2353</a><span class="code-text">   -  ``traceroute`` and ``tracepath`` (:issue:`6803`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2354" href="#L2354">2354</a><span class="code-text">   -  ``windscribe`` (:issue:`6788`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2355" href="#L2355">2355</a><span class="code-text">   -  ``wireshark``, ``tshark``, and ``dumpcap``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2356" href="#L2356">2356</a><span class="code-text">   -  ``xbps-*`` (:issue:`7239`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2357" href="#L2357">2357</a><span class="code-text">   -  ``xxhsum``, ``xxh32sum``, ``xxh64sum`` and ``xxh128sum`` (:issue:`7103`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2358" href="#L2358">2358</a><span class="code-text">   -  ``yadm`` (:issue:`7100`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2359" href="#L2359">2359</a><span class="code-text">   -  ``zopfli`` and ``zopflipng`` (:issue:`6872`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2360" href="#L2360">2360</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2361" href="#L2361">2361</a><span class="code-text">-  Lots of improvements to completions, including:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2362" href="#L2362">2362</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2363" href="#L2363">2363</a><span class="code-text">   -  ``git`` completions can complete the right and left parts of a commit range like ``from..to`` or ``left...right``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2364" href="#L2364">2364</a><span class="code-text">   -  Completion scripts for custom Git subcommands like ``git-xyz`` are now loaded with Git completions. The completions can now be defined directly on the subcommand (using ``complete git-xyz``), and completion for ``git xyz`` will work. (:issue:`7075`, :issue:`7652`, :issue:`4358`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2365" href="#L2365">2365</a><span class="code-text">   -  ``make`` completions no longer second-guess make's file detection, fixing target completion in some cases (:issue:`7535`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2366" href="#L2366">2366</a><span class="code-text">   -  Command completions now correctly print the description even if the command was fully matched (like in ``ls&lt;TAB&gt;``).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2367" href="#L2367">2367</a><span class="code-text">   -  ``set`` completions no longer hide variables starting with ``__``, they are sorted last instead.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2368" href="#L2368">2368</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2369" href="#L2369">2369</a><span class="code-text">-  Improvements to the manual page completion generator (:issue:`7086`, :issue:`6879`, :issue:`7187`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2370" href="#L2370">2370</a><span class="code-text">-  Significant performance improvements to completion of the available commands (:issue:`7153`), especially on macOS Big Sur where there was a significant regression (:issue:`7365`, :issue:`7511`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2371" href="#L2371">2371</a><span class="code-text">-  Suffix completion using ``__fish_complete_suffix`` uses the same fuzzy matching logic as normal file completion, and completes any file but sorts files with matching suffix first (:issue:`7040`, :issue:`7547`). Previously, it only completed files with matching suffix.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2372" href="#L2372">2372</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2373" href="#L2373">2373</a><span class="code-text">For distributors</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2374" href="#L2374">2374</a><span class="code-text">----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2375" href="#L2375">2375</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2376" href="#L2376">2376</a><span class="code-text">-  fish has a new interactive test driver based on pexpect, removing the optional dependency on expect (and adding an optional dependency on pexpect) (:issue:`5451`, :issue:`6825`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2377" href="#L2377">2377</a><span class="code-text">-  The CHANGELOG was moved to restructured text, allowing it to be included in the documentation (:issue:`7057`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2378" href="#L2378">2378</a><span class="code-text">-  fish handles ncurses installed in a non-standard prefix better (:issue:`6600`, :issue:`7219`), and uses variadic tparm on NetBSD curses (:issue:`6626`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2379" href="#L2379">2379</a><span class="code-text">-  The Web-based configuration tool no longer uses an obsolete Angular version (:issue:`7147`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2380" href="#L2380">2380</a><span class="code-text">-  The fish project has adopted the Contributor Covenant code of conduct (:issue:`7151`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2381" href="#L2381">2381</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2382" href="#L2382">2382</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2383" href="#L2383">2383</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2384" href="#L2384">2384</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2385" href="#L2385">2385</a><span class="code-text">-  The ``fish_color_match`` variable is no longer used. (Previously this controlled the color of matching quotes and parens when using ``read``).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2386" href="#L2386">2386</a><span class="code-text">-  fish 3.2.0 will be the last release in which the redirection to standard error with the ``^`` character is enabled.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2387" href="#L2387">2387</a><span class="code-text">   The ``stderr-nocaret`` feature flag will be changed to &quot;on&quot; in future releases.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2388" href="#L2388">2388</a><span class="code-text">-  ``string`` is now a reserved word and cannot be used for function names (see above).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2389" href="#L2389">2389</a><span class="code-text">-  ``fish_vi_cursor``'s option ``--force-iterm`` has been deprecated (see above).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2390" href="#L2390">2390</a><span class="code-text">-  ``command``, ``jobs`` and ``type`` long-form option ``--quiet`` is deprecated in favor of ``--query`` (see above).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2391" href="#L2391">2391</a><span class="code-text">-  The ``fish_command_not_found`` event is no longer emitted, instead there is a function of that name.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2392" href="#L2392">2392</a><span class="code-text">   By default it will call a previously-defined ``__fish_command_not_found_handler``. To emit the event manually use ``emit fish_command_not_found``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2393" href="#L2393">2393</a><span class="code-text">-  The ``fish_prompt`` event no longer fires when ``read`` is used. If</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2394" href="#L2394">2394</a><span class="code-text">   you need a function to run any time ``read`` is invoked by a script,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2395" href="#L2395">2395</a><span class="code-text">   use the new ``fish_read`` event instead (:issue:`7039`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2396" href="#L2396">2396</a><span class="code-text">-  To disable the greeting message permanently it is no longer enough to just run ``set fish_greeting`` interactively as it is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2397" href="#L2397">2397</a><span class="code-text">   no longer implicitly a universal variable. Use ``set -U fish_greeting`` or disable it in config.fish with ``set -g fish_greeting``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2398" href="#L2398">2398</a><span class="code-text">-  The long-deprecated and non-functional ``-m``/``--read-mode`` options to ``read`` were removed in 3.1b1. Using the short form, or a never-implemented ``-B`` option, no longer crashes fish (:issue:`7659`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2399" href="#L2399">2399</a><span class="code-text">-  With the addition of new categories for debug options, the old numbered debugging levels have been removed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2400" href="#L2400">2400</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2401" href="#L2401">2401</a><span class="code-text">For distributors and developers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2402" href="#L2402">2402</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2403" href="#L2403">2403</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2404" href="#L2404">2404</a><span class="code-text">-  fish source tarballs are now distributed using the XZ compression</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2405" href="#L2405">2405</a><span class="code-text">   method (:issue:`5460`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2406" href="#L2406">2406</a><span class="code-text">-  The fish source tarball contains an example FreeDesktop entry and icon.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2407" href="#L2407">2407</a><span class="code-text">-  The CMake variable ``MAC_CODESIGN_ID`` can now be set to &quot;off&quot; to disable code-signing (:issue:`6952`, :issue:`6792`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2408" href="#L2408">2408</a><span class="code-text">-  Building on on macOS earlier than 10.13.6 succeeds, instead of failing on code-signing (:issue:`6791`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2409" href="#L2409">2409</a><span class="code-text">-  The pkg-config file now uses variables to ensure paths used are portable across prefixes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2410" href="#L2410">2410</a><span class="code-text">-  The default values for the ``extra_completionsdir``, ``extra_functionsdir``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2411" href="#L2411">2411</a><span class="code-text">   and ``extra_confdir`` options now use the installation prefix rather than ``/usr/local`` (:issue:`6778`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2412" href="#L2412">2412</a><span class="code-text">-  A new CMake variable ``FISH_USE_SYSTEM_PCRE2`` controls whether fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2413" href="#L2413">2413</a><span class="code-text">   builds with the system-installed PCRE2, or the version it bundles. By</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2414" href="#L2414">2414</a><span class="code-text">   default it prefers the system library if available, unless Mac</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2415" href="#L2415">2415</a><span class="code-text">   codesigning is enabled (:issue:`6952`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2416" href="#L2416">2416</a><span class="code-text">-  Running the full interactive test suite now requires Python 3.5+ and the pexpect package (:issue:`6825`); the expect package is no longer required.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2417" href="#L2417">2417</a><span class="code-text">-  Support for Python 2 in fish's tools (``fish_config`` and the manual page completion generator) is no longer guaranteed. Please use Python 3.5 or later (:issue:`6537`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2418" href="#L2418">2418</a><span class="code-text">-  The Web-based configuration tool is compatible with Python 3.10  (:issue:`7600`) and no longer requires Python's distutils package (:issue:`7514`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2419" href="#L2419">2419</a><span class="code-text">-  fish 3.2 is the last release to support Red Hat Enterprise Linux &amp; CentOS version 6.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2420" href="#L2420">2420</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2421" href="#L2421">2421</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2422" href="#L2422">2422</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2423" href="#L2423">2423</a><span class="code-text">fish 3.1.2 (released April 29, 2020)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2424" href="#L2424">2424</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2425" href="#L2425">2425</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2426" href="#L2426">2426</a><span class="code-text">This release of fish fixes a major issue discovered in fish 3.1.1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2427" href="#L2427">2427</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2428" href="#L2428">2428</a><span class="code-text">-  Commands such as ``fzf`` and ``enhancd``, when used with ``eval``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2429" href="#L2429">2429</a><span class="code-text">   would hang. ``eval`` buffered output too aggressively, which has been</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2430" href="#L2430">2430</a><span class="code-text">   fixed (:issue:`6955`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2431" href="#L2431">2431</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2432" href="#L2432">2432</a><span class="code-text">If you are upgrading from version 3.0.0 or before, please also review</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2433" href="#L2433">2433</a><span class="code-text">the release notes for 3.1.1, 3.1.0 and 3.1b1 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2434" href="#L2434">2434</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2435" href="#L2435">2435</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2436" href="#L2436">2436</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2437" href="#L2437">2437</a><span class="code-text">fish 3.1.1 (released April 27, 2020)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2438" href="#L2438">2438</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2439" href="#L2439">2439</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2440" href="#L2440">2440</a><span class="code-text">This release of fish fixes a number of major issues discovered in fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2441" href="#L2441">2441</a><span class="code-text">3.1.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2442" href="#L2442">2442</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2443" href="#L2443">2443</a><span class="code-text">-  Commands which involve ``. ( ... | psub)`` now work correctly, as a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2444" href="#L2444">2444</a><span class="code-text">   bug in the ``function --on-job-exit`` option has been fixed (:issue:`6613`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2445" href="#L2445">2445</a><span class="code-text">-  Conflicts between upstream packages for ripgrep and bat, and the fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2446" href="#L2446">2446</a><span class="code-text">   packages, have been resolved (:issue:`5822`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2447" href="#L2447">2447</a><span class="code-text">-  Starting fish in a directory without read access, such as via ``su``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2448" href="#L2448">2448</a><span class="code-text">   no longer crashes (:issue:`6597`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2449" href="#L2449">2449</a><span class="code-text">-  Glob ordering changes which were introduced in 3.1.0 have been</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2450" href="#L2450">2450</a><span class="code-text">   reverted, returning the order of globs to the previous state (:issue:`6593`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2451" href="#L2451">2451</a><span class="code-text">-  Redirections using the deprecated caret syntax to a file descriptor</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2452" href="#L2452">2452</a><span class="code-text">   (eg ``^&amp;2``) work correctly (:issue:`6591`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2453" href="#L2453">2453</a><span class="code-text">-  Redirections that append to a file descriptor (eg ``2&gt;&gt;&amp;1``) work</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2454" href="#L2454">2454</a><span class="code-text">   correctly (:issue:`6614`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2455" href="#L2455">2455</a><span class="code-text">-  Building fish on macOS (:issue:`6602`) or with new versions of GCC (:issue:`6604`,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2456" href="#L2456">2456</a><span class="code-text">   :issue:`6609`) is now successful.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2457" href="#L2457">2457</a><span class="code-text">-  ``time`` is now correctly listed in the output of ``builtin -n``, and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2458" href="#L2458">2458</a><span class="code-text">   ``time --help`` works correctly (:issue:`6598`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2459" href="#L2459">2459</a><span class="code-text">-  Exported universal variables now update properly (:issue:`6612`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2460" href="#L2460">2460</a><span class="code-text">-  ``status current-command`` gives the expected output when used with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2461" href="#L2461">2461</a><span class="code-text">   an environment override - that is, ``F=B status current-command``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2462" href="#L2462">2462</a><span class="code-text">   returns ``status`` instead of ``F=B`` (:issue:`6635`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2463" href="#L2463">2463</a><span class="code-text">-  ``test`` no longer crashes when used with “``nan``” or “``inf``”</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2464" href="#L2464">2464</a><span class="code-text">   arguments, erroring out instead (:issue:`6655`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2465" href="#L2465">2465</a><span class="code-text">-  Copying from the end of the command line no longer crashes fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2466" href="#L2466">2466</a><span class="code-text">   (:issue:`6680`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2467" href="#L2467">2467</a><span class="code-text">-  ``read`` no longer removes multiple separators when splitting a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2468" href="#L2468">2468</a><span class="code-text">   variable into a list, restoring the previous behaviour from fish 3.0</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2469" href="#L2469">2469</a><span class="code-text">   and before (:issue:`6650`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2470" href="#L2470">2470</a><span class="code-text">-  Functions using ``--on-job-exit`` and ``--on-process-exit`` work</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2471" href="#L2471">2471</a><span class="code-text">   reliably again (:issue:`6679`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2472" href="#L2472">2472</a><span class="code-text">-  Functions using ``--on-signal INT`` work reliably in interactive</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2473" href="#L2473">2473</a><span class="code-text">   sessions, as they did in fish 2.7 and before (:issue:`6649`). These handlers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2474" href="#L2474">2474</a><span class="code-text">   have never worked in non-interactive sessions, and making them work</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2475" href="#L2475">2475</a><span class="code-text">   is an ongoing process.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2476" href="#L2476">2476</a><span class="code-text">-  Functions using ``--on-variable`` work reliably with variables which</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2477" href="#L2477">2477</a><span class="code-text">   are set implicitly (rather than with ``set``), such as</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2478" href="#L2478">2478</a><span class="code-text">   “``fish_bind_mode``” and “``PWD``” (:issue:`6653`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2479" href="#L2479">2479</a><span class="code-text">-  256 colors are properly enabled under certain conditions that were</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2480" href="#L2480">2480</a><span class="code-text">   incorrectly detected in fish 3.1.0 (``$TERM`` begins with xterm, does</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2481" href="#L2481">2481</a><span class="code-text">   not include “``256color``”, and ``$TERM_PROGRAM`` is not set)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2482" href="#L2482">2482</a><span class="code-text">   (:issue:`6701`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2483" href="#L2483">2483</a><span class="code-text">-  The Mercurial (``hg``) prompt no longer produces an error when the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2484" href="#L2484">2484</a><span class="code-text">   current working directory is removed (:issue:`6699`). Also, for performance</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2485" href="#L2485">2485</a><span class="code-text">   reasons it shows only basic information by default; to restore the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2486" href="#L2486">2486</a><span class="code-text">   detailed status, set ``$fish_prompt_hg_show_informative_status``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2487" href="#L2487">2487</a><span class="code-text">-  The VCS prompt, ``fish_vcs_prompt``, no longer displays Subversion</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2488" href="#L2488">2488</a><span class="code-text">   (``svn``) status by default, due to the potential slowness of this</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2489" href="#L2489">2489</a><span class="code-text">   operation (:issue:`6681`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2490" href="#L2490">2490</a><span class="code-text">-  Pasting of commands has been sped up (:issue:`6713`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2491" href="#L2491">2491</a><span class="code-text">-  Using extended Unicode characters, such as emoji, in a non-Unicode</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2492" href="#L2492">2492</a><span class="code-text">   capable locale (such as the ``C`` or ``POSIX`` locale) no longer</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2493" href="#L2493">2493</a><span class="code-text">   renders all output blank (:issue:`6736`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2494" href="#L2494">2494</a><span class="code-text">-  ``help`` prefers to use ``xdg-open``, avoiding the use of ``open`` on</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2495" href="#L2495">2495</a><span class="code-text">   Debian systems where this command is actually ``openvt`` (:issue:`6739`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2496" href="#L2496">2496</a><span class="code-text">-  Command lines starting with a space, which are not saved in history,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2497" href="#L2497">2497</a><span class="code-text">   now do not get autosuggestions. This fixes an issue with Midnight</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2498" href="#L2498">2498</a><span class="code-text">   Commander integration (:issue:`6763`), but may be changed in a future</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2499" href="#L2499">2499</a><span class="code-text">   version.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2500" href="#L2500">2500</a><span class="code-text">-  Copying to the clipboard no longer inserts a newline at the end of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2501" href="#L2501">2501</a><span class="code-text">   the content, matching fish 2.7 and earlier (:issue:`6927`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2502" href="#L2502">2502</a><span class="code-text">-  ``fzf`` in complex pipes no longer hangs. More generally, code run as</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2503" href="#L2503">2503</a><span class="code-text">   part of command substitutions or ``eval`` will no longer have</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2504" href="#L2504">2504</a><span class="code-text">   separate process groups. (:issue:`6624`, :issue:`6806`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2505" href="#L2505">2505</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2506" href="#L2506">2506</a><span class="code-text">This release also includes:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2507" href="#L2507">2507</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2508" href="#L2508">2508</a><span class="code-text">-  several changes to improve macOS compatibility with code signing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2509" href="#L2509">2509</a><span class="code-text">   and notarization;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2510" href="#L2510">2510</a><span class="code-text">-  several improvements to completions; and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2511" href="#L2511">2511</a><span class="code-text">-  several content and formatting improvements to the documentation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2512" href="#L2512">2512</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2513" href="#L2513">2513</a><span class="code-text">If you are upgrading from version 3.0.0 or before, please also review</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2514" href="#L2514">2514</a><span class="code-text">the release notes for 3.1.0 and 3.1b1 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2515" href="#L2515">2515</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2516" href="#L2516">2516</a><span class="code-text">Errata for fish 3.1</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2517" href="#L2517">2517</a><span class="code-text">-------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2518" href="#L2518">2518</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2519" href="#L2519">2519</a><span class="code-text">A new builtin, ``time``, was introduced in the fish 3.1 releases. This</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2520" href="#L2520">2520</a><span class="code-text">builtin is a reserved word (like ``test``, ``function``, and others)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2521" href="#L2521">2521</a><span class="code-text">because of the way it is implemented, and functions can no longer be</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2522" href="#L2522">2522</a><span class="code-text">named ``time``. This was not clear in the fish 3.1b1 changelog.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2523" href="#L2523">2523</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2524" href="#L2524">2524</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2525" href="#L2525">2525</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2526" href="#L2526">2526</a><span class="code-text">fish 3.1.0 (released February 12, 2020)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2527" href="#L2527">2527</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2528" href="#L2528">2528</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2529" href="#L2529">2529</a><span class="code-text">Compared to the beta release of fish 3.1b1, fish version 3.1.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2530" href="#L2530">2530</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2531" href="#L2531">2531</a><span class="code-text">-  Fixes a regression where spaces after a brace were removed despite</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2532" href="#L2532">2532</a><span class="code-text">   brace expansion not occurring (:issue:`6564`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2533" href="#L2533">2533</a><span class="code-text">-  Fixes a number of problems in compiling and testing on Cygwin</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2534" href="#L2534">2534</a><span class="code-text">   (:issue:`6549`) and Solaris-derived systems such as Illumos (:issue:`6553`, :issue:`6554`,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2535" href="#L2535">2535</a><span class="code-text">   :issue:`6555`, :issue:`6556`, and :issue:`6558`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2536" href="#L2536">2536</a><span class="code-text">-  Fixes the process for building macOS packages.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2537" href="#L2537">2537</a><span class="code-text">-  Fixes a regression where excessive error messages are printed if</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2538" href="#L2538">2538</a><span class="code-text">   Unicode characters are emitted in non-Unicode-capable locales</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2539" href="#L2539">2539</a><span class="code-text">   (:issue:`6584`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2540" href="#L2540">2540</a><span class="code-text">-  Contains some improvements to the documentation and a small number</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2541" href="#L2541">2541</a><span class="code-text">   of completions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2542" href="#L2542">2542</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2543" href="#L2543">2543</a><span class="code-text">If you are upgrading from version 3.0.0 or before, please also review</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2544" href="#L2544">2544</a><span class="code-text">the release notes for 3.1b1 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2545" href="#L2545">2545</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2546" href="#L2546">2546</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2547" href="#L2547">2547</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2548" href="#L2548">2548</a><span class="code-text">fish 3.1b1 (released January 26, 2020)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2549" href="#L2549">2549</a><span class="code-text">======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2550" href="#L2550">2550</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2551" href="#L2551">2551</a><span class="code-text">.. _notable-improvements-and-fixes-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2552" href="#L2552">2552</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2553" href="#L2553">2553</a><span class="code-text">Notable improvements and fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2554" href="#L2554">2554</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2555" href="#L2555">2555</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2556" href="#L2556">2556</a><span class="code-text">-  A new ``$pipestatus`` variable contains a list of exit statuses of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2557" href="#L2557">2557</a><span class="code-text">   the previous job, for each of the separate commands in a pipeline</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2558" href="#L2558">2558</a><span class="code-text">   (:issue:`5632`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2559" href="#L2559">2559</a><span class="code-text">-  fish no longer buffers pipes to the last function in a pipeline,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2560" href="#L2560">2560</a><span class="code-text">   improving many cases where pipes appeared to block or hang (:issue:`1396`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2561" href="#L2561">2561</a><span class="code-text">-  An overhaul of error messages for builtin commands, including a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2562" href="#L2562">2562</a><span class="code-text">   removal of the overwhelming usage summary, more readable stack traces</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2563" href="#L2563">2563</a><span class="code-text">   (:issue:`3404`, :issue:`5434`), and stack traces for ``test`` (aka ``[``) (:issue:`5771`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2564" href="#L2564">2564</a><span class="code-text">-  fish’s debugging arguments have been significantly improved. The</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2565" href="#L2565">2565</a><span class="code-text">   ``--debug-level`` option has been removed, and a new ``--debug``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2566" href="#L2566">2566</a><span class="code-text">   option replaces it. This option accepts various categories, which may</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2567" href="#L2567">2567</a><span class="code-text">   be listed via ``fish --print-debug-categories`` (:issue:`5879`). A new</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2568" href="#L2568">2568</a><span class="code-text">   ``--debug-output`` option allows for redirection of debug output.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2569" href="#L2569">2569</a><span class="code-text">-  ``string`` has a new ``collect`` subcommand for use in command</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2570" href="#L2570">2570</a><span class="code-text">   substitutions, producing a single output instead of splitting on new</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2571" href="#L2571">2571</a><span class="code-text">   lines (similar to ``&quot;$(cmd)&quot;`` in other shells) (:issue:`159`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2572" href="#L2572">2572</a><span class="code-text">-  The fish manual, tutorial and FAQ are now available in ``man`` format</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2573" href="#L2573">2573</a><span class="code-text">   as ``fish-doc``, ``fish-tutorial`` and ``fish-faq`` respectively</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2574" href="#L2574">2574</a><span class="code-text">   (:issue:`5521`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2575" href="#L2575">2575</a><span class="code-text">-  Like other shells, ``cd`` now always looks for its argument in the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2576" href="#L2576">2576</a><span class="code-text">   current directory as a last resort, even if the ``CDPATH`` variable</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2577" href="#L2577">2577</a><span class="code-text">   does not include it or “.” (:issue:`4484`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2578" href="#L2578">2578</a><span class="code-text">-  fish now correctly handles ``CDPATH`` entries that start with ``..``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2579" href="#L2579">2579</a><span class="code-text">   (:issue:`6220`) or contain ``./`` (:issue:`5887`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2580" href="#L2580">2580</a><span class="code-text">-  The ``fish_trace`` variable may be set to trace execution (:issue:`3427`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2581" href="#L2581">2581</a><span class="code-text">   This performs a similar role as ``set -x`` in other shells.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2582" href="#L2582">2582</a><span class="code-text">-  fish uses the temporary directory determined by the system, rather</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2583" href="#L2583">2583</a><span class="code-text">   than relying on ``/tmp`` (:issue:`3845`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2584" href="#L2584">2584</a><span class="code-text">-  The fish Web configuration tool (``fish_config``) prints a list of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2585" href="#L2585">2585</a><span class="code-text">   commands it is executing, to help understanding and debugging</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2586" href="#L2586">2586</a><span class="code-text">   (:issue:`5584`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2587" href="#L2587">2587</a><span class="code-text">-  Major performance improvements when pasting (:issue:`5866`), executing lots</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2588" href="#L2588">2588</a><span class="code-text">   of commands (:issue:`5905`), importing history from bash (:issue:`6295`), and when</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2589" href="#L2589">2589</a><span class="code-text">   completing variables that might match ``$history`` (:issue:`6288`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2590" href="#L2590">2590</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2591" href="#L2591">2591</a><span class="code-text">.. _syntax-changes-and-new-commands-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2592" href="#L2592">2592</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2593" href="#L2593">2593</a><span class="code-text">Syntax changes and new commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2594" href="#L2594">2594</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2595" href="#L2595">2595</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2596" href="#L2596">2596</a><span class="code-text">-  A new builtin command, ``time``, which allows timing of fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2597" href="#L2597">2597</a><span class="code-text">   functions and builtins as well as external commands (:issue:`117`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2598" href="#L2598">2598</a><span class="code-text">-  Brace expansion now only takes place if the braces include a “,” or a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2599" href="#L2599">2599</a><span class="code-text">   variable expansion, meaning common commands such as</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2600" href="#L2600">2600</a><span class="code-text">   ``git reset HEAD@{0}`` do not require escaping (:issue:`5869`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2601" href="#L2601">2601</a><span class="code-text">-  New redirections ``&amp;&gt;`` and ``&amp;|`` may be used to redirect or pipe</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2602" href="#L2602">2602</a><span class="code-text">   stdout, and also redirect stderr to stdout (:issue:`6192`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2603" href="#L2603">2603</a><span class="code-text">-  ``switch`` now allows arguments that expand to nothing, like empty</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2604" href="#L2604">2604</a><span class="code-text">   variables (:issue:`5677`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2605" href="#L2605">2605</a><span class="code-text">-  The ``VAR=val cmd`` syntax can now be used to run a command in a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2606" href="#L2606">2606</a><span class="code-text">   modified environment (:issue:`6287`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2607" href="#L2607">2607</a><span class="code-text">-  ``and`` is no longer recognised as a command, so that nonsensical</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2608" href="#L2608">2608</a><span class="code-text">   constructs like ``and and and`` produce a syntax error (:issue:`6089`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2609" href="#L2609">2609</a><span class="code-text">-  ``math``\ ‘s exponent operator,’\ ``^``\ ‘, was previously</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2610" href="#L2610">2610</a><span class="code-text">   left-associative, but now uses the more commonly-used</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2611" href="#L2611">2611</a><span class="code-text">   right-associative behaviour (:issue:`6280`). This means that</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2612" href="#L2612">2612</a><span class="code-text">   ``math '3^0.5^2'`` was previously calculated as’(3\ :sup:`0.5)`\ 2’,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2613" href="#L2613">2613</a><span class="code-text">   but is now calculated as ‘3\ :sup:`(0.5`\ 2)’.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2614" href="#L2614">2614</a><span class="code-text">-  In fish 3.0, the variable used with ``for`` loops inside command</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2615" href="#L2615">2615</a><span class="code-text">   substitutions could leak into enclosing scopes; this was an</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2616" href="#L2616">2616</a><span class="code-text">   inadvertent behaviour change and has been reverted (:issue:`6480`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2617" href="#L2617">2617</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2618" href="#L2618">2618</a><span class="code-text">.. _scripting-improvements-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2619" href="#L2619">2619</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2620" href="#L2620">2620</a><span class="code-text">Scripting improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2621" href="#L2621">2621</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2622" href="#L2622">2622</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2623" href="#L2623">2623</a><span class="code-text">-  ``string split0`` now returns 0 if it split something (:issue:`5701`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2624" href="#L2624">2624</a><span class="code-text">-  In the interest of consistency, ``builtin -q`` and ``command -q`` can</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2625" href="#L2625">2625</a><span class="code-text">   now be used to query if a builtin or command exists (:issue:`5631`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2626" href="#L2626">2626</a><span class="code-text">-  ``math`` now accepts ``--scale=max`` for the maximum scale (:issue:`5579`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2627" href="#L2627">2627</a><span class="code-text">-  ``builtin $var`` now works correctly, allowing a variable as the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2628" href="#L2628">2628</a><span class="code-text">   builtin name (:issue:`5639`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2629" href="#L2629">2629</a><span class="code-text">-  ``cd`` understands the ``--`` argument to make it possible to change</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2630" href="#L2630">2630</a><span class="code-text">   to directories starting with a hyphen (:issue:`6071`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2631" href="#L2631">2631</a><span class="code-text">-  ``complete --do-complete`` now also does fuzzy matches (:issue:`5467`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2632" href="#L2632">2632</a><span class="code-text">-  ``complete --do-complete`` can be used inside completions, allowing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2633" href="#L2633">2633</a><span class="code-text">   limited recursion (:issue:`3474`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2634" href="#L2634">2634</a><span class="code-text">-  ``count`` now also counts lines fed on standard input (:issue:`5744`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2635" href="#L2635">2635</a><span class="code-text">-  ``eval`` produces an exit status of 0 when given no arguments, like</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2636" href="#L2636">2636</a><span class="code-text">   other shells (:issue:`5692`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2637" href="#L2637">2637</a><span class="code-text">-  ``printf`` prints what it can when input hasn’t been fully converted</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2638" href="#L2638">2638</a><span class="code-text">   to a number, but still prints an error (:issue:`5532`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2639" href="#L2639">2639</a><span class="code-text">-  ``complete -C foo`` now works as expected, rather than requiring</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2640" href="#L2640">2640</a><span class="code-text">   ``complete -Cfoo``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2641" href="#L2641">2641</a><span class="code-text">-  ``complete`` has a new ``--force-files`` option, to re-enable file</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2642" href="#L2642">2642</a><span class="code-text">   completions. This allows ``sudo -E`` and ``pacman -Qo`` to complete</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2643" href="#L2643">2643</a><span class="code-text">   correctly (:issue:`5646`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2644" href="#L2644">2644</a><span class="code-text">-  ``argparse`` now defaults to showing the current function name</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2645" href="#L2645">2645</a><span class="code-text">   (instead of ``argparse``) in its errors, making ``--name`` often</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2646" href="#L2646">2646</a><span class="code-text">   superfluous (:issue:`5835`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2647" href="#L2647">2647</a><span class="code-text">-  ``argparse`` has a new ``--ignore-unknown`` option to keep</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2648" href="#L2648">2648</a><span class="code-text">   unrecognized options, allowing multiple argparse passes to parse</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2649" href="#L2649">2649</a><span class="code-text">   options (:issue:`5367`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2650" href="#L2650">2650</a><span class="code-text">-  ``argparse`` correctly handles flag value validation of options that</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2651" href="#L2651">2651</a><span class="code-text">   only have short names (:issue:`5864`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2652" href="#L2652">2652</a><span class="code-text">-  ``read -S`` (short option of ``--shell``) is recognised correctly</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2653" href="#L2653">2653</a><span class="code-text">   (:issue:`5660`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2654" href="#L2654">2654</a><span class="code-text">-  ``read`` understands ``--list``, which acts like ``--array`` in</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2655" href="#L2655">2655</a><span class="code-text">   reading all arguments into a list inside a single variable, but is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2656" href="#L2656">2656</a><span class="code-text">   better named (:issue:`5846`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2657" href="#L2657">2657</a><span class="code-text">-  ``read`` has a new option, ``--tokenize``, which splits a string into</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2658" href="#L2658">2658</a><span class="code-text">   variables according to the shell’s tokenization rules, considering</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2659" href="#L2659">2659</a><span class="code-text">   quoting, escaping, and so on (:issue:`3823`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2660" href="#L2660">2660</a><span class="code-text">-  ``read`` interacts more correctly with the deprecated ``$IFS``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2661" href="#L2661">2661</a><span class="code-text">   variable, in particular removing multiple separators when splitting a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2662" href="#L2662">2662</a><span class="code-text">   variable into a list (:issue:`6406`), matching other shells.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2663" href="#L2663">2663</a><span class="code-text">-  ``fish_indent`` now handles semicolons better, including leaving them</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2664" href="#L2664">2664</a><span class="code-text">   in place for ``; and`` and ``; or`` instead of breaking the line</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2665" href="#L2665">2665</a><span class="code-text">   (:issue:`5859`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2666" href="#L2666">2666</a><span class="code-text">-  ``fish_indent --write`` now supports multiple file arguments,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2667" href="#L2667">2667</a><span class="code-text">   indenting them in turn.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2668" href="#L2668">2668</a><span class="code-text">-  The default read limit has been increased to 100MiB (:issue:`5267`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2669" href="#L2669">2669</a><span class="code-text">-  ``math`` now also understands ``x`` for multiplication, provided it</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2670" href="#L2670">2670</a><span class="code-text">   is followed by whitespace (:issue:`5906`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2671" href="#L2671">2671</a><span class="code-text">-  ``math`` reports the right error when incorrect syntax is used inside</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2672" href="#L2672">2672</a><span class="code-text">   parentheses (:issue:`6063`), and warns when unsupported logical operations</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2673" href="#L2673">2673</a><span class="code-text">   are used (:issue:`6096`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2674" href="#L2674">2674</a><span class="code-text">-  ``functions --erase`` now also prevents fish from autoloading a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2675" href="#L2675">2675</a><span class="code-text">   function for the first time (:issue:`5951`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2676" href="#L2676">2676</a><span class="code-text">-  ``jobs --last`` returns 0 to indicate success when a job is found</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2677" href="#L2677">2677</a><span class="code-text">   (:issue:`6104`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2678" href="#L2678">2678</a><span class="code-text">-  ``commandline -p`` and ``commandline -j`` now split on ``&amp;&amp;`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2679" href="#L2679">2679</a><span class="code-text">   ``||`` in addition to ``;`` and ``&amp;`` (:issue:`6214`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2680" href="#L2680">2680</a><span class="code-text">-  A bug where ``string split`` would drop empty strings if the output</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2681" href="#L2681">2681</a><span class="code-text">   was only empty strings has been fixed (:issue:`5987`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2682" href="#L2682">2682</a><span class="code-text">-  ``eval`` no long creates a new local variable scope, but affects</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2683" href="#L2683">2683</a><span class="code-text">   variables in the scope it is called from (:issue:`4443`). ``source`` still</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2684" href="#L2684">2684</a><span class="code-text">   creates a new local scope.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2685" href="#L2685">2685</a><span class="code-text">-  ``abbr`` has a new ``--query`` option to check for the existence of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2686" href="#L2686">2686</a><span class="code-text">   an abbreviation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2687" href="#L2687">2687</a><span class="code-text">-  Local values for ``fish_complete_path`` and ``fish_function_path``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2688" href="#L2688">2688</a><span class="code-text">   are now ignored; only their global values are respected.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2689" href="#L2689">2689</a><span class="code-text">-  Syntax error reports now display a marker in the correct position</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2690" href="#L2690">2690</a><span class="code-text">   (:issue:`5812`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2691" href="#L2691">2691</a><span class="code-text">-  Empty universal variables may now be exported (:issue:`5992`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2692" href="#L2692">2692</a><span class="code-text">-  Exported universal variables are no longer imported into the global</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2693" href="#L2693">2693</a><span class="code-text">   scope, preventing shadowing. This makes it easier to change such</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2694" href="#L2694">2694</a><span class="code-text">   variables for all fish sessions and avoids breakage when the value is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2695" href="#L2695">2695</a><span class="code-text">   a list of multiple elements (:issue:`5258`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2696" href="#L2696">2696</a><span class="code-text">-  A bug where ``for`` could use invalid variable names has been fixed</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2697" href="#L2697">2697</a><span class="code-text">   (:issue:`5800`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2698" href="#L2698">2698</a><span class="code-text">-  A bug where local variables would not be exported to functions has</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2699" href="#L2699">2699</a><span class="code-text">   been fixed (:issue:`6153`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2700" href="#L2700">2700</a><span class="code-text">-  The null command (``:``) now always exits successfully, rather than</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2701" href="#L2701">2701</a><span class="code-text">   passing through the previous exit status (:issue:`6022`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2702" href="#L2702">2702</a><span class="code-text">-  The output of ``functions FUNCTION`` matches the declaration of the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2703" href="#L2703">2703</a><span class="code-text">   function, correctly including comments or blank lines (:issue:`5285`), and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2704" href="#L2704">2704</a><span class="code-text">   correctly includes any ``--wraps`` flags (:issue:`1625`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2705" href="#L2705">2705</a><span class="code-text">-  ``type`` supports a new option, ``--short``, which suppress function</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2706" href="#L2706">2706</a><span class="code-text">   expansion (:issue:`6403`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2707" href="#L2707">2707</a><span class="code-text">-  ``type --path`` with a function argument will now output the path to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2708" href="#L2708">2708</a><span class="code-text">   the file containing the definition of that function, if it exists.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2709" href="#L2709">2709</a><span class="code-text">-  ``type --force-path`` with an argument that cannot be found now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2710" href="#L2710">2710</a><span class="code-text">   correctly outputs nothing, as documented (:issue:`6411`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2711" href="#L2711">2711</a><span class="code-text">-  The ``$hostname`` variable is no longer truncated to 32 characters</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2712" href="#L2712">2712</a><span class="code-text">   (:issue:`5758`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2713" href="#L2713">2713</a><span class="code-text">-  Line numbers in function backtraces are calculated correctly (:issue:`6350`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2714" href="#L2714">2714</a><span class="code-text">-  A new ``fish_cancel`` event is emitted when the command line is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2715" href="#L2715">2715</a><span class="code-text">   cancelled, which is useful for terminal integration (:issue:`5973`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2716" href="#L2716">2716</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2717" href="#L2717">2717</a><span class="code-text">.. _interactive-improvements-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2718" href="#L2718">2718</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2719" href="#L2719">2719</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2720" href="#L2720">2720</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2721" href="#L2721">2721</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2722" href="#L2722">2722</a><span class="code-text">-  New Base16 color options are available through the Web-based</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2723" href="#L2723">2723</a><span class="code-text">   configuration (:issue:`6504`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2724" href="#L2724">2724</a><span class="code-text">-  fish only parses ``/etc/paths`` on macOS in login shells, matching</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2725" href="#L2725">2725</a><span class="code-text">   the bash implementation (:issue:`5637`) and avoiding changes to path ordering</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2726" href="#L2726">2726</a><span class="code-text">   in child shells (:issue:`5456`). It now ignores blank lines like the bash</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2727" href="#L2727">2727</a><span class="code-text">   implementation (:issue:`5809`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2728" href="#L2728">2728</a><span class="code-text">-  The locale is now reloaded when the ``LOCPATH`` variable is changed</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2729" href="#L2729">2729</a><span class="code-text">   (:issue:`5815`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2730" href="#L2730">2730</a><span class="code-text">-  ``read`` no longer keeps a history, making it suitable for operations</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2731" href="#L2731">2731</a><span class="code-text">   that shouldn’t end up there, like password entry (:issue:`5904`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2732" href="#L2732">2732</a><span class="code-text">-  ``dirh`` outputs its stack in the correct order (:issue:`5477`), and behaves</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2733" href="#L2733">2733</a><span class="code-text">   as documented when universal variables are used for its stack</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2734" href="#L2734">2734</a><span class="code-text">   (:issue:`5797`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2735" href="#L2735">2735</a><span class="code-text">-  ``funced`` and the edit-commandline-in-buffer bindings did not work</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2736" href="#L2736">2736</a><span class="code-text">   in fish 3.0 when the ``$EDITOR`` variable contained spaces; this has</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2737" href="#L2737">2737</a><span class="code-text">   been corrected (:issue:`5625`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2738" href="#L2738">2738</a><span class="code-text">-  Builtins now pipe their help output to a pager automatically (:issue:`6227`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2739" href="#L2739">2739</a><span class="code-text">-  ``set_color`` now colors the ``--print-colors`` output in the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2740" href="#L2740">2740</a><span class="code-text">   matching colors if it is going to a terminal.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2741" href="#L2741">2741</a><span class="code-text">-  fish now underlines every valid entered path instead of just the last</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2742" href="#L2742">2742</a><span class="code-text">   one (:issue:`5872`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2743" href="#L2743">2743</a><span class="code-text">-  When syntax highlighting a string with an unclosed quote, only the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2744" href="#L2744">2744</a><span class="code-text">   quote itself will be shown as an error, instead of the whole</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2745" href="#L2745">2745</a><span class="code-text">   argument.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2746" href="#L2746">2746</a><span class="code-text">-  Syntax highlighting works correctly with variables as commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2747" href="#L2747">2747</a><span class="code-text">   (:issue:`5658`) and redirections to close file descriptors (:issue:`6092`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2748" href="#L2748">2748</a><span class="code-text">-  ``help`` works properly on Windows Subsystem for Linux (:issue:`5759`, :issue:`6338`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2749" href="#L2749">2749</a><span class="code-text">-  A bug where ``disown`` could crash the shell has been fixed (:issue:`5720`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2750" href="#L2750">2750</a><span class="code-text">-  fish will not autosuggest files ending with ``~`` unless there are no</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2751" href="#L2751">2751</a><span class="code-text">   other candidates, as these are generally backup files (:issue:`985`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2752" href="#L2752">2752</a><span class="code-text">-  Escape in the pager works correctly (:issue:`5818`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2753" href="#L2753">2753</a><span class="code-text">-  Key bindings that call ``fg`` no longer leave the terminal in a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2754" href="#L2754">2754</a><span class="code-text">   broken state (:issue:`2114`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2755" href="#L2755">2755</a><span class="code-text">-  Brackets (:issue:`5831`) and filenames containing ``$`` (:issue:`6060`) are completed</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2756" href="#L2756">2756</a><span class="code-text">   with appropriate escaping.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2757" href="#L2757">2757</a><span class="code-text">-  The output of ``complete`` and ``functions`` is now colorized in</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2758" href="#L2758">2758</a><span class="code-text">   interactive terminals.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2759" href="#L2759">2759</a><span class="code-text">-  The Web-based configuration handles aliases that include single</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2760" href="#L2760">2760</a><span class="code-text">   quotes correctly (:issue:`6120`), and launches correctly under Termux (:issue:`6248`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2761" href="#L2761">2761</a><span class="code-text">   and OpenBSD (:issue:`6522`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2762" href="#L2762">2762</a><span class="code-text">-  ``function`` now correctly validates parameters for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2763" href="#L2763">2763</a><span class="code-text">   ``--argument-names`` as valid variable names (:issue:`6147`) and correctly</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2764" href="#L2764">2764</a><span class="code-text">   parses options following ``--argument-names``, as in</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2765" href="#L2765">2765</a><span class="code-text">   “``--argument-names foo --description bar``” (:issue:`6186`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2766" href="#L2766">2766</a><span class="code-text">-  History newly imported from bash includes command lines using ``&amp;&amp;``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2767" href="#L2767">2767</a><span class="code-text">   or ``||``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2768" href="#L2768">2768</a><span class="code-text">-  The automatic generation of completions from manual pages is better</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2769" href="#L2769">2769</a><span class="code-text">   described in job and process listings, and no longer produces a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2770" href="#L2770">2770</a><span class="code-text">   warning when exiting fish (:issue:`6269`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2771" href="#L2771">2771</a><span class="code-text">-  In private mode, setting ``$fish_greeting`` to an empty string before</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2772" href="#L2772">2772</a><span class="code-text">   starting the private session will prevent the warning about history</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2773" href="#L2773">2773</a><span class="code-text">   not being saved from being printed (:issue:`6299`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2774" href="#L2774">2774</a><span class="code-text">-  In the interactive editor, a line break (Enter) inside unclosed</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2775" href="#L2775">2775</a><span class="code-text">   brackets will insert a new line, rather than executing the command</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2776" href="#L2776">2776</a><span class="code-text">   and producing an error (:issue:`6316`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2777" href="#L2777">2777</a><span class="code-text">-  Ctrl-C always repaints the prompt (:issue:`6394`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2778" href="#L2778">2778</a><span class="code-text">-  When run interactively from another program (such as Python), fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2779" href="#L2779">2779</a><span class="code-text">   will correctly start a new process group, like other shells (:issue:`5909`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2780" href="#L2780">2780</a><span class="code-text">-  Job identifiers (for example, for background jobs) are assigned more</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2781" href="#L2781">2781</a><span class="code-text">   logically (:issue:`6053`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2782" href="#L2782">2782</a><span class="code-text">-  A bug where history would appear truncated if an empty command was</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2783" href="#L2783">2783</a><span class="code-text">   executed was fixed (:issue:`6032`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2784" href="#L2784">2784</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2785" href="#L2785">2785</a><span class="code-text">.. _new-or-improved-bindings-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2786" href="#L2786">2786</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2787" href="#L2787">2787</a><span class="code-text">New or improved bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2788" href="#L2788">2788</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2789" href="#L2789">2789</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2790" href="#L2790">2790</a><span class="code-text">-  Pasting strips leading spaces to avoid pasted commands being omitted</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2791" href="#L2791">2791</a><span class="code-text">   from the history (:issue:`4327`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2792" href="#L2792">2792</a><span class="code-text">-  Shift-Left and Shift-Right now default to moving backwards and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2793" href="#L2793">2793</a><span class="code-text">   forwards by one bigword (words separated by whitespace) (:issue:`1505`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2794" href="#L2794">2794</a><span class="code-text">-  The default escape delay (to differentiate between the escape key and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2795" href="#L2795">2795</a><span class="code-text">   an alt-combination) has been reduced to 30ms, down from 300ms for the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2796" href="#L2796">2796</a><span class="code-text">   default mode and 100ms for Vi mode (:issue:`3904`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2797" href="#L2797">2797</a><span class="code-text">-  The ``forward-bigword`` binding now interacts correctly with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2798" href="#L2798">2798</a><span class="code-text">   autosuggestions (:issue:`5336`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2799" href="#L2799">2799</a><span class="code-text">-  The ``fish_clipboard_*`` functions support Wayland by using</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2800" href="#L2800">2800</a><span class="code-text">   `wl-clipboard &lt;https://github.com/bugaevc/wl-clipboard&gt;`_</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2801" href="#L2801">2801</a><span class="code-text">   (:issue:`5450`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2802" href="#L2802">2802</a><span class="code-text">-  The ``nextd`` and ``prevd`` functions no longer print “Hit end of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2803" href="#L2803">2803</a><span class="code-text">   history”, instead using a bell. They correctly store working</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2804" href="#L2804">2804</a><span class="code-text">   directories containing symbolic links (:issue:`6395`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2805" href="#L2805">2805</a><span class="code-text">-  If a ``fish_mode_prompt`` function exists, Vi mode will only execute</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2806" href="#L2806">2806</a><span class="code-text">   it on mode-switch instead of the entire prompt. This should make it</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2807" href="#L2807">2807</a><span class="code-text">   much more responsive with slow prompts (:issue:`5783`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2808" href="#L2808">2808</a><span class="code-text">-  The path-component bindings (like Ctrl-w) now also stop at “:” and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2809" href="#L2809">2809</a><span class="code-text">   “@”, because those are used to denote user and host in commands such</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2810" href="#L2810">2810</a><span class="code-text">   as ``ssh`` (:issue:`5841`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2811" href="#L2811">2811</a><span class="code-text">-  The NULL character can now be bound via ``bind -k nul``. Terminals</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2812" href="#L2812">2812</a><span class="code-text">   often generate this character via control-space. (:issue:`3189`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2813" href="#L2813">2813</a><span class="code-text">-  A new readline command ``expand-abbr`` can be used to trigger</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2814" href="#L2814">2814</a><span class="code-text">   abbreviation expansion (:issue:`5762`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2815" href="#L2815">2815</a><span class="code-text">-  A new readline command, ``delete-or-exit``, removes a character to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2816" href="#L2816">2816</a><span class="code-text">   the right of the cursor or exits the shell if the command line is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2817" href="#L2817">2817</a><span class="code-text">   empty (moving this functionality out of the ``delete-or-exit``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2818" href="#L2818">2818</a><span class="code-text">   function).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2819" href="#L2819">2819</a><span class="code-text">-  The ``self-insert`` readline command will now insert the binding</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2820" href="#L2820">2820</a><span class="code-text">   sequence, if not empty.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2821" href="#L2821">2821</a><span class="code-text">-  A new binding to prepend ``sudo``, bound to Alt-S by default (:issue:`6140`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2822" href="#L2822">2822</a><span class="code-text">-  The Alt-W binding to describe a command should now work better with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2823" href="#L2823">2823</a><span class="code-text">   multiline prompts (:issue:`6110`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2824" href="#L2824">2824</a><span class="code-text">-  The Alt-H binding to open a command’s man page now tries to ignore</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2825" href="#L2825">2825</a><span class="code-text">   ``sudo`` (:issue:`6122`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2826" href="#L2826">2826</a><span class="code-text">-  A new pair of bind functions, ``history-prefix-search-backward`` (and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2827" href="#L2827">2827</a><span class="code-text">   ``forward``), was introduced (:issue:`6143`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2828" href="#L2828">2828</a><span class="code-text">-  Vi mode now supports R to enter replace mode (:issue:`6342`), and ``d0`` to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2829" href="#L2829">2829</a><span class="code-text">   delete the current line (:issue:`6292`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2830" href="#L2830">2830</a><span class="code-text">-  In Vi mode, hitting Enter in replace-one mode no longer erases the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2831" href="#L2831">2831</a><span class="code-text">   prompt (:issue:`6298`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2832" href="#L2832">2832</a><span class="code-text">-  Selections in Vi mode are inclusive, matching the actual behaviour of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2833" href="#L2833">2833</a><span class="code-text">   Vi (:issue:`5770`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2834" href="#L2834">2834</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2835" href="#L2835">2835</a><span class="code-text">.. _improved-prompts-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2836" href="#L2836">2836</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2837" href="#L2837">2837</a><span class="code-text">Improved prompts</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2838" href="#L2838">2838</a><span class="code-text">^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2839" href="#L2839">2839</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2840" href="#L2840">2840</a><span class="code-text">-  The Git prompt in informative mode now shows the number of stashes if</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2841" href="#L2841">2841</a><span class="code-text">   enabled.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2842" href="#L2842">2842</a><span class="code-text">-  The Git prompt now has an option</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2843" href="#L2843">2843</a><span class="code-text">   (``$__fish_git_prompt_use_informative_chars``) to use the (more</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2844" href="#L2844">2844</a><span class="code-text">   modern) informative characters without enabling informative mode.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2845" href="#L2845">2845</a><span class="code-text">-  The default prompt now also features VCS integration and will color</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2846" href="#L2846">2846</a><span class="code-text">   the host if running via SSH (:issue:`6375`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2847" href="#L2847">2847</a><span class="code-text">-  The default and example prompts print the pipe status if an earlier</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2848" href="#L2848">2848</a><span class="code-text">   command in the pipe fails.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2849" href="#L2849">2849</a><span class="code-text">-  The default and example prompts try to resolve exit statuses to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2850" href="#L2850">2850</a><span class="code-text">   signal names when appropriate.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2851" href="#L2851">2851</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2852" href="#L2852">2852</a><span class="code-text">.. _improved-terminal-output-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2853" href="#L2853">2853</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2854" href="#L2854">2854</a><span class="code-text">Improved terminal output</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2855" href="#L2855">2855</a><span class="code-text">^^^^^^^^^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2856" href="#L2856">2856</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2857" href="#L2857">2857</a><span class="code-text">-  New ``fish_pager_color_`` options have been added to control more</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2858" href="#L2858">2858</a><span class="code-text">   elements of the pager’s colors (:issue:`5524`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2859" href="#L2859">2859</a><span class="code-text">-  Better detection and support for using fish from various system</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2860" href="#L2860">2860</a><span class="code-text">   consoles, where limited colors and special characters are supported</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2861" href="#L2861">2861</a><span class="code-text">   (:issue:`5552`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2862" href="#L2862">2862</a><span class="code-text">-  fish now tries to guess if the system supports Unicode 9 (and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2863" href="#L2863">2863</a><span class="code-text">   displays emoji as wide), eliminating the need to set</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2864" href="#L2864">2864</a><span class="code-text">   ``$fish_emoji_width`` in most cases (:issue:`5722`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2865" href="#L2865">2865</a><span class="code-text">-  Improvements to the display of wide characters, particularly Korean</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2866" href="#L2866">2866</a><span class="code-text">   characters and emoji (:issue:`5583`, :issue:`5729`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2867" href="#L2867">2867</a><span class="code-text">-  The Vi mode cursor is correctly redrawn when regaining focus under</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2868" href="#L2868">2868</a><span class="code-text">   terminals that report focus (eg tmux) (:issue:`4788`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2869" href="#L2869">2869</a><span class="code-text">-  Variables that control background colors (such as</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2870" href="#L2870">2870</a><span class="code-text">   ``fish_pager_color_search_match``) can now use ``--reverse``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2871" href="#L2871">2871</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2872" href="#L2872">2872</a><span class="code-text">.. _completions-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2873" href="#L2873">2873</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2874" href="#L2874">2874</a><span class="code-text">Completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2875" href="#L2875">2875</a><span class="code-text">^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2876" href="#L2876">2876</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2877" href="#L2877">2877</a><span class="code-text">-  Added completions for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2878" href="#L2878">2878</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2879" href="#L2879">2879</a><span class="code-text">   -  ``aws``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2880" href="#L2880">2880</a><span class="code-text">   -  ``bat`` (:issue:`6052`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2881" href="#L2881">2881</a><span class="code-text">   -  ``bosh`` (:issue:`5700`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2882" href="#L2882">2882</a><span class="code-text">   -  ``btrfs``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2883" href="#L2883">2883</a><span class="code-text">   -  ``camcontrol``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2884" href="#L2884">2884</a><span class="code-text">   -  ``cf`` (:issue:`5700`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2885" href="#L2885">2885</a><span class="code-text">   -  ``chronyc`` (:issue:`6496`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2886" href="#L2886">2886</a><span class="code-text">   -  ``code`` (:issue:`6205`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2887" href="#L2887">2887</a><span class="code-text">   -  ``cryptsetup`` (:issue:`6488`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2888" href="#L2888">2888</a><span class="code-text">   -  ``csc`` and ``csi`` (:issue:`6016`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2889" href="#L2889">2889</a><span class="code-text">   -  ``cwebp`` (:issue:`6034`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2890" href="#L2890">2890</a><span class="code-text">   -  ``cygpath`` and ``cygstart`` (:issue:`6239`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2891" href="#L2891">2891</a><span class="code-text">   -  ``epkginfo`` (:issue:`5829`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2892" href="#L2892">2892</a><span class="code-text">   -  ``ffmpeg``, ``ffplay``, and ``ffprobe`` (:issue:`5922`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2893" href="#L2893">2893</a><span class="code-text">   -  ``fsharpc`` and ``fsharpi`` (:issue:`6016`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2894" href="#L2894">2894</a><span class="code-text">   -  ``fzf`` (:issue:`6178`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2895" href="#L2895">2895</a><span class="code-text">   -  ``g++`` (:issue:`6217`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2896" href="#L2896">2896</a><span class="code-text">   -  ``gpg1`` (:issue:`6139`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2897" href="#L2897">2897</a><span class="code-text">   -  ``gpg2`` (:issue:`6062`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2898" href="#L2898">2898</a><span class="code-text">   -  ``grub-mkrescue`` (:issue:`6182`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2899" href="#L2899">2899</a><span class="code-text">   -  ``hledger`` (:issue:`6043`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2900" href="#L2900">2900</a><span class="code-text">   -  ``hwinfo`` (:issue:`6496`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2901" href="#L2901">2901</a><span class="code-text">   -  ``irb`` (:issue:`6260`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2902" href="#L2902">2902</a><span class="code-text">   -  ``iw`` (:issue:`6232`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2903" href="#L2903">2903</a><span class="code-text">   -  ``kak``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2904" href="#L2904">2904</a><span class="code-text">   -  ``keepassxc-cli`` (:issue:`6505`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2905" href="#L2905">2905</a><span class="code-text">   -  ``keybase`` (:issue:`6410`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2906" href="#L2906">2906</a><span class="code-text">   -  ``loginctl`` (:issue:`6501`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2907" href="#L2907">2907</a><span class="code-text">   -  ``lz4``, ``lz4c`` and ``lz4cat`` (:issue:`6364`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2908" href="#L2908">2908</a><span class="code-text">   -  ``mariner`` (:issue:`5718`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2909" href="#L2909">2909</a><span class="code-text">   -  ``nethack`` (:issue:`6240`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2910" href="#L2910">2910</a><span class="code-text">   -  ``patool`` (:issue:`6083`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2911" href="#L2911">2911</a><span class="code-text">   -  ``phpunit`` (:issue:`6197`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2912" href="#L2912">2912</a><span class="code-text">   -  ``plutil`` (:issue:`6301`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2913" href="#L2913">2913</a><span class="code-text">   -  ``pzstd`` (:issue:`6364`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2914" href="#L2914">2914</a><span class="code-text">   -  ``qubes-gpg-client`` (:issue:`6067`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2915" href="#L2915">2915</a><span class="code-text">   -  ``resolvectl`` (:issue:`6501`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2916" href="#L2916">2916</a><span class="code-text">   -  ``rg``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2917" href="#L2917">2917</a><span class="code-text">   -  ``rustup``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2918" href="#L2918">2918</a><span class="code-text">   -  ``sfdx`` (:issue:`6149`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2919" href="#L2919">2919</a><span class="code-text">   -  ``speedtest`` and ``speedtest-cli`` (:issue:`5840`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2920" href="#L2920">2920</a><span class="code-text">   -  ``src`` (:issue:`6026`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2921" href="#L2921">2921</a><span class="code-text">   -  ``tokei`` (:issue:`6085`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2922" href="#L2922">2922</a><span class="code-text">   -  ``tsc`` (:issue:`6016`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2923" href="#L2923">2923</a><span class="code-text">   -  ``unlz4`` (:issue:`6364`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2924" href="#L2924">2924</a><span class="code-text">   -  ``unzstd`` (:issue:`6364`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2925" href="#L2925">2925</a><span class="code-text">   -  ``vbc`` (:issue:`6016`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2926" href="#L2926">2926</a><span class="code-text">   -  ``zpaq`` (:issue:`6245`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2927" href="#L2927">2927</a><span class="code-text">   -  ``zstd``, ``zstdcat``, ``zstdgrep``, ``zstdless`` and ``zstdmt``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2928" href="#L2928">2928</a><span class="code-text">      (:issue:`6364`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2929" href="#L2929">2929</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2930" href="#L2930">2930</a><span class="code-text">-  Lots of improvements to completions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2931" href="#L2931">2931</a><span class="code-text">-  Selecting short options which also have a long name from the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2932" href="#L2932">2932</a><span class="code-text">   completion pager is possible (:issue:`5634`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2933" href="#L2933">2933</a><span class="code-text">-  Tab completion will no longer add trailing spaces if they already</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2934" href="#L2934">2934</a><span class="code-text">   exist (:issue:`6107`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2935" href="#L2935">2935</a><span class="code-text">-  Completion of subcommands to builtins like ``and`` or ``not`` now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2936" href="#L2936">2936</a><span class="code-text">   works correctly (:issue:`6249`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2937" href="#L2937">2937</a><span class="code-text">-  Completion of arguments to short options works correctly when</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2938" href="#L2938">2938</a><span class="code-text">   multiple short options are used together (:issue:`332`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2939" href="#L2939">2939</a><span class="code-text">-  Activating completion in the middle of an invalid completion does not</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2940" href="#L2940">2940</a><span class="code-text">   move the cursor any more, making it easier to fix a mistake (:issue:`4124`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2941" href="#L2941">2941</a><span class="code-text">-  Completion in empty commandlines now lists all available commands.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2942" href="#L2942">2942</a><span class="code-text">-  Functions listed as completions could previously leak parts of the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2943" href="#L2943">2943</a><span class="code-text">   function as other completions; this has been fixed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2944" href="#L2944">2944</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2945" href="#L2945">2945</a><span class="code-text">.. _deprecations-and-removed-features-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2946" href="#L2946">2946</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2947" href="#L2947">2947</a><span class="code-text">Deprecations and removed features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2948" href="#L2948">2948</a><span class="code-text">---------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2949" href="#L2949">2949</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2950" href="#L2950">2950</a><span class="code-text">-  The vcs-prompt functions have been promoted to names without</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2951" href="#L2951">2951</a><span class="code-text">   double-underscore, so \__fish_git_prompt is now fish_git_prompt,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2952" href="#L2952">2952</a><span class="code-text">   \__fish_vcs_prompt is now fish_vcs_prompt, \__fish_hg_prompt is now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2953" href="#L2953">2953</a><span class="code-text">   fish_hg_prompt and \__fish_svn_prompt is now fish_svn_prompt. Shims</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2954" href="#L2954">2954</a><span class="code-text">   at the old names have been added, and the variables have kept their</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2955" href="#L2955">2955</a><span class="code-text">   old names (:issue:`5586`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2956" href="#L2956">2956</a><span class="code-text">-  ``string replace`` has an additional round of escaping in the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2957" href="#L2957">2957</a><span class="code-text">   replacement expression, so escaping backslashes requires many escapes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2958" href="#L2958">2958</a><span class="code-text">   (eg ``string replace -ra '([ab])' '\\\\\\\$1' a``). The new feature</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2959" href="#L2959">2959</a><span class="code-text">   flag ``regex-easyesc`` can be used to disable this, so that the same</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2960" href="#L2960">2960</a><span class="code-text">   effect can be achieved with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2961" href="#L2961">2961</a><span class="code-text">   ``string replace -ra '([ab])' '\\\\$1' a`` (:issue:`5556`). As a reminder,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2962" href="#L2962">2962</a><span class="code-text">   the intention behind feature flags is that this will eventually</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2963" href="#L2963">2963</a><span class="code-text">   become the default and then only option, so scripts should be</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2964" href="#L2964">2964</a><span class="code-text">   updated.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2965" href="#L2965">2965</a><span class="code-text">-  The ``fish_vi_mode`` function, deprecated in fish 2.3, has been</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2966" href="#L2966">2966</a><span class="code-text">   removed. Use ``fish_vi_key_bindings`` instead (:issue:`6372`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2967" href="#L2967">2967</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2968" href="#L2968">2968</a><span class="code-text">.. _for-distributors-and-developers-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2969" href="#L2969">2969</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2970" href="#L2970">2970</a><span class="code-text">For distributors and developers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2971" href="#L2971">2971</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2972" href="#L2972">2972</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2973" href="#L2973">2973</a><span class="code-text">-  fish 3.0 introduced a CMake-based build system. In fish 3.1, both the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2974" href="#L2974">2974</a><span class="code-text">   Autotools-based build and legacy Xcode build system have been</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2975" href="#L2975">2975</a><span class="code-text">   removed, leaving only the CMake build system. All distributors and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2976" href="#L2976">2976</a><span class="code-text">   developers must install CMake.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2977" href="#L2977">2977</a><span class="code-text">-  fish now depends on the common ``tee`` external command, for the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2978" href="#L2978">2978</a><span class="code-text">   ``psub`` process substitution function.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2979" href="#L2979">2979</a><span class="code-text">-  The documentation is now built with Sphinx. The old Doxygen-based</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2980" href="#L2980">2980</a><span class="code-text">   documentation system has been removed. Developers, and distributors</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2981" href="#L2981">2981</a><span class="code-text">   who wish to rebuild the documentation, must install Sphinx.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2982" href="#L2982">2982</a><span class="code-text">-  The ``INTERNAL_WCWIDTH`` build option has been removed, as fish now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2983" href="#L2983">2983</a><span class="code-text">   always uses an internal ``wcwidth`` function. It has a number of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2984" href="#L2984">2984</a><span class="code-text">   configuration options that make it more suitable for general use</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2985" href="#L2985">2985</a><span class="code-text">   (:issue:`5777`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2986" href="#L2986">2986</a><span class="code-text">-  mandoc can now be used to format the output from ``--help`` if</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2987" href="#L2987">2987</a><span class="code-text">   ``nroff`` is not installed, reducing the number of external</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2988" href="#L2988">2988</a><span class="code-text">   dependencies on systems with ``mandoc`` installed (:issue:`5489`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2989" href="#L2989">2989</a><span class="code-text">-  Some bugs preventing building on Solaris-derived systems such as</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2990" href="#L2990">2990</a><span class="code-text">   Illumos were fixed (:issue:`5458`, :issue:`5461`, :issue:`5611`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2991" href="#L2991">2991</a><span class="code-text">-  Completions for ``npm``, ``bower`` and ``yarn`` no longer require the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2992" href="#L2992">2992</a><span class="code-text">   ``jq`` utility for full functionality, but will use Python instead if</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2993" href="#L2993">2993</a><span class="code-text">   it is available.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2994" href="#L2994">2994</a><span class="code-text">-  The paths for completions, functions and configuration snippets have</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2995" href="#L2995">2995</a><span class="code-text">   been extended. On systems that define ``XDG_DATA_DIRS``, each of the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2996" href="#L2996">2996</a><span class="code-text">   directories in this variable are searched in the subdirectories</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2997" href="#L2997">2997</a><span class="code-text">   ``fish/vendor_completions.d``, ``fish/vendor_functions.d``, and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2998" href="#L2998">2998</a><span class="code-text">   ``fish/vendor_conf.d`` respectively. On systems that do not define</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2999" href="#L2999">2999</a><span class="code-text">   this variable in the environment, the vendor directories are searched</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3000" href="#L3000">3000</a><span class="code-text">   for in both the installation prefix and the default “extra”</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3001" href="#L3001">3001</a><span class="code-text">   directory, which now defaults to ``/usr/local`` (:issue:`5029`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3002" href="#L3002">3002</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3003" href="#L3003">3003</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3004" href="#L3004">3004</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3005" href="#L3005">3005</a><span class="code-text">fish 3.0.2 (released February 19, 2019)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3006" href="#L3006">3006</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3007" href="#L3007">3007</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3008" href="#L3008">3008</a><span class="code-text">This release of fish fixes an issue discovered in fish 3.0.1.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3009" href="#L3009">3009</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3010" href="#L3010">3010</a><span class="code-text">Fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3011" href="#L3011">3011</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3012" href="#L3012">3012</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3013" href="#L3013">3013</a><span class="code-text">-  The PWD environment variable is now ignored if it does not resolve to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3014" href="#L3014">3014</a><span class="code-text">   the true working directory, fixing strange behaviour in terminals</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3015" href="#L3015">3015</a><span class="code-text">   started by editors and IDEs (:issue:`5647`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3016" href="#L3016">3016</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3017" href="#L3017">3017</a><span class="code-text">If you are upgrading from version 2.7.1 or before, please also review</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3018" href="#L3018">3018</a><span class="code-text">the release notes for 3.0.1, 3.0.0 and 3.0b1 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3019" href="#L3019">3019</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3020" href="#L3020">3020</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3021" href="#L3021">3021</a><span class="code-text">fish 3.0.1 (released February 11, 2019)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3022" href="#L3022">3022</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3023" href="#L3023">3023</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3024" href="#L3024">3024</a><span class="code-text">This release of fish fixes a number of major issues discovered in fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3025" href="#L3025">3025</a><span class="code-text">3.0.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3026" href="#L3026">3026</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3027" href="#L3027">3027</a><span class="code-text">.. _fixes-and-improvements-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3028" href="#L3028">3028</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3029" href="#L3029">3029</a><span class="code-text">Fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3030" href="#L3030">3030</a><span class="code-text">----------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3031" href="#L3031">3031</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3032" href="#L3032">3032</a><span class="code-text">-  ``exec`` does not complain about running foreground jobs when called</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3033" href="#L3033">3033</a><span class="code-text">   (:issue:`5449`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3034" href="#L3034">3034</a><span class="code-text">-  while loops now evaluate to the last executed command in the loop</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3035" href="#L3035">3035</a><span class="code-text">   body (or zero if the body was empty), matching POSIX semantics</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3036" href="#L3036">3036</a><span class="code-text">   (:issue:`4982`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3037" href="#L3037">3037</a><span class="code-text">-  ``read --silent`` no longer echoes to the tty when run from a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3038" href="#L3038">3038</a><span class="code-text">   non-interactive script (:issue:`5519`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3039" href="#L3039">3039</a><span class="code-text">-  On macOS, path entries with spaces in ``/etc/paths`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3040" href="#L3040">3040</a><span class="code-text">   ``/etc/paths.d`` now correctly set path entries with spaces.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3041" href="#L3041">3041</a><span class="code-text">   Likewise, ``MANPATH`` is correctly set from ``/etc/manpaths`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3042" href="#L3042">3042</a><span class="code-text">   ``/etc/manpaths.d`` (:issue:`5481`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3043" href="#L3043">3043</a><span class="code-text">-  fish starts correctly under Cygwin/MSYS2 (:issue:`5426`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3044" href="#L3044">3044</a><span class="code-text">-  The ``pager-toggle-search`` binding (Ctrl-S by default) will now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3045" href="#L3045">3045</a><span class="code-text">   activate the search field, even when the pager is not focused.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3046" href="#L3046">3046</a><span class="code-text">-  The error when a command is not found is now printed a single time,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3047" href="#L3047">3047</a><span class="code-text">   instead of once per argument (:issue:`5588`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3048" href="#L3048">3048</a><span class="code-text">-  Fixes and improvements to the git completions, including printing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3049" href="#L3049">3049</a><span class="code-text">   correct paths with older git versions, fuzzy matching again, reducing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3050" href="#L3050">3050</a><span class="code-text">   unnecessary offers of root paths (starting with ``:/``) (:issue:`5578`,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3051" href="#L3051">3051</a><span class="code-text">   :issue:`5574`, :issue:`5476`), and ignoring shell aliases, so enterprising users can</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3052" href="#L3052">3052</a><span class="code-text">   set up the wrapping command (via</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3053" href="#L3053">3053</a><span class="code-text">   ``set -g __fish_git_alias_$command $whatitwraps``) (:issue:`5412`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3054" href="#L3054">3054</a><span class="code-text">-  Significant performance improvements to core shell functions (:issue:`5447`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3055" href="#L3055">3055</a><span class="code-text">   and to the ``kill`` completions (:issue:`5541`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3056" href="#L3056">3056</a><span class="code-text">-  Starting in symbolically-linked working directories works correctly</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3057" href="#L3057">3057</a><span class="code-text">   (:issue:`5525`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3058" href="#L3058">3058</a><span class="code-text">-  The default ``fish_title`` function no longer contains extra spaces</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3059" href="#L3059">3059</a><span class="code-text">   (:issue:`5517`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3060" href="#L3060">3060</a><span class="code-text">-  The ``nim`` prompt now works correctly when chosen in the Web-based</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3061" href="#L3061">3061</a><span class="code-text">   configuration (:issue:`5490`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3062" href="#L3062">3062</a><span class="code-text">-  ``string`` now prints help to stdout, like other builtins (:issue:`5495`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3063" href="#L3063">3063</a><span class="code-text">-  Killing the terminal while fish is in vi normal mode will no longer</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3064" href="#L3064">3064</a><span class="code-text">   send it spinning and eating CPU. (:issue:`5528`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3065" href="#L3065">3065</a><span class="code-text">-  A number of crashes have been fixed (:issue:`5550`, :issue:`5548`, :issue:`5479`, :issue:`5453`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3066" href="#L3066">3066</a><span class="code-text">-  Improvements to the documentation and certain completions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3067" href="#L3067">3067</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3068" href="#L3068">3068</a><span class="code-text">Known issues</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3069" href="#L3069">3069</a><span class="code-text">------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3070" href="#L3070">3070</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3071" href="#L3071">3071</a><span class="code-text">There is one significant known issue that was not corrected before the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3072" href="#L3072">3072</a><span class="code-text">release:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3073" href="#L3073">3073</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3074" href="#L3074">3074</a><span class="code-text">-  fish does not run correctly under Windows Services for Linux before</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3075" href="#L3075">3075</a><span class="code-text">   Windows 10 version 1809/17763, and the message warning of this may</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3076" href="#L3076">3076</a><span class="code-text">   not be displayed (:issue:`5619`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3077" href="#L3077">3077</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3078" href="#L3078">3078</a><span class="code-text">If you are upgrading from version 2.7.1 or before, please also review</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3079" href="#L3079">3079</a><span class="code-text">the release notes for 3.0.0 and 3.0b1 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3080" href="#L3080">3080</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3081" href="#L3081">3081</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3082" href="#L3082">3082</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3083" href="#L3083">3083</a><span class="code-text">fish 3.0.0 (released December 28, 2018)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3084" href="#L3084">3084</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3085" href="#L3085">3085</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3086" href="#L3086">3086</a><span class="code-text">fish 3 is a major release, which introduces some breaking changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3087" href="#L3087">3087</a><span class="code-text">alongside improved functionality. Although most existing scripts will</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3088" href="#L3088">3088</a><span class="code-text">continue to work, they should be reviewed against the list contained in</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3089" href="#L3089">3089</a><span class="code-text">the 3.0b1 release notes below.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3090" href="#L3090">3090</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3091" href="#L3091">3091</a><span class="code-text">Compared to the beta release of fish 3.0b1, fish version 3.0.0:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3092" href="#L3092">3092</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3093" href="#L3093">3093</a><span class="code-text">-  builds correctly against musl libc (:issue:`5407`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3094" href="#L3094">3094</a><span class="code-text">-  handles huge numeric arguments to ``test`` correctly (:issue:`5414`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3095" href="#L3095">3095</a><span class="code-text">-  removes the history colouring introduced in 3.0b1, which did not</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3096" href="#L3096">3096</a><span class="code-text">   always work correctly</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3097" href="#L3097">3097</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3098" href="#L3098">3098</a><span class="code-text">There is one significant known issue which was not able to be corrected</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3099" href="#L3099">3099</a><span class="code-text">before the release:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3100" href="#L3100">3100</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3101" href="#L3101">3101</a><span class="code-text">-  fish 3.0.0 builds on Cygwin (:issue:`5423`), but does not run correctly</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3102" href="#L3102">3102</a><span class="code-text">   (:issue:`5426`) and will result in a hanging terminal when started. Cygwin</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3103" href="#L3103">3103</a><span class="code-text">   users are encouraged to continue using 2.7.1 until a release which</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3104" href="#L3104">3104</a><span class="code-text">   corrects this is available.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3105" href="#L3105">3105</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3106" href="#L3106">3106</a><span class="code-text">If you are upgrading from version 2.7.1 or before, please also review</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3107" href="#L3107">3107</a><span class="code-text">the release notes for 3.0b1 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3108" href="#L3108">3108</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3109" href="#L3109">3109</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3110" href="#L3110">3110</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3111" href="#L3111">3111</a><span class="code-text">fish 3.0b1 (released December 11, 2018)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3112" href="#L3112">3112</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3113" href="#L3113">3113</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3114" href="#L3114">3114</a><span class="code-text">fish 3 is a major release, which introduces some breaking changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3115" href="#L3115">3115</a><span class="code-text">alongside improved functionality. Although most existing scripts will</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3116" href="#L3116">3116</a><span class="code-text">continue to work, they should be reviewed against the list below.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3117" href="#L3117">3117</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3118" href="#L3118">3118</a><span class="code-text">Notable non-backward compatible changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3119" href="#L3119">3119</a><span class="code-text">---------------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3120" href="#L3120">3120</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3121" href="#L3121">3121</a><span class="code-text">-  Process and job expansion has largely been removed. ``%`` will no</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3122" href="#L3122">3122</a><span class="code-text">   longer perform these expansions, except for ``%self`` for the PID of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3123" href="#L3123">3123</a><span class="code-text">   the current shell. Additionally, job management commands (``disown``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3124" href="#L3124">3124</a><span class="code-text">   ``wait``, ``bg``, ``fg`` and ``kill``) will expand job specifiers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3125" href="#L3125">3125</a><span class="code-text">   starting with ``%`` (:issue:`4230`, :issue:`1202`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3126" href="#L3126">3126</a><span class="code-text">-  ``set x[1] x[2] a b``, to set multiple elements of an array at once,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3127" href="#L3127">3127</a><span class="code-text">   is no longer valid syntax (:issue:`4236`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3128" href="#L3128">3128</a><span class="code-text">-  A literal ``{}`` now expands to itself, rather than nothing. This</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3129" href="#L3129">3129</a><span class="code-text">   makes working with ``find -exec`` easier (:issue:`1109`, :issue:`4632`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3130" href="#L3130">3130</a><span class="code-text">-  Literally accessing a zero-index is now illegal syntax and is caught</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3131" href="#L3131">3131</a><span class="code-text">   by the parser (:issue:`4862`). (fish indices start at 1)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3132" href="#L3132">3132</a><span class="code-text">-  Successive commas in brace expansions are handled in less surprising</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3133" href="#L3133">3133</a><span class="code-text">   manner. For example, ``{,,,}`` expands to four empty strings rather</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3134" href="#L3134">3134</a><span class="code-text">   than an empty string, a comma and an empty string again (:issue:`3002`,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3135" href="#L3135">3135</a><span class="code-text">   :issue:`4632`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3136" href="#L3136">3136</a><span class="code-text">-  ``for`` loop control variables are no longer local to the ``for``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3137" href="#L3137">3137</a><span class="code-text">   block (:issue:`1935`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3138" href="#L3138">3138</a><span class="code-text">-  Variables set in ``if`` and ``while`` conditions are available</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3139" href="#L3139">3139</a><span class="code-text">   outside the block (:issue:`4820`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3140" href="#L3140">3140</a><span class="code-text">-  Local exported (``set -lx``) vars are now visible to functions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3141" href="#L3141">3141</a><span class="code-text">   (:issue:`1091`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3142" href="#L3142">3142</a><span class="code-text">-  The new ``math`` builtin (see below) does not support logical</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3143" href="#L3143">3143</a><span class="code-text">   expressions; ``test`` should be used instead (:issue:`4777`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3144" href="#L3144">3144</a><span class="code-text">-  Range expansion will now behave sensibly when given a single positive</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3145" href="#L3145">3145</a><span class="code-text">   and negative index (``$foo[5..-1]`` or ``$foo[-1..5]``), clamping to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3146" href="#L3146">3146</a><span class="code-text">   the last valid index without changing direction if the list has fewer</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3147" href="#L3147">3147</a><span class="code-text">   elements than expected.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3148" href="#L3148">3148</a><span class="code-text">-  ``read`` now uses ``-s`` as short for ``--silent`` (à la ``bash``);</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3149" href="#L3149">3149</a><span class="code-text">   ``--shell``\ ’s abbreviation (formerly ``-s``) is now ``-S`` instead</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3150" href="#L3150">3150</a><span class="code-text">   (:issue:`4490`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3151" href="#L3151">3151</a><span class="code-text">-  ``cd`` no longer resolves symlinks. fish now maintains a virtual</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3152" href="#L3152">3152</a><span class="code-text">   path, matching other shells (:issue:`3350`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3153" href="#L3153">3153</a><span class="code-text">-  ``source`` now requires an explicit ``-`` as the filename to read</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3154" href="#L3154">3154</a><span class="code-text">   from the terminal (:issue:`2633`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3155" href="#L3155">3155</a><span class="code-text">-  Arguments to ``end`` are now errors, instead of being silently</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3156" href="#L3156">3156</a><span class="code-text">   ignored.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3157" href="#L3157">3157</a><span class="code-text">-  The names ``argparse``, ``read``, ``set``, ``status``, ``test`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3158" href="#L3158">3158</a><span class="code-text">   ``[`` are now reserved and not allowed as function names. This</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3159" href="#L3159">3159</a><span class="code-text">   prevents users unintentionally breaking stuff (:issue:`3000`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3160" href="#L3160">3160</a><span class="code-text">-  The ``fish_user_abbreviations`` variable is no longer used;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3161" href="#L3161">3161</a><span class="code-text">   abbreviations will be migrated to the new storage format</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3162" href="#L3162">3162</a><span class="code-text">   automatically.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3163" href="#L3163">3163</a><span class="code-text">-  The ``FISH_READ_BYTE_LIMIT`` variable is now called</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3164" href="#L3164">3164</a><span class="code-text">   ``fish_byte_limit`` (:issue:`4414`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3165" href="#L3165">3165</a><span class="code-text">-  Environment variables are no longer split into arrays based on the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3166" href="#L3166">3166</a><span class="code-text">   record separator character on startup. Instead, variables are not</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3167" href="#L3167">3167</a><span class="code-text">   split, unless their name ends in PATH, in which case they are split</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3168" href="#L3168">3168</a><span class="code-text">   on colons (:issue:`436`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3169" href="#L3169">3169</a><span class="code-text">-  The ``history`` builtin’s ``--with-time`` option has been removed;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3170" href="#L3170">3170</a><span class="code-text">   this has been deprecated in favor of ``--show-time`` since 2.7.0</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3171" href="#L3171">3171</a><span class="code-text">   (:issue:`4403`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3172" href="#L3172">3172</a><span class="code-text">-  The internal variables ``__fish_datadir`` and ``__fish_sysconfdir``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3173" href="#L3173">3173</a><span class="code-text">   are now known as ``__fish_data_dir`` and ``__fish_sysconf_dir``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3174" href="#L3174">3174</a><span class="code-text">   respectively.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3175" href="#L3175">3175</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3176" href="#L3176">3176</a><span class="code-text">Deprecations</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3177" href="#L3177">3177</a><span class="code-text">------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3178" href="#L3178">3178</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3179" href="#L3179">3179</a><span class="code-text">With the release of fish 3, a number of features have been marked for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3180" href="#L3180">3180</a><span class="code-text">removal in the future. All users are encouraged to explore alternatives.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3181" href="#L3181">3181</a><span class="code-text">A small number of these features are currently behind feature flags,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3182" href="#L3182">3182</a><span class="code-text">which are turned on at present but may be turned off by default in the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3183" href="#L3183">3183</a><span class="code-text">future.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3184" href="#L3184">3184</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3185" href="#L3185">3185</a><span class="code-text">A new feature flags mechanism is added for staging deprecations and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3186" href="#L3186">3186</a><span class="code-text">breaking changes. Feature flags may be specified at launch with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3187" href="#L3187">3187</a><span class="code-text">``fish --features ...`` or by setting the universal ``fish_features``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3188" href="#L3188">3188</a><span class="code-text">variable. (:issue:`4940`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3189" href="#L3189">3189</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3190" href="#L3190">3190</a><span class="code-text">-  The use of the ``IFS`` variable for ``read`` is deprecated; ``IFS``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3191" href="#L3191">3191</a><span class="code-text">   will be ignored in the future (:issue:`4156`). Use the ``read --delimiter``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3192" href="#L3192">3192</a><span class="code-text">   option instead.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3193" href="#L3193">3193</a><span class="code-text">-  The ``function --on-process-exit`` switch will be removed in future</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3194" href="#L3194">3194</a><span class="code-text">   (:issue:`4700`). Use the ``fish_exit`` event instead:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3195" href="#L3195">3195</a><span class="code-text">   ``function --on-event fish_exit``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3196" href="#L3196">3196</a><span class="code-text">-  ``$_`` is deprecated and will removed in the future (:issue:`813`). Use</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3197" href="#L3197">3197</a><span class="code-text">   ``status current-command`` in a command substitution instead.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3198" href="#L3198">3198</a><span class="code-text">-  ``^`` as a redirection deprecated and will be removed in the future.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3199" href="#L3199">3199</a><span class="code-text">   (:issue:`4394`). Use ``2&gt;`` to redirect stderr. This is controlled by the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3200" href="#L3200">3200</a><span class="code-text">   ``stderr-nocaret`` feature flag.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3201" href="#L3201">3201</a><span class="code-text">-  ``?`` as a glob (wildcard) is deprecated and will be removed in the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3202" href="#L3202">3202</a><span class="code-text">   future (:issue:`4520`). This is controlled by the ``qmark-noglob`` feature</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3203" href="#L3203">3203</a><span class="code-text">   flag.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3204" href="#L3204">3204</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3205" href="#L3205">3205</a><span class="code-text">Notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3206" href="#L3206">3206</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3207" href="#L3207">3207</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3208" href="#L3208">3208</a><span class="code-text">.. _syntax-changes-and-new-commands-2:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3209" href="#L3209">3209</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3210" href="#L3210">3210</a><span class="code-text">Syntax changes and new commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3211" href="#L3211">3211</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3212" href="#L3212">3212</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3213" href="#L3213">3213</a><span class="code-text">-  fish now supports ``&amp;&amp;`` (like ``and``), ``||`` (like ``or``), and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3214" href="#L3214">3214</a><span class="code-text">   ``!`` (like ``not``), for better migration from POSIX-compliant</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3215" href="#L3215">3215</a><span class="code-text">   shells (:issue:`4620`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3216" href="#L3216">3216</a><span class="code-text">-  Variables may be used as commands (:issue:`154`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3217" href="#L3217">3217</a><span class="code-text">-  fish may be started in private mode via ``fish --private``. Private</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3218" href="#L3218">3218</a><span class="code-text">   mode fish sessions do not have access to the history file and any</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3219" href="#L3219">3219</a><span class="code-text">   commands evaluated in private mode are not persisted for future</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3220" href="#L3220">3220</a><span class="code-text">   sessions. A session variable ``$fish_private_mode`` can be queried to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3221" href="#L3221">3221</a><span class="code-text">   detect private mode and adjust the behavior of scripts accordingly to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3222" href="#L3222">3222</a><span class="code-text">   respect the user’s wish for privacy.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3223" href="#L3223">3223</a><span class="code-text">-  A new ``wait`` command for waiting on backgrounded processes (:issue:`4498`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3224" href="#L3224">3224</a><span class="code-text">-  ``math`` is now a builtin rather than a wrapper around ``bc``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3225" href="#L3225">3225</a><span class="code-text">   (:issue:`3157`). Floating point computations is now used by default, and can</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3226" href="#L3226">3226</a><span class="code-text">   be controlled with the new ``--scale`` option (:issue:`4478`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3227" href="#L3227">3227</a><span class="code-text">-  Setting ``$PATH`` no longer warns on non-existent directories,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3228" href="#L3228">3228</a><span class="code-text">   allowing for a single $PATH to be shared across machines (eg via</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3229" href="#L3229">3229</a><span class="code-text">   dotfiles) (:issue:`2969`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3230" href="#L3230">3230</a><span class="code-text">-  ``while`` sets ``$status`` to a non-zero value if the loop is not</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3231" href="#L3231">3231</a><span class="code-text">   executed (:issue:`4982`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3232" href="#L3232">3232</a><span class="code-text">-  Command substitution output is now limited to 10 MB by default,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3233" href="#L3233">3233</a><span class="code-text">   controlled by the ``fish_read_limit`` variable (:issue:`3822`). Notably, this</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3234" href="#L3234">3234</a><span class="code-text">   is larger than most operating systems’ argument size limit, so trying</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3235" href="#L3235">3235</a><span class="code-text">   to pass argument lists this size to external commands has never</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3236" href="#L3236">3236</a><span class="code-text">   worked.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3237" href="#L3237">3237</a><span class="code-text">-  The machine hostname, where available, is now exposed as the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3238" href="#L3238">3238</a><span class="code-text">   ``$hostname`` reserved variable. This removes the dependency on the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3239" href="#L3239">3239</a><span class="code-text">   ``hostname`` executable (:issue:`4422`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3240" href="#L3240">3240</a><span class="code-text">-  Bare ``bind`` invocations in config.fish now work. The</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3241" href="#L3241">3241</a><span class="code-text">   ``fish_user_key_bindings`` function is no longer necessary, but will</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3242" href="#L3242">3242</a><span class="code-text">   still be executed if it exists (:issue:`5191`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3243" href="#L3243">3243</a><span class="code-text">-  ``$fish_pid`` and ``$last_pid`` are available as replacements for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3244" href="#L3244">3244</a><span class="code-text">   ``%self`` and ``%last``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3245" href="#L3245">3245</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3246" href="#L3246">3246</a><span class="code-text">New features in commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3247" href="#L3247">3247</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3248" href="#L3248">3248</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3249" href="#L3249">3249</a><span class="code-text">-  ``alias`` has a new ``--save`` option to save the generated function</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3250" href="#L3250">3250</a><span class="code-text">   immediately (:issue:`4878`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3251" href="#L3251">3251</a><span class="code-text">-  ``bind`` has a new ``--silent`` option to ignore bind requests for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3252" href="#L3252">3252</a><span class="code-text">   named keys not available under the current terminal (:issue:`4188`, :issue:`4431`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3253" href="#L3253">3253</a><span class="code-text">-  ``complete`` has a new ``--keep-order`` option to show the provided</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3254" href="#L3254">3254</a><span class="code-text">   or dynamically-generated argument list in the same order as</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3255" href="#L3255">3255</a><span class="code-text">   specified, rather than alphabetically (:issue:`361`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3256" href="#L3256">3256</a><span class="code-text">-  ``exec`` prompts for confirmation if background jobs are running.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3257" href="#L3257">3257</a><span class="code-text">-  ``funced`` has a new ``--save`` option to automatically save the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3258" href="#L3258">3258</a><span class="code-text">   edited function after successfully editing (:issue:`4668`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3259" href="#L3259">3259</a><span class="code-text">-  ``functions`` has a new ``--handlers`` option to show functions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3260" href="#L3260">3260</a><span class="code-text">   registered as event handlers (:issue:`4694`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3261" href="#L3261">3261</a><span class="code-text">-  ``history search`` supports globs for wildcard searching (:issue:`3136`) and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3262" href="#L3262">3262</a><span class="code-text">   has a new ``--reverse`` option to show entries from oldest to newest</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3263" href="#L3263">3263</a><span class="code-text">   (:issue:`4375`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3264" href="#L3264">3264</a><span class="code-text">-  ``jobs`` has a new ``--quiet`` option to silence the output.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3265" href="#L3265">3265</a><span class="code-text">-  ``read`` has a new ``--delimiter`` option for splitting input into</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3266" href="#L3266">3266</a><span class="code-text">   arrays (:issue:`4256`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3267" href="#L3267">3267</a><span class="code-text">-  ``read`` writes directly to stdout if called without arguments</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3268" href="#L3268">3268</a><span class="code-text">   (:issue:`4407`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3269" href="#L3269">3269</a><span class="code-text">-  ``read`` can now read individual lines into separate variables</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3270" href="#L3270">3270</a><span class="code-text">   without consuming the input in its entirety via the new ``/--line``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3271" href="#L3271">3271</a><span class="code-text">   option.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3272" href="#L3272">3272</a><span class="code-text">-  ``set`` has new ``--append`` and ``--prepend`` options (:issue:`1326`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3273" href="#L3273">3273</a><span class="code-text">-  ``string match`` with an empty pattern and ``--entire`` in glob mode</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3274" href="#L3274">3274</a><span class="code-text">   now matches everything instead of nothing (:issue:`4971`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3275" href="#L3275">3275</a><span class="code-text">-  ``string split`` supports a new ``--no-empty`` option to exclude</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3276" href="#L3276">3276</a><span class="code-text">   empty strings from the result (:issue:`4779`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3277" href="#L3277">3277</a><span class="code-text">-  ``string`` has new subcommands ``split0`` and ``join0`` for working</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3278" href="#L3278">3278</a><span class="code-text">   with NUL-delimited output.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3279" href="#L3279">3279</a><span class="code-text">-  ``string`` no longer stops processing text after NUL characters</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3280" href="#L3280">3280</a><span class="code-text">   (:issue:`4605`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3281" href="#L3281">3281</a><span class="code-text">-  ``string escape`` has a new ``--style regex`` option for escaping</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3282" href="#L3282">3282</a><span class="code-text">   strings to be matched literally in ``string`` regex operations.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3283" href="#L3283">3283</a><span class="code-text">-  ``test`` now supports floating point values in numeric comparisons.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3284" href="#L3284">3284</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3285" href="#L3285">3285</a><span class="code-text">.. _interactive-improvements-2:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3286" href="#L3286">3286</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3287" href="#L3287">3287</a><span class="code-text">Interactive improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3288" href="#L3288">3288</a><span class="code-text">------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3289" href="#L3289">3289</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3290" href="#L3290">3290</a><span class="code-text">-  A pipe at the end of a line now allows the job to continue on the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3291" href="#L3291">3291</a><span class="code-text">   next line (:issue:`1285`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3292" href="#L3292">3292</a><span class="code-text">-  Italics and dim support out of the box on macOS for Terminal.app and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3293" href="#L3293">3293</a><span class="code-text">   iTerm (:issue:`4436`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3294" href="#L3294">3294</a><span class="code-text">-  ``cd`` tab completions no longer descend into the deepest unambiguous</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3295" href="#L3295">3295</a><span class="code-text">   path (:issue:`4649`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3296" href="#L3296">3296</a><span class="code-text">-  Pager navigation has been improved. Most notably, moving down now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3297" href="#L3297">3297</a><span class="code-text">   wraps around, moving up from the commandline now jumps to the last</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3298" href="#L3298">3298</a><span class="code-text">   element and moving right and left now reverse each other even when</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3299" href="#L3299">3299</a><span class="code-text">   wrapping around (:issue:`4680`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3300" href="#L3300">3300</a><span class="code-text">-  Typing normal characters while the completion pager is active no</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3301" href="#L3301">3301</a><span class="code-text">   longer shows the search field. Instead it enters them into the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3302" href="#L3302">3302</a><span class="code-text">   command line, and ends paging (:issue:`2249`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3303" href="#L3303">3303</a><span class="code-text">-  A new input binding ``pager-toggle-search`` toggles the search field</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3304" href="#L3304">3304</a><span class="code-text">   in the completions pager on and off. By default, this is bound to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3305" href="#L3305">3305</a><span class="code-text">   Ctrl-S.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3306" href="#L3306">3306</a><span class="code-text">-  Searching in the pager now does a full fuzzy search (:issue:`5213`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3307" href="#L3307">3307</a><span class="code-text">-  The pager will now show the full command instead of just its last</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3308" href="#L3308">3308</a><span class="code-text">   line if the number of completions is large (:issue:`4702`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3309" href="#L3309">3309</a><span class="code-text">-  Abbreviations can be tab-completed (:issue:`3233`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3310" href="#L3310">3310</a><span class="code-text">-  Tildes in file names are now properly escaped in completions (:issue:`2274`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3311" href="#L3311">3311</a><span class="code-text">-  Wrapping completions (from ``complete --wraps`` or</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3312" href="#L3312">3312</a><span class="code-text">   ``function --wraps``) can now inject arguments. For example,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3313" href="#L3313">3313</a><span class="code-text">   ``complete gco --wraps 'git checkout'`` now works properly (:issue:`1976`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3314" href="#L3314">3314</a><span class="code-text">   The ``alias`` function has been updated to respect this behavior.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3315" href="#L3315">3315</a><span class="code-text">-  Path completions now support expansions, meaning expressions like</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3316" href="#L3316">3316</a><span class="code-text">   ``python ~/&lt;TAB&gt;`` now provides file suggestions just like any other</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3317" href="#L3317">3317</a><span class="code-text">   relative or absolute path. (This includes support for other</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3318" href="#L3318">3318</a><span class="code-text">   expansions, too.)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3319" href="#L3319">3319</a><span class="code-text">-  Autosuggestions try to avoid arguments that are already present in</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3320" href="#L3320">3320</a><span class="code-text">   the command line.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3321" href="#L3321">3321</a><span class="code-text">-  Notifications about crashed processes are now always shown, even in</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3322" href="#L3322">3322</a><span class="code-text">   command substitutions (:issue:`4962`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3323" href="#L3323">3323</a><span class="code-text">-  The screen is no longer reset after a BEL, fixing graphical glitches</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3324" href="#L3324">3324</a><span class="code-text">   (:issue:`3693`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3325" href="#L3325">3325</a><span class="code-text">-  vi-mode now supports ‘;’ and ‘,’ motions. This introduces new</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3326" href="#L3326">3326</a><span class="code-text">   {forward,backward}-jump-till and repeat-jump{,-reverse} bind</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3327" href="#L3327">3327</a><span class="code-text">   functions (:issue:`5140`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3328" href="#L3328">3328</a><span class="code-text">-  The ``*y`` vi-mode binding now works (:issue:`5100`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3329" href="#L3329">3329</a><span class="code-text">-  True color is now enabled in neovim by default (:issue:`2792`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3330" href="#L3330">3330</a><span class="code-text">-  Terminal size variables (``$COLUMNS``/``$LINES``) are now updated</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3331" href="#L3331">3331</a><span class="code-text">   before ``fish_prompt`` is called, allowing the prompt to react</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3332" href="#L3332">3332</a><span class="code-text">   (:issue:`904`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3333" href="#L3333">3333</a><span class="code-text">-  Multi-line prompts no longer repeat when the terminal is resized</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3334" href="#L3334">3334</a><span class="code-text">   (:issue:`2320`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3335" href="#L3335">3335</a><span class="code-text">-  ``xclip`` support has been added to the clipboard integration</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3336" href="#L3336">3336</a><span class="code-text">   (:issue:`5020`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3337" href="#L3337">3337</a><span class="code-text">-  The Alt-P keybinding paginates the last command if the command line</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3338" href="#L3338">3338</a><span class="code-text">   is empty.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3339" href="#L3339">3339</a><span class="code-text">-  ``$cmd_duration`` is no longer reset when no command is executed</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3340" href="#L3340">3340</a><span class="code-text">   (:issue:`5011`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3341" href="#L3341">3341</a><span class="code-text">-  Deleting a one-character word no longer erases the next word as well</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3342" href="#L3342">3342</a><span class="code-text">   (:issue:`4747`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3343" href="#L3343">3343</a><span class="code-text">-  Token history search (Alt-Up) omits duplicate entries (:issue:`4795`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3344" href="#L3344">3344</a><span class="code-text">-  The ``fish_escape_delay_ms`` timeout, allowing the use of the escape</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3345" href="#L3345">3345</a><span class="code-text">   key both on its own and as part of a control sequence, was applied to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3346" href="#L3346">3346</a><span class="code-text">   all control characters; this has been reduced to just the escape key.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3347" href="#L3347">3347</a><span class="code-text">-  Completing a function shows the description properly (:issue:`5206`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3348" href="#L3348">3348</a><span class="code-text">-  ``commandline`` can now be used to set the commandline for the next command, restoring a behavior in 3.4.1 (:issue:`8807`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3349" href="#L3349">3349</a><span class="code-text">-  Added completions for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3350" href="#L3350">3350</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3351" href="#L3351">3351</a><span class="code-text">   -  ``ansible``, including ``ansible-galaxy``, ``ansible-playbook``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3352" href="#L3352">3352</a><span class="code-text">      and ``ansible-vault`` (:issue:`4697`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3353" href="#L3353">3353</a><span class="code-text">   -  ``bb-power`` (:issue:`4800`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3354" href="#L3354">3354</a><span class="code-text">   -  ``bd`` (:issue:`4472`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3355" href="#L3355">3355</a><span class="code-text">   -  ``bower``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3356" href="#L3356">3356</a><span class="code-text">   -  ``clang`` and ``clang++`` (:issue:`4174`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3357" href="#L3357">3357</a><span class="code-text">   -  ``conda`` (:issue:`4837`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3358" href="#L3358">3358</a><span class="code-text">   -  ``configure`` (for autoconf-generated files only)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3359" href="#L3359">3359</a><span class="code-text">   -  ``curl``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3360" href="#L3360">3360</a><span class="code-text">   -  ``doas`` (:issue:`5196`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3361" href="#L3361">3361</a><span class="code-text">   -  ``ebuild`` (:issue:`4911`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3362" href="#L3362">3362</a><span class="code-text">   -  ``emaint`` (:issue:`4758`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3363" href="#L3363">3363</a><span class="code-text">   -  ``eopkg`` (:issue:`4600`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3364" href="#L3364">3364</a><span class="code-text">   -  ``exercism`` (:issue:`4495`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3365" href="#L3365">3365</a><span class="code-text">   -  ``hjson``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3366" href="#L3366">3366</a><span class="code-text">   -  ``hugo`` (:issue:`4529`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3367" href="#L3367">3367</a><span class="code-text">   -  ``j`` (from autojump :issue:`4344`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3368" href="#L3368">3368</a><span class="code-text">   -  ``jbake`` (:issue:`4814`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3369" href="#L3369">3369</a><span class="code-text">   -  ``jhipster`` (:issue:`4472`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3370" href="#L3370">3370</a><span class="code-text">   -  ``kitty``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3371" href="#L3371">3371</a><span class="code-text">   -  ``kldload``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3372" href="#L3372">3372</a><span class="code-text">   -  ``kldunload``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3373" href="#L3373">3373</a><span class="code-text">   -  ``makensis`` (:issue:`5242`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3374" href="#L3374">3374</a><span class="code-text">   -  ``meson``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3375" href="#L3375">3375</a><span class="code-text">   -  ``mkdocs`` (:issue:`4906`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3376" href="#L3376">3376</a><span class="code-text">   -  ``ngrok`` (:issue:`4642`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3377" href="#L3377">3377</a><span class="code-text">   -  OpenBSD’s ``pkg_add``, ``pkg_delete``, ``pkg_info``, ``pfctl``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3378" href="#L3378">3378</a><span class="code-text">      ``rcctl``, ``signify``, and ``vmctl`` (:issue:`4584`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3379" href="#L3379">3379</a><span class="code-text">   -  ``openocd``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3380" href="#L3380">3380</a><span class="code-text">   -  ``optipng``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3381" href="#L3381">3381</a><span class="code-text">   -  ``opkg`` (:issue:`5168`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3382" href="#L3382">3382</a><span class="code-text">   -  ``pandoc`` (:issue:`2937`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3383" href="#L3383">3383</a><span class="code-text">   -  ``port`` (:issue:`4737`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3384" href="#L3384">3384</a><span class="code-text">   -  ``powerpill`` (:issue:`4800`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3385" href="#L3385">3385</a><span class="code-text">   -  ``pstack`` (:issue:`5135`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3386" href="#L3386">3386</a><span class="code-text">   -  ``serve`` (:issue:`5026`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3387" href="#L3387">3387</a><span class="code-text">   -  ``ttx``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3388" href="#L3388">3388</a><span class="code-text">   -  ``unzip``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3389" href="#L3389">3389</a><span class="code-text">   -  ``virsh`` (:issue:`5113`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3390" href="#L3390">3390</a><span class="code-text">   -  ``xclip`` (:issue:`5126`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3391" href="#L3391">3391</a><span class="code-text">   -  ``xsv``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3392" href="#L3392">3392</a><span class="code-text">   -  ``zfs`` and ``zpool`` (:issue:`4608`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3393" href="#L3393">3393</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3394" href="#L3394">3394</a><span class="code-text">-  Lots of improvements to completions (especially ``darcs`` (:issue:`5112`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3395" href="#L3395">3395</a><span class="code-text">   ``git``, ``hg`` and ``sudo``).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3396" href="#L3396">3396</a><span class="code-text">-  Completions for ``yarn`` and ``npm`` now require the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3397" href="#L3397">3397</a><span class="code-text">   ``all-the-package-names`` NPM package for full functionality.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3398" href="#L3398">3398</a><span class="code-text">-  Completions for ``bower`` and ``yarn`` now require the ``jq`` utility</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3399" href="#L3399">3399</a><span class="code-text">   for full functionality.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3400" href="#L3400">3400</a><span class="code-text">-  Improved French translations.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3401" href="#L3401">3401</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3402" href="#L3402">3402</a><span class="code-text">Other fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3403" href="#L3403">3403</a><span class="code-text">----------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3404" href="#L3404">3404</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3405" href="#L3405">3405</a><span class="code-text">-  Significant performance improvements to ``abbr`` (:issue:`4048`), setting</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3406" href="#L3406">3406</a><span class="code-text">   variables (:issue:`4200`, :issue:`4341`), executing functions, globs (:issue:`4579`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3407" href="#L3407">3407</a><span class="code-text">   ``string`` reading from standard input (:issue:`4610`), and slicing history</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3408" href="#L3408">3408</a><span class="code-text">   (in particular, ``$history[1]`` for the last executed command).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3409" href="#L3409">3409</a><span class="code-text">-  fish’s internal wcwidth function has been updated to deal with newer</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3410" href="#L3410">3410</a><span class="code-text">   Unicode, and the width of some characters can be configured via the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3411" href="#L3411">3411</a><span class="code-text">   ``fish_ambiguous_width`` (:issue:`5149`) and ``fish_emoji_width`` (:issue:`2652`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3412" href="#L3412">3412</a><span class="code-text">   variables. Alternatively, a new build-time option INTERNAL_WCWIDTH</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3413" href="#L3413">3413</a><span class="code-text">   can be used to use the system’s wcwidth instead (:issue:`4816`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3414" href="#L3414">3414</a><span class="code-text">-  ``functions`` correctly supports ``-d`` as the short form of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3415" href="#L3415">3415</a><span class="code-text">   ``--description``. (:issue:`5105`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3416" href="#L3416">3416</a><span class="code-text">-  ``/etc/paths`` is now parsed like macOS’ bash ``path_helper``, fixing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3417" href="#L3417">3417</a><span class="code-text">   $PATH order (:issue:`4336`, :issue:`4852`) on macOS.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3418" href="#L3418">3418</a><span class="code-text">-  Using a read-only variable in a ``for`` loop produces an error,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3419" href="#L3419">3419</a><span class="code-text">   rather than silently producing incorrect results (:issue:`4342`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3420" href="#L3420">3420</a><span class="code-text">-  The universal variables filename no longer contains the hostname or</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3421" href="#L3421">3421</a><span class="code-text">   MAC address. It is now at the fixed location</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3422" href="#L3422">3422</a><span class="code-text">   ``.config/fish/fish_variables`` (:issue:`1912`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3423" href="#L3423">3423</a><span class="code-text">-  Exported variables in the global or universal scope no longer have</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3424" href="#L3424">3424</a><span class="code-text">   their exported status affected by local variables (:issue:`2611`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3425" href="#L3425">3425</a><span class="code-text">-  Major rework of terminal and job handling to eliminate bugs (:issue:`3805`,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3426" href="#L3426">3426</a><span class="code-text">   :issue:`3952`, :issue:`4178`, :issue:`4235`, :issue:`4238`, :issue:`4540`, :issue:`4929`, :issue:`5210`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3427" href="#L3427">3427</a><span class="code-text">-  Improvements to the manual page completion generator (:issue:`2937`, :issue:`4313`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3428" href="#L3428">3428</a><span class="code-text">-  ``suspend --force`` now works correctly (:issue:`4672`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3429" href="#L3429">3429</a><span class="code-text">-  Pressing Ctrl-C while running a script now reliably terminates fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3430" href="#L3430">3430</a><span class="code-text">   (:issue:`5253`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3431" href="#L3431">3431</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3432" href="#L3432">3432</a><span class="code-text">.. _for-distributors-and-developers-2:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3433" href="#L3433">3433</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3434" href="#L3434">3434</a><span class="code-text">For distributors and developers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3435" href="#L3435">3435</a><span class="code-text">-------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3436" href="#L3436">3436</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3437" href="#L3437">3437</a><span class="code-text">-  fish ships with a new build system based on CMake. CMake 3.2 is the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3438" href="#L3438">3438</a><span class="code-text">   minimum required version. Although the autotools-based Makefile and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3439" href="#L3439">3439</a><span class="code-text">   the Xcode project are still shipped with this release, they will be</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3440" href="#L3440">3440</a><span class="code-text">   removed in the near future. All distributors and developers are</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3441" href="#L3441">3441</a><span class="code-text">   encouraged to migrate to the CMake build.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3442" href="#L3442">3442</a><span class="code-text">-  Build scripts for most platforms no longer require bash, using the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3443" href="#L3443">3443</a><span class="code-text">   standard sh instead.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3444" href="#L3444">3444</a><span class="code-text">-  The ``hostname`` command is no longer required for fish to operate.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3445" href="#L3445">3445</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3446" href="#L3446">3446</a><span class="code-text">-</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3447" href="#L3447">3447</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3448" href="#L3448">3448</a><span class="code-text">fish 2.7.1 (released December 23, 2017)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3449" href="#L3449">3449</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3450" href="#L3450">3450</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3451" href="#L3451">3451</a><span class="code-text">This release of fish fixes an issue where iTerm 2 on macOS would display</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3452" href="#L3452">3452</a><span class="code-text">a warning about paste bracketing being left on when starting a new fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3453" href="#L3453">3453</a><span class="code-text">session (:issue:`4521`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3454" href="#L3454">3454</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3455" href="#L3455">3455</a><span class="code-text">If you are upgrading from version 2.6.0 or before, please also review</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3456" href="#L3456">3456</a><span class="code-text">the release notes for 2.7.0 and 2.7b1 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3457" href="#L3457">3457</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3458" href="#L3458">3458</a><span class="code-text">-</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3459" href="#L3459">3459</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3460" href="#L3460">3460</a><span class="code-text">fish 2.7.0 (released November 23, 2017)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3461" href="#L3461">3461</a><span class="code-text">=======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3462" href="#L3462">3462</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3463" href="#L3463">3463</a><span class="code-text">There are no major changes between 2.7b1 and 2.7.0. If you are upgrading</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3464" href="#L3464">3464</a><span class="code-text">from version 2.6.0 or before, please also review the release notes for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3465" href="#L3465">3465</a><span class="code-text">2.7b1 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3466" href="#L3466">3466</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3467" href="#L3467">3467</a><span class="code-text">Xcode builds and macOS packages could not be produced with 2.7b1, but</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3468" href="#L3468">3468</a><span class="code-text">this is fixed in 2.7.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3469" href="#L3469">3469</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3470" href="#L3470">3470</a><span class="code-text">-</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3471" href="#L3471">3471</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3472" href="#L3472">3472</a><span class="code-text">fish 2.7b1 (released October 31, 2017)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3473" href="#L3473">3473</a><span class="code-text">======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3474" href="#L3474">3474</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3475" href="#L3475">3475</a><span class="code-text">Notable improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3476" href="#L3476">3476</a><span class="code-text">--------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3477" href="#L3477">3477</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3478" href="#L3478">3478</a><span class="code-text">-  A new ``cdh`` (change directory using recent history) command</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3479" href="#L3479">3479</a><span class="code-text">   provides a more friendly alternative to prevd/nextd and pushd/popd</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3480" href="#L3480">3480</a><span class="code-text">   (:issue:`2847`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3481" href="#L3481">3481</a><span class="code-text">-  A new ``argparse`` command is available to allow fish script to parse</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3482" href="#L3482">3482</a><span class="code-text">   arguments with the same behavior as builtin commands. This also</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3483" href="#L3483">3483</a><span class="code-text">   includes the ``fish_opt`` helper command. (:issue:`4190`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3484" href="#L3484">3484</a><span class="code-text">-  Invalid array indexes are now silently ignored (:issue:`826`, :issue:`4127`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3485" href="#L3485">3485</a><span class="code-text">-  Improvements to the debugging facility, including a prompt specific</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3486" href="#L3486">3486</a><span class="code-text">   to the debugger (``fish_breakpoint_prompt``) and a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3487" href="#L3487">3487</a><span class="code-text">   ``status is-breakpoint`` subcommand (:issue:`1310`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3488" href="#L3488">3488</a><span class="code-text">-  ``string`` supports new ``lower`` and ``upper`` subcommands, for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3489" href="#L3489">3489</a><span class="code-text">   altering the case of strings (:issue:`4080`). The case changing is not</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3490" href="#L3490">3490</a><span class="code-text">   locale-aware yet.- ``string escape`` has a new ``--style=xxx`` flag</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3491" href="#L3491">3491</a><span class="code-text">   where ``xxx`` can be ``script``, ``var``, or ``url`` (:issue:`4150`), and can</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3492" href="#L3492">3492</a><span class="code-text">   be reversed with ``string unescape`` (:issue:`3543`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3493" href="#L3493">3493</a><span class="code-text">-  History can now be split into sessions with the ``fish_history``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3494" href="#L3494">3494</a><span class="code-text">   variable, or not saved to disk at all (:issue:`102`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3495" href="#L3495">3495</a><span class="code-text">-  Read history is now controlled by the ``fish_history`` variable</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3496" href="#L3496">3496</a><span class="code-text">   rather than the ``--mode-name`` flag (:issue:`1504`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3497" href="#L3497">3497</a><span class="code-text">-  ``command`` now supports an ``--all`` flag to report all directories</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3498" href="#L3498">3498</a><span class="code-text">   with the command. ``which`` is no longer a runtime dependency</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3499" href="#L3499">3499</a><span class="code-text">   (:issue:`2778`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3500" href="#L3500">3500</a><span class="code-text">-  fish can run commands before starting an interactive session using</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3501" href="#L3501">3501</a><span class="code-text">   the new ``--init-command``/``-C`` options (:issue:`4164`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3502" href="#L3502">3502</a><span class="code-text">-  ``set`` has a new ``--show`` option to show lots of information about</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3503" href="#L3503">3503</a><span class="code-text">   variables (:issue:`4265`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3504" href="#L3504">3504</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3505" href="#L3505">3505</a><span class="code-text">Other significant changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3506" href="#L3506">3506</a><span class="code-text">-------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3507" href="#L3507">3507</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3508" href="#L3508">3508</a><span class="code-text">-  The ``COLUMNS`` and ``LINES`` environment variables are now correctly</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3509" href="#L3509">3509</a><span class="code-text">   set the first time ``fish_prompt`` is run (:issue:`4141`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3510" href="#L3510">3510</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3511" href="#L3511">3511</a><span class="code-text">-  ``complete``\ ’s ``--no-files`` option works as intended (:issue:`112`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3512" href="#L3512">3512</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3513" href="#L3513">3513</a><span class="code-text">-  ``echo -h`` now correctly echoes ``-h`` in line with other shells</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3514" href="#L3514">3514</a><span class="code-text">   (:issue:`4120`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3515" href="#L3515">3515</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3516" href="#L3516">3516</a><span class="code-text">-  The ``export`` compatibility function now returns zero on success,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3517" href="#L3517">3517</a><span class="code-text">   rather than always returning 1 (:issue:`4435`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3518" href="#L3518">3518</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3519" href="#L3519">3519</a><span class="code-text">-  Stop converting empty elements in MANPATH to “.” (:issue:`4158`). The</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3520" href="#L3520">3520</a><span class="code-text">   behavior being changed was introduced in fish 2.6.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3521" href="#L3521">3521</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3522" href="#L3522">3522</a><span class="code-text">-  ``count -h`` and ``count --help`` now return 1 rather than produce</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3523" href="#L3523">3523</a><span class="code-text">   command help output (:issue:`4189`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3524" href="#L3524">3524</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3525" href="#L3525">3525</a><span class="code-text">-  An attempt to ``read`` which stops because too much data is available</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3526" href="#L3526">3526</a><span class="code-text">   still defines the variables given as parameters (:issue:`4180`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3527" href="#L3527">3527</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3528" href="#L3528">3528</a><span class="code-text">-  A regression in fish 2.4.0 which prevented ``pushd +1`` from working</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3529" href="#L3529">3529</a><span class="code-text">   has been fixed (:issue:`4091`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3530" href="#L3530">3530</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3531" href="#L3531">3531</a><span class="code-text">-  A regression in fish 2.6.0 where multiple ``read`` commands in</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3532" href="#L3532">3532</a><span class="code-text">   non-interactive scripts were broken has been fixed (:issue:`4206`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3533" href="#L3533">3533</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3534" href="#L3534">3534</a><span class="code-text">-  A regression in fish 2.6.0 involving universal variables with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3535" href="#L3535">3535</a><span class="code-text">   side-effects at startup such as ``set -U fish_escape_delay_ms 10``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3536" href="#L3536">3536</a><span class="code-text">   has been fixed (:issue:`4196`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3537" href="#L3537">3537</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3538" href="#L3538">3538</a><span class="code-text">-  Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3539" href="#L3539">3539</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3540" href="#L3540">3540</a><span class="code-text">   -  ``as`` (:issue:`4130`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3541" href="#L3541">3541</a><span class="code-text">   -  ``cdh`` (:issue:`2847`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3542" href="#L3542">3542</a><span class="code-text">   -  ``dhcpd`` (:issue:`4115`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3543" href="#L3543">3543</a><span class="code-text">   -  ``ezjail-admin`` (:issue:`4324`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3544" href="#L3544">3544</a><span class="code-text">   -  Fabric’s ``fab`` (:issue:`4153`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3545" href="#L3545">3545</a><span class="code-text">   -  ``grub-file`` (:issue:`4119`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3546" href="#L3546">3546</a><span class="code-text">   -  ``grub-install`` (:issue:`4119`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3547" href="#L3547">3547</a><span class="code-text">   -  ``jest`` (:issue:`4142`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3548" href="#L3548">3548</a><span class="code-text">   -  ``kdeconnect-cli``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3549" href="#L3549">3549</a><span class="code-text">   -  ``magneto`` (:issue:`4043`, :issue:`4108`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3550" href="#L3550">3550</a><span class="code-text">   -  ``mdadm`` (:issue:`4198`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3551" href="#L3551">3551</a><span class="code-text">   -  ``passwd`` (:issue:`4209`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3552" href="#L3552">3552</a><span class="code-text">   -  ``pip`` and ``pipenv`` (:issue:`4448`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3553" href="#L3553">3553</a><span class="code-text">   -  ``s3cmd`` (:issue:`4332`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3554" href="#L3554">3554</a><span class="code-text">   -  ``sbt`` (:issue:`4347`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3555" href="#L3555">3555</a><span class="code-text">   -  ``snap`` (:issue:`4215`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3556" href="#L3556">3556</a><span class="code-text">   -  Sublime Text 3’s ``subl`` (:issue:`4277`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3557" href="#L3557">3557</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3558" href="#L3558">3558</a><span class="code-text">-  Lots of improvements to completions.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3559" href="#L3559">3559</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3560" href="#L3560">3560</a><span class="code-text">-  Updated Chinese and French translations.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3561" href="#L3561">3561</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3562" href="#L3562">3562</a><span class="code-text">-  Improved completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3563" href="#L3563">3563</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3564" href="#L3564">3564</a><span class="code-text">   -  ``apt``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3565" href="#L3565">3565</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3566" href="#L3566">3566</a><span class="code-text">   -  ``cd`` (:issue:`4061`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3567" href="#L3567">3567</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3568" href="#L3568">3568</a><span class="code-text">   -  ``composer`` (:issue:`4295`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3569" href="#L3569">3569</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3570" href="#L3570">3570</a><span class="code-text">   -  ``eopkg``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3571" href="#L3571">3571</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3572" href="#L3572">3572</a><span class="code-text">   -  ``flatpak`` (:issue:`4456`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3573" href="#L3573">3573</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3574" href="#L3574">3574</a><span class="code-text">   -  ``git`` (:issue:`4117`, :issue:`4147`, :issue:`4329`, :issue:`4368`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3575" href="#L3575">3575</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3576" href="#L3576">3576</a><span class="code-text">   -  ``gphoto2``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3577" href="#L3577">3577</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3578" href="#L3578">3578</a><span class="code-text">   -  ``killall`` (:issue:`4052`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3579" href="#L3579">3579</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3580" href="#L3580">3580</a><span class="code-text">   -  ``ln``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3581" href="#L3581">3581</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3582" href="#L3582">3582</a><span class="code-text">   -  ``npm`` (:issue:`4241`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3583" href="#L3583">3583</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3584" href="#L3584">3584</a><span class="code-text">   -  ``ssh`` (:issue:`4377`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3585" href="#L3585">3585</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3586" href="#L3586">3586</a><span class="code-text">   -  ``tail``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3587" href="#L3587">3587</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3588" href="#L3588">3588</a><span class="code-text">   -  ``xdg-mime`` (:issue:`4333`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3589" href="#L3589">3589</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3590" href="#L3590">3590</a><span class="code-text">   -  ``zypper`` (:issue:`4325`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3591" href="#L3591">3591</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3592" href="#L3592">3592</a><span class="code-text">fish 2.6.0 (released June 3, 2017)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3593" href="#L3593">3593</a><span class="code-text">==================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3594" href="#L3594">3594</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3595" href="#L3595">3595</a><span class="code-text">Since the beta release of fish 2.6b1, fish version 2.6.0 contains a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3596" href="#L3596">3596</a><span class="code-text">number of minor fixes, new completions for ``magneto`` (:issue:`4043`), and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3597" href="#L3597">3597</a><span class="code-text">improvements to the documentation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3598" href="#L3598">3598</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3599" href="#L3599">3599</a><span class="code-text">.. _known-issues-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3600" href="#L3600">3600</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3601" href="#L3601">3601</a><span class="code-text">Known issues</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3602" href="#L3602">3602</a><span class="code-text">------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3603" href="#L3603">3603</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3604" href="#L3604">3604</a><span class="code-text">-  Apple macOS Sierra 10.12.5 introduced a problem with launching web</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3605" href="#L3605">3605</a><span class="code-text">   browsers from other programs using AppleScript. This affects the fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3606" href="#L3606">3606</a><span class="code-text">   Web configuration (``fish_config``); users on these platforms will</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3607" href="#L3607">3607</a><span class="code-text">   need to manually open the address displayed in the terminal, such as</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3608" href="#L3608">3608</a><span class="code-text">   by copying and pasting it into a browser. This problem will be fixed</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3609" href="#L3609">3609</a><span class="code-text">   with macOS 10.12.6.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3610" href="#L3610">3610</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3611" href="#L3611">3611</a><span class="code-text">If you are upgrading from version 2.5.0 or before, please also review</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3612" href="#L3612">3612</a><span class="code-text">the release notes for 2.6b1 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3613" href="#L3613">3613</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3614" href="#L3614">3614</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3615" href="#L3615">3615</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3616" href="#L3616">3616</a><span class="code-text">fish 2.6b1 (released May 14, 2017)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3617" href="#L3617">3617</a><span class="code-text">==================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3618" href="#L3618">3618</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3619" href="#L3619">3619</a><span class="code-text">.. _notable-fixes-and-improvements-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3620" href="#L3620">3620</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3621" href="#L3621">3621</a><span class="code-text">Notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3622" href="#L3622">3622</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3623" href="#L3623">3623</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3624" href="#L3624">3624</a><span class="code-text">-  Jobs running in the background can now be removed from the list of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3625" href="#L3625">3625</a><span class="code-text">   jobs with the new ``disown`` builtin, which behaves like the same</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3626" href="#L3626">3626</a><span class="code-text">   command in other shells (:issue:`2810`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3627" href="#L3627">3627</a><span class="code-text">-  Command substitutions now have access to the terminal, like in other</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3628" href="#L3628">3628</a><span class="code-text">   shells. This allows tools like ``fzf`` to work properly (:issue:`1362`,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3629" href="#L3629">3629</a><span class="code-text">   :issue:`3922`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3630" href="#L3630">3630</a><span class="code-text">-  In cases where the operating system does not report the size of the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3631" href="#L3631">3631</a><span class="code-text">   terminal, the ``COLUMNS`` and ``LINES`` environment variables are</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3632" href="#L3632">3632</a><span class="code-text">   used; if they are unset, a default of 80x24 is assumed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3633" href="#L3633">3633</a><span class="code-text">-  New French (:issue:`3772` &amp; :issue:`3788`) and improved German (:issue:`3834`) translations.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3634" href="#L3634">3634</a><span class="code-text">-  fish no longer depends on the ``which`` external command.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3635" href="#L3635">3635</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3636" href="#L3636">3636</a><span class="code-text">.. _other-significant-changes-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3637" href="#L3637">3637</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3638" href="#L3638">3638</a><span class="code-text">Other significant changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3639" href="#L3639">3639</a><span class="code-text">-------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3640" href="#L3640">3640</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3641" href="#L3641">3641</a><span class="code-text">-  Performance improvements in launching processes, including major</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3642" href="#L3642">3642</a><span class="code-text">   reductions in signal blocking. Although this has been heavily tested,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3643" href="#L3643">3643</a><span class="code-text">   it may cause problems in some circumstances; set the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3644" href="#L3644">3644</a><span class="code-text">   ``FISH_NO_SIGNAL_BLOCK`` variable to 0 in your fish configuration</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3645" href="#L3645">3645</a><span class="code-text">   file to return to the old behaviour (:issue:`2007`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3646" href="#L3646">3646</a><span class="code-text">-  Performance improvements in prompts and functions that set lots of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3647" href="#L3647">3647</a><span class="code-text">   colours (:issue:`3793`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3648" href="#L3648">3648</a><span class="code-text">-  The Delete key no longer deletes backwards (a regression in 2.5.0).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3649" href="#L3649">3649</a><span class="code-text">-  ``functions`` supports a new ``--details`` option, which identifies</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3650" href="#L3650">3650</a><span class="code-text">   where the function was loaded from (:issue:`3295`), and a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3651" href="#L3651">3651</a><span class="code-text">   ``--details --verbose`` option which includes the function</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3652" href="#L3652">3652</a><span class="code-text">   description (:issue:`597`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3653" href="#L3653">3653</a><span class="code-text">-  ``read`` will read up to 10 MiB by default, leaving the target</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3654" href="#L3654">3654</a><span class="code-text">   variable empty and exiting with status 122 if the line is too long.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3655" href="#L3655">3655</a><span class="code-text">   You can set a different limit with the ``FISH_READ_BYTE_LIMIT``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3656" href="#L3656">3656</a><span class="code-text">   variable.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3657" href="#L3657">3657</a><span class="code-text">-  ``read`` supports a new ``--silent`` option to hide the characters</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3658" href="#L3658">3658</a><span class="code-text">   typed (:issue:`838`), for when reading sensitive data from the terminal.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3659" href="#L3659">3659</a><span class="code-text">   ``read`` also now accepts simple strings for the prompt (rather than</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3660" href="#L3660">3660</a><span class="code-text">   scripts) with the new ``-P`` and ``--prompt-str`` options (:issue:`802`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3661" href="#L3661">3661</a><span class="code-text">-  ``export`` and ``setenv`` now understand colon-separated ``PATH``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3662" href="#L3662">3662</a><span class="code-text">   ``CDPATH`` and ``MANPATH`` variables.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3663" href="#L3663">3663</a><span class="code-text">-  ``setenv`` is no longer a simple alias for ``set -gx`` and will</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3664" href="#L3664">3664</a><span class="code-text">   complain, just like the csh version, if given more than one value</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3665" href="#L3665">3665</a><span class="code-text">   (:issue:`4103`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3666" href="#L3666">3666</a><span class="code-text">-  ``bind`` supports a new ``--list-modes`` option (:issue:`3872`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3667" href="#L3667">3667</a><span class="code-text">-  ``bg`` will check all of its arguments before backgrounding any jobs;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3668" href="#L3668">3668</a><span class="code-text">   any invalid arguments will cause a failure, but non-existent (eg</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3669" href="#L3669">3669</a><span class="code-text">   recently exited) jobs are ignored (:issue:`3909`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3670" href="#L3670">3670</a><span class="code-text">-  ``funced`` warns if the function being edited has not been modified</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3671" href="#L3671">3671</a><span class="code-text">   (:issue:`3961`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3672" href="#L3672">3672</a><span class="code-text">-  ``printf`` correctly outputs “long long” integers (:issue:`3352`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3673" href="#L3673">3673</a><span class="code-text">-  ``status`` supports a new ``current-function`` subcommand to print</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3674" href="#L3674">3674</a><span class="code-text">   the current function name (:issue:`1743`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3675" href="#L3675">3675</a><span class="code-text">-  ``string`` supports a new ``repeat`` subcommand (:issue:`3864`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3676" href="#L3676">3676</a><span class="code-text">   ``string match`` supports a new ``--entire`` option to emit the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3677" href="#L3677">3677</a><span class="code-text">   entire line matched by a pattern (:issue:`3957`). ``string replace`` supports</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3678" href="#L3678">3678</a><span class="code-text">   a new ``--filter`` option to only emit lines which underwent a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3679" href="#L3679">3679</a><span class="code-text">   replacement (:issue:`3348`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3680" href="#L3680">3680</a><span class="code-text">-  ``test`` supports the ``-k`` option to test for sticky bits (:issue:`733`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3681" href="#L3681">3681</a><span class="code-text">-  ``umask`` understands symbolic modes (:issue:`738`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3682" href="#L3682">3682</a><span class="code-text">-  Empty components in the ``CDPATH``, ``MANPATH`` and ``PATH``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3683" href="#L3683">3683</a><span class="code-text">   variables are now converted to “.” (:issue:`2106`, :issue:`3914`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3684" href="#L3684">3684</a><span class="code-text">-  New versions of ncurses (6.0 and up) wipe terminal scrollback buffers</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3685" href="#L3685">3685</a><span class="code-text">   with certain commands; the ``C-l`` binding tries to avoid this</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3686" href="#L3686">3686</a><span class="code-text">   (:issue:`2855`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3687" href="#L3687">3687</a><span class="code-text">-  Some systems’ ``su`` implementations do not set the ``USER``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3688" href="#L3688">3688</a><span class="code-text">   environment variable; it is now reset for root users (:issue:`3916`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3689" href="#L3689">3689</a><span class="code-text">-  Under terminals which support it, bracketed paste is enabled,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3690" href="#L3690">3690</a><span class="code-text">   escaping problematic characters for security and convenience (:issue:`3871`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3691" href="#L3691">3691</a><span class="code-text">   Inside single quotes (``'``), single quotes and backslashes in pasted</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3692" href="#L3692">3692</a><span class="code-text">   text are escaped (:issue:`967`). The ``fish_clipboard_paste`` function (bound</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3693" href="#L3693">3693</a><span class="code-text">   to ``C-v`` by default) is still the recommended pasting method where</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3694" href="#L3694">3694</a><span class="code-text">   possible as it includes this functionality and more.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3695" href="#L3695">3695</a><span class="code-text">-  Processes in pipelines are no longer signalled as soon as one command</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3696" href="#L3696">3696</a><span class="code-text">   in the pipeline has completed (:issue:`1926`). This behaviour matches other</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3697" href="#L3697">3697</a><span class="code-text">   shells mre closely.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3698" href="#L3698">3698</a><span class="code-text">-  All functions requiring Python work with whichever version of Python</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3699" href="#L3699">3699</a><span class="code-text">   is installed (:issue:`3970`). Python 3 is preferred, but Python 2.6 remains</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3700" href="#L3700">3700</a><span class="code-text">   the minimum version required.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3701" href="#L3701">3701</a><span class="code-text">-  The color of the cancellation character can be controlled by the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3702" href="#L3702">3702</a><span class="code-text">   ``fish_color_cancel`` variable (:issue:`3963`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3703" href="#L3703">3703</a><span class="code-text">-  Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3704" href="#L3704">3704</a><span class="code-text">-  ``caddy`` (:issue:`4008`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3705" href="#L3705">3705</a><span class="code-text">-  ``castnow`` (:issue:`3744`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3706" href="#L3706">3706</a><span class="code-text">-  ``climate`` (:issue:`3760`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3707" href="#L3707">3707</a><span class="code-text">-  ``flatpak``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3708" href="#L3708">3708</a><span class="code-text">-  ``gradle`` (:issue:`3859`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3709" href="#L3709">3709</a><span class="code-text">-  ``gsettings`` (:issue:`4001`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3710" href="#L3710">3710</a><span class="code-text">-  ``helm`` (:issue:`3829`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3711" href="#L3711">3711</a><span class="code-text">-  ``i3-msg`` (:issue:`3787`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3712" href="#L3712">3712</a><span class="code-text">-  ``ipset`` (:issue:`3924`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3713" href="#L3713">3713</a><span class="code-text">-  ``jq`` (:issue:`3804`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3714" href="#L3714">3714</a><span class="code-text">-  ``light`` (:issue:`3752`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3715" href="#L3715">3715</a><span class="code-text">-  ``minikube`` (:issue:`3778`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3716" href="#L3716">3716</a><span class="code-text">-  ``mocha`` (:issue:`3828`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3717" href="#L3717">3717</a><span class="code-text">-  ``mkdosfs`` (:issue:`4017`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3718" href="#L3718">3718</a><span class="code-text">-  ``pv`` (:issue:`3773`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3719" href="#L3719">3719</a><span class="code-text">-  ``setsid`` (:issue:`3791`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3720" href="#L3720">3720</a><span class="code-text">-  ``terraform`` (:issue:`3960`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3721" href="#L3721">3721</a><span class="code-text">-  ``usermod`` (:issue:`3775`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3722" href="#L3722">3722</a><span class="code-text">-  ``xinput``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3723" href="#L3723">3723</a><span class="code-text">-  ``yarn`` (:issue:`3816`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3724" href="#L3724">3724</a><span class="code-text">-  Improved completions for ``adb`` (:issue:`3853`), ``apt`` (:issue:`3771`), ``bzr``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3725" href="#L3725">3725</a><span class="code-text">   (:issue:`3769`), ``dconf``, ``git`` (including :issue:`3743`), ``grep`` (:issue:`3789`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3726" href="#L3726">3726</a><span class="code-text">   ``go`` (:issue:`3789`), ``help`` (:issue:`3789`), ``hg`` (:issue:`3975`), ``htop`` (:issue:`3789`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3727" href="#L3727">3727</a><span class="code-text">   ``killall`` (:issue:`3996`), ``lua``, ``man`` (:issue:`3762`), ``mount`` (:issue:`3764` &amp;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3728" href="#L3728">3728</a><span class="code-text">   :issue:`3841`), ``obnam`` (:issue:`3924`), ``perl`` (:issue:`3856`), ``portmaster`` (:issue:`3950`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3729" href="#L3729">3729</a><span class="code-text">   ``python`` (:issue:`3840`), ``ssh`` (:issue:`3781`), ``scp`` (:issue:`3781`), ``systemctl``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3730" href="#L3730">3730</a><span class="code-text">   (:issue:`3757`) and ``udisks`` (:issue:`3764`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3731" href="#L3731">3731</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3732" href="#L3732">3732</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3733" href="#L3733">3733</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3734" href="#L3734">3734</a><span class="code-text">fish 2.5.0 (released February 3, 2017)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3735" href="#L3735">3735</a><span class="code-text">======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3736" href="#L3736">3736</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3737" href="#L3737">3737</a><span class="code-text">There are no major changes between 2.5b1 and 2.5.0. If you are upgrading</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3738" href="#L3738">3738</a><span class="code-text">from version 2.4.0 or before, please also review the release notes for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3739" href="#L3739">3739</a><span class="code-text">2.5b1 (included below).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3740" href="#L3740">3740</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3741" href="#L3741">3741</a><span class="code-text">.. _notable-fixes-and-improvements-2:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3742" href="#L3742">3742</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3743" href="#L3743">3743</a><span class="code-text">Notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3744" href="#L3744">3744</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3745" href="#L3745">3745</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3746" href="#L3746">3746</a><span class="code-text">-  The Home, End, Insert, Delete, Page Up and Page Down keys work in</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3747" href="#L3747">3747</a><span class="code-text">   Vi-style key bindings (:issue:`3731`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3748" href="#L3748">3748</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3749" href="#L3749">3749</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3750" href="#L3750">3750</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3751" href="#L3751">3751</a><span class="code-text">fish 2.5b1 (released January 14, 2017)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3752" href="#L3752">3752</a><span class="code-text">======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3753" href="#L3753">3753</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3754" href="#L3754">3754</a><span class="code-text">Platform Changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3755" href="#L3755">3755</a><span class="code-text">----------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3756" href="#L3756">3756</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3757" href="#L3757">3757</a><span class="code-text">Starting with version 2.5, fish requires a more up-to-date version of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3758" href="#L3758">3758</a><span class="code-text">C++, specifically C++11 (from 2011). This affects some older platforms:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3759" href="#L3759">3759</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3760" href="#L3760">3760</a><span class="code-text">Linux</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3761" href="#L3761">3761</a><span class="code-text">^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3762" href="#L3762">3762</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3763" href="#L3763">3763</a><span class="code-text">For users building from source, GCC’s g++ 4.8 or later, or LLVM’s clang</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3764" href="#L3764">3764</a><span class="code-text">3.3 or later, are known to work. Older platforms may require a newer</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3765" href="#L3765">3765</a><span class="code-text">compiler installed.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3766" href="#L3766">3766</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3767" href="#L3767">3767</a><span class="code-text">Unfortunately, because of the complexity of the toolchain, binary</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3768" href="#L3768">3768</a><span class="code-text">packages are no longer published by the fish-shell developers for the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3769" href="#L3769">3769</a><span class="code-text">following platforms:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3770" href="#L3770">3770</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3771" href="#L3771">3771</a><span class="code-text">-  Red Hat Enterprise Linux and CentOS 5 &amp; 6 for 64-bit builds</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3772" href="#L3772">3772</a><span class="code-text">-  Ubuntu 12.04 (EoLTS April 2017)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3773" href="#L3773">3773</a><span class="code-text">-  Debian 7 (EoLTS May 2018)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3774" href="#L3774">3774</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3775" href="#L3775">3775</a><span class="code-text">Installing newer version of fish on these systems will require building</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3776" href="#L3776">3776</a><span class="code-text">from source.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3777" href="#L3777">3777</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3778" href="#L3778">3778</a><span class="code-text">OS X SnowLeopard</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3779" href="#L3779">3779</a><span class="code-text">^^^^^^^^^^^^^^^^</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3780" href="#L3780">3780</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3781" href="#L3781">3781</a><span class="code-text">Starting with version 2.5, fish requires a C++11 standard library on OS</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3782" href="#L3782">3782</a><span class="code-text">X 10.6 (“SnowLeopard”). If this library is not installed, you will see</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3783" href="#L3783">3783</a><span class="code-text">this error: ``dyld: Library not loaded: /usr/lib/libc++.1.dylib``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3784" href="#L3784">3784</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3785" href="#L3785">3785</a><span class="code-text">MacPorts is the easiest way to obtain this library. After installing the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3786" href="#L3786">3786</a><span class="code-text">SnowLeopard MacPorts release from the install page, run:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3787" href="#L3787">3787</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3788" href="#L3788">3788</a><span class="code-text">::</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3789" href="#L3789">3789</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3790" href="#L3790">3790</a><span class="code-text">   sudo port -v install libcxx</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3791" href="#L3791">3791</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3792" href="#L3792">3792</a><span class="code-text">Now fish should launch successfully. (Please open an issue if it does</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3793" href="#L3793">3793</a><span class="code-text">not.)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3794" href="#L3794">3794</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3795" href="#L3795">3795</a><span class="code-text">This is only necessary on 10.6. OS X 10.7 and later include the required</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3796" href="#L3796">3796</a><span class="code-text">library by default.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3797" href="#L3797">3797</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3798" href="#L3798">3798</a><span class="code-text">.. _other-significant-changes-2:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3799" href="#L3799">3799</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3800" href="#L3800">3800</a><span class="code-text">Other significant changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3801" href="#L3801">3801</a><span class="code-text">-------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3802" href="#L3802">3802</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3803" href="#L3803">3803</a><span class="code-text">-  Attempting to exit with running processes in the background produces</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3804" href="#L3804">3804</a><span class="code-text">   a warning, then signals them to terminate if a second attempt to exit</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3805" href="#L3805">3805</a><span class="code-text">   is made. This brings the behaviour for running background processes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3806" href="#L3806">3806</a><span class="code-text">   into line with stopped processes. (:issue:`3497`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3807" href="#L3807">3807</a><span class="code-text">-  ``random`` can now have start, stop and step values specified, or the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3808" href="#L3808">3808</a><span class="code-text">   new ``choice`` subcommand can be used to pick an argument from a list</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3809" href="#L3809">3809</a><span class="code-text">   (:issue:`3619`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3810" href="#L3810">3810</a><span class="code-text">-  A new key bindings preset, ``fish_hybrid_key_bindings``, including</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3811" href="#L3811">3811</a><span class="code-text">   all the Emacs-style and Vi-style bindings, which behaves like</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3812" href="#L3812">3812</a><span class="code-text">   ``fish_vi_key_bindings`` in fish 2.3.0 (:issue:`3556`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3813" href="#L3813">3813</a><span class="code-text">-  ``function`` now returns an error when called with invalid options,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3814" href="#L3814">3814</a><span class="code-text">   rather than defining the function anyway (:issue:`3574`). This was a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3815" href="#L3815">3815</a><span class="code-text">   regression present in fish 2.3 and 2.4.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3816" href="#L3816">3816</a><span class="code-text">-  fish no longer prints a warning when it identifies a running instance</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3817" href="#L3817">3817</a><span class="code-text">   of an old version (2.1.0 and earlier). Changes to universal variables</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3818" href="#L3818">3818</a><span class="code-text">   may not propagate between these old versions and 2.5b1.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3819" href="#L3819">3819</a><span class="code-text">-  Improved compatibility with Android (:issue:`3585`), MSYS/mingw (:issue:`2360`), and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3820" href="#L3820">3820</a><span class="code-text">   Solaris (:issue:`3456`, :issue:`3340`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3821" href="#L3821">3821</a><span class="code-text">-  Like other shells, the ``test`` built-in now returns an error for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3822" href="#L3822">3822</a><span class="code-text">   numeric operations on invalid integers (:issue:`3346`, :issue:`3581`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3823" href="#L3823">3823</a><span class="code-text">-  ``complete`` no longer recognises ``--authoritative`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3824" href="#L3824">3824</a><span class="code-text">   ``--unauthoritative`` options, and they are marked as obsolete.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3825" href="#L3825">3825</a><span class="code-text">-  ``status`` accepts subcommands, and should be used like</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3826" href="#L3826">3826</a><span class="code-text">   ``status is-interactive``. The old options continue to be supported</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3827" href="#L3827">3827</a><span class="code-text">   for the foreseeable future (:issue:`3526`), although only one subcommand or</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3828" href="#L3828">3828</a><span class="code-text">   option can be specified at a time.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3829" href="#L3829">3829</a><span class="code-text">-  Selection mode (used with “begin-selection”) no longer selects a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3830" href="#L3830">3830</a><span class="code-text">   character the cursor does not move over (:issue:`3684`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3831" href="#L3831">3831</a><span class="code-text">-  List indexes are handled better, and a bit more liberally in some</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3832" href="#L3832">3832</a><span class="code-text">   cases (``echo $PATH[1 .. 3]`` is now valid) (:issue:`3579`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3833" href="#L3833">3833</a><span class="code-text">-  The ``fish_mode_prompt`` function is now simply a stub around</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3834" href="#L3834">3834</a><span class="code-text">   ``fish_default_mode_prompt``, which allows the mode prompt to be</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3835" href="#L3835">3835</a><span class="code-text">   included more easily in customised prompt functions (:issue:`3641`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3836" href="#L3836">3836</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3837" href="#L3837">3837</a><span class="code-text">.. _notable-fixes-and-improvements-3:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3838" href="#L3838">3838</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3839" href="#L3839">3839</a><span class="code-text">Notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3840" href="#L3840">3840</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3841" href="#L3841">3841</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3842" href="#L3842">3842</a><span class="code-text">-  ``alias``, run without options or arguments, lists all defined</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3843" href="#L3843">3843</a><span class="code-text">   aliases, and aliases now include a description in the function</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3844" href="#L3844">3844</a><span class="code-text">   signature that identifies them.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3845" href="#L3845">3845</a><span class="code-text">-  ``complete`` accepts empty strings as descriptions (:issue:`3557`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3846" href="#L3846">3846</a><span class="code-text">-  ``command`` accepts ``-q``/``--quiet`` in combination with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3847" href="#L3847">3847</a><span class="code-text">   ``--search`` (:issue:`3591`), providing a simple way of checking whether a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3848" href="#L3848">3848</a><span class="code-text">   command exists in scripts.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3849" href="#L3849">3849</a><span class="code-text">-  Abbreviations can now be renamed with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3850" href="#L3850">3850</a><span class="code-text">   ``abbr --rename OLD_KEY NEW_KEY`` (:issue:`3610`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3851" href="#L3851">3851</a><span class="code-text">-  The command synopses printed by ``--help`` options work better with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3852" href="#L3852">3852</a><span class="code-text">   copying and pasting (:issue:`2673`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3853" href="#L3853">3853</a><span class="code-text">-  ``help`` launches the browser specified by the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3854" href="#L3854">3854</a><span class="code-text">   ``$fish_help_browser variable`` if it is set (:issue:`3131`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3855" href="#L3855">3855</a><span class="code-text">-  History merging could lose items under certain circumstances and is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3856" href="#L3856">3856</a><span class="code-text">   now fixed (:issue:`3496`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3857" href="#L3857">3857</a><span class="code-text">-  The ``$status`` variable is now set to 123 when a syntactically</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3858" href="#L3858">3858</a><span class="code-text">   invalid command is entered (:issue:`3616`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3859" href="#L3859">3859</a><span class="code-text">-  Exiting fish now signals all background processes to terminate, not</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3860" href="#L3860">3860</a><span class="code-text">   just stopped jobs (:issue:`3497`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3861" href="#L3861">3861</a><span class="code-text">-  A new ``prompt_hostname`` function which prints a hostname suitable</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3862" href="#L3862">3862</a><span class="code-text">   for use in prompts (:issue:`3482`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3863" href="#L3863">3863</a><span class="code-text">-  The ``__fish_man_page`` function (bound to Alt-h by default) now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3864" href="#L3864">3864</a><span class="code-text">   tries to recognize subcommands (e.g. ``git add`` will now open the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3865" href="#L3865">3865</a><span class="code-text">   “git-add” man page) (:issue:`3678`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3866" href="#L3866">3866</a><span class="code-text">-  A new function ``edit_command_buffer`` (bound to Alt-e &amp; Alt-v by</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3867" href="#L3867">3867</a><span class="code-text">   default) to edit the command buffer in an external editor (:issue:`1215`,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3868" href="#L3868">3868</a><span class="code-text">   :issue:`3627`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3869" href="#L3869">3869</a><span class="code-text">-  ``set_color`` now supports italics (``--italics``), dim (``--dim``)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3870" href="#L3870">3870</a><span class="code-text">   and reverse (``--reverse``) modes (:issue:`3650`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3871" href="#L3871">3871</a><span class="code-text">-  Filesystems with very slow locking (eg incorrectly-configured NFS)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3872" href="#L3872">3872</a><span class="code-text">   will no longer slow fish down (:issue:`685`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3873" href="#L3873">3873</a><span class="code-text">-  Improved completions for ``apt`` (:issue:`3695`), ``fusermount`` (:issue:`3642`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3874" href="#L3874">3874</a><span class="code-text">   ``make`` (:issue:`3628`), ``netctl-auto`` (:issue:`3378`), ``nmcli`` (:issue:`3648`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3875" href="#L3875">3875</a><span class="code-text">   ``pygmentize`` (:issue:`3378`), and ``tar`` (:issue:`3719`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3876" href="#L3876">3876</a><span class="code-text">-  Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3877" href="#L3877">3877</a><span class="code-text">-  ``VBoxHeadless`` (:issue:`3378`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3878" href="#L3878">3878</a><span class="code-text">-  ``VBoxSDL`` (:issue:`3378`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3879" href="#L3879">3879</a><span class="code-text">-  ``base64`` (:issue:`3378`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3880" href="#L3880">3880</a><span class="code-text">-  ``caffeinate`` (:issue:`3524`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3881" href="#L3881">3881</a><span class="code-text">-  ``dconf`` (:issue:`3638`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3882" href="#L3882">3882</a><span class="code-text">-  ``dig`` (:issue:`3495`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3883" href="#L3883">3883</a><span class="code-text">-  ``dpkg-reconfigure`` (:issue:`3521` &amp; :issue:`3522`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3884" href="#L3884">3884</a><span class="code-text">-  ``feh`` (:issue:`3378`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3885" href="#L3885">3885</a><span class="code-text">-  ``launchctl`` (:issue:`3682`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3886" href="#L3886">3886</a><span class="code-text">-  ``lxc`` (:issue:`3554` &amp; :issue:`3564`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3887" href="#L3887">3887</a><span class="code-text">-  ``mddiagnose`` (:issue:`3524`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3888" href="#L3888">3888</a><span class="code-text">-  ``mdfind`` (:issue:`3524`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3889" href="#L3889">3889</a><span class="code-text">-  ``mdimport`` (:issue:`3524`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3890" href="#L3890">3890</a><span class="code-text">-  ``mdls`` (:issue:`3524`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3891" href="#L3891">3891</a><span class="code-text">-  ``mdutil`` (:issue:`3524`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3892" href="#L3892">3892</a><span class="code-text">-  ``mkvextract`` (:issue:`3492`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3893" href="#L3893">3893</a><span class="code-text">-  ``nvram`` (:issue:`3524`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3894" href="#L3894">3894</a><span class="code-text">-  ``objdump`` (:issue:`3378`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3895" href="#L3895">3895</a><span class="code-text">-  ``sysbench`` (:issue:`3491`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3896" href="#L3896">3896</a><span class="code-text">-  ``tmutil`` (:issue:`3524`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3897" href="#L3897">3897</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3898" href="#L3898">3898</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3899" href="#L3899">3899</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3900" href="#L3900">3900</a><span class="code-text">fish 2.4.0 (released November 8, 2016)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3901" href="#L3901">3901</a><span class="code-text">======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3902" href="#L3902">3902</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3903" href="#L3903">3903</a><span class="code-text">There are no major changes between 2.4b1 and 2.4.0.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3904" href="#L3904">3904</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3905" href="#L3905">3905</a><span class="code-text">.. _notable-fixes-and-improvements-4:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3906" href="#L3906">3906</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3907" href="#L3907">3907</a><span class="code-text">Notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3908" href="#L3908">3908</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3909" href="#L3909">3909</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3910" href="#L3910">3910</a><span class="code-text">-  The documentation is now generated properly and with the correct</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3911" href="#L3911">3911</a><span class="code-text">   version identifier.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3912" href="#L3912">3912</a><span class="code-text">-  Automatic cursor changes are now only enabled on the subset of XTerm</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3913" href="#L3913">3913</a><span class="code-text">   versions known to support them, resolving a problem where older</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3914" href="#L3914">3914</a><span class="code-text">   versions printed garbage to the terminal before and after every</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3915" href="#L3915">3915</a><span class="code-text">   prompt (:issue:`3499`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3916" href="#L3916">3916</a><span class="code-text">-  Improved the title set in Apple Terminal.app.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3917" href="#L3917">3917</a><span class="code-text">-  Added completions for ``defaults`` and improved completions for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3918" href="#L3918">3918</a><span class="code-text">   ``diskutil`` (:issue:`3478`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3919" href="#L3919">3919</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3920" href="#L3920">3920</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3921" href="#L3921">3921</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3922" href="#L3922">3922</a><span class="code-text">fish 2.4b1 (released October 18, 2016)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3923" href="#L3923">3923</a><span class="code-text">======================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3924" href="#L3924">3924</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3925" href="#L3925">3925</a><span class="code-text">Significant changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3926" href="#L3926">3926</a><span class="code-text">-------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3927" href="#L3927">3927</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3928" href="#L3928">3928</a><span class="code-text">-  The clipboard integration has been revamped with explicit bindings.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3929" href="#L3929">3929</a><span class="code-text">   The killring commands no longer copy from, or paste to, the X11</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3930" href="#L3930">3930</a><span class="code-text">   clipboard - use the new copy (``C-x``) and paste (``C-v``) bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3931" href="#L3931">3931</a><span class="code-text">   instead. The clipboard is now available on OS X as well as systems</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3932" href="#L3932">3932</a><span class="code-text">   using X11 (e.g. Linux). (:issue:`3061`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3933" href="#L3933">3933</a><span class="code-text">-  ``history`` uses subcommands (``history delete``) rather than options</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3934" href="#L3934">3934</a><span class="code-text">   (``history --delete``) for its actions (:issue:`3367`). You can no longer</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3935" href="#L3935">3935</a><span class="code-text">   specify multiple actions via flags (e.g.,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3936" href="#L3936">3936</a><span class="code-text">   ``history --delete --save something``).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3937" href="#L3937">3937</a><span class="code-text">-  New ``history`` options have been added, including ``--max=n`` to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3938" href="#L3938">3938</a><span class="code-text">   limit the number of history entries, ``--show-time`` option to show</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3939" href="#L3939">3939</a><span class="code-text">   timestamps (:issue:`3175`, :issue:`3244`), and ``--null`` to null terminate history</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3940" href="#L3940">3940</a><span class="code-text">   entries in the search output.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3941" href="#L3941">3941</a><span class="code-text">-  ``history search`` is now case-insensitive by default (which also</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3942" href="#L3942">3942</a><span class="code-text">   affects ``history delete``) (:issue:`3236`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3943" href="#L3943">3943</a><span class="code-text">-  ``history delete`` now correctly handles multiline commands (:issue:`31`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3944" href="#L3944">3944</a><span class="code-text">-  Vi-style bindings no longer include all of the default emacs-style</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3945" href="#L3945">3945</a><span class="code-text">   bindings; instead, they share some definitions (:issue:`3068`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3946" href="#L3946">3946</a><span class="code-text">-  If there is no locale set in the environment, various known system</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3947" href="#L3947">3947</a><span class="code-text">   configuration files will be checked for a default. If no locale can</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3948" href="#L3948">3948</a><span class="code-text">   be found, ``en_US-UTF.8`` will be used (:issue:`277`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3949" href="#L3949">3949</a><span class="code-text">-  A number followed by a caret (e.g. ``5^``) is no longer treated as a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3950" href="#L3950">3950</a><span class="code-text">   redirection (:issue:`1873`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3951" href="#L3951">3951</a><span class="code-text">-  The ``$version`` special variable can be overwritten, so that it can</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3952" href="#L3952">3952</a><span class="code-text">   be used for other purposes if required.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3953" href="#L3953">3953</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3954" href="#L3954">3954</a><span class="code-text">.. _notable-fixes-and-improvements-5:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3955" href="#L3955">3955</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3956" href="#L3956">3956</a><span class="code-text">Notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3957" href="#L3957">3957</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3958" href="#L3958">3958</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3959" href="#L3959">3959</a><span class="code-text">-  The ``fish_realpath`` builtin has been renamed to ``realpath`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3960" href="#L3960">3960</a><span class="code-text">   made compatible with GNU ``realpath`` when run without arguments</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3961" href="#L3961">3961</a><span class="code-text">   (:issue:`3400`). It is used only for systems without a ``realpath`` or</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3962" href="#L3962">3962</a><span class="code-text">   ``grealpath`` utility (:issue:`3374`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3963" href="#L3963">3963</a><span class="code-text">-  Improved color handling on terminals/consoles with 8-16 colors,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3964" href="#L3964">3964</a><span class="code-text">   particularly the use of bright named color (:issue:`3176`, :issue:`3260`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3965" href="#L3965">3965</a><span class="code-text">-  ``fish_indent`` can now read from files given as arguments, rather</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3966" href="#L3966">3966</a><span class="code-text">   than just standard input (:issue:`3037`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3967" href="#L3967">3967</a><span class="code-text">-  Fuzzy tab completions behave in a less surprising manner (:issue:`3090`,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3968" href="#L3968">3968</a><span class="code-text">   :issue:`3211`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3969" href="#L3969">3969</a><span class="code-text">-  ``jobs`` should only print its header line once (:issue:`3127`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3970" href="#L3970">3970</a><span class="code-text">-  Wildcards in redirections are highlighted appropriately (:issue:`2789`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3971" href="#L3971">3971</a><span class="code-text">-  Suggestions will be offered more often, like after removing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3972" href="#L3972">3972</a><span class="code-text">   characters (:issue:`3069`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3973" href="#L3973">3973</a><span class="code-text">-  ``history --merge`` now correctly interleaves items in chronological</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3974" href="#L3974">3974</a><span class="code-text">   order (:issue:`2312`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3975" href="#L3975">3975</a><span class="code-text">-  Options for ``fish_indent`` have been aligned with the other binaries</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3976" href="#L3976">3976</a><span class="code-text">   - in particular, ``-d`` now means ``--debug``. The ``--dump`` option</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3977" href="#L3977">3977</a><span class="code-text">   has been renamed to ``--dump-parse-tree`` (:issue:`3191`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3978" href="#L3978">3978</a><span class="code-text">-  The display of bindings in the Web-based configuration has been</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3979" href="#L3979">3979</a><span class="code-text">   greatly improved (:issue:`3325`), as has the rendering of prompts (:issue:`2924`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3980" href="#L3980">3980</a><span class="code-text">-  fish should no longer hang using 100% CPU in the C locale (:issue:`3214`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3981" href="#L3981">3981</a><span class="code-text">-  A bug in FreeBSD 11 &amp; 12, Dragonfly BSD &amp; illumos prevented fish from</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3982" href="#L3982">3982</a><span class="code-text">   working correctly on these platforms under UTF-8 locales; fish now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3983" href="#L3983">3983</a><span class="code-text">   avoids the buggy behaviour (:issue:`3050`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3984" href="#L3984">3984</a><span class="code-text">-  Prompts which show git repository information (via</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3985" href="#L3985">3985</a><span class="code-text">   ``__fish_git_prompt``) are faster in large repositories (:issue:`3294`) and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3986" href="#L3986">3986</a><span class="code-text">   slow filesystems (:issue:`3083`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3987" href="#L3987">3987</a><span class="code-text">-  fish 2.3.0 reintroduced a problem where the greeting was printed even</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3988" href="#L3988">3988</a><span class="code-text">   when using ``read``; this has been corrected again (:issue:`3261`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3989" href="#L3989">3989</a><span class="code-text">-  Vi mode changes the cursor depending on the current mode (:issue:`3215`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3990" href="#L3990">3990</a><span class="code-text">-  Command lines with escaped space characters at the end tab-complete</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3991" href="#L3991">3991</a><span class="code-text">   correctly (:issue:`2447`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3992" href="#L3992">3992</a><span class="code-text">-  Added completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3993" href="#L3993">3993</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3994" href="#L3994">3994</a><span class="code-text">   -  ``arcanist`` (:issue:`3256`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3995" href="#L3995">3995</a><span class="code-text">   -  ``connmanctl`` (:issue:`3419`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3996" href="#L3996">3996</a><span class="code-text">   -  ``figlet`` (:issue:`3378`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3997" href="#L3997">3997</a><span class="code-text">   -  ``mdbook`` (:issue:`3378`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3998" href="#L3998">3998</a><span class="code-text">   -  ``ninja`` (:issue:`3415`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3999" href="#L3999">3999</a><span class="code-text">   -  ``p4``, the Perforce client (:issue:`3314`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4000" href="#L4000">4000</a><span class="code-text">   -  ``pygmentize`` (:issue:`3378`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4001" href="#L4001">4001</a><span class="code-text">   -  ``ranger`` (:issue:`3378`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4002" href="#L4002">4002</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4003" href="#L4003">4003</a><span class="code-text">-  Improved completions for ``aura`` (:issue:`3297`), ``abbr`` (:issue:`3267`), ``brew``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4004" href="#L4004">4004</a><span class="code-text">   (:issue:`3309`), ``chown`` (:issue:`3380`, :issue:`3383`),\ ``cygport`` (:issue:`3392`), ``git``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4005" href="#L4005">4005</a><span class="code-text">   (:issue:`3274`, :issue:`3226`, :issue:`3225`, :issue:`3094`, :issue:`3087`, :issue:`3035`, :issue:`3021`, :issue:`2982`, :issue:`3230`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4006" href="#L4006">4006</a><span class="code-text">   ``kill`` &amp; ``pkill`` (:issue:`3200`), ``screen`` (:issue:`3271`), ``wget`` (:issue:`3470`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4007" href="#L4007">4007</a><span class="code-text">   and ``xz`` (:issue:`3378`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4008" href="#L4008">4008</a><span class="code-text">-  Distributors, packagers and developers will notice that the build</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4009" href="#L4009">4009</a><span class="code-text">   process produces more succinct output by default; use ``make V=1`` to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4010" href="#L4010">4010</a><span class="code-text">   get verbose output (:issue:`3248`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4011" href="#L4011">4011</a><span class="code-text">-  Improved compatibility with minor platforms including musl (:issue:`2988`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4012" href="#L4012">4012</a><span class="code-text">   Cygwin (:issue:`2993`), Android (:issue:`3441`, :issue:`3442`), Haiku (:issue:`3322`) and Solaris .</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4013" href="#L4013">4013</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4014" href="#L4014">4014</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4015" href="#L4015">4015</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4016" href="#L4016">4016</a><span class="code-text">fish 2.3.1 (released July 3, 2016)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4017" href="#L4017">4017</a><span class="code-text">==================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4018" href="#L4018">4018</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4019" href="#L4019">4019</a><span class="code-text">This is a functionality and bugfix release. This release does not</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4020" href="#L4020">4020</a><span class="code-text">contain all the changes to fish since the last release, but fixes a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4021" href="#L4021">4021</a><span class="code-text">number of issues directly affecting users at present and includes a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4022" href="#L4022">4022</a><span class="code-text">small number of new features.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4023" href="#L4023">4023</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4024" href="#L4024">4024</a><span class="code-text">.. _significant-changes-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4025" href="#L4025">4025</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4026" href="#L4026">4026</a><span class="code-text">Significant changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4027" href="#L4027">4027</a><span class="code-text">-------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4028" href="#L4028">4028</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4029" href="#L4029">4029</a><span class="code-text">-  A new ``fish_key_reader`` binary for decoding interactive keypresses</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4030" href="#L4030">4030</a><span class="code-text">   (:issue:`2991`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4031" href="#L4031">4031</a><span class="code-text">-  ``fish_mode_prompt`` has been updated to reflect the changes in the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4032" href="#L4032">4032</a><span class="code-text">   way the Vi input mode is set up (:issue:`3067`), making this more reliable.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4033" href="#L4033">4033</a><span class="code-text">-  ``fish_config`` can now properly be launched from the OS X app bundle</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4034" href="#L4034">4034</a><span class="code-text">   (:issue:`3140`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4035" href="#L4035">4035</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4036" href="#L4036">4036</a><span class="code-text">.. _notable-fixes-and-improvements-6:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4037" href="#L4037">4037</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4038" href="#L4038">4038</a><span class="code-text">Notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4039" href="#L4039">4039</a><span class="code-text">------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4040" href="#L4040">4040</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4041" href="#L4041">4041</a><span class="code-text">-  Extra lines were sometimes inserted into the output under Windows</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4042" href="#L4042">4042</a><span class="code-text">   (Cygwin and Microsoft Windows Subsystem for Linux) due to TTY</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4043" href="#L4043">4043</a><span class="code-text">   timestamps not being updated (:issue:`2859`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4044" href="#L4044">4044</a><span class="code-text">-  The ``string`` builtin’s ``match`` mode now handles the combination</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4045" href="#L4045">4045</a><span class="code-text">   of ``-rnv`` (match, invert and count) correctly (:issue:`3098`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4046" href="#L4046">4046</a><span class="code-text">-  Improvements to TTY special character handling (:issue:`3064`), locale</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4047" href="#L4047">4047</a><span class="code-text">   handling (:issue:`3124`) and terminal environment variable handling (:issue:`3060`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4048" href="#L4048">4048</a><span class="code-text">-  Work towards handling the terminal modes for external commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4049" href="#L4049">4049</a><span class="code-text">   launched from initialisation files (:issue:`2980`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4050" href="#L4050">4050</a><span class="code-text">-  Ease the upgrade path from fish 2.2.0 and before by warning users to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4051" href="#L4051">4051</a><span class="code-text">   restart fish if the ``string`` builtin is not available (:issue:`3057`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4052" href="#L4052">4052</a><span class="code-text">-  ``type -a`` now syntax-colorizes function source output.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4053" href="#L4053">4053</a><span class="code-text">-  Added completions for ``alsamixer``, ``godoc``, ``gofmt``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4054" href="#L4054">4054</a><span class="code-text">   ``goimports``, ``gorename``, ``lscpu``, ``mkdir``, ``modinfo``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4055" href="#L4055">4055</a><span class="code-text">   ``netctl-auto``, ``poweroff``, ``termite``, ``udisksctl`` and ``xz``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4056" href="#L4056">4056</a><span class="code-text">   (:issue:`3123`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4057" href="#L4057">4057</a><span class="code-text">-  Improved completions for ``apt`` (:issue:`3097`), ``aura`` (:issue:`3102`),\ ``git``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4058" href="#L4058">4058</a><span class="code-text">   (:issue:`3114`), ``npm`` (:issue:`3158`), ``string`` and ``suspend`` (:issue:`3154`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4059" href="#L4059">4059</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4060" href="#L4060">4060</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4061" href="#L4061">4061</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4062" href="#L4062">4062</a><span class="code-text">fish 2.3.0 (released May 20, 2016)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4063" href="#L4063">4063</a><span class="code-text">==================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4064" href="#L4064">4064</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4065" href="#L4065">4065</a><span class="code-text">There are no significant changes between 2.3.0 and 2.3b2.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4066" href="#L4066">4066</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4067" href="#L4067">4067</a><span class="code-text">Other notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4068" href="#L4068">4068</a><span class="code-text">------------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4069" href="#L4069">4069</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4070" href="#L4070">4070</a><span class="code-text">-  ``abbr`` now allows non-letter keys (:issue:`2996`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4071" href="#L4071">4071</a><span class="code-text">-  Define a few extra colours on first start (:issue:`2987`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4072" href="#L4072">4072</a><span class="code-text">-  Multiple documentation updates.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4073" href="#L4073">4073</a><span class="code-text">-  Added completions for rmmod (:issue:`3007`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4074" href="#L4074">4074</a><span class="code-text">-  Improved completions for git (:issue:`2998`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4075" href="#L4075">4075</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4076" href="#L4076">4076</a><span class="code-text">.. _known-issues-2:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4077" href="#L4077">4077</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4078" href="#L4078">4078</a><span class="code-text">Known issues</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4079" href="#L4079">4079</a><span class="code-text">------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4080" href="#L4080">4080</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4081" href="#L4081">4081</a><span class="code-text">-  Interactive commands started from fish configuration files or from</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4082" href="#L4082">4082</a><span class="code-text">   the ``-c`` option may, under certain circumstances, be started with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4083" href="#L4083">4083</a><span class="code-text">   incorrect terminal modes and fail to behave as expected. A fix is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4084" href="#L4084">4084</a><span class="code-text">   planned but requires further testing (:issue:`2619`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4085" href="#L4085">4085</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4086" href="#L4086">4086</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4087" href="#L4087">4087</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4088" href="#L4088">4088</a><span class="code-text">fish 2.3b2 (released May 5, 2016)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4089" href="#L4089">4089</a><span class="code-text">=================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4090" href="#L4090">4090</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4091" href="#L4091">4091</a><span class="code-text">.. _significant-changes-2:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4092" href="#L4092">4092</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4093" href="#L4093">4093</a><span class="code-text">Significant changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4094" href="#L4094">4094</a><span class="code-text">-------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4095" href="#L4095">4095</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4096" href="#L4096">4096</a><span class="code-text">-  A new ``fish_realpath`` builtin and associated function to allow the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4097" href="#L4097">4097</a><span class="code-text">   use of ``realpath`` even on those platforms that don’t ship an</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4098" href="#L4098">4098</a><span class="code-text">   appropriate command (:issue:`2932`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4099" href="#L4099">4099</a><span class="code-text">-  Alt-# toggles the current command line between commented and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4100" href="#L4100">4100</a><span class="code-text">   uncommented states, making it easy to save a command in history</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4101" href="#L4101">4101</a><span class="code-text">   without executing it.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4102" href="#L4102">4102</a><span class="code-text">-  The ``fish_vi_mode`` function is now deprecated in favour of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4103" href="#L4103">4103</a><span class="code-text">   ``fish_vi_key_bindings``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4104" href="#L4104">4104</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4105" href="#L4105">4105</a><span class="code-text">.. _other-notable-fixes-and-improvements-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4106" href="#L4106">4106</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4107" href="#L4107">4107</a><span class="code-text">Other notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4108" href="#L4108">4108</a><span class="code-text">------------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4109" href="#L4109">4109</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4110" href="#L4110">4110</a><span class="code-text">-  Fix the build on Cygwin (:issue:`2952`) and RedHat Enterprise Linux/CentOS 5</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4111" href="#L4111">4111</a><span class="code-text">   (:issue:`2955`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4112" href="#L4112">4112</a><span class="code-text">-  Avoid confusing the terminal line driver with non-printing characters</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4113" href="#L4113">4113</a><span class="code-text">   in ``fish_title`` (:issue:`2453`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4114" href="#L4114">4114</a><span class="code-text">-  Improved completions for busctl, git (:issue:`2585`, :issue:`2879`, :issue:`2984`), and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4115" href="#L4115">4115</a><span class="code-text">   netctl.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4116" href="#L4116">4116</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4117" href="#L4117">4117</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4118" href="#L4118">4118</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4119" href="#L4119">4119</a><span class="code-text">fish 2.3b1 (released April 19, 2016)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4120" href="#L4120">4120</a><span class="code-text">====================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4121" href="#L4121">4121</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4122" href="#L4122">4122</a><span class="code-text">.. _significant-changes-3:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4123" href="#L4123">4123</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4124" href="#L4124">4124</a><span class="code-text">Significant Changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4125" href="#L4125">4125</a><span class="code-text">-------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4126" href="#L4126">4126</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4127" href="#L4127">4127</a><span class="code-text">-  A new ``string`` builtin to handle… strings! This builtin will</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4128" href="#L4128">4128</a><span class="code-text">   measure, split, search and replace text strings, including using</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4129" href="#L4129">4129</a><span class="code-text">   regular expressions. It can also be used to turn lists into plain</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4130" href="#L4130">4130</a><span class="code-text">   strings using ``join``. ``string`` can be used in place of ``sed``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4131" href="#L4131">4131</a><span class="code-text">   ``grep``, ``tr``, ``cut``, and ``awk`` in many situations. (:issue:`2296`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4132" href="#L4132">4132</a><span class="code-text">-  Allow using escape as the Meta modifier key, by waiting after seeing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4133" href="#L4133">4133</a><span class="code-text">   an escape character wait up to 300ms for an additional character.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4134" href="#L4134">4134</a><span class="code-text">   This is consistent with readline (e.g. bash) and can be configured</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4135" href="#L4135">4135</a><span class="code-text">   via the ``fish_escape_delay_ms variable``. This allows using escape</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4136" href="#L4136">4136</a><span class="code-text">   as the Meta modifier. (:issue:`1356`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4137" href="#L4137">4137</a><span class="code-text">-  Add new directories for vendor functions and configuration snippets</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4138" href="#L4138">4138</a><span class="code-text">   (:issue:`2500`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4139" href="#L4139">4139</a><span class="code-text">-  A new ``fish_realpath`` builtin and associated ``realpath`` function</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4140" href="#L4140">4140</a><span class="code-text">   should allow scripts to resolve path names via ``realpath``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4141" href="#L4141">4141</a><span class="code-text">   regardless of whether there is an external command of that name;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4142" href="#L4142">4142</a><span class="code-text">   albeit with some limitations. See the associated documentation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4143" href="#L4143">4143</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4144" href="#L4144">4144</a><span class="code-text">Backward-incompatible changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4145" href="#L4145">4145</a><span class="code-text">-----------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4146" href="#L4146">4146</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4147" href="#L4147">4147</a><span class="code-text">-  Unmatched globs will now cause an error, except when used with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4148" href="#L4148">4148</a><span class="code-text">   ``for``, ``set`` or ``count`` (:issue:`2719`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4149" href="#L4149">4149</a><span class="code-text">-  ``and`` and ``or`` will now bind to the closest ``if`` or ``while``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4150" href="#L4150">4150</a><span class="code-text">   allowing compound conditions without ``begin`` and ``end`` (:issue:`1428`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4151" href="#L4151">4151</a><span class="code-text">-  ``set -ql`` now searches up to function scope for variables (:issue:`2502`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4152" href="#L4152">4152</a><span class="code-text">-  ``status -f`` will now behave the same when run as the main script or</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4153" href="#L4153">4153</a><span class="code-text">   using ``source`` (:issue:`2643`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4154" href="#L4154">4154</a><span class="code-text">-  ``source`` no longer puts the file name in ``$argv`` if no arguments</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4155" href="#L4155">4155</a><span class="code-text">   are given (:issue:`139`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4156" href="#L4156">4156</a><span class="code-text">-  History files are stored under the ``XDG_DATA_HOME`` hierarchy (by</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4157" href="#L4157">4157</a><span class="code-text">   default, in ``~/.local/share``), and existing history will be moved</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4158" href="#L4158">4158</a><span class="code-text">   on first use (:issue:`744`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4159" href="#L4159">4159</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4160" href="#L4160">4160</a><span class="code-text">.. _other-notable-fixes-and-improvements-2:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4161" href="#L4161">4161</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4162" href="#L4162">4162</a><span class="code-text">Other notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4163" href="#L4163">4163</a><span class="code-text">------------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4164" href="#L4164">4164</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4165" href="#L4165">4165</a><span class="code-text">-  fish no longer silences errors in config.fish (:issue:`2702`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4166" href="#L4166">4166</a><span class="code-text">-  Directory autosuggestions will now descend as far as possible if</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4167" href="#L4167">4167</a><span class="code-text">   there is only one child directory (:issue:`2531`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4168" href="#L4168">4168</a><span class="code-text">-  Add support for bright colors (:issue:`1464`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4169" href="#L4169">4169</a><span class="code-text">-  Allow Ctrl-J (``\cj``) to be bound separately from Ctrl-M</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4170" href="#L4170">4170</a><span class="code-text">   (``\cm``) (:issue:`217`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4171" href="#L4171">4171</a><span class="code-text">-  psub now has a “-s”/“-suffix” option to name the temporary file with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4172" href="#L4172">4172</a><span class="code-text">   that suffix</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4173" href="#L4173">4173</a><span class="code-text">-  Enable 24-bit colors on select terminals (:issue:`2495`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4174" href="#L4174">4174</a><span class="code-text">-  Support for SVN status in the prompt (:issue:`2582`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4175" href="#L4175">4175</a><span class="code-text">-  Mercurial and SVN support have been added to the Classic + Git (now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4176" href="#L4176">4176</a><span class="code-text">   Classic + VCS) prompt (via the new \__fish_vcs_prompt function)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4177" href="#L4177">4177</a><span class="code-text">   (:issue:`2592`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4178" href="#L4178">4178</a><span class="code-text">-  export now handles variables with a “=” in the value (:issue:`2403`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4179" href="#L4179">4179</a><span class="code-text">-  New completions for:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4180" href="#L4180">4180</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4181" href="#L4181">4181</a><span class="code-text">   -  alsactl</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4182" href="#L4182">4182</a><span class="code-text">   -  Archlinux’s asp, makepkg</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4183" href="#L4183">4183</a><span class="code-text">   -  Atom’s apm (:issue:`2390`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4184" href="#L4184">4184</a><span class="code-text">   -  entr - the “Event Notify Test Runner” (:issue:`2265`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4185" href="#L4185">4185</a><span class="code-text">   -  Fedora’s dnf (:issue:`2638`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4186" href="#L4186">4186</a><span class="code-text">   -  OSX diskutil (:issue:`2738`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4187" href="#L4187">4187</a><span class="code-text">   -  pkgng (:issue:`2395`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4188" href="#L4188">4188</a><span class="code-text">   -  pulseaudio’s pacmd and pactl</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4189" href="#L4189">4189</a><span class="code-text">   -  rust’s rustc and cargo (:issue:`2409`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4190" href="#L4190">4190</a><span class="code-text">   -  sysctl (:issue:`2214`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4191" href="#L4191">4191</a><span class="code-text">   -  systemd’s machinectl (:issue:`2158`), busctl (:issue:`2144`), systemd-nspawn,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4192" href="#L4192">4192</a><span class="code-text">      systemd-analyze, localectl, timedatectl</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4193" href="#L4193">4193</a><span class="code-text">   -  and more</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4194" href="#L4194">4194</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4195" href="#L4195">4195</a><span class="code-text">-  fish no longer has a function called sgrep, freeing it for user</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4196" href="#L4196">4196</a><span class="code-text">   customization (:issue:`2245`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4197" href="#L4197">4197</a><span class="code-text">-  A rewrite of the completions for cd, fixing a few bugs (:issue:`2299`, :issue:`2300`,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4198" href="#L4198">4198</a><span class="code-text">   :issue:`562`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4199" href="#L4199">4199</a><span class="code-text">-  Linux VTs now run in a simplified mode to avoid issues (:issue:`2311`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4200" href="#L4200">4200</a><span class="code-text">-  The vi-bindings now inherit from the emacs bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4201" href="#L4201">4201</a><span class="code-text">-  fish will also execute ``fish_user_key_bindings`` when in vi-mode</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4202" href="#L4202">4202</a><span class="code-text">-  ``funced`` will now also check $VISUAL (:issue:`2268`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4203" href="#L4203">4203</a><span class="code-text">-  A new ``suspend`` function (:issue:`2269`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4204" href="#L4204">4204</a><span class="code-text">-  Subcommand completion now works better with split /usr (:issue:`2141`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4205" href="#L4205">4205</a><span class="code-text">-  The command-not-found-handler can now be overridden by defining a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4206" href="#L4206">4206</a><span class="code-text">   function called ``__fish_command_not_found_handler`` in config.fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4207" href="#L4207">4207</a><span class="code-text">   (:issue:`2332`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4208" href="#L4208">4208</a><span class="code-text">-  A few fixes to the Sorin theme</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4209" href="#L4209">4209</a><span class="code-text">-  PWD shortening in the prompt can now be configured via the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4210" href="#L4210">4210</a><span class="code-text">   ``fish_prompt_pwd_dir_length`` variable, set to the length per path</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4211" href="#L4211">4211</a><span class="code-text">   component (:issue:`2473`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4212" href="#L4212">4212</a><span class="code-text">-  fish no longer requires ``/etc/fish/config.fish`` to correctly start,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4213" href="#L4213">4213</a><span class="code-text">   and now ships a skeleton file that only contains some documentation</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4214" href="#L4214">4214</a><span class="code-text">   (:issue:`2799`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4215" href="#L4215">4215</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4216" href="#L4216">4216</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4217" href="#L4217">4217</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4218" href="#L4218">4218</a><span class="code-text">fish 2.2.0 (released July 12, 2015)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4219" href="#L4219">4219</a><span class="code-text">===================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4220" href="#L4220">4220</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4221" href="#L4221">4221</a><span class="code-text">.. _significant-changes-4:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4222" href="#L4222">4222</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4223" href="#L4223">4223</a><span class="code-text">Significant changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4224" href="#L4224">4224</a><span class="code-text">-------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4225" href="#L4225">4225</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4226" href="#L4226">4226</a><span class="code-text">-  Abbreviations: the new ``abbr`` command allows for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4227" href="#L4227">4227</a><span class="code-text">   interactively-expanded abbreviations, allowing quick access to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4228" href="#L4228">4228</a><span class="code-text">   frequently-used commands (:issue:`731`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4229" href="#L4229">4229</a><span class="code-text">-  Vi mode: run ``fish_vi_mode`` to switch fish into the key bindings</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4230" href="#L4230">4230</a><span class="code-text">   and prompt familiar to users of the Vi editor (:issue:`65`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4231" href="#L4231">4231</a><span class="code-text">-  New inline and interactive pager, which will be familiar to users of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4232" href="#L4232">4232</a><span class="code-text">   zsh (:issue:`291`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4233" href="#L4233">4233</a><span class="code-text">-  Underlying architectural changes: the ``fishd`` universal variable</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4234" href="#L4234">4234</a><span class="code-text">   server has been removed as it was a source of many bugs and security</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4235" href="#L4235">4235</a><span class="code-text">   problems. Notably, old fish sessions will not be able to communicate</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4236" href="#L4236">4236</a><span class="code-text">   universal variable changes with new fish sessions. For best results,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4237" href="#L4237">4237</a><span class="code-text">   restart all running instances of ``fish``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4238" href="#L4238">4238</a><span class="code-text">-  The web-based configuration tool has been redesigned, featuring a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4239" href="#L4239">4239</a><span class="code-text">   prompt theme chooser and other improvements.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4240" href="#L4240">4240</a><span class="code-text">-  New German, Brazilian Portuguese, and Chinese translations.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4241" href="#L4241">4241</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4242" href="#L4242">4242</a><span class="code-text">.. _backward-incompatible-changes-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4243" href="#L4243">4243</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4244" href="#L4244">4244</a><span class="code-text">Backward-incompatible changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4245" href="#L4245">4245</a><span class="code-text">-----------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4246" href="#L4246">4246</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4247" href="#L4247">4247</a><span class="code-text">These are kept to a minimum, but either change undocumented features or</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4248" href="#L4248">4248</a><span class="code-text">are too hard to use in their existing forms. These changes may break</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4249" href="#L4249">4249</a><span class="code-text">existing scripts.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4250" href="#L4250">4250</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4251" href="#L4251">4251</a><span class="code-text">-  ``commandline`` no longer interprets functions “in reverse”, instead</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4252" href="#L4252">4252</a><span class="code-text">   behaving as expected (:issue:`1567`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4253" href="#L4253">4253</a><span class="code-text">-  The previously-undocumented ``CMD_DURATION`` variable is now set for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4254" href="#L4254">4254</a><span class="code-text">   all commands and contains the execution time of the last command in</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4255" href="#L4255">4255</a><span class="code-text">   milliseconds (:issue:`1585`). It is no longer exported to other commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4256" href="#L4256">4256</a><span class="code-text">   (:issue:`1896`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4257" href="#L4257">4257</a><span class="code-text">-  ``if`` / ``else`` conditional statements now return values consistent</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4258" href="#L4258">4258</a><span class="code-text">   with the Single Unix Specification, like other shells (:issue:`1443`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4259" href="#L4259">4259</a><span class="code-text">-  A new “top-level” local scope has been added, allowing local</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4260" href="#L4260">4260</a><span class="code-text">   variables declared on the commandline to be visible to subsequent</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4261" href="#L4261">4261</a><span class="code-text">   commands. (:issue:`1908`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4262" href="#L4262">4262</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4263" href="#L4263">4263</a><span class="code-text">.. _other-notable-fixes-and-improvements-3:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4264" href="#L4264">4264</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4265" href="#L4265">4265</a><span class="code-text">Other notable fixes and improvements</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4266" href="#L4266">4266</a><span class="code-text">------------------------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4267" href="#L4267">4267</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4268" href="#L4268">4268</a><span class="code-text">-  New documentation design (:issue:`1662`), which requires a Doxygen version</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4269" href="#L4269">4269</a><span class="code-text">   1.8.7 or newer to build.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4270" href="#L4270">4270</a><span class="code-text">-  fish now defines a default directory for other packages to provide</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4271" href="#L4271">4271</a><span class="code-text">   completions. By default this is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4272" href="#L4272">4272</a><span class="code-text">   ``/usr/share/fish/vendor-completions.d``; on systems with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4273" href="#L4273">4273</a><span class="code-text">   ``pkgconfig`` installed this path is discoverable with</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4274" href="#L4274">4274</a><span class="code-text">   ``pkg-config --variable completionsdir fish``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4275" href="#L4275">4275</a><span class="code-text">-  A new parser removes many bugs; all existing syntax should keep</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4276" href="#L4276">4276</a><span class="code-text">   working.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4277" href="#L4277">4277</a><span class="code-text">-  New ``fish_preexec`` and ``fish_postexec`` events are fired before</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4278" href="#L4278">4278</a><span class="code-text">   and after job execution respectively (:issue:`1549`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4279" href="#L4279">4279</a><span class="code-text">-  Unmatched wildcards no longer prevent a job from running. Wildcards</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4280" href="#L4280">4280</a><span class="code-text">   used interactively will still print an error, but the job will</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4281" href="#L4281">4281</a><span class="code-text">   proceed and the wildcard will expand to zero arguments (:issue:`1482`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4282" href="#L4282">4282</a><span class="code-text">-  The ``.`` command is deprecated and the ``source`` command is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4283" href="#L4283">4283</a><span class="code-text">   preferred (:issue:`310`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4284" href="#L4284">4284</a><span class="code-text">-  ``bind`` supports “bind modes”, which allows bindings to be set for a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4285" href="#L4285">4285</a><span class="code-text">   particular named mode, to support the implementation of Vi mode.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4286" href="#L4286">4286</a><span class="code-text">-  A new ``export`` alias, which behaves like other shells (:issue:`1833`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4287" href="#L4287">4287</a><span class="code-text">-  ``command`` has a new ``--search`` option to print the name of the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4288" href="#L4288">4288</a><span class="code-text">   disk file that would be executed, like other shells’ ``command -v``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4289" href="#L4289">4289</a><span class="code-text">   (:issue:`1540`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4290" href="#L4290">4290</a><span class="code-text">-  ``commandline`` has a new ``--paging-mode`` option to support the new</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4291" href="#L4291">4291</a><span class="code-text">   pager.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4292" href="#L4292">4292</a><span class="code-text">-  ``complete`` has a new ``--wraps`` option, which allows a command to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4293" href="#L4293">4293</a><span class="code-text">   (recursively) inherit the completions of a wrapped command (:issue:`393`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4294" href="#L4294">4294</a><span class="code-text">   and ``complete -e`` now correctly erases completions (:issue:`380`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4295" href="#L4295">4295</a><span class="code-text">-  Completions are now generated from manual pages by default on the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4296" href="#L4296">4296</a><span class="code-text">   first run of fish (:issue:`997`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4297" href="#L4297">4297</a><span class="code-text">-  ``fish_indent`` can now produce colorized (``--ansi``) and HTML</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4298" href="#L4298">4298</a><span class="code-text">   (``--html``) output (:issue:`1827`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4299" href="#L4299">4299</a><span class="code-text">-  ``functions --erase`` now prevents autoloaded functions from being</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4300" href="#L4300">4300</a><span class="code-text">   reloaded in the current session.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4301" href="#L4301">4301</a><span class="code-text">-  ``history`` has a new ``--merge`` option, to incorporate history from</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4302" href="#L4302">4302</a><span class="code-text">   other sessions into the current session (:issue:`825`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4303" href="#L4303">4303</a><span class="code-text">-  ``jobs`` returns 1 if there are no active jobs (:issue:`1484`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4304" href="#L4304">4304</a><span class="code-text">-  ``read`` has several new options:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4305" href="#L4305">4305</a><span class="code-text">-  ``--array`` to break input into an array (:issue:`1540`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4306" href="#L4306">4306</a><span class="code-text">-  ``--null`` to break lines on NUL characters rather than newlines</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4307" href="#L4307">4307</a><span class="code-text">   (:issue:`1694`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4308" href="#L4308">4308</a><span class="code-text">-  ``--nchars`` to read a specific number of characters (:issue:`1616`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4309" href="#L4309">4309</a><span class="code-text">-  ``--right-prompt`` to display a right-hand-side prompt during</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4310" href="#L4310">4310</a><span class="code-text">   interactive read (:issue:`1698`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4311" href="#L4311">4311</a><span class="code-text">-  ``type`` has a new ``-q`` option to suppress output (:issue:`1540` and, like</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4312" href="#L4312">4312</a><span class="code-text">   other shells, ``type -a`` now prints all matches for a command</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4313" href="#L4313">4313</a><span class="code-text">   (:issue:`261`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4314" href="#L4314">4314</a><span class="code-text">-  Pressing :kbd:`f1` now shows the manual page for the current command</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4315" href="#L4315">4315</a><span class="code-text">   (:issue:`1063`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4316" href="#L4316">4316</a><span class="code-text">-  ``fish_title`` functions have access to the arguments of the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4317" href="#L4317">4317</a><span class="code-text">   currently running argument as ``$argv[1]`` (:issue:`1542`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4318" href="#L4318">4318</a><span class="code-text">-  The OS command-not-found handler is used on Arch Linux (:issue:`1925`), nixOS</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4319" href="#L4319">4319</a><span class="code-text">   (:issue:`1852`), openSUSE and Fedora (:issue:`1280`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4320" href="#L4320">4320</a><span class="code-text">-  ``Alt``\ +\ ``.`` searches backwards in the token history, mapping to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4321" href="#L4321">4321</a><span class="code-text">   the same behavior as inserting the last argument of the previous</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4322" href="#L4322">4322</a><span class="code-text">   command, like other shells (:issue:`89`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4323" href="#L4323">4323</a><span class="code-text">-  The ``SHLVL`` environment variable is incremented correctly (:issue:`1634` &amp;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4324" href="#L4324">4324</a><span class="code-text">   :issue:`1693`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4325" href="#L4325">4325</a><span class="code-text">-  Added completions for ``adb`` (:issue:`1165` &amp; :issue:`1211`), ``apt`` (:issue:`2018`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4326" href="#L4326">4326</a><span class="code-text">   ``aura`` (:issue:`1292`), ``composer`` (:issue:`1607`), ``cygport`` (:issue:`1841`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4327" href="#L4327">4327</a><span class="code-text">   ``dropbox`` (:issue:`1533`), ``elixir`` (:issue:`1167`), ``fossil``, ``heroku``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4328" href="#L4328">4328</a><span class="code-text">   (:issue:`1790`), ``iex`` (:issue:`1167`), ``kitchen`` (:issue:`2000`), ``nix`` (:issue:`1167`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4329" href="#L4329">4329</a><span class="code-text">   ``node``/``npm`` (:issue:`1566`), ``opam`` (:issue:`1615`), ``setfacl`` (:issue:`1752`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4330" href="#L4330">4330</a><span class="code-text">   ``tmuxinator`` (:issue:`1863`), and ``yast2`` (:issue:`1739`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4331" href="#L4331">4331</a><span class="code-text">-  Improved completions for ``brew`` (:issue:`1090` &amp; :issue:`1810`), ``bundler``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4332" href="#L4332">4332</a><span class="code-text">   (:issue:`1779`), ``cd`` (:issue:`1135`), ``emerge`` (:issue:`1840`),\ ``git`` (:issue:`1680`, :issue:`1834` &amp;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4333" href="#L4333">4333</a><span class="code-text">   :issue:`1951`), ``man`` (:issue:`960`), ``modprobe`` (:issue:`1124`), ``pacman`` (:issue:`1292`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4334" href="#L4334">4334</a><span class="code-text">   ``rpm`` (:issue:`1236`), ``rsync`` (:issue:`1872`), ``scp`` (:issue:`1145`), ``ssh`` (:issue:`1234`),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4335" href="#L4335">4335</a><span class="code-text">   ``sshfs`` (:issue:`1268`), ``systemctl`` (:issue:`1462`, :issue:`1950` &amp; :issue:`1972`), ``tmux``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4336" href="#L4336">4336</a><span class="code-text">   (:issue:`1853`), ``vagrant`` (:issue:`1748`), ``yum`` (:issue:`1269`), and ``zypper``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4337" href="#L4337">4337</a><span class="code-text">   (:issue:`1787`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4338" href="#L4338">4338</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4339" href="#L4339">4339</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4340" href="#L4340">4340</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4341" href="#L4341">4341</a><span class="code-text">fish 2.1.2 (released Feb 24, 2015)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4342" href="#L4342">4342</a><span class="code-text">==================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4343" href="#L4343">4343</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4344" href="#L4344">4344</a><span class="code-text">fish 2.1.2 contains a workaround for a filesystem bug in Mac OS X</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4345" href="#L4345">4345</a><span class="code-text">Yosemite. :issue:`1859`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4346" href="#L4346">4346</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4347" href="#L4347">4347</a><span class="code-text">Specifically, after installing fish 2.1.1 and then rebooting, “Verify</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4348" href="#L4348">4348</a><span class="code-text">Disk” in Disk Utility will report “Invalid number of hard links.” We</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4349" href="#L4349">4349</a><span class="code-text">don’t have any reports of data loss or other adverse consequences. fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4350" href="#L4350">4350</a><span class="code-text">2.1.2 avoids triggering the bug, but does not repair an already affected</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4351" href="#L4351">4351</a><span class="code-text">filesystem. To repair the filesystem, you can boot into Recovery Mode</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4352" href="#L4352">4352</a><span class="code-text">and use Repair Disk from Disk Utility. Linux and versions of OS X prior</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4353" href="#L4353">4353</a><span class="code-text">to Yosemite are believed to be unaffected.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4354" href="#L4354">4354</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4355" href="#L4355">4355</a><span class="code-text">There are no other changes in this release.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4356" href="#L4356">4356</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4357" href="#L4357">4357</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4358" href="#L4358">4358</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4359" href="#L4359">4359</a><span class="code-text">fish 2.1.1 (released September 26, 2014)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4360" href="#L4360">4360</a><span class="code-text">========================================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4361" href="#L4361">4361</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4362" href="#L4362">4362</a><span class="code-text">**Important:** if you are upgrading, stop all running instances of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4363" href="#L4363">4363</a><span class="code-text">``fishd`` as soon as possible after installing this release; it will be</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4364" href="#L4364">4364</a><span class="code-text">restarted automatically. On most systems, there will be no further</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4365" href="#L4365">4365</a><span class="code-text">action required. Note that some environments (where ``XDG_RUNTIME_DIR``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4366" href="#L4366">4366</a><span class="code-text">is set), such as Fedora 20, will require a restart of all running fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4367" href="#L4367">4367</a><span class="code-text">processes before universal variables work as intended.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4368" href="#L4368">4368</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4369" href="#L4369">4369</a><span class="code-text">Distributors are highly encouraged to call ``killall fishd``,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4370" href="#L4370">4370</a><span class="code-text">``pkill fishd`` or similar in installation scripts, or to warn their</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4371" href="#L4371">4371</a><span class="code-text">users to do so.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4372" href="#L4372">4372</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4373" href="#L4373">4373</a><span class="code-text">Security fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4374" href="#L4374">4374</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4375" href="#L4375">4375</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4376" href="#L4376">4376</a><span class="code-text">-  The fish_config web interface now uses an authentication token to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4377" href="#L4377">4377</a><span class="code-text">   protect requests and only responds to requests from the local machine</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4378" href="#L4378">4378</a><span class="code-text">   with this token, preventing a remote code execution attack. (closing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4379" href="#L4379">4379</a><span class="code-text">   CVE-2014-2914). :issue:`1438`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4380" href="#L4380">4380</a><span class="code-text">-  ``psub`` and ``funced`` are no longer vulnerable to attacks which</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4381" href="#L4381">4381</a><span class="code-text">   allow local privilege escalation and data tampering (closing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4382" href="#L4382">4382</a><span class="code-text">   CVE-2014-2906 and CVE-2014-3856). :issue:`1437`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4383" href="#L4383">4383</a><span class="code-text">-  ``fishd`` uses a secure path for its socket, preventing a local</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4384" href="#L4384">4384</a><span class="code-text">   privilege escalation attack (closing CVE-2014-2905). :issue:`1436`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4385" href="#L4385">4385</a><span class="code-text">-  ``__fish_print_packages`` is no longer vulnerable to attacks which</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4386" href="#L4386">4386</a><span class="code-text">   would allow local privilege escalation and data tampering (closing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4387" href="#L4387">4387</a><span class="code-text">   CVE-2014-3219). :issue:`1440`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4388" href="#L4388">4388</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4389" href="#L4389">4389</a><span class="code-text">Other fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4390" href="#L4390">4390</a><span class="code-text">-----------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4391" href="#L4391">4391</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4392" href="#L4392">4392</a><span class="code-text">-  ``fishd`` now ignores SIGPIPE, fixing crashes using tools like GNU</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4393" href="#L4393">4393</a><span class="code-text">   Parallel and which occurred more often as a result of the other</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4394" href="#L4394">4394</a><span class="code-text">   ``fishd`` changes. :issue:`1084` &amp; :issue:`1690`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4395" href="#L4395">4395</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4396" href="#L4396">4396</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4397" href="#L4397">4397</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4398" href="#L4398">4398</a><span class="code-text">fish 2.1.0</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4399" href="#L4399">4399</a><span class="code-text">==========</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4400" href="#L4400">4400</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4401" href="#L4401">4401</a><span class="code-text">.. _significant-changes-5:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4402" href="#L4402">4402</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4403" href="#L4403">4403</a><span class="code-text">Significant Changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4404" href="#L4404">4404</a><span class="code-text">-------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4405" href="#L4405">4405</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4406" href="#L4406">4406</a><span class="code-text">-  **Tab completions will fuzzy-match files.** :issue:`568`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4407" href="#L4407">4407</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4408" href="#L4408">4408</a><span class="code-text">   When tab-completing a file, fish will first attempt prefix matches</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4409" href="#L4409">4409</a><span class="code-text">   (``foo`` matches ``foobar``), then substring matches (``ooba``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4410" href="#L4410">4410</a><span class="code-text">   matches ``foobar``), and lastly subsequence matches (``fbr`` matches</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4411" href="#L4411">4411</a><span class="code-text">   ``foobar``). For example, in a directory with files foo1.txt,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4412" href="#L4412">4412</a><span class="code-text">   foo2.txt, foo3.txt…, you can type only the numeric part and hit tab</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4413" href="#L4413">4413</a><span class="code-text">   to fill in the rest.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4414" href="#L4414">4414</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4415" href="#L4415">4415</a><span class="code-text">   This feature is implemented for files and executables. It is not yet</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4416" href="#L4416">4416</a><span class="code-text">   implemented for options (like ``--foobar``), and not yet implemented</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4417" href="#L4417">4417</a><span class="code-text">   across path components (like ``/u/l/b`` to match ``/usr/local/bin``).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4418" href="#L4418">4418</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4419" href="#L4419">4419</a><span class="code-text">-  **Redirections now work better across pipelines.** :issue:`110`, :issue:`877`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4420" href="#L4420">4420</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4421" href="#L4421">4421</a><span class="code-text">   In particular, you can pipe stderr and stdout together, for example,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4422" href="#L4422">4422</a><span class="code-text">   with ``cmd ^&amp;1 | tee log.txt``, or the more familiar</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4423" href="#L4423">4423</a><span class="code-text">   ``cmd 2&gt;&amp;1 | tee log.txt``.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4424" href="#L4424">4424</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4425" href="#L4425">4425</a><span class="code-text">-  **A single ``%`` now expands to the last job backgrounded.** :issue:`1008`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4426" href="#L4426">4426</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4427" href="#L4427">4427</a><span class="code-text">   Previously, a single ``%`` would pid-expand to either all</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4428" href="#L4428">4428</a><span class="code-text">   backgrounded jobs, or all jobs owned by your user. Now it expands to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4429" href="#L4429">4429</a><span class="code-text">   the last job backgrounded. If no job is in the background, it will</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4430" href="#L4430">4430</a><span class="code-text">   fail to expand. In particular, ``fg %`` can be used to put the most</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4431" href="#L4431">4431</a><span class="code-text">   recent background job in the foreground.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4432" href="#L4432">4432</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4433" href="#L4433">4433</a><span class="code-text">Other Notable Fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4434" href="#L4434">4434</a><span class="code-text">-------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4435" href="#L4435">4435</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4436" href="#L4436">4436</a><span class="code-text">-  alt-U and alt+C now uppercase and capitalize words, respectively.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4437" href="#L4437">4437</a><span class="code-text">   :issue:`995`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4438" href="#L4438">4438</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4439" href="#L4439">4439</a><span class="code-text">-  VTE based terminals should now know the working directory. :issue:`906`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4440" href="#L4440">4440</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4441" href="#L4441">4441</a><span class="code-text">-  The autotools build now works on Mavericks. :issue:`968`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4442" href="#L4442">4442</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4443" href="#L4443">4443</a><span class="code-text">-  The end-of-line binding (ctrl+E) now accepts autosuggestions. :issue:`932`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4444" href="#L4444">4444</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4445" href="#L4445">4445</a><span class="code-text">-  Directories in ``/etc/paths`` (used on OS X) are now prepended</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4446" href="#L4446">4446</a><span class="code-text">   instead of appended, similar to other shells. :issue:`927`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4447" href="#L4447">4447</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4448" href="#L4448">4448</a><span class="code-text">-  Option-right-arrow (used for partial autosuggestion completion) now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4449" href="#L4449">4449</a><span class="code-text">   works on iTerm2. :issue:`920`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4450" href="#L4450">4450</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4451" href="#L4451">4451</a><span class="code-text">-  Tab completions now work properly within nested subcommands. :issue:`913`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4452" href="#L4452">4452</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4453" href="#L4453">4453</a><span class="code-text">-  ``printf`` supports ``\e``, the escape character. :issue:`910`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4454" href="#L4454">4454</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4455" href="#L4455">4455</a><span class="code-text">-  ``fish_config history`` no longer shows duplicate items. :issue:`900`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4456" href="#L4456">4456</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4457" href="#L4457">4457</a><span class="code-text">-  ``$fish_user_paths`` is now prepended to $PATH instead of appended.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4458" href="#L4458">4458</a><span class="code-text">   :issue:`888`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4459" href="#L4459">4459</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4460" href="#L4460">4460</a><span class="code-text">-  Jobs complete when all processes complete. :issue:`876`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4461" href="#L4461">4461</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4462" href="#L4462">4462</a><span class="code-text">   For example, in previous versions of fish, ``sleep 10 | echo Done``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4463" href="#L4463">4463</a><span class="code-text">   returns control immediately, because echo does not read from stdin.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4464" href="#L4464">4464</a><span class="code-text">   Now it does not complete until sleep exits (presumably after 10</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4465" href="#L4465">4465</a><span class="code-text">   seconds).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4466" href="#L4466">4466</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4467" href="#L4467">4467</a><span class="code-text">-  Better error reporting for square brackets. :issue:`875`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4468" href="#L4468">4468</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4469" href="#L4469">4469</a><span class="code-text">-  fish no longer tries to add ``/bin`` to ``$PATH`` unless PATH is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4470" href="#L4470">4470</a><span class="code-text">   totally empty. :issue:`852`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4471" href="#L4471">4471</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4472" href="#L4472">4472</a><span class="code-text">-  History token substitution (alt-up) now works correctly inside</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4473" href="#L4473">4473</a><span class="code-text">   subshells. :issue:`833`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4474" href="#L4474">4474</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4475" href="#L4475">4475</a><span class="code-text">-  Flow control is now disabled, freeing up ctrl-S and ctrl-Q for other</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4476" href="#L4476">4476</a><span class="code-text">   uses. :issue:`814`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4477" href="#L4477">4477</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4478" href="#L4478">4478</a><span class="code-text">-  sh-style variable setting like ``foo=bar`` now produces better error</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4479" href="#L4479">4479</a><span class="code-text">   messages. :issue:`809`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4480" href="#L4480">4480</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4481" href="#L4481">4481</a><span class="code-text">-  Commands with wildcards no longer produce autosuggestions. :issue:`785`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4482" href="#L4482">4482</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4483" href="#L4483">4483</a><span class="code-text">-  funced no longer freaks out when supplied with no arguments. :issue:`780`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4484" href="#L4484">4484</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4485" href="#L4485">4485</a><span class="code-text">-  fish.app now works correctly in a directory containing spaces. :issue:`774`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4486" href="#L4486">4486</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4487" href="#L4487">4487</a><span class="code-text">-  Tab completion cycling no longer occasionally fails to repaint. :issue:`765`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4488" href="#L4488">4488</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4489" href="#L4489">4489</a><span class="code-text">-  Comments now work in eval’d strings. :issue:`684`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4490" href="#L4490">4490</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4491" href="#L4491">4491</a><span class="code-text">-  History search (up-arrow) now shows the item matching the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4492" href="#L4492">4492</a><span class="code-text">   autosuggestion, if that autosuggestion was truncated. :issue:`650`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4493" href="#L4493">4493</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4494" href="#L4494">4494</a><span class="code-text">-  Ctrl-T now transposes characters, as in other shells. :issue:`128`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4495" href="#L4495">4495</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4496" href="#L4496">4496</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4497" href="#L4497">4497</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4498" href="#L4498">4498</a><span class="code-text">fish 2.0.0</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4499" href="#L4499">4499</a><span class="code-text">==========</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4500" href="#L4500">4500</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4501" href="#L4501">4501</a><span class="code-text">.. _significant-changes-6:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4502" href="#L4502">4502</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4503" href="#L4503">4503</a><span class="code-text">Significant Changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4504" href="#L4504">4504</a><span class="code-text">-------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4505" href="#L4505">4505</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4506" href="#L4506">4506</a><span class="code-text">-  **Command substitutions now modify ``$status`` :issue:`547`.** Previously the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4507" href="#L4507">4507</a><span class="code-text">   exit status of command substitutions (like ``(pwd)``) was ignored;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4508" href="#L4508">4508</a><span class="code-text">   however now it modifies $status. Furthermore, the ``set`` command now</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4509" href="#L4509">4509</a><span class="code-text">   only sets $status on failure; it is untouched on success. This allows</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4510" href="#L4510">4510</a><span class="code-text">   for the following pattern:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4511" href="#L4511">4511</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4512" href="#L4512">4512</a><span class="code-text">   .. code:: sh</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4513" href="#L4513">4513</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4514" href="#L4514">4514</a><span class="code-text">      if set python_path (which python)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4515" href="#L4515">4515</a><span class="code-text">         ...</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4516" href="#L4516">4516</a><span class="code-text">      end</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4517" href="#L4517">4517</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4518" href="#L4518">4518</a><span class="code-text">   Because set does not modify $status on success, the if branch</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4519" href="#L4519">4519</a><span class="code-text">   effectively tests whether ``which`` succeeded, and if so, whether the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4520" href="#L4520">4520</a><span class="code-text">   ``set`` also succeeded.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4521" href="#L4521">4521</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4522" href="#L4522">4522</a><span class="code-text">-  Improvements to PATH handling. There is a new variable, fish_user_paths,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4523" href="#L4523">4523</a><span class="code-text">   which can be set universally, and whose contents are appended to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4524" href="#L4524">4524</a><span class="code-text">   $PATH :issue:`527`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4525" href="#L4525">4525</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4526" href="#L4526">4526</a><span class="code-text">   -  /etc/paths and /etc/paths.d are now respected on OS X</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4527" href="#L4527">4527</a><span class="code-text">   -  fish no longer modifies $PATH to find its own binaries</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4528" href="#L4528">4528</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4529" href="#L4529">4529</a><span class="code-text">-  **Long lines no longer use ellipsis for line breaks**, and copy and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4530" href="#L4530">4530</a><span class="code-text">   paste should no longer include a newline even if the line was broken</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4531" href="#L4531">4531</a><span class="code-text">   :issue:`300`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4532" href="#L4532">4532</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4533" href="#L4533">4533</a><span class="code-text">-  **New syntax for index ranges** (sometimes known as “slices”) :issue:`212`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4534" href="#L4534">4534</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4535" href="#L4535">4535</a><span class="code-text">-  **fish now supports an ``else if`` statement** :issue:`134`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4536" href="#L4536">4536</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4537" href="#L4537">4537</a><span class="code-text">-  **Process and pid completion now works on OS X** :issue:`129`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4538" href="#L4538">4538</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4539" href="#L4539">4539</a><span class="code-text">-  **fish is now relocatable**, and no longer depends on compiled-in</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4540" href="#L4540">4540</a><span class="code-text">   paths :issue:`125`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4541" href="#L4541">4541</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4542" href="#L4542">4542</a><span class="code-text">-  **fish now supports a right prompt (RPROMPT)** through the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4543" href="#L4543">4543</a><span class="code-text">   fish_right_prompt function :issue:`80`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4544" href="#L4544">4544</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4545" href="#L4545">4545</a><span class="code-text">-  **fish now uses posix_spawn instead of fork when possible**, which is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4546" href="#L4546">4546</a><span class="code-text">   much faster on BSD and OS X :issue:`11`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4547" href="#L4547">4547</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4548" href="#L4548">4548</a><span class="code-text">.. _other-notable-fixes-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4549" href="#L4549">4549</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4550" href="#L4550">4550</a><span class="code-text">Other Notable Fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4551" href="#L4551">4551</a><span class="code-text">-------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4552" href="#L4552">4552</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4553" href="#L4553">4553</a><span class="code-text">-  Updated VCS completions (darcs, cvs, svn, etc.)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4554" href="#L4554">4554</a><span class="code-text">-  Avoid calling getcwd on the main thread, as it can hang :issue:`696`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4555" href="#L4555">4555</a><span class="code-text">-  Control-D (forward delete) no longer stops at a period :issue:`667`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4556" href="#L4556">4556</a><span class="code-text">-  Completions for many new commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4557" href="#L4557">4557</a><span class="code-text">-  fish now respects rxvt’s unique keybindings :issue:`657`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4558" href="#L4558">4558</a><span class="code-text">-  xsel is no longer built as part of fish. It will still be invoked if</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4559" href="#L4559">4559</a><span class="code-text">   installed separately :issue:`633`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4560" href="#L4560">4560</a><span class="code-text">-  \__fish_filter_mime no longer spews :issue:`628`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4561" href="#L4561">4561</a><span class="code-text">-  The -no-execute option to fish no longer falls over when reaching the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4562" href="#L4562">4562</a><span class="code-text">   end of a block :issue:`624`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4563" href="#L4563">4563</a><span class="code-text">-  fish_config knows how to find fish even if it’s not in the $PATH :issue:`621`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4564" href="#L4564">4564</a><span class="code-text">-  A leading space now prevents writing to history, as is done in bash</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4565" href="#L4565">4565</a><span class="code-text">   and zsh :issue:`615`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4566" href="#L4566">4566</a><span class="code-text">-  Hitting enter after a backslash only goes to a new line if it is</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4567" href="#L4567">4567</a><span class="code-text">   followed by whitespace or the end of the line :issue:`613`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4568" href="#L4568">4568</a><span class="code-text">-  printf is now a builtin :issue:`611`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4569" href="#L4569">4569</a><span class="code-text">-  Event handlers should no longer fire if signals are blocked :issue:`608`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4570" href="#L4570">4570</a><span class="code-text">-  set_color is now a builtin :issue:`578`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4571" href="#L4571">4571</a><span class="code-text">-  man page completions are now located in a new generated_completions</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4572" href="#L4572">4572</a><span class="code-text">   directory, instead of your completions directory :issue:`576`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4573" href="#L4573">4573</a><span class="code-text">-  tab now clears autosuggestions :issue:`561`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4574" href="#L4574">4574</a><span class="code-text">-  tab completion from within a pair of quotes now attempts to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4575" href="#L4575">4575</a><span class="code-text">   “appropriate” the closing quote :issue:`552`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4576" href="#L4576">4576</a><span class="code-text">-  $EDITOR can now be a list: for example, ``set EDITOR gvim -f``) :issue:`541`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4577" href="#L4577">4577</a><span class="code-text">-  ``case`` bodies are now indented :issue:`530`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4578" href="#L4578">4578</a><span class="code-text">-  The profile switch ``-p`` no longer crashes :issue:`517`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4579" href="#L4579">4579</a><span class="code-text">-  You can now control-C out of ``read`` :issue:`516`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4580" href="#L4580">4580</a><span class="code-text">-  ``umask`` is now functional on OS X :issue:`515`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4581" href="#L4581">4581</a><span class="code-text">-  Avoid calling getpwnam on the main thread, as it can hang :issue:`512`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4582" href="#L4582">4582</a><span class="code-text">-  Alt-F or Alt-right-arrow (Option-F or option-right-arrow) now accepts</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4583" href="#L4583">4583</a><span class="code-text">   one word of an autosuggestion :issue:`435`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4584" href="#L4584">4584</a><span class="code-text">-  Setting fish as your login shell no longer kills OpenSUSE :issue:`367`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4585" href="#L4585">4585</a><span class="code-text">-  Backslashes now join lines, instead of creating multiple commands</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4586" href="#L4586">4586</a><span class="code-text">   :issue:`347`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4587" href="#L4587">4587</a><span class="code-text">-  echo now implements the -e flag to interpret escapes :issue:`337`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4588" href="#L4588">4588</a><span class="code-text">-  When the last token in the user’s input contains capital letters, use</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4589" href="#L4589">4589</a><span class="code-text">   its case in preference to that of the autosuggestion :issue:`335`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4590" href="#L4590">4590</a><span class="code-text">-  Descriptions now have their own muted color :issue:`279`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4591" href="#L4591">4591</a><span class="code-text">-  Wildcards beginning with a . (for example, ``ls .*``) no longer match</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4592" href="#L4592">4592</a><span class="code-text">   . and .. :issue:`270`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4593" href="#L4593">4593</a><span class="code-text">-  Recursive wildcards now handle symlink loops :issue:`268`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4594" href="#L4594">4594</a><span class="code-text">-  You can now delete history items from the fish_config web interface</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4595" href="#L4595">4595</a><span class="code-text">   :issue:`250`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4596" href="#L4596">4596</a><span class="code-text">-  The OS X build now weak links ``wcsdup`` and ``wcscasecmp`` :issue:`240`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4597" href="#L4597">4597</a><span class="code-text">-  fish now saves and restores the process group, which prevents certain</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4598" href="#L4598">4598</a><span class="code-text">   processes from being erroneously reported as stopped :issue:`197`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4599" href="#L4599">4599</a><span class="code-text">-  funced now takes an editor option :issue:`187`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4600" href="#L4600">4600</a><span class="code-text">-  Alternating row colors are available in fish pager through</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4601" href="#L4601">4601</a><span class="code-text">   ``fish_pager_color_secondary`` :issue:`186`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4602" href="#L4602">4602</a><span class="code-text">-  Universal variable values are now stored based on your MAC address,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4603" href="#L4603">4603</a><span class="code-text">   not your hostname :issue:`183`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4604" href="#L4604">4604</a><span class="code-text">-  The caret ^ now only does a stderr redirection if it is the first</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4605" href="#L4605">4605</a><span class="code-text">   character of a token, making git users happy :issue:`168`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4606" href="#L4606">4606</a><span class="code-text">-  Autosuggestions will no longer cause line wrapping :issue:`167`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4607" href="#L4607">4607</a><span class="code-text">-  Better handling of Unicode combining characters :issue:`155`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4608" href="#L4608">4608</a><span class="code-text">-  fish SIGHUPs processes more often :issue:`138`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4609" href="#L4609">4609</a><span class="code-text">-  fish no longer causes ``sudo`` to ask for a password every time</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4610" href="#L4610">4610</a><span class="code-text">-  fish behaves better under Midnight Commander :issue:`121`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4611" href="#L4611">4611</a><span class="code-text">-  ``set -e`` no longer crashes :issue:`100`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4612" href="#L4612">4612</a><span class="code-text">-  fish now will automatically import history from bash, if there is no</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4613" href="#L4613">4613</a><span class="code-text">   fish history :issue:`66`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4614" href="#L4614">4614</a><span class="code-text">-  Backslashed-newlines inside quoted strings now behave more</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4615" href="#L4615">4615</a><span class="code-text">   intuitively :issue:`52`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4616" href="#L4616">4616</a><span class="code-text">-  Tab titles should be shown correctly in iTerm2 :issue:`47`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4617" href="#L4617">4617</a><span class="code-text">-  scp remote path completion now sometimes works :issue:`42`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4618" href="#L4618">4618</a><span class="code-text">-  The ``read`` builtin no longer shows autosuggestions :issue:`29`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4619" href="#L4619">4619</a><span class="code-text">-  Custom key bindings can now be set via the ``fish_user_key_bindings``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4620" href="#L4620">4620</a><span class="code-text">   function :issue:`21`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4621" href="#L4621">4621</a><span class="code-text">-  All Python scripts now run correctly under both Python 2 and Python 3</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4622" href="#L4622">4622</a><span class="code-text">   :issue:`14`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4623" href="#L4623">4623</a><span class="code-text">-  The “accept autosuggestion” key can now be configured :issue:`19`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4624" href="#L4624">4624</a><span class="code-text">-  Autosuggestions will no longer suggest invalid commands :issue:`6`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4625" href="#L4625">4625</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4626" href="#L4626">4626</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4627" href="#L4627">4627</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4628" href="#L4628">4628</a><span class="code-text">fishfish Beta r2</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4629" href="#L4629">4629</a><span class="code-text">================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4630" href="#L4630">4630</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4631" href="#L4631">4631</a><span class="code-text">Bug Fixes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4632" href="#L4632">4632</a><span class="code-text">---------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4633" href="#L4633">4633</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4634" href="#L4634">4634</a><span class="code-text">-  **Implicit cd** is back, for paths that start with one or two dots, a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4635" href="#L4635">4635</a><span class="code-text">   slash, or a tilde.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4636" href="#L4636">4636</a><span class="code-text">-  **Overrides of default functions should be fixed.** The “internalized</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4637" href="#L4637">4637</a><span class="code-text">   scripts” feature is disabled for now.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4638" href="#L4638">4638</a><span class="code-text">-  **Disabled delayed suspend.** This is a strange job-control feature</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4639" href="#L4639">4639</a><span class="code-text">   of BSD systems, including OS X. Disabling it frees up Control Y for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4640" href="#L4640">4640</a><span class="code-text">   other purposes; in particular, for yank, which now works on OS X.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4641" href="#L4641">4641</a><span class="code-text">-  **fish_indent is fixed.** In particular, the ``funced`` and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4642" href="#L4642">4642</a><span class="code-text">   ``funcsave`` functions work again.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4643" href="#L4643">4643</a><span class="code-text">-  A SIGTERM now ends the whole execution stack again (resolving :issue:`13`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4644" href="#L4644">4644</a><span class="code-text">-  Bumped the \__fish_config_interactive version number so the default</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4645" href="#L4645">4645</a><span class="code-text">   fish_color_autosuggestion kicks in.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4646" href="#L4646">4646</a><span class="code-text">-  fish_config better handles combined term256 and classic colors like</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4647" href="#L4647">4647</a><span class="code-text">   “555 yellow”.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4648" href="#L4648">4648</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4649" href="#L4649">4649</a><span class="code-text">New Features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4650" href="#L4650">4650</a><span class="code-text">------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4651" href="#L4651">4651</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4652" href="#L4652">4652</a><span class="code-text">-  **A history builtin**, and associated interactive function that</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4653" href="#L4653">4653</a><span class="code-text">   enables deleting history items. Example usage: \* Print all history</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4654" href="#L4654">4654</a><span class="code-text">   items beginning with echo: ``history --prefix echo`` \* Print all</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4655" href="#L4655">4655</a><span class="code-text">   history items containing foo: ``history --contains foo`` \*</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4656" href="#L4656">4656</a><span class="code-text">   Interactively delete some items containing foo:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4657" href="#L4657">4657</a><span class="code-text">   ``history --delete --contains foo``</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4658" href="#L4658">4658</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4659" href="#L4659">4659</a><span class="code-text">Credit to @siteshwar for implementation. Thanks @siteshwar!</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4660" href="#L4660">4660</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4661" href="#L4661">4661</a><span class="code-text">--------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4662" href="#L4662">4662</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4663" href="#L4663">4663</a><span class="code-text">fishfish Beta r1</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4664" href="#L4664">4664</a><span class="code-text">================</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4665" href="#L4665">4665</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4666" href="#L4666">4666</a><span class="code-text">Scripting</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4667" href="#L4667">4667</a><span class="code-text">---------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4668" href="#L4668">4668</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4669" href="#L4669">4669</a><span class="code-text">-  No changes! All existing fish scripts, config files, completions,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4670" href="#L4670">4670</a><span class="code-text">   etc. from trunk should continue to work.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4671" href="#L4671">4671</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4672" href="#L4672">4672</a><span class="code-text">.. _new-features-1:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4673" href="#L4673">4673</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4674" href="#L4674">4674</a><span class="code-text">New Features</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4675" href="#L4675">4675</a><span class="code-text">------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4676" href="#L4676">4676</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4677" href="#L4677">4677</a><span class="code-text">-  **Autosuggestions**. Think URL fields in browsers. When you type a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4678" href="#L4678">4678</a><span class="code-text">   command, fish will suggest the rest of the command after the cursor,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4679" href="#L4679">4679</a><span class="code-text">   in a muted gray when possible. You can accept the suggestion with the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4680" href="#L4680">4680</a><span class="code-text">   right arrow key or Ctrl-F. Suggestions come from command history,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4681" href="#L4681">4681</a><span class="code-text">   completions, and some custom code for cd; there’s a lot of potential</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4682" href="#L4682">4682</a><span class="code-text">   for improvement here. The suggestions are computed on a background</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4683" href="#L4683">4683</a><span class="code-text">   pthread, so they never slow down your typing. The autosuggestion</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4684" href="#L4684">4684</a><span class="code-text">   feature is incredible. I miss it dearly every time I use anything</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4685" href="#L4685">4685</a><span class="code-text">   else.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4686" href="#L4686">4686</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4687" href="#L4687">4687</a><span class="code-text">-  **term256 support** where available, specifically modern xterms and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4688" href="#L4688">4688</a><span class="code-text">   OS X Lion. You can specify colors the old way (‘set_color cyan’) or</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4689" href="#L4689">4689</a><span class="code-text">   by specifying RGB hex values (‘set_color FF3333’); fish will pick the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4690" href="#L4690">4690</a><span class="code-text">   closest supported color. Some xterms do not advertise term256 support</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4691" href="#L4691">4691</a><span class="code-text">   either in the $TERM or terminfo max_colors field, but nevertheless</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4692" href="#L4692">4692</a><span class="code-text">   support it. For that reason, fish will default into using it on any</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4693" href="#L4693">4693</a><span class="code-text">   xterm (but it can be disabled with an environment variable).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4694" href="#L4694">4694</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4695" href="#L4695">4695</a><span class="code-text">-  **Web-based configuration** page. There is a new function</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4696" href="#L4696">4696</a><span class="code-text">   ‘fish_config’. This spins up a simple Python web server and opens a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4697" href="#L4697">4697</a><span class="code-text">   browser window to it. From this web page, you can set your shell</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4698" href="#L4698">4698</a><span class="code-text">   colors and view your functions, variables, and history; all changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4699" href="#L4699">4699</a><span class="code-text">   apply immediately to all running shells. Eventually all configuration</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4700" href="#L4700">4700</a><span class="code-text">   ought to be supported via this mechanism (but in addition to, not</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4701" href="#L4701">4701</a><span class="code-text">   instead of, command line mechanisms).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4702" href="#L4702">4702</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4703" href="#L4703">4703</a><span class="code-text">-  **Man page completions**. There is a new function</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4704" href="#L4704">4704</a><span class="code-text">   ‘fish_update_completions’. This function reads all the man1 files</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4705" href="#L4705">4705</a><span class="code-text">   from your manpath, removes the roff formatting, parses them to find</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4706" href="#L4706">4706</a><span class="code-text">   the commands and options, and outputs fish completions into</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4707" href="#L4707">4707</a><span class="code-text">   ~/.config/fish/completions. It won’t overwrite existing completion</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4708" href="#L4708">4708</a><span class="code-text">   files (except ones that it generated itself).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4709" href="#L4709">4709</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4710" href="#L4710">4710</a><span class="code-text">Programmatic Changes</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4711" href="#L4711">4711</a><span class="code-text">--------------------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4712" href="#L4712">4712</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4713" href="#L4713">4713</a><span class="code-text">-  fish is now entirely in C++. I have no particular love for C++, but</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4714" href="#L4714">4714</a><span class="code-text">   it provides a ready memory-model to replace halloc. We’ve made an</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4715" href="#L4715">4715</a><span class="code-text">   effort to keep it to a sane and portable subset (no C++11, no boost,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4716" href="#L4716">4716</a><span class="code-text">   no going crazy with templates or smart pointers), but we do use the</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4717" href="#L4717">4717</a><span class="code-text">   STL and a little tr1.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4718" href="#L4718">4718</a><span class="code-text">-  halloc is entirely gone, replaced by normal C++ ownership semantics.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4719" href="#L4719">4719</a><span class="code-text">   If you don’t know what halloc is, well, now you have two reasons to</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4720" href="#L4720">4720</a><span class="code-text">   be happy.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4721" href="#L4721">4721</a><span class="code-text">-  All the crufty C data structures are entirely gone. array_list_t,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4722" href="#L4722">4722</a><span class="code-text">   priority_queue_t, hash_table_t, string_buffer_t have been removed and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4723" href="#L4723">4723</a><span class="code-text">   replaced by STL equivalents like std::vector, std::map, and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4724" href="#L4724">4724</a><span class="code-text">   std::wstring. A lot of the string handling now uses std::wstring</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4725" href="#L4725">4725</a><span class="code-text">   instead of wchar_t \*</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4726" href="#L4726">4726</a><span class="code-text">-  fish now spawns pthreads for tasks like syntax highlighting that</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4727" href="#L4727">4727</a><span class="code-text">   require blocking I/O.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4728" href="#L4728">4728</a><span class="code-text">-  History has been completely rewritten. History files now use an</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4729" href="#L4729">4729</a><span class="code-text">   extensible YAML-style syntax. History “merging” (multiple shells</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4730" href="#L4730">4730</a><span class="code-text">   writing to the same history file) now works better. There is now a</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4731" href="#L4731">4731</a><span class="code-text">   maximum history length of about 250k items (256 \* 1024).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4732" href="#L4732">4732</a><span class="code-text">-  The parser has been “instanced,” so you can now create more than one.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4733" href="#L4733">4733</a><span class="code-text">-  Total #LoC has shrunk slightly even with the new features.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4734" href="#L4734">4734</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4735" href="#L4735">4735</a><span class="code-text">Performance</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4736" href="#L4736">4736</a><span class="code-text">-----------</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4737" href="#L4737">4737</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4738" href="#L4738">4738</a><span class="code-text">-  fish now runs syntax highlighting in a background thread, so typing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4739" href="#L4739">4739</a><span class="code-text">   commands is always responsive even on slow filesystems.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4740" href="#L4740">4740</a><span class="code-text">-  echo, test, and pwd are now builtins, which eliminates many forks.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4741" href="#L4741">4741</a><span class="code-text">-  The files in share/functions and share/completions now get</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4742" href="#L4742">4742</a><span class="code-text">   ‘internalized’ into C strings that get compiled in with fish. This</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4743" href="#L4743">4743</a><span class="code-text">   substantially reduces the number of files touched at startup. A</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4744" href="#L4744">4744</a><span class="code-text">   consequence is that you cannot change these functions without</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4745" href="#L4745">4745</a><span class="code-text">   recompiling, but often other functions depend on these “standard”</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4746" href="#L4746">4746</a><span class="code-text">   functions, so changing them is perhaps not a good idea anyways.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4747" href="#L4747">4747</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4748" href="#L4748">4748</a><span class="code-text">Here are some system call counts for launching and then exiting fish</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4749" href="#L4749">4749</a><span class="code-text">with the default configuration, on OS X. The first column is fish trunk,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4750" href="#L4750">4750</a><span class="code-text">the next column is with our changes, and the last column is bash for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4751" href="#L4751">4751</a><span class="code-text">comparison. This data was collected via dtrace.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4752" href="#L4752">4752</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4753" href="#L4753">4753</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4754" href="#L4754">4754</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4755" href="#L4755">4755</a><span class="code-text">   &lt;table&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4756" href="#L4756">4756</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4757" href="#L4757">4757</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4758" href="#L4758">4758</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4759" href="#L4759">4759</a><span class="code-text">   &lt;tr&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4760" href="#L4760">4760</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4761" href="#L4761">4761</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4762" href="#L4762">4762</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4763" href="#L4763">4763</a><span class="code-text">   &lt;th&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4764" href="#L4764">4764</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4765" href="#L4765">4765</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4766" href="#L4766">4766</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4767" href="#L4767">4767</a><span class="code-text">   &lt;th&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4768" href="#L4768">4768</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4769" href="#L4769">4769</a><span class="code-text">before</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4770" href="#L4770">4770</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4771" href="#L4771">4771</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4772" href="#L4772">4772</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4773" href="#L4773">4773</a><span class="code-text">   &lt;th&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4774" href="#L4774">4774</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4775" href="#L4775">4775</a><span class="code-text">after</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4776" href="#L4776">4776</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4777" href="#L4777">4777</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4778" href="#L4778">4778</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4779" href="#L4779">4779</a><span class="code-text">   &lt;th&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4780" href="#L4780">4780</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4781" href="#L4781">4781</a><span class="code-text">bash</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4782" href="#L4782">4782</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4783" href="#L4783">4783</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4784" href="#L4784">4784</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4785" href="#L4785">4785</a><span class="code-text">   &lt;tr&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4786" href="#L4786">4786</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4787" href="#L4787">4787</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4788" href="#L4788">4788</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4789" href="#L4789">4789</a><span class="code-text">   &lt;th&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4790" href="#L4790">4790</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4791" href="#L4791">4791</a><span class="code-text">open</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4792" href="#L4792">4792</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4793" href="#L4793">4793</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4794" href="#L4794">4794</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4795" href="#L4795">4795</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4796" href="#L4796">4796</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4797" href="#L4797">4797</a><span class="code-text">9</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4798" href="#L4798">4798</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4799" href="#L4799">4799</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4800" href="#L4800">4800</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4801" href="#L4801">4801</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4802" href="#L4802">4802</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4803" href="#L4803">4803</a><span class="code-text">4</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4804" href="#L4804">4804</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4805" href="#L4805">4805</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4806" href="#L4806">4806</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4807" href="#L4807">4807</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4808" href="#L4808">4808</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4809" href="#L4809">4809</a><span class="code-text">5</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4810" href="#L4810">4810</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4811" href="#L4811">4811</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4812" href="#L4812">4812</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4813" href="#L4813">4813</a><span class="code-text">   &lt;tr&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4814" href="#L4814">4814</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4815" href="#L4815">4815</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4816" href="#L4816">4816</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4817" href="#L4817">4817</a><span class="code-text">   &lt;th&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4818" href="#L4818">4818</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4819" href="#L4819">4819</a><span class="code-text">fork</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4820" href="#L4820">4820</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4821" href="#L4821">4821</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4822" href="#L4822">4822</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4823" href="#L4823">4823</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4824" href="#L4824">4824</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4825" href="#L4825">4825</a><span class="code-text">28</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4826" href="#L4826">4826</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4827" href="#L4827">4827</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4828" href="#L4828">4828</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4829" href="#L4829">4829</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4830" href="#L4830">4830</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4831" href="#L4831">4831</a><span class="code-text">14</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4832" href="#L4832">4832</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4833" href="#L4833">4833</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4834" href="#L4834">4834</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4835" href="#L4835">4835</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4836" href="#L4836">4836</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4837" href="#L4837">4837</a><span class="code-text">0</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4838" href="#L4838">4838</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4839" href="#L4839">4839</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4840" href="#L4840">4840</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4841" href="#L4841">4841</a><span class="code-text">   &lt;tr&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4842" href="#L4842">4842</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4843" href="#L4843">4843</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4844" href="#L4844">4844</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4845" href="#L4845">4845</a><span class="code-text">   &lt;th&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4846" href="#L4846">4846</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4847" href="#L4847">4847</a><span class="code-text">stat</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4848" href="#L4848">4848</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4849" href="#L4849">4849</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4850" href="#L4850">4850</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4851" href="#L4851">4851</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4852" href="#L4852">4852</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4853" href="#L4853">4853</a><span class="code-text">131</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4854" href="#L4854">4854</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4855" href="#L4855">4855</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4856" href="#L4856">4856</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4857" href="#L4857">4857</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4858" href="#L4858">4858</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4859" href="#L4859">4859</a><span class="code-text">85</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4860" href="#L4860">4860</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4861" href="#L4861">4861</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4862" href="#L4862">4862</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4863" href="#L4863">4863</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4864" href="#L4864">4864</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4865" href="#L4865">4865</a><span class="code-text">11</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4866" href="#L4866">4866</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4867" href="#L4867">4867</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4868" href="#L4868">4868</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4869" href="#L4869">4869</a><span class="code-text">   &lt;tr&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4870" href="#L4870">4870</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4871" href="#L4871">4871</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4872" href="#L4872">4872</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4873" href="#L4873">4873</a><span class="code-text">   &lt;th&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4874" href="#L4874">4874</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4875" href="#L4875">4875</a><span class="code-text">lstat</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4876" href="#L4876">4876</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4877" href="#L4877">4877</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4878" href="#L4878">4878</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4879" href="#L4879">4879</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4880" href="#L4880">4880</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4881" href="#L4881">4881</a><span class="code-text">670</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4882" href="#L4882">4882</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4883" href="#L4883">4883</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4884" href="#L4884">4884</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4885" href="#L4885">4885</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4886" href="#L4886">4886</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4887" href="#L4887">4887</a><span class="code-text">0</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4888" href="#L4888">4888</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4889" href="#L4889">4889</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4890" href="#L4890">4890</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4891" href="#L4891">4891</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4892" href="#L4892">4892</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4893" href="#L4893">4893</a><span class="code-text">0</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4894" href="#L4894">4894</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4895" href="#L4895">4895</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4896" href="#L4896">4896</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4897" href="#L4897">4897</a><span class="code-text">   &lt;tr&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4898" href="#L4898">4898</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4899" href="#L4899">4899</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4900" href="#L4900">4900</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4901" href="#L4901">4901</a><span class="code-text">   &lt;th&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4902" href="#L4902">4902</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4903" href="#L4903">4903</a><span class="code-text">read</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4904" href="#L4904">4904</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4905" href="#L4905">4905</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4906" href="#L4906">4906</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4907" href="#L4907">4907</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4908" href="#L4908">4908</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4909" href="#L4909">4909</a><span class="code-text">332</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4910" href="#L4910">4910</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4911" href="#L4911">4911</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4912" href="#L4912">4912</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4913" href="#L4913">4913</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4914" href="#L4914">4914</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4915" href="#L4915">4915</a><span class="code-text">80</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4916" href="#L4916">4916</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4917" href="#L4917">4917</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4918" href="#L4918">4918</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4919" href="#L4919">4919</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4920" href="#L4920">4920</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4921" href="#L4921">4921</a><span class="code-text">4</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4922" href="#L4922">4922</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4923" href="#L4923">4923</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4924" href="#L4924">4924</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4925" href="#L4925">4925</a><span class="code-text">   &lt;tr&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4926" href="#L4926">4926</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4927" href="#L4927">4927</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4928" href="#L4928">4928</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4929" href="#L4929">4929</a><span class="code-text">   &lt;th&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4930" href="#L4930">4930</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4931" href="#L4931">4931</a><span class="code-text">write</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4932" href="#L4932">4932</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4933" href="#L4933">4933</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4934" href="#L4934">4934</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4935" href="#L4935">4935</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4936" href="#L4936">4936</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4937" href="#L4937">4937</a><span class="code-text">172</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4938" href="#L4938">4938</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4939" href="#L4939">4939</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4940" href="#L4940">4940</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4941" href="#L4941">4941</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4942" href="#L4942">4942</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4943" href="#L4943">4943</a><span class="code-text">149</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4944" href="#L4944">4944</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4945" href="#L4945">4945</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4946" href="#L4946">4946</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4947" href="#L4947">4947</a><span class="code-text">   &lt;td&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4948" href="#L4948">4948</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4949" href="#L4949">4949</a><span class="code-text">0</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4950" href="#L4950">4950</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4951" href="#L4951">4951</a><span class="code-text">.. raw:: html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4952" href="#L4952">4952</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4953" href="#L4953">4953</a><span class="code-text">   &lt;/table&gt;</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4954" href="#L4954">4954</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4955" href="#L4955">4955</a><span class="code-text">The large number of forks relative to bash are due to fish’s insanely</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4956" href="#L4956">4956</a><span class="code-text">expensive default prompt, which is unchanged in my version. If we switch</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4957" href="#L4957">4957</a><span class="code-text">to a prompt comparable to bash’s (lame) default, the forks drop to 16</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4958" href="#L4958">4958</a><span class="code-text">with trunk, 4 after our changes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4959" href="#L4959">4959</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4960" href="#L4960">4960</a><span class="code-text">The large reduction in lstat() numbers is due to fish no longer needing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4961" href="#L4961">4961</a><span class="code-text">to call ttyname() on OS X.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4962" href="#L4962">4962</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4963" href="#L4963">4963</a><span class="code-text">We’ve got some work to do to be as lean as bash, but we’re on the right</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4964" href="#L4964">4964</a><span class="code-text">track.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4965" href="#L4965">4965</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4966" href="#L4966">4966</a><span class="code-text">.. vim: ft=rst : tw=0 :</span></span></pre>
</main>
</body>
</html>
