mirror of
https://github.com/fish-shell/fish-shell
synced 2024-11-14 00:47:30 +00:00
2824 lines
128 KiB
ReStructuredText
2824 lines
128 KiB
ReStructuredText
fish 3.2.0 (released ???)
|
||
=========================
|
||
|
||
Notable improvements and fixes
|
||
------------------------------
|
||
|
||
- 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+/.
|
||
- builtins may 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.
|
||
This makes it usable also for pipes where the previous command hasn't finished yet, like::
|
||
|
||
# Show all dmesg lines related to "usb"
|
||
dmesg -w | string match '*usb*'
|
||
|
||
- Prompts whose width exceeds $COLUMNS will now be truncated instead of replaced with `"> "` (:issue:`904`).
|
||
- When pressing Tab, fish displays ambiguous completions even when they
|
||
have a common prefix, without the user having to press Tab again
|
||
(:issue:`6924`).
|
||
- fish is less aggressive about resetting terminal modes, such as flow control, after every command.
|
||
Although flow control remains off by default, enterprising users can now enable it for external commands with
|
||
``stty`` (:issue:`2315`).
|
||
- A new ``fish_add_path`` helper function to add paths to $PATH without producing duplicates, to be used interactively or in ``config.fish`` (:issue:`6960`).
|
||
For example::
|
||
|
||
fish_add_path /opt/mycoolthing/bin
|
||
|
||
will add /opt/mycoolthing/bin to the beginning of $fish_user_path without creating duplicates,
|
||
so it can be called again and again from config.fish or just once interactively, and the path will just be there, once.
|
||
- The ``test`` builtin now better shows where an error occured (:issue:`6030`)::
|
||
|
||
> test 1 = 2 and echo true or false
|
||
test: Expected a combining operator like '-a' at index 4
|
||
1 = 2 and echo true or echo false
|
||
^
|
||
|
||
- The documentation (:issue:`6500`, :issue:`7371`) and ``fish_config`` (:issue:`7523`) received a new theme, matching the design on fishshell.com.
|
||
- ``fish --no-execute`` will no longer complain about unknown commands
|
||
or non-matching wildcards, as these could be defined differently at
|
||
runtime (especially for functions). This makes it usable as a static syntax checker (:issue:`977`).
|
||
- ``type`` is now a builtin and therefore much faster (:issue:`7342`).
|
||
- ``string match --regex`` now imports named PCRE2 capture groups as fish variables (:issue:`7459`). Note: Because of this, it can no longer be wrapped in a function and the name has been added as a reserved word.
|
||
- Globs and other expansions are limited to 512k results (:issue:`7226`). Because operating systems limit arguments to ARG_MAX, larger values are unlikely to work anyway, and this helps to avoid hangs.
|
||
- 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' cwd-introspection hack to work (:issue:`5699`).
|
||
|
||
Syntax changes and new commands
|
||
-------------------------------
|
||
- 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.
|
||
- Logical operators ``&&`` and ``||`` can be followed by newlines before their right operand, matching POSIX shells.
|
||
|
||
Scripting improvements
|
||
----------------------
|
||
- ``set`` and backgrounded jobs no longer overwrite ``$pipestatus`` (:issue:`6820`), improving its use in command substitutions (:issue:`6998`).
|
||
- ``fish_preexec`` and ``fish_postexec`` events are no longer triggered for empty commands (:issue:`4829`).
|
||
- 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`).
|
||
- A new subcommand, ``string pad``, allows extending strings to a given width (:issue:`7340`).
|
||
- ``string sub`` has a new ``--end`` option to specify the end index of
|
||
a substring (:issue:`6765`).
|
||
- ``string split`` has a new ``--fields`` option to specify fields to
|
||
output, similar to ``cut -f`` (:issue:`6770`).
|
||
- ``printf`` no longer prints an error if not given an argument (not
|
||
even a format string)
|
||
- The ``true`` and ``false`` builtins ignore any arguments, like other shells (:issue:`7030`).
|
||
- Computed ("electric") variables such as ``status`` are now only global in scope, so ``set -Uq status`` returns false (:issue:`7032`).
|
||
- The output for ``set --show`` has been shortened, only mentioning the scopes in which a variable exists (:issue:`6944`).
|
||
- A new ``fish_posterror`` event is emitted when attempting to execute a command with syntax errors (:issue:`6880`).
|
||
- ``fish_indent`` now removes spurious quotes in simple cases (:issue:`6722`)
|
||
and learned a ``--check`` option to just check if a file is indented correctly (:issue:`7251`).
|
||
- ``pushd`` only adds a directory to the stack if changing to it was successful (:issue:`6947`).
|
||
- A new ``fish_job_summary`` function is called whenever a
|
||
background job stops or ends, or any job terminates from a signal (:issue:`6959`).
|
||
The default behaviour can now be customized by redefining it.
|
||
- The ``fish_prompt`` event no longer fires when ``read`` is used. If
|
||
you need a function to run any time ``read`` is invoked by a script,
|
||
use the new ``fish_read`` event instead (:issue:`7039`).
|
||
- ``status`` gained new ``dirname`` and ``basename`` convenience subcommands
|
||
to get just the directory to the running script or the name of it,
|
||
to simplify common tasks such as running ``(dirname (status filename))`` (:issue:`7076`).
|
||
- The ``_`` gettext function is now implemented as a builtin for performance purposes (:issue:`7036`).
|
||
- Broken pipelines are now handled more smoothly; in particular, bad redirection mid-pipeline
|
||
results in the job continuing to run but with the broken file descriptor replaced with a closed
|
||
file descriptor. This allows better error recovery and is more in line with other shells'
|
||
behaviour (:issue:`7038`).
|
||
- ``jobs --quiet PID`` no longer prints "no suitable job" if the job for PID does not exist (eg because it has finished) (:issue:`6809`).
|
||
- All builtins that query if something exists now take ``--query`` as the long form for ``-q``. ``--quiet`` is deprecated for ``command``, ``jobs`` and ``type`` (:issue:`7276`).
|
||
- ``argparse`` now only prints a backtrace with invalid options to argparse itself (:issue:`6703`).
|
||
- ``complete`` takes the first argument as the name of the command if the ``--command``/``-c`` option is not used (``complete git`` is treated like ``complete --command git``), and can show the loaded completions for specific commands with ``complete COMMANDNAME`` (:issue:`7321`).
|
||
- ``set_color -b`` (without an argument) no longer prints an error message, matching other invalid invocations of this command (:issue:`7154`).
|
||
- Functions triggered by the ``fish_exit`` event are correctly run when the terminal is closed or the shell receives SIGHUP (:issue:`7014`).
|
||
- ``string replace`` no longer errors if a capturing group wasn't matched, instead treating it as empty (:issue:`7343`).
|
||
- ``exec`` no longer produces a syntax error when the command cannot be found (:issue:`6098`).
|
||
- ``disown`` should no longer create zombie processes when job control is off, such as in ``config.fish`` (:issue:`7183`).
|
||
- Using ``read --silent`` while fish is in private mode was adding these potentially-sensitive entries to the history; this has been fixed (:issue:`7230`).
|
||
- ``set --erase`` and ``abbr --erase`` can now erase multiple things in one go, matching ``functions --erase`` (:issue:`7377`).
|
||
- ``abbr --erase`` no longer errors on an unset abbreviation (:issue:`7376`).
|
||
- ``test -t``, for testing whether file descriptors are connected to a terminal, works for file descriptors 0, 1, and 2 (:issue:`4766`). It can still return incorrect results in other cases (:issue:`1228`).
|
||
- Trying to run scripts with Windows line endings (CRLF) via the shebang produces a sensible error (:issue:`2783`).
|
||
- An ``alias`` that delegates to a command with the same name no longer triggers an error about recursive completion (:issue:`7389`).
|
||
- ``math`` now has a ``--base`` option to output the result in hexadecimal or octal (:issue:`7496`).
|
||
- ``string`` subcommands now quit early when used with ``--quiet`` (:issue:`7495`).
|
||
- Failed redirections will now set ``$status`` (:issue:`7540`).
|
||
|
||
Interactive improvements
|
||
------------------------
|
||
|
||
- Control-C no longer kills background jobs for which job control is
|
||
disabled, matching POSIX semantics (:issue:`6828`).
|
||
- The prompt is reprinted after a background job exits (:issue:`1018`).
|
||
- fish no longer inserts a space after a completion ending in ``.`` or
|
||
``,`` is accepted (:issue:`6928`).
|
||
- If a filename is invalid when first pressing Tab, but becomes valid, it will be completed properly on the next attempt (:issue:`6863`).
|
||
- ``help string match/replace/<subcommand>`` will show the help for string subcommands (:issue:`6786`).
|
||
- ``fish_key_reader`` sets the exit status to 0 when used with ``--help`` or ``--version`` (:issue:`6964`).
|
||
- ``fish_key_reader`` and ``fish_indent`` send output from ``--version`` to standard output, matching other fish binaries (:issue:`6964`).
|
||
- A new variable ``$status_generation`` is incremented only when the previous command produces a 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.
|
||
- ``fish_greeting`` is now a function that reads a variable of the same name, and defaults to setting it globally. This removes a universal variable by default and helps with updating the greeting. 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`).
|
||
- Events are properly emitted after a job is cancelled (:issue:`2356`).
|
||
- 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.
|
||
- The enabled debug categories are now printed on shell startup (:issue:`7007`).
|
||
- The ``-o`` short option to fish, for ``--debug-output``, works correctly instead of producing an
|
||
invalid option error (:issue:`7254`).
|
||
- Abbreviations are now expanded after all command terminators (eg ``;`` or ``|``), not just space, as in fish 2.7.1 and before (:issue:`6970`), and after closing a command substitution (:issue:`6658`).
|
||
- The history file is now created with user-private permissions,
|
||
matching other shells (:issue:`6926`). The directory containing the history
|
||
file was already private, so there should not have been any private data
|
||
revealed.
|
||
- The output of ``time`` is now properly aligned in all cases (:issue:`6726`).
|
||
- The ``pwd`` command supports the long options ``--logical`` and ``--physical``, matching other implementations (:issue:`6787`).
|
||
- The command-not-found handling has been simplified. When it can't find a command, fish now just executes a function called ``fish_command_not_found`` instead of firing an event, making it easier to replace and reason about. Shims for backwards-compatibility have been added (:issue:`7293`).
|
||
- Control-C no longer occasionally prints an "unknown command" error (:issue:`7145`).
|
||
- Autocompletions work properly after Control-C to cancel the commmand line (:issue:`6937`).
|
||
- History search is now case-insensitive unless the search string contains an uppercase character (:issue:`7273`).
|
||
- ``fish_update_completions`` has a new ``-keep`` option, which improves speed by skipping completions that already exist (:issue:`6775`).
|
||
- Aliases containing an embedded backslash appear properly in the output of ``alias`` (:issue:`6910`).
|
||
- ``open`` no longer hangs indefinitely as a bug in ``xdg-open`` has been worked around (:issue:`7215`).
|
||
- Long command lines no longer add a blank line after execution (:issue:`6826`) and behave better with backspace (:issue:`6951`).
|
||
- ``functions -t`` works like the long option ``--handlers-type``, as documented, instead of producing an error (:issue:`6985`).
|
||
- History search now flashes when it found no more results (:issue:`7362`)
|
||
- Fish's debugging can now also be enabled via $FISH_DEBUG and $FISH_DEBUG_OUTPUT from the outside. This helps with debugging when no commandline options can be passed, like when fish is called in a shebang (:issue:`7359`).
|
||
- Fish now creates $XDG_RUNTIME_DIR if it does not exist (:issue:`7335`).
|
||
- ``set_color --print-colors`` now also respects the bold, dim, underline, reverse, italic and background modifiers, to better show their effect (:issue:`7314`).
|
||
- 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`).
|
||
- ``funcsave`` has a new ``--directory`` option to specify the location of the saved function (:issue:`7041`).
|
||
- ``help`` works properly on MSYS2 (:issue:`7113`).
|
||
- Resuming a piped job by its number, like ``fg %1`` has been fixed (:issue:`7406`).
|
||
- Commands run from key bindings now use the same tty modes as normal commands (:issue:`7483`).
|
||
- Autosuggestions from history are now case-sensitive, and tab completions are "smartcase": they offer case-insensitive matches if the input string is lowercase (:issue:`3978`).
|
||
|
||
New or improved bindings
|
||
^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
- As mentioned above, new readline commands ``undo`` (Control+\_ or Control+Z) and ``redo`` (Alt-/) can be used to revert changes to the command line or the pager search field (:issue:`6570`).
|
||
- Control-Z is now available for binding (:issue:`7152`).
|
||
- Additionally, using the ``cancel`` readline command (bound to escape by default) right after fish picked an unambiguous completion will undo that (:issue:`7433`).
|
||
- Vi mode bindings now support ``dh``, ``dl``, ``c0``, ``cf``, ``ct``, ``cF``, ``cT``, ``ch``, ``cl``, ``y0``, ``ci``, ``ca``, ``yi``, ``ya``, ``di``, ``da``, ``o``, ``O`` and Control+left/right keys to navigate by word (:issue:`6648`, :issue:`6755`, :issue:`6769`, :issue:`7442`).
|
||
- Vi mode bindings support ``~`` (tilde) to toggle the case of the selected character (:issue:`6908`).
|
||
- Functions ``up-or-search`` and ``down-or-search`` (up-arrow and down-arrow) can cross empty lines and don't activate search mode if the search fails which makes it easier to use them to move between lines in some situations.
|
||
- The readline command ``beginning-of-history`` (Page Up) now moves to the oldest search instead of the youngest - that's ``end-of-history`` (Page Down).
|
||
- A new readline command ``forward-single-char`` moves one character to the right, and if an autosuggestion is available, only take a single character from it (:issue:`7217`).
|
||
- Readline commands can now be joined with ``or`` as a modifier (adding to ``and``), though only some commands report success or failure (:issue:`7217`).
|
||
- A new function ``__fish_preview_current_file``, bound to Alt+O, opens the
|
||
current file at the cursor in a pager (:issue:`6838`).
|
||
- ``edit_command_buffer`` (Alt-E and Alt-V) passes the cursor position
|
||
to the external editor if the editor is recognized (:issue:`6138`, :issue:`6954`).
|
||
- ``__fish_prepend_sudo`` (Alt-S) now toggles a ``sudo`` prefix (:issue:`7012`) and avoids shifting the cursor (:issue:`6542`).
|
||
- ``__fish_prepend_sudo`` (Alt-S) now uses the previous commandline if the current one is empty,
|
||
to simplify rerunning the previous command with ``sudo`` (:issue:`7079`).
|
||
- ``__fish_toggle_comment_commandline`` (Alt-#) now uncomments and presents the last comment
|
||
from history if the commandline is empty (:issue:`7137`).
|
||
- ``__fish_whatis_current_token`` (Alt-W) prints descriptions for functions and builtins (:issue:`7191`).
|
||
- The definition of "word" and "bigword" for movements was refined, fixing e.g. vi mode's behavior with ``e`` on the second-to-last char, and bigword's behavior with single-char words and non-blank non-graphic characters (:issue:`7353`, :issue:`7354`, :issue:`4025`, :issue:`7328`, :issue:`7325`)
|
||
|
||
|
||
Improved prompts
|
||
^^^^^^^^^^^^^^^^
|
||
|
||
- The default and example prompts print the correct exit status for
|
||
commands prefixed with ``not`` (:issue:`6566`).
|
||
- git prompts include all untracked files in the repository, not just those in the current
|
||
directory (:issue:`6086`).
|
||
- The git prompts correctly show stash states (:issue:`6876`, :issue:`7136`).
|
||
- The Mercurial prompt correctly shows untracked status (:issue:`6906`).
|
||
- The ``fish_vcs_prompt`` passes its arguments to the various VCS prompts that it calls (:issue:`7033`).
|
||
- The Subversion prompt was broken in a number of ways in 3.1.0 and has been restored (:issue:`7278`).
|
||
- A new helper function ``fish_is_root_user`` simplifies checking for superuser privilege (:issue:`7031`).
|
||
|
||
Improved terminal support
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
- A new variable, ``$fish_vi_force_cursor``, can be set to force ``fish_vi_cursor`` to attempt changing the cursor
|
||
shape in vi mode, regardless of terminal (:issue:`6968`). The ``fish_vi_cursor`` option ``--force-iterm`` has been deprecated.
|
||
- ``diff`` will now colourise output, if supported (:issue:`7308`).
|
||
- Autosuggestions now show up also when the cursor passes the right
|
||
prompt (:issue:`6948`) or wraps to the next line (:issue:`7213`).
|
||
- The cursor shape in Vi mode changes properly in Windows Terminal (:issue:`6999`).
|
||
- The spurious warning about terminal size in small terminals has been removed (:issue:`6980`).
|
||
- Dynamic titles are now enabled in Alacritty (:issue:`7073`).
|
||
- Current working directory updates are enabled in foot (:issue:`7099`).
|
||
- The width computation for certain emoji agrees better with terminals. In particular, flags now have width 2. (:issue:`7237`).
|
||
- An issue producing strange status output from commands involving ``not`` has been fixed (:issue:`6566`).
|
||
- Long command lines are wrapped in all cases, instead of sometimes being put on a new line (:issue:`5118`).
|
||
- The pager is properly rendered with long command lines selected (:issue:`2557`).
|
||
- Fish no longer performs its own resizing in VTE-based terminals, as they perform their own reflowing, which clashes especially with right prompts (:issue:`7491`).
|
||
|
||
Completions
|
||
^^^^^^^^^^^
|
||
|
||
- Added completions for
|
||
|
||
- ``7z``, ``7za`` and ``7zr`` (:issue:`7220`)
|
||
- ``alias`` (:issue:`7035`)
|
||
- ``apk`` (:issue:`7108`)
|
||
- ``asciidoctor`` (:issue:`7000`)
|
||
- ``cmark`` (:issue:`7000`)
|
||
- ``create_ap`` (:issue:`7096`)
|
||
- ``deno`` (:issue:`7138`)
|
||
- ``dhclient``
|
||
- Postgres-related commands ``dropdb``, ``createdb``, ``pg_restore``, ``pg_dump`` and
|
||
``pg_dumpall`` (:issue:`6620`)
|
||
- ``dotnet`` (:issue:`7558`)
|
||
- ``downgrade`` (:issue:`6751`)
|
||
- ``gapplication``, ``gdbus``, ``gio`` and ``gresource`` (:issue:`7300`)
|
||
- ``gh`` (:issue:`7112`)
|
||
- ``gitk``
|
||
- ``hikari`` (:issue:`7083`)
|
||
- ``imv`` (:issue:`6675`)
|
||
- ``julia`` (:issue:`7468`)
|
||
- ``k3d`` (:issue:`7202`)
|
||
- ``micro`` (:issue:`7339`)
|
||
- ``mpc`` (:issue:`7169`)
|
||
- Metasploit's ``msfconsole``, ``msfdb`` and ``msfvenom`` (:issue:`6930`)
|
||
- ``ncat``, ``nc.openbsd`` and ``nc.traditional`` (:issue:`6873`)
|
||
- ``nmap`` (:issue:`6873`)
|
||
- ``prime-run`` (:issue:`7241`)
|
||
- ``ps2pdf{12,13,14,wr}`` (:issue:`6673`)
|
||
- ``pyenv`` (:issue:`6551`)
|
||
- ``rst2html``, ``rst2html4``, ``rst2html5``, ``rst2latex``,
|
||
``rst2man``, ``rst2odt``, ``rst2pseudoxml``, ``rst2s5``,
|
||
``rst2xetex``, ``rst2xml`` and ``rstpep2html`` (:issue:`7019`)
|
||
- ``spago`` (:issue:`7381`)
|
||
- ``sphinx-apidoc``, ``sphinx-autogen``, ``sphinx-build`` and
|
||
``sphinx-quickstart`` (:issue:`7000`)
|
||
- ``strace`` (:issue:`6656`)
|
||
- ``tcpdump`` (:issue:`6690`)
|
||
- ``tig``
|
||
- ``windscribe`` (:issue:`6788`)
|
||
- ``wireshark``, ``tshark``, and ``dumpcap``
|
||
- ``xbps-*`` (:issue:`7239`)
|
||
- ``xxhsum``, ``xxh32sum``, ``xxh64sum`` and ``xxh128sum`` (:issue:`7103`)
|
||
- ``yadm`` (:issue:`7100`)
|
||
- ``zopfli`` and ``zopflipng``
|
||
|
||
- Lots of improvements to completions.
|
||
- Improvements to the manpage completion generator (:issue:`7086`).
|
||
- Significant performance improvements to completion of the available commands (:issue:`7153`).
|
||
- ``__fish_complete_suffix`` completes any file but sorts files with matching suffix first (:issue:`7040`). Previously, it only completed files with matching suffix.
|
||
|
||
Deprecations and removed features
|
||
---------------------------------
|
||
- fish no longer attempts to modify the terminal size via `TIOCSWINSZ` (:issue:`6994`).
|
||
- The `fish_color_match` variable is no longer used. (Previously this controlled the color of matching quotes and parens when using `read`).
|
||
- fish 3.2.0 will be the last release in which the redirection to standard error with the ``^`` character is enabled. The ``stderr-nocaret`` feature flag will be changed to "on" in future releases.
|
||
|
||
For distributors and developers
|
||
-------------------------------
|
||
|
||
- fish source tarballs are now distributed using the XZ compression
|
||
method (:issue:`5460`).
|
||
- The CMake variable ``MAC_CODESIGN_ID`` can now be set to "off" to disable code-signing (:issue:`6952`).
|
||
- Building on on macOS earlier than 10.13.6 succeeds, instead of failing on code-signing (:issue:`6791`).
|
||
- The pkg-config file now uses variables to ensure paths used are portable across prefixes.
|
||
- The default values for the ``extra_completionsdir``, ``extra_functionsdir``
|
||
and ``extra_confdir`` options now use the installation prefix rather than ``/usr/local``.
|
||
- A new CMake variable ``FISH_USE_SYSTEM_PCRE2`` controls whether fish
|
||
builds with the system-installed PCRE2, or the version it bundles. By
|
||
default it prefers the system library if available, unless Mac
|
||
codesigning is enabled (:issue:`6952`).
|
||
- Running the full interactive test suite now requires Python 3.5+ and the pexpect package (:issue:`6825`); the expect package is no longer required.
|
||
- 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`).
|
||
- The webconfig tool no longer requires python's distutils (:issue:`7514`)
|
||
|
||
--------------
|
||
|
||
fish 3.1.2 (released April 29, 2020)
|
||
====================================
|
||
|
||
This release of fish fixes a major issue discovered in fish 3.1.1:
|
||
|
||
- Commands such as ``fzf`` and ``enhancd``, when used with ``eval``,
|
||
would hang. ``eval`` buffered output too aggressively, which has been
|
||
fixed (:issue:`6955`).
|
||
|
||
If you are upgrading from version 3.0.0 or before, please also review
|
||
the release notes for 3.1.1, 3.1.0 and 3.1b1 (included below).
|
||
|
||
--------------
|
||
|
||
fish 3.1.1 (released April 27, 2020)
|
||
====================================
|
||
|
||
This release of fish fixes a number of major issues discovered in fish
|
||
3.1.0.
|
||
|
||
- Commands which involve ``. ( ... | psub)`` now work correctly, as a
|
||
bug in the ``function --on-job-exit`` option has been fixed (:issue:`6613`).
|
||
- Conflicts between upstream packages for ripgrep and bat, and the fish
|
||
packages, have been resolved (:issue:`5822`).
|
||
- Starting fish in a directory without read access, such as via ``su``,
|
||
no longer crashes (:issue:`6597`).
|
||
- Glob ordering changes which were introduced in 3.1.0 have been
|
||
reverted, returning the order of globs to the previous state (:issue:`6593`).
|
||
- Redirections using the deprecated caret syntax to a file descriptor
|
||
(eg ``^&2``) work correctly (:issue:`6591`).
|
||
- Redirections that append to a file descriptor (eg ``2>>&1``) work
|
||
correctly (:issue:`6614`).
|
||
- Building fish on macOS (:issue:`6602`) or with new versions of GCC (:issue:`6604`,
|
||
:issue:`6609`) is now successful.
|
||
- ``time`` is now correctly listed in the output of ``builtin -n``, and
|
||
``time --help`` works correctly (:issue:`6598`).
|
||
- Exported universal variables now update properly (:issue:`6612`).
|
||
- ``status current-command`` gives the expected output when used with
|
||
an environment override - that is, ``F=B status current-command``
|
||
returns ``status`` instead of ``F=B`` (:issue:`6635`).
|
||
- ``test`` no longer crashes when used with “``nan``” or “``inf``”
|
||
arguments, erroring out instead (:issue:`6655`).
|
||
- Copying from the end of the command line no longer crashes fish
|
||
(:issue:`6680`).
|
||
- ``read`` no longer removes multiple separators when splitting a
|
||
variable into a list, restoring the previous behaviour from fish 3.0
|
||
and before (:issue:`6650`).
|
||
- Functions using ``--on-job-exit`` and ``--on-process-exit`` work
|
||
reliably again (:issue:`6679`).
|
||
- Functions using ``--on-signal INT`` work reliably in interactive
|
||
sessions, as they did in fish 2.7 and before (:issue:`6649`). These handlers
|
||
have never worked in non-interactive sessions, and making them work
|
||
is an ongoing process.
|
||
- Functions using ``--on-variable`` work reliably with variables which
|
||
are set implicitly (rather than with ``set``), such as
|
||
“``fish_bind_mode``” and “``PWD``” (:issue:`6653`).
|
||
- 256 colors are properly enabled under certain conditions that were
|
||
incorrectly detected in fish 3.1.0 (``$TERM`` begins with xterm, does
|
||
not include “``256color``”, and ``$TERM_PROGRAM`` is not set)
|
||
(:issue:`6701`).
|
||
- The Mercurial (``hg``) prompt no longer produces an error when the
|
||
current working directory is removed (:issue:`6699`). Also, for performance
|
||
reasons it shows only basic information by default; to restore the
|
||
detailed status, set ``$fish_prompt_hg_show_informative_status``.
|
||
- The VCS prompt, ``fish_vcs_prompt``, no longer displays Subversion
|
||
(``svn``) status by default, due to the potential slowness of this
|
||
operation (:issue:`6681`).
|
||
- Pasting of commands has been sped up (:issue:`6713`).
|
||
- Using extended Unicode characters, such as emoji, in a non-Unicode
|
||
capable locale (such as the ``C`` or ``POSIX`` locale) no longer
|
||
renders all output blank (:issue:`6736`).
|
||
- ``help`` prefers to use ``xdg-open``, avoiding the use of ``open`` on
|
||
Debian systems where this command is actually ``openvt`` (:issue:`6739`).
|
||
- Command lines starting with a space, which are not saved in history,
|
||
now do not get autosuggestions. This fixes an issue with Midnight
|
||
Commander integration (:issue:`6763`), but may be changed in a future
|
||
version.
|
||
- Copying to the clipboard no longer inserts a newline at the end of
|
||
the content, matching fish 2.7 and earlier (:issue:`6927`).
|
||
- ``fzf`` in complex pipes no longer hangs. More generally, code run as
|
||
part of command substitutions or ``eval`` will no longer have
|
||
separate process groups. (:issue:`6624`, :issue:`6806`).
|
||
|
||
This release also includes:
|
||
|
||
- several changes to improve macOS compatibility with code signing
|
||
and notarization;
|
||
- several improvements to completions; and
|
||
- several content and formatting improvements to the documentation.
|
||
|
||
If you are upgrading from version 3.0.0 or before, please also review
|
||
the release notes for 3.1.0 and 3.1b1 (included below).
|
||
|
||
Errata for fish 3.1
|
||
-------------------
|
||
|
||
A new builtin, ``time``, was introduced in the fish 3.1 releases. This
|
||
builtin is a reserved word (like ``test``, ``function``, and others)
|
||
because of the way it is implemented, and functions can no longer be
|
||
named ``time``. This was not clear in the fish 3.1b1 changelog.
|
||
|
||
--------------
|
||
|
||
fish 3.1.0 (released February 12, 2020)
|
||
=======================================
|
||
|
||
Compared to the beta release of fish 3.1b1, fish version 3.1.0:
|
||
|
||
- Fixes a regression where spaces after a brace were removed despite
|
||
brace expansion not occurring (:issue:`6564`).
|
||
- Fixes a number of problems in compiling and testing on Cygwin
|
||
(:issue:`6549`) and Solaris-derived systems such as Illumos (:issue:`6553`, :issue:`6554`,
|
||
:issue:`6555`, :issue:`6556`, and :issue:`6558`).
|
||
- Fixes the process for building macOS packages.
|
||
- Fixes a regression where excessive error messages are printed if
|
||
Unicode characters are emitted in non-Unicode-capable locales
|
||
(:issue:`6584`).
|
||
- Contains some improvements to the documentation and a small number
|
||
of completions.
|
||
|
||
If you are upgrading from version 3.0.0 or before, please also review
|
||
the release notes for 3.1b1 (included below).
|
||
|
||
--------------
|
||
|
||
fish 3.1b1 (released January 26, 2020)
|
||
======================================
|
||
|
||
.. _notable-improvements-and-fixes-1:
|
||
|
||
Notable improvements and fixes
|
||
------------------------------
|
||
|
||
- A new ``$pipestatus`` variable contains a list of exit statuses of
|
||
the previous job, for each of the separate commands in a pipeline
|
||
(:issue:`5632`).
|
||
- fish no longer buffers pipes to the last function in a pipeline,
|
||
improving many cases where pipes appeared to block or hang (:issue:`1396`).
|
||
- An overhaul of error messages for builtin commands, including a
|
||
removal of the overwhelming usage summary, more readable stack traces
|
||
(:issue:`3404`, :issue:`5434`), and stack traces for ``test`` (aka ``[``) (:issue:`5771`).
|
||
- fish’s debugging arguments have been significantly improved. The
|
||
``--debug-level`` option has been removed, and a new ``--debug``
|
||
option replaces it. This option accepts various categories, which may
|
||
be listed via ``fish --print-debug-categories`` (:issue:`5879`). A new
|
||
``--debug-output`` option allows for redirection of debug output.
|
||
- ``string`` has a new ``collect`` subcommand for use in command
|
||
substitutions, producing a single output instead of splitting on new
|
||
lines (similar to ``"$(cmd)"`` in other shells) (:issue:`159`).
|
||
- The fish manual, tutorial and FAQ are now available in ``man`` format
|
||
as ``fish-doc``, ``fish-tutorial`` and ``fish-faq`` respectively
|
||
(:issue:`5521`).
|
||
- Like other shells, ``cd`` now always looks for its argument in the
|
||
current directory as a last resort, even if the ``CDPATH`` variable
|
||
does not include it or “.” (:issue:`4484`).
|
||
- fish now correctly handles ``CDPATH`` entries that start with ``..``
|
||
(:issue:`6220`) or contain ``./`` (:issue:`5887`).
|
||
- The ``fish_trace`` variable may be set to trace execution (:issue:`3427`).
|
||
This performs a similar role as ``set -x`` in other shells.
|
||
- fish uses the temporary directory determined by the system, rather
|
||
than relying on ``/tmp`` (:issue:`3845`).
|
||
- The fish Web configuration tool (``fish_config``) prints a list of
|
||
commands it is executing, to help understanding and debugging
|
||
(:issue:`5584`).
|
||
- Major performance improvements when pasting (:issue:`5866`), executing lots
|
||
of commands (:issue:`5905`), importing history from bash (:issue:`6295`), and when
|
||
completing variables that might match ``$history`` (:issue:`6288`).
|
||
|
||
.. _syntax-changes-and-new-commands-1:
|
||
|
||
Syntax changes and new commands
|
||
-------------------------------
|
||
|
||
- A new builtin command, ``time``, which allows timing of fish
|
||
functions and builtins as well as external commands (:issue:`117`).
|
||
- Brace expansion now only takes place if the braces include a “,” or a
|
||
variable expansion, meaning common commands such as
|
||
``git reset HEAD@{0}`` do not require escaping (:issue:`5869`).
|
||
- New redirections ``&>`` and ``&|`` may be used to redirect or pipe
|
||
stdout, and also redirect stderr to stdout (:issue:`6192`).
|
||
- ``switch`` now allows arguments that expand to nothing, like empty
|
||
variables (:issue:`5677`).
|
||
- The ``VAR=val cmd`` syntax can now be used to run a command in a
|
||
modified environment (:issue:`6287`).
|
||
- ``and`` is no longer recognised as a command, so that nonsensical
|
||
constructs like ``and and and`` produce a syntax error (:issue:`6089`).
|
||
- ``math``\ ‘s exponent operator,’\ ``^``\ ‘, was previously
|
||
left-associative, but now uses the more commonly-used
|
||
right-associative behaviour (:issue:`6280`). This means that
|
||
``math '3^0.5^2'`` was previously calculated as’(3\ :sup:`0.5)`\ 2’,
|
||
but is now calculated as ‘3\ :sup:`(0.5`\ 2)’.
|
||
- In fish 3.0, the variable used with ``for`` loops inside command
|
||
substitutions could leak into enclosing scopes; this was an
|
||
inadvertent behaviour change and has been reverted (:issue:`6480`).
|
||
|
||
.. _scripting-improvements-1:
|
||
|
||
Scripting improvements
|
||
----------------------
|
||
|
||
- ``string split0`` now returns 0 if it split something (:issue:`5701`).
|
||
- In the interest of consistency, ``builtin -q`` and ``command -q`` can
|
||
now be used to query if a builtin or command exists (:issue:`5631`).
|
||
- ``math`` now accepts ``--scale=max`` for the maximum scale (:issue:`5579`).
|
||
- ``builtin $var`` now works correctly, allowing a variable as the
|
||
builtin name (:issue:`5639`).
|
||
- ``cd`` understands the ``--`` argument to make it possible to change
|
||
to directories starting with a hyphen (:issue:`6071`).
|
||
- ``complete --do-complete`` now also does fuzzy matches (:issue:`5467`).
|
||
- ``complete --do-complete`` can be used inside completions, allowing
|
||
limited recursion (:issue:`3474`).
|
||
- ``count`` now also counts lines fed on standard input (:issue:`5744`).
|
||
- ``eval`` produces an exit status of 0 when given no arguments, like
|
||
other shells (:issue:`5692`).
|
||
- ``printf`` prints what it can when input hasn’t been fully converted
|
||
to a number, but still prints an error (:issue:`5532`).
|
||
- ``complete -C foo`` now works as expected, rather than requiring
|
||
``complete -Cfoo``.
|
||
- ``complete`` has a new ``--force-files`` option, to re-enable file
|
||
completions. This allows ``sudo -E`` and ``pacman -Qo`` to complete
|
||
correctly (:issue:`5646`).
|
||
- ``argparse`` now defaults to showing the current function name
|
||
(instead of ``argparse``) in its errors, making ``--name`` often
|
||
superfluous (:issue:`5835`).
|
||
- ``argparse`` has a new ``--ignore-unknown`` option to keep
|
||
unrecognized options, allowing multiple argparse passes to parse
|
||
options (:issue:`5367`).
|
||
- ``argparse`` correctly handles flag value validation of options that
|
||
only have short names (:issue:`5864`).
|
||
- ``read -S`` (short option of ``--shell``) is recognised correctly
|
||
(:issue:`5660`).
|
||
- ``read`` understands ``--list``, which acts like ``--array`` in
|
||
reading all arguments into a list inside a single variable, but is
|
||
better named (:issue:`5846`).
|
||
- ``read`` has a new option, ``--tokenize``, which splits a string into
|
||
variables according to the shell’s tokenization rules, considering
|
||
quoting, escaping, and so on (:issue:`3823`).
|
||
- ``read`` interacts more correctly with the deprecated ``$IFS``
|
||
variable, in particular removing multiple separators when splitting a
|
||
variable into a list (:issue:`6406`), matching other shells.
|
||
- ``fish_indent`` now handles semicolons better, including leaving them
|
||
in place for ``; and`` and ``; or`` instead of breaking the line
|
||
(:issue:`5859`).
|
||
- ``fish_indent --write`` now supports multiple file arguments,
|
||
indenting them in turn.
|
||
- The default read limit has been increased to 100MiB (:issue:`5267`).
|
||
- ``math`` now also understands ``x`` for multiplication, provided it
|
||
is followed by whitespace (:issue:`5906`).
|
||
- ``math`` reports the right error when incorrect syntax is used inside
|
||
parentheses (:issue:`6063`), and warns when unsupported logical operations
|
||
are used (:issue:`6096`).
|
||
- ``math`` learned bitwise functions ``bitand``, ``bitor`` and ``bitxor``, used like ``math "bitand(0xFE, 5)"`` (:issue:`7281`).
|
||
- ``math`` learned tau for those wishing to cut down on typing "2 * pi".
|
||
- ``functions --erase`` now also prevents fish from autoloading a
|
||
function for the first time (:issue:`5951`).
|
||
- ``jobs --last`` returns 0 to indicate success when a job is found
|
||
(:issue:`6104`).
|
||
- ``commandline -p`` and ``commandline -j`` now split on ``&&`` and
|
||
``||`` in addition to ``;`` and ``&`` (:issue:`6214`).
|
||
- A bug where ``string split`` would drop empty strings if the output
|
||
was only empty strings has been fixed (:issue:`5987`).
|
||
- ``eval`` no long creates a new local variable scope, but affects
|
||
variables in the scope it is called from (:issue:`4443`). ``source`` still
|
||
creates a new local scope.
|
||
- ``abbr`` has a new ``--query`` option to check for the existence of
|
||
an abbreviation.
|
||
- Local values for ``fish_complete_path`` and ``fish_function_path``
|
||
are now ignored; only their global values are respected.
|
||
- Syntax error reports now display a marker in the correct position
|
||
(:issue:`5812`).
|
||
- Empty universal variables may now be exported (:issue:`5992`).
|
||
- Exported universal variables are no longer imported into the global
|
||
scope, preventing shadowing. This makes it easier to change such
|
||
variables for all fish sessions and avoids breakage when the value is
|
||
a list of multiple elements (:issue:`5258`).
|
||
- A bug where ``for`` could use invalid variable names has been fixed
|
||
(:issue:`5800`).
|
||
- A bug where local variables would not be exported to functions has
|
||
been fixed (:issue:`6153`).
|
||
- The null command (``:``) now always exits successfully, rather than
|
||
passing through the previous exit status (:issue:`6022`).
|
||
- The output of ``functions FUNCTION`` matches the declaration of the
|
||
function, correctly including comments or blank lines (:issue:`5285`), and
|
||
correctly includes any ``--wraps`` flags (:issue:`1625`).
|
||
- ``type`` supports a new option, ``--short``, which suppress function
|
||
expansion (:issue:`6403`).
|
||
- ``type --path`` with a function argument will now output the path to
|
||
the file containing the definition of that function, if it exists.
|
||
- ``type --force-path`` with an argument that cannot be found now
|
||
correctly outputs nothing, as documented (:issue:`6411`).
|
||
- The ``$hostname`` variable is no longer truncated to 32 characters
|
||
(:issue:`5758`).
|
||
- Line numbers in function backtraces are calculated correctly (:issue:`6350`).
|
||
- A new ``fish_cancel`` event is emitted when the command line is
|
||
cancelled, which is useful for terminal integration (:issue:`5973`).
|
||
|
||
.. _interactive-improvements-1:
|
||
|
||
Interactive improvements
|
||
------------------------
|
||
|
||
- New Base16 color options are available through the Web-based
|
||
configuration (:issue:`6504`).
|
||
- fish only parses ``/etc/paths`` on macOS in login shells, matching
|
||
the bash implementation (:issue:`5637`) and avoiding changes to path ordering
|
||
in child shells (:issue:`5456`). It now ignores blank lines like the bash
|
||
implementation (:issue:`5809`).
|
||
- The locale is now reloaded when the ``LOCPATH`` variable is changed
|
||
(:issue:`5815`).
|
||
- ``read`` no longer keeps a history, making it suitable for operations
|
||
that shouldn’t end up there, like password entry (:issue:`5904`).
|
||
- ``dirh`` outputs its stack in the correct order (:issue:`5477`), and behaves
|
||
as documented when universal variables are used for its stack
|
||
(:issue:`5797`).
|
||
- ``funced`` and the edit-commandline-in-buffer bindings did not work
|
||
in fish 3.0 when the ``$EDITOR`` variable contained spaces; this has
|
||
been corrected (:issue:`5625`).
|
||
- Builtins now pipe their help output to a pager automatically (:issue:`6227`).
|
||
- ``set_color`` now colors the ``--print-colors`` output in the
|
||
matching colors if it is going to a terminal.
|
||
- fish now underlines every valid entered path instead of just the last
|
||
one (:issue:`5872`).
|
||
- When syntax highlighting a string with an unclosed quote, only the
|
||
quote itself will be shown as an error, instead of the whole
|
||
argument.
|
||
- Syntax highlighting works correctly with variables as commands
|
||
(:issue:`5658`) and redirections to close file descriptors (:issue:`6092`).
|
||
- ``help`` works properly on Windows Subsytem for Linux (:issue:`5759`, :issue:`6338`).
|
||
- A bug where ``disown`` could crash the shell has been fixed (:issue:`5720`).
|
||
- fish will not autosuggest files ending with ``~`` unless there are no
|
||
other candidates, as these are generally backup files (:issue:`985`).
|
||
- Escape in the pager works correctly (:issue:`5818`).
|
||
- Key bindings that call ``fg`` no longer leave the terminal in a
|
||
broken state (:issue:`2114`).
|
||
- Brackets (:issue:`5831`) and filenames containing ``$`` (:issue:`6060`) are completed
|
||
with appropriate escaping.
|
||
- The output of ``complete`` and ``functions`` is now colorized in
|
||
interactive terminals.
|
||
- The Web-based configuration handles aliases that include single
|
||
quotes correctly (:issue:`6120`), and launches correctly under Termux (:issue:`6248`)
|
||
and OpenBSD (:issue:`6522`).
|
||
- ``function`` now correctly validates parameters for
|
||
``--argument-names`` as valid variable names (:issue:`6147`) and correctly
|
||
parses options following ``--argument-names``, as in
|
||
“``--argument-names foo --description bar``” (:issue:`6186`).
|
||
- History newly imported from bash includes command lines using ``&&``
|
||
or ``||``.
|
||
- The automatic generation of completions from manual pages is better
|
||
described in job and process listings, and no longer produces a
|
||
warning when exiting fish (:issue:`6269`).
|
||
- In private mode, setting ``$fish_greeting`` to an empty string before
|
||
starting the private session will prevent the warning about history
|
||
not being saved from being printed (:issue:`6299`).
|
||
- In the interactive editor, a line break (Enter) inside unclosed
|
||
brackets will insert a new line, rather than executing the command
|
||
and producing an error (:issue:`6316`).
|
||
- Ctrl-C always repaints the prompt (:issue:`6394`).
|
||
- When run interactively from another program (such as Python), fish
|
||
will correctly start a new process group, like other shells (:issue:`5909`).
|
||
- Job identifiers (for example, for background jobs) are assigned more
|
||
logically (:issue:`6053`).
|
||
- A bug where history would appear truncated if an empty command was
|
||
executed was fixed (:issue:`6032`).
|
||
|
||
.. _new-or-improved-bindings-1:
|
||
|
||
New or improved bindings
|
||
^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
- Pasting strips leading spaces to avoid pasted commands being omitted
|
||
from the history (:issue:`4327`).
|
||
- Shift-Left and Shift-Right now default to moving backwards and
|
||
forwards by one bigword (words separated by whitespace) (:issue:`1505`).
|
||
- The default escape delay (to differentiate between the escape key and
|
||
an alt-combination) has been reduced to 30ms, down from 300ms for the
|
||
default mode and 100ms for Vi mode (:issue:`3904`).
|
||
- The ``forward-bigword`` binding now interacts correctly with
|
||
autosuggestions (:issue:`5336`).
|
||
- The ``fish_clipboard_*`` functions support Wayland by using
|
||
`wl-clipboard <https://github.com/bugaevc/wl-clipboard>`_
|
||
(:issue:`5450`).
|
||
- The ``nextd`` and ``prevd`` functions no longer print “Hit end of
|
||
history”, instead using a bell. They correctly store working
|
||
directories containing symbolic links (:issue:`6395`).
|
||
- If a ``fish_mode_prompt`` function exists, Vi mode will only execute
|
||
it on mode-switch instead of the entire prompt. This should make it
|
||
much more responsive with slow prompts (:issue:`5783`).
|
||
- The path-component bindings (like Ctrl-w) now also stop at “:” and
|
||
“@”, because those are used to denote user and host in commands such
|
||
as ``ssh`` (:issue:`5841`).
|
||
- The NULL character can now be bound via ``bind -k nul``. Terminals
|
||
often generate this character via control-space. (:issue:`3189`).
|
||
- A new readline command ``expand-abbr`` can be used to trigger
|
||
abbreviation expansion (:issue:`5762`).
|
||
- A new readline command, ``delete-or-exit``, removes a character to
|
||
the right of the cursor or exits the shell if the command line is
|
||
empty (moving this functionality out of the ``delete-or-exit``
|
||
function).
|
||
- The ``self-insert`` readline command will now insert the binding
|
||
sequence, if not empty.
|
||
- A new binding to prepend ``sudo``, bound to Alt-S by default (:issue:`6140`).
|
||
- The Alt-W binding to describe a command should now work better with
|
||
multiline prompts (:issue:`6110`)
|
||
- The Alt-H binding to open a command’s man page now tries to ignore
|
||
``sudo`` (:issue:`6122`).
|
||
- A new pair of bind functions, ``history-prefix-search-backward`` (and
|
||
``forward``), was introduced (:issue:`6143`).
|
||
- Vi mode now supports R to enter replace mode (:issue:`6342`), and ``d0`` to
|
||
delete the current line (:issue:`6292`).
|
||
- In Vi mode, hitting Enter in replace-one mode no longer erases the
|
||
prompt (:issue:`6298`).
|
||
- Selections in Vi mode are inclusive, matching the actual behaviour of
|
||
Vi (:issue:`5770`).
|
||
|
||
.. _improved-prompts-1:
|
||
|
||
Improved prompts
|
||
^^^^^^^^^^^^^^^^
|
||
|
||
- The Git prompt in informative mode now shows the number of stashes if
|
||
enabled.
|
||
- The Git prompt now has an option
|
||
(``$__fish_git_prompt_use_informative_chars``) to use the (more
|
||
modern) informative characters without enabling informative mode.
|
||
- The default prompt now also features VCS integration and will color
|
||
the host if running via SSH (:issue:`6375`).
|
||
- The default and example prompts print the pipe status if an earlier
|
||
command in the pipe fails.
|
||
- The default and example prompts try to resolve exit statuses to
|
||
signal names when appropriate.
|
||
|
||
.. _improved-terminal-output-1:
|
||
|
||
Improved terminal output
|
||
^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
- New ``fish_pager_color_`` options have been added to control more
|
||
elements of the pager’s colors (:issue:`5524`).
|
||
- Better detection and support for using fish from various system
|
||
consoles, where limited colors and special characters are supported
|
||
(:issue:`5552`).
|
||
- fish now tries to guess if the system supports Unicode 9 (and
|
||
displays emoji as wide), eliminating the need to set
|
||
``$fish_emoji_width`` in most cases (:issue:`5722`).
|
||
- Improvements to the display of wide characters, particularly Korean
|
||
characters and emoji (:issue:`5583`, :issue:`5729`).
|
||
- The Vi mode cursor is correctly redrawn when regaining focus under
|
||
terminals that report focus (eg tmux) (:issue:`4788`).
|
||
- Variables that control background colors (such as
|
||
``fish_pager_color_search_match``) can now use ``--reverse``.
|
||
|
||
.. _completions-1:
|
||
|
||
Completions
|
||
^^^^^^^^^^^
|
||
|
||
- Added completions for
|
||
|
||
- ``aws``
|
||
- ``bat`` (:issue:`6052`)
|
||
- ``bosh`` (:issue:`5700`)
|
||
- ``btrfs``
|
||
- ``camcontrol``
|
||
- ``cf`` (:issue:`5700`)
|
||
- ``chronyc`` (:issue:`6496`)
|
||
- ``code`` (:issue:`6205`)
|
||
- ``cryptsetup`` (:issue:`6488`)
|
||
- ``csc`` and ``csi`` (:issue:`6016`)
|
||
- ``cwebp`` (:issue:`6034`)
|
||
- ``cygpath`` and ``cygstart`` (:issue:`6239`)
|
||
- ``epkginfo`` (:issue:`5829`)
|
||
- ``ffmpeg``, ``ffplay``, and ``ffprobe`` (:issue:`5922`)
|
||
- ``fsharpc`` and ``fsharpi`` (:issue:`6016`)
|
||
- ``fzf`` (:issue:`6178`)
|
||
- ``g++`` (:issue:`6217`)
|
||
- ``gpg1`` (:issue:`6139`)
|
||
- ``gpg2`` (:issue:`6062`)
|
||
- ``grub-mkrescue`` (:issue:`6182`)
|
||
- ``hledger`` (:issue:`6043`)
|
||
- ``hwinfo`` (:issue:`6496`)
|
||
- ``irb`` (:issue:`6260`)
|
||
- ``iw`` (:issue:`6232`)
|
||
- ``kak``
|
||
- ``keepassxc-cli`` (:issue:`6505`)
|
||
- ``keybase`` (:issue:`6410`)
|
||
- ``loginctl`` (:issue:`6501`)
|
||
- ``lz4``, ``lz4c`` and ``lz4cat`` (:issue:`6364`)
|
||
- ``mariner`` (:issue:`5718`)
|
||
- ``nethack`` (:issue:`6240`)
|
||
- ``patool`` (:issue:`6083`)
|
||
- ``phpunit`` (:issue:`6197`)
|
||
- ``plutil`` (:issue:`6301`)
|
||
- ``pzstd`` (:issue:`6364`)
|
||
- ``qubes-gpg-client`` (:issue:`6067`)
|
||
- ``resolvectl`` (:issue:`6501`)
|
||
- ``rg``
|
||
- ``rustup``
|
||
- ``sfdx`` (:issue:`6149`)
|
||
- ``speedtest`` and ``speedtest-cli`` (:issue:`5840`)
|
||
- ``src`` (:issue:`6026`)
|
||
- ``tokei`` (:issue:`6085`)
|
||
- ``tsc`` (:issue:`6016`)
|
||
- ``unlz4`` (:issue:`6364`)
|
||
- ``unzstd`` (:issue:`6364`)
|
||
- ``vbc`` (:issue:`6016`)
|
||
- ``zpaq`` (:issue:`6245`)
|
||
- ``zstd``, ``zstdcat``, ``zstdgrep``, ``zstdless`` and ``zstdmt``
|
||
(:issue:`6364`)
|
||
|
||
- Lots of improvements to completions.
|
||
- Selecting short options which also have a long name from the
|
||
completion pager is possible (:issue:`5634`).
|
||
- Tab completion will no longer add trailing spaces if they already
|
||
exist (:issue:`6107`).
|
||
- Completion of subcommands to builtins like ``and`` or ``not`` now
|
||
works correctly (:issue:`6249`).
|
||
- Completion of arguments to short options works correctly when
|
||
multiple short options are used together (:issue:`332`).
|
||
- Activating completion in the middle of an invalid completion does not
|
||
move the cursor any more, making it easier to fix a mistake (:issue:`4124`).
|
||
- Completion in empty commandlines now lists all available commands.
|
||
- Functions listed as completions could previously leak parts of the
|
||
function as other completions; this has been fixed.
|
||
|
||
.. _deprecations-and-removed-features-1:
|
||
|
||
Deprecations and removed features
|
||
---------------------------------
|
||
|
||
- The vcs-prompt functions have been promoted to names without
|
||
double-underscore, so \__fish_git_prompt is now fish_git_prompt,
|
||
\__fish_vcs_prompt is now fish_vcs_prompt, \__fish_hg_prompt is now
|
||
fish_hg_prompt and \__fish_svn_prompt is now fish_svn_prompt. Shims
|
||
at the old names have been added, and the variables have kept their
|
||
old names (:issue:`5586`).
|
||
- ``string replace`` has an additional round of escaping in the
|
||
replacement expression, so escaping backslashes requires many escapes
|
||
(eg ``string replace -ra '([ab])' '\\\\\\\$1' a``). The new feature
|
||
flag ``regex-easyesc`` can be used to disable this, so that the same
|
||
effect can be achieved with
|
||
``string replace -ra '([ab])' '\\\\$1' a`` (:issue:`5556`). As a reminder,
|
||
the intention behind feature flags is that this will eventually
|
||
become the default and then only option, so scripts should be
|
||
updated.
|
||
- The ``fish_vi_mode`` function, deprecated in fish 2.3, has been
|
||
removed. Use ``fish_vi_key_bindings`` instead (:issue:`6372`).
|
||
|
||
.. _for-distributors-and-developers-1:
|
||
|
||
For distributors and developers
|
||
-------------------------------
|
||
|
||
- fish 3.0 introduced a CMake-based build system. In fish 3.1, both the
|
||
Autotools-based build and legacy Xcode build system have been
|
||
removed, leaving only the CMake build system. All distributors and
|
||
developers must install CMake.
|
||
- fish now depends on the common ``tee`` external command, for the
|
||
``psub`` process substitution function.
|
||
- The documentation is now built with Sphinx. The old Doxygen-based
|
||
documentation system has been removed. Developers, and distributors
|
||
who wish to rebuild the documentation, must install Sphinx.
|
||
- The ``INTERNAL_WCWIDTH`` build option has been removed, as fish now
|
||
always uses an internal ``wcwidth`` function. It has a number of
|
||
configuration options that make it more suitable for general use
|
||
(:issue:`5777`).
|
||
- mandoc can now be used to format the output from ``--help`` if
|
||
``nroff`` is not installed, reducing the number of external
|
||
dependencies on systems with ``mandoc`` installed (:issue:`5489`).
|
||
- Some bugs preventing building on Solaris-derived systems such as
|
||
Illumos were fixed (:issue:`5458`, :issue:`5461`, :issue:`5611`).
|
||
- Completions for ``npm``, ``bower`` and ``yarn`` no longer require the
|
||
``jq`` utility for full functionality, but will use Python instead if
|
||
it is available.
|
||
- The paths for completions, functions and configuration snippets have
|
||
been extended. On systems that define ``XDG_DATA_DIRS``, each of the
|
||
directories in this variable are searched in the subdirectories
|
||
``fish/vendor_completions.d``, ``fish/vendor_functions.d``, and
|
||
``fish/vendor_conf.d`` respectively. On systems that do not define
|
||
this variable in the environment, the vendor directories are searched
|
||
for in both the installation prefix and the default “extra”
|
||
directory, which now defaults to ``/usr/local`` (:issue:`5029`).
|
||
|
||
--------------
|
||
|
||
fish 3.0.2 (released February 19, 2019)
|
||
=======================================
|
||
|
||
This release of fish fixes an issue discovered in fish 3.0.1.
|
||
|
||
Fixes and improvements
|
||
----------------------
|
||
|
||
- The PWD environment variable is now ignored if it does not resolve to
|
||
the true working directory, fixing strange behaviour in terminals
|
||
started by editors and IDEs (:issue:`5647`).
|
||
|
||
If you are upgrading from version 2.7.1 or before, please also review
|
||
the release notes for 3.0.1, 3.0.0 and 3.0b1 (included below).
|
||
|
||
|
||
fish 3.0.1 (released February 11, 2019)
|
||
=======================================
|
||
|
||
This release of fish fixes a number of major issues discovered in fish
|
||
3.0.0.
|
||
|
||
.. _fixes-and-improvements-1:
|
||
|
||
Fixes and improvements
|
||
----------------------
|
||
|
||
- ``exec`` does not complain about running foreground jobs when called
|
||
(:issue:`5449`).
|
||
- while loops now evaluate to the last executed command in the loop
|
||
body (or zero if the body was empty), matching POSIX semantics
|
||
(:issue:`4982`).
|
||
- ``read --silent`` no longer echoes to the tty when run from a
|
||
non-interactive script (:issue:`5519`).
|
||
- On macOS, path entries with spaces in ``/etc/paths`` and
|
||
``/etc/paths.d`` now correctly set path entries with spaces.
|
||
Likewise, ``MANPATH`` is correctly set from ``/etc/manpaths`` and
|
||
``/etc/manpaths.d`` (:issue:`5481`).
|
||
- fish starts correctly under Cygwin/MSYS2 (:issue:`5426`).
|
||
- The ``pager-toggle-search`` binding (Ctrl-S by default) will now
|
||
activate the search field, even when the pager is not focused.
|
||
- The error when a command is not found is now printed a single time,
|
||
instead of once per argument (:issue:`5588`).
|
||
- Fixes and improvements to the git completions, including printing
|
||
correct paths with older git versions, fuzzy matching again, reducing
|
||
unnecessary offers of root paths (starting with ``:/``) (:issue:`5578`,
|
||
:issue:`5574`, :issue:`5476`), and ignoring shell aliases, so enterprising users can
|
||
set up the wrapping command (via
|
||
``set -g __fish_git_alias_$command $whatitwraps``) (:issue:`5412`).
|
||
- Significant performance improvements to core shell functions (:issue:`5447`)
|
||
and to the ``kill`` completions (:issue:`5541`).
|
||
- Starting in symbolically-linked working directories works correctly
|
||
(:issue:`5525`).
|
||
- The default ``fish_title`` function no longer contains extra spaces
|
||
(:issue:`5517`).
|
||
- The ``nim`` prompt now works correctly when chosen in the Web-based
|
||
configuration (:issue:`5490`).
|
||
- ``string`` now prints help to stdout, like other builtins (:issue:`5495`).
|
||
- Killing the terminal while fish is in vi normal mode will no longer
|
||
send it spinning and eating CPU. (:issue:`5528`)
|
||
- A number of crashes have been fixed (:issue:`5550`, :issue:`5548`, :issue:`5479`, :issue:`5453`).
|
||
- Improvements to the documentation and certain completions.
|
||
|
||
Known issues
|
||
------------
|
||
|
||
There is one significant known issue that was not corrected before the
|
||
release:
|
||
|
||
- fish does not run correctly under Windows Services for Linux before
|
||
Windows 10 version 1809/17763, and the message warning of this may
|
||
not be displayed (:issue:`5619`).
|
||
|
||
If you are upgrading from version 2.7.1 or before, please also review
|
||
the release notes for 3.0.0 and 3.0b1 (included below).
|
||
|
||
--------------
|
||
|
||
fish 3.0.0 (released December 28, 2018)
|
||
=======================================
|
||
|
||
fish 3 is a major release, which introduces some breaking changes
|
||
alongside improved functionality. Although most existing scripts will
|
||
continue to work, they should be reviewed against the list contained in
|
||
the 3.0b1 release notes below.
|
||
|
||
Compared to the beta release of fish 3.0b1, fish version 3.0.0:
|
||
|
||
- builds correctly against musl libc (:issue:`5407`)
|
||
- handles huge numeric arguments to ``test`` correctly (:issue:`5414`)
|
||
- removes the history colouring introduced in 3.0b1, which did not
|
||
always work correctly
|
||
|
||
There is one significant known issue which was not able to be corrected
|
||
before the release:
|
||
|
||
- fish 3.0.0 builds on Cygwin (:issue:`5423`), but does not run correctly
|
||
(:issue:`5426`) and will result in a hanging terminal when started. Cygwin
|
||
users are encouraged to continue using 2.7.1 until a release which
|
||
corrects this is available.
|
||
|
||
If you are upgrading from version 2.7.1 or before, please also review
|
||
the release notes for 3.0b1 (included below).
|
||
|
||
--------------
|
||
|
||
fish 3.0b1 (released December 11, 2018)
|
||
=======================================
|
||
|
||
fish 3 is a major release, which introduces some breaking changes
|
||
alongside improved functionality. Although most existing scripts will
|
||
continue to work, they should be reviewed against the list below.
|
||
|
||
Notable non-backward compatible changes
|
||
---------------------------------------
|
||
|
||
- Process and job expansion has largely been removed. ``%`` will no
|
||
longer perform these expansions, except for ``%self`` for the PID of
|
||
the current shell. Additionally, job management commands (``disown``,
|
||
``wait``, ``bg``, ``fg`` and ``kill``) will expand job specifiers
|
||
starting with ``%`` (:issue:`4230`, :issue:`1202`).
|
||
- ``set x[1] x[2] a b``, to set multiple elements of an array at once,
|
||
is no longer valid syntax (:issue:`4236`).
|
||
- A literal ``{}`` now expands to itself, rather than nothing. This
|
||
makes working with ``find -exec`` easier (:issue:`1109`, :issue:`4632`).
|
||
- Literally accessing a zero-index is now illegal syntax and is caught
|
||
by the parser (:issue:`4862`). (fish indices start at 1)
|
||
- Successive commas in brace expansions are handled in less surprising
|
||
manner. For example, ``{,,,}`` expands to four empty strings rather
|
||
than an empty string, a comma and an empty string again (:issue:`3002`,
|
||
:issue:`4632`).
|
||
- ``for`` loop control variables are no longer local to the ``for``
|
||
block (:issue:`1935`).
|
||
- Variables set in ``if`` and ``while`` conditions are available
|
||
outside the block (:issue:`4820`).
|
||
- Local exported (``set -lx``) vars are now visible to functions
|
||
(:issue:`1091`).
|
||
- The new ``math`` builtin (see below) does not support logical
|
||
expressions; ``test`` should be used instead (:issue:`4777`).
|
||
- Range expansion will now behave sensibly when given a single positive
|
||
and negative index (``$foo[5..-1]`` or ``$foo[-1..5]``), clamping to
|
||
the last valid index without changing direction if the list has fewer
|
||
elements than expected.
|
||
- ``read`` now uses ``-s`` as short for ``--silent`` (à la ``bash``);
|
||
``--shell``\ ’s abbreviation (formerly ``-s``) is now ``-S`` instead
|
||
(:issue:`4490`).
|
||
- ``cd`` no longer resolves symlinks. fish now maintains a virtual
|
||
path, matching other shells (:issue:`3350`).
|
||
- ``source`` now requires an explicit ``-`` as the filename to read
|
||
from the terminal (:issue:`2633`).
|
||
- Arguments to ``end`` are now errors, instead of being silently
|
||
ignored.
|
||
- The names ``argparse``, ``read``, ``set``, ``status``, ``test`` and
|
||
``[`` are now reserved and not allowed as function names. This
|
||
prevents users unintentionally breaking stuff (:issue:`3000`).
|
||
- The ``fish_user_abbreviations`` variable is no longer used;
|
||
abbreviations will be migrated to the new storage format
|
||
automatically.
|
||
- The ``FISH_READ_BYTE_LIMIT`` variable is now called
|
||
``fish_byte_limit`` (:issue:`4414`).
|
||
- Environment variables are no longer split into arrays based on the
|
||
record separator character on startup. Instead, variables are not
|
||
split, unless their name ends in PATH, in which case they are split
|
||
on colons (:issue:`436`).
|
||
- The ``history`` builtin’s ``--with-time`` option has been removed;
|
||
this has been deprecated in favor of ``--show-time`` since 2.7.0
|
||
(:issue:`4403`).
|
||
- The internal variables ``__fish_datadir`` and ``__fish_sysconfdir``
|
||
are now known as ``__fish_data_dir`` and ``__fish_sysconf_dir``
|
||
respectively.
|
||
|
||
Deprecations
|
||
------------
|
||
|
||
With the release of fish 3, a number of features have been marked for
|
||
removal in the future. All users are encouraged to explore alternatives.
|
||
A small number of these features are currently behind feature flags,
|
||
which are turned on at present but may be turned off by default in the
|
||
future.
|
||
|
||
A new feature flags mechanism is added for staging deprecations and
|
||
breaking changes. Feature flags may be specified at launch with
|
||
``fish --features ...`` or by setting the universal ``fish_features``
|
||
variable. (:issue:`4940`)
|
||
|
||
- The use of the ``IFS`` variable for ``read`` is deprecated; ``IFS``
|
||
will be ignored in the future (:issue:`4156`). Use the ``read --delimiter``
|
||
option instead.
|
||
- The ``function --on-process-exit`` switch will be removed in future
|
||
(:issue:`4700`). Use the ``fish_exit`` event instead:
|
||
``function --on-event fish_exit``.
|
||
- ``$_`` is deprecated and will removed in the future (:issue:`813`). Use
|
||
``status current-command`` in a command substitution instead.
|
||
- ``^`` as a redirection deprecated and will be removed in the future.
|
||
(:issue:`4394`). Use ``2>`` to redirect stderr. This is controlled by the
|
||
``stderr-nocaret`` feature flag.
|
||
- ``?`` as a glob (wildcard) is deprecated and will be removed in the
|
||
future (:issue:`4520`). This is controlled by the ``qmark-noglob`` feature
|
||
flag.
|
||
|
||
Notable fixes and improvements
|
||
------------------------------
|
||
|
||
.. _syntax-changes-and-new-commands-2:
|
||
|
||
Syntax changes and new commands
|
||
-------------------------------
|
||
|
||
- fish now supports ``&&`` (like ``and``), ``||`` (like ``or``), and
|
||
``!`` (like ``not``), for better migration from POSIX-compliant
|
||
shells (:issue:`4620`).
|
||
- Variables may be used as commands (:issue:`154`).
|
||
- fish may be started in private mode via ``fish --private``. Private
|
||
mode fish sessions do not have access to the history file and any
|
||
commands evaluated in private mode are not persisted for future
|
||
sessions. A session variable ``$fish_private_mode`` can be queried to
|
||
detect private mode and adjust the behavior of scripts accordingly to
|
||
respect the user’s wish for privacy.
|
||
- A new ``wait`` command for waiting on backgrounded processes (:issue:`4498`).
|
||
- ``math`` is now a builtin rather than a wrapper around ``bc``
|
||
(:issue:`3157`). Floating point computations is now used by default, and can
|
||
be controlled with the new ``--scale`` option (:issue:`4478`).
|
||
- Setting ``$PATH`` no longer warns on non-existent directories,
|
||
allowing for a single $PATH to be shared across machines (eg via
|
||
dotfiles) (:issue:`2969`).
|
||
- ``while`` sets ``$status`` to a non-zero value if the loop is not
|
||
executed (:issue:`4982`).
|
||
- Command substitution output is now limited to 10 MB by default,
|
||
controlled by the ``fish_read_limit`` variable (:issue:`3822`). Notably, this
|
||
is larger than most operating systems’ argument size limit, so trying
|
||
to pass argument lists this size to external commands has never
|
||
worked.
|
||
- The machine hostname, where available, is now exposed as the
|
||
``$hostname`` reserved variable. This removes the dependency on the
|
||
``hostname`` executable (:issue:`4422`).
|
||
- Bare ``bind`` invocations in config.fish now work. The
|
||
``fish_user_key_bindings`` function is no longer necessary, but will
|
||
still be executed if it exists (:issue:`5191`).
|
||
- ``$fish_pid`` and ``$last_pid`` are available as replacements for
|
||
``%self`` and ``%last``.
|
||
|
||
New features in commands
|
||
------------------------
|
||
|
||
- ``alias`` has a new ``--save`` option to save the generated function
|
||
immediately (:issue:`4878`).
|
||
- ``bind`` has a new ``--silent`` option to ignore bind requests for
|
||
named keys not available under the current terminal (:issue:`4188`, :issue:`4431`).
|
||
- ``complete`` has a new ``--keep-order`` option to show the provided
|
||
or dynamically-generated argument list in the same order as
|
||
specified, rather than alphabetically (:issue:`361`).
|
||
- ``exec`` prompts for confirmation if background jobs are running.
|
||
- ``funced`` has a new ``--save`` option to automatically save the
|
||
edited function after successfully editing (:issue:`4668`).
|
||
- ``functions`` has a new ``--handlers`` option to show functions
|
||
registered as event handlers (:issue:`4694`).
|
||
- ``history search`` supports globs for wildcard searching (:issue:`3136`) and
|
||
has a new ``--reverse`` option to show entries from oldest to newest
|
||
(:issue:`4375`).
|
||
- ``jobs`` has a new ``--quiet`` option to silence the output.
|
||
- ``read`` has a new ``--delimiter`` option for splitting input into
|
||
arrays (:issue:`4256`).
|
||
- ``read`` writes directly to stdout if called without arguments
|
||
(:issue:`4407`).
|
||
- ``read`` can now read individual lines into separate variables
|
||
without consuming the input in its entirety via the new ``/--line``
|
||
option.
|
||
- ``set`` has new ``--append`` and ``--prepend`` options (:issue:`1326`).
|
||
- ``string match`` with an empty pattern and ``--entire`` in glob mode
|
||
now matches everything instead of nothing (:issue:`4971`).
|
||
- ``string split`` supports a new ``--no-empty`` option to exclude
|
||
empty strings from the result (:issue:`4779`).
|
||
- ``string`` has new subcommands ``split0`` and ``join0`` for working
|
||
with NUL-delimited output.
|
||
- ``string`` no longer stops processing text after NUL characters
|
||
(:issue:`4605`)
|
||
- ``string escape`` has a new ``--style regex`` option for escaping
|
||
strings to be matched literally in ``string`` regex operations.
|
||
- ``test`` now supports floating point values in numeric comparisons.
|
||
|
||
.. _interactive-improvements-2:
|
||
|
||
Interactive improvements
|
||
------------------------
|
||
|
||
- A pipe at the end of a line now allows the job to continue on the
|
||
next line (:issue:`1285`).
|
||
- Italics and dim support out of the box on macOS for Terminal.app and
|
||
iTerm (:issue:`4436`).
|
||
- ``cd`` tab completions no longer descend into the deepest unambiguous
|
||
path (:issue:`4649`).
|
||
- Pager navigation has been improved. Most notably, moving down now
|
||
wraps around, moving up from the commandline now jumps to the last
|
||
element and moving right and left now reverse each other even when
|
||
wrapping around (:issue:`4680`).
|
||
- Typing normal characters while the completion pager is active no
|
||
longer shows the search field. Instead it enters them into the
|
||
command line, and ends paging (:issue:`2249`).
|
||
- A new input binding ``pager-toggle-search`` toggles the search field
|
||
in the completions pager on and off. By default, this is bound to
|
||
Ctrl-S.
|
||
- Searching in the pager now does a full fuzzy search (:issue:`5213`).
|
||
- The pager will now show the full command instead of just its last
|
||
line if the number of completions is large (:issue:`4702`).
|
||
- Abbreviations can be tab-completed (:issue:`3233`).
|
||
- Tildes in file names are now properly escaped in completions (:issue:`2274`).
|
||
- Wrapping completions (from ``complete --wraps`` or
|
||
``function --wraps``) can now inject arguments. For example,
|
||
``complete gco --wraps 'git checkout'`` now works properly (:issue:`1976`).
|
||
The ``alias`` function has been updated to respect this behavior.
|
||
- Path completions now support expansions, meaning expressions like
|
||
``python ~/<TAB>`` now provides file suggestions just like any other
|
||
relative or absolute path. (This includes support for other
|
||
expansions, too.)
|
||
- Autosuggestions try to avoid arguments that are already present in
|
||
the command line.
|
||
- Notifications about crashed processes are now always shown, even in
|
||
command substitutions (:issue:`4962`).
|
||
- The screen is no longer reset after a BEL, fixing graphical glitches
|
||
(:issue:`3693`).
|
||
- vi-mode now supports ‘;’ and ‘,’ motions. This introduces new
|
||
{forward,backward}-jump-till and repeat-jump{,-reverse} bind
|
||
functions (:issue:`5140`).
|
||
- The ``*y`` vi-mode binding now works (:issue:`5100`).
|
||
- True color is now enabled in neovim by default (:issue:`2792`).
|
||
- Terminal size variables (``$COLUMNS``/``$LINES``) are now updated
|
||
before ``fish_prompt`` is called, allowing the prompt to react
|
||
(:issue:`904`).
|
||
- Multi-line prompts no longer repeat when the terminal is resized
|
||
(:issue:`2320`).
|
||
- ``xclip`` support has been added to the clipboard integration
|
||
(:issue:`5020`).
|
||
- The Alt-P keybinding paginates the last command if the command line
|
||
is empty.
|
||
- ``$cmd_duration`` is no longer reset when no command is executed
|
||
(:issue:`5011`).
|
||
- Deleting a one-character word no longer erases the next word as well
|
||
(:issue:`4747`).
|
||
- Token history search (Alt-Up) omits duplicate entries (:issue:`4795`).
|
||
- The ``fish_escape_delay_ms`` timeout, allowing the use of the escape
|
||
key both on its own and as part of a control sequence, was applied to
|
||
all control characters; this has been reduced to just the escape key.
|
||
- Completing a function shows the description properly (:issue:`5206`).
|
||
- Added completions for
|
||
|
||
- ``ansible``, including ``ansible-galaxy``, ``ansible-playbook``
|
||
and ``ansible-vault`` (:issue:`4697`)
|
||
- ``bb-power`` (:issue:`4800`)
|
||
- ``bd`` (:issue:`4472`)
|
||
- ``bower``
|
||
- ``clang`` and ``clang++`` (:issue:`4174`)
|
||
- ``conda`` (:issue:`4837`)
|
||
- ``configure`` (for autoconf-generated files only)
|
||
- ``curl``
|
||
- ``doas`` (:issue:`5196`)
|
||
- ``ebuild`` (:issue:`4911`)
|
||
- ``emaint`` (:issue:`4758`)
|
||
- ``eopkg`` (:issue:`4600`)
|
||
- ``exercism`` (:issue:`4495`)
|
||
- ``hjson``
|
||
- ``hugo`` (:issue:`4529`)
|
||
- ``j`` (from autojump :issue:`4344`)
|
||
- ``jbake`` (:issue:`4814`)
|
||
- ``jhipster`` (:issue:`4472`)
|
||
- ``kitty``
|
||
- ``kldload``
|
||
- ``kldunload``
|
||
- ``makensis`` (:issue:`5242`)
|
||
- ``meson``
|
||
- ``mkdocs`` (:issue:`4906`)
|
||
- ``ngrok`` (:issue:`4642`)
|
||
- OpenBSD’s ``pkg_add``, ``pkg_delete``, ``pkg_info``, ``pfctl``,
|
||
``rcctl``, ``signify``, and ``vmctl`` (:issue:`4584`)
|
||
- ``openocd``
|
||
- ``optipng``
|
||
- ``opkg`` (:issue:`5168`)
|
||
- ``pandoc`` (:issue:`2937`)
|
||
- ``port`` (:issue:`4737`)
|
||
- ``powerpill`` (:issue:`4800`)
|
||
- ``pstack`` (:issue:`5135`)
|
||
- ``serve`` (:issue:`5026`)
|
||
- ``ttx``
|
||
- ``unzip``
|
||
- ``virsh`` (:issue:`5113`)
|
||
- ``xclip`` (:issue:`5126`)
|
||
- ``xsv``
|
||
- ``zfs`` and ``zpool`` (:issue:`4608`)
|
||
|
||
- Lots of improvements to completions (especially ``darcs`` (:issue:`5112`),
|
||
``git``, ``hg`` and ``sudo``).
|
||
- Completions for ``yarn`` and ``npm`` now require the
|
||
``all-the-package-names`` NPM package for full functionality.
|
||
- Completions for ``bower`` and ``yarn`` now require the ``jq`` utility
|
||
for full functionality.
|
||
- Improved French translations.
|
||
|
||
Other fixes and improvements
|
||
----------------------------
|
||
|
||
- Significant performance improvements to ``abbr`` (:issue:`4048`), setting
|
||
variables (:issue:`4200`, :issue:`4341`), executing functions, globs (:issue:`4579`),
|
||
``string`` reading from standard input (:issue:`4610`), and slicing history
|
||
(in particular, ``$history[1]`` for the last executed command).
|
||
- Fish’s internal wcwidth function has been updated to deal with newer
|
||
Unicode, and the width of some characters can be configured via the
|
||
``fish_ambiguous_width`` (:issue:`5149`) and ``fish_emoji_width`` (:issue:`2652`)
|
||
variables. Alternatively, a new build-time option INTERNAL_WCWIDTH
|
||
can be used to use the system’s wcwidth instead (:issue:`4816`).
|
||
- ``functions`` correctly supports ``-d`` as the short form of
|
||
``--description``. (:issue:`5105`)
|
||
- ``/etc/paths`` is now parsed like macOS’ bash ``path_helper``, fixing
|
||
$PATH order (:issue:`4336`, :issue:`4852`) on macOS.
|
||
- Using a read-only variable in a ``for`` loop produces an error,
|
||
rather than silently producing incorrect results (:issue:`4342`).
|
||
- The universal variables filename no longer contains the hostname or
|
||
MAC address. It is now at the fixed location
|
||
``.config/fish/fish_variables`` (:issue:`1912`).
|
||
- Exported variables in the global or universal scope no longer have
|
||
their exported status affected by local variables (:issue:`2611`).
|
||
- Major rework of terminal and job handling to eliminate bugs (:issue:`3805`,
|
||
:issue:`3952`, :issue:`4178`, :issue:`4235`, :issue:`4238`, :issue:`4540`, :issue:`4929`, :issue:`5210`).
|
||
- Improvements to the manual page completion generator (:issue:`2937`, :issue:`4313`).
|
||
- ``suspend --force`` now works correctly (:issue:`4672`).
|
||
- Pressing Ctrl-C while running a script now reliably terminates fish
|
||
(:issue:`5253`).
|
||
|
||
.. _for-distributors-and-developers-2:
|
||
|
||
For distributors and developers
|
||
-------------------------------
|
||
|
||
- fish ships with a new build system based on CMake. CMake 3.2 is the
|
||
minimum required version. Although the autotools-based Makefile and
|
||
the Xcode project are still shipped with this release, they will be
|
||
removed in the near future. All distributors and developers are
|
||
encouraged to migrate to the CMake build.
|
||
- Build scripts for most platforms no longer require bash, using the
|
||
standard sh instead.
|
||
- The ``hostname`` command is no longer required for fish to operate.
|
||
|
||
–
|
||
|
||
fish 2.7.1 (released December 23, 2017)
|
||
=======================================
|
||
|
||
This release of fish fixes an issue where iTerm 2 on macOS would display
|
||
a warning about paste bracketing being left on when starting a new fish
|
||
session (:issue:`4521`).
|
||
|
||
If you are upgrading from version 2.6.0 or before, please also review
|
||
the release notes for 2.7.0 and 2.7b1 (included below).
|
||
|
||
–
|
||
|
||
fish 2.7.0 (released November 23, 2017)
|
||
=======================================
|
||
|
||
There are no major changes between 2.7b1 and 2.7.0. If you are upgrading
|
||
from version 2.6.0 or before, please also review the release notes for
|
||
2.7b1 (included below).
|
||
|
||
Xcode builds and macOS packages could not be produced with 2.7b1, but
|
||
this is fixed in 2.7.0.
|
||
|
||
–
|
||
|
||
fish 2.7b1 (released October 31, 2017)
|
||
======================================
|
||
|
||
Notable improvements
|
||
--------------------
|
||
|
||
- A new ``cdh`` (change directory using recent history) command
|
||
provides a more friendly alternative to prevd/nextd and pushd/popd
|
||
(:issue:`2847`).
|
||
- A new ``argparse`` command is available to allow fish script to parse
|
||
arguments with the same behavior as builtin commands. This also
|
||
includes the ``fish_opt`` helper command. (:issue:`4190`).
|
||
- Invalid array indexes are now silently ignored (:issue:`826`, :issue:`4127`).
|
||
- Improvements to the debugging facility, including a prompt specific
|
||
to the debugger (``fish_breakpoint_prompt``) and a
|
||
``status is-breakpoint`` subcommand (:issue:`1310`).
|
||
- ``string`` supports new ``lower`` and ``upper`` subcommands, for
|
||
altering the case of strings (:issue:`4080`). The case changing is not
|
||
locale-aware yet.- ``string escape`` has a new ``--style=xxx`` flag
|
||
where ``xxx`` can be ``script``, ``var``, or ``url`` (:issue:`4150`), and can
|
||
be reversed with ``string unescape`` (:issue:`3543`).
|
||
- History can now be split into sessions with the ``fish_history``
|
||
variable, or not saved to disk at all (:issue:`102`).
|
||
- Read history is now controlled by the ``fish_history`` variable
|
||
rather than the ``--mode-name`` flag (:issue:`1504`).
|
||
- ``command`` now supports an ``--all`` flag to report all directories
|
||
with the command. ``which`` is no longer a runtime dependency
|
||
(:issue:`2778`).
|
||
- fish can run commands before starting an interactive session using
|
||
the new ``--init-command``/``-C`` options (:issue:`4164`).
|
||
- ``set`` has a new ``--show`` option to show lots of information about
|
||
variables (:issue:`4265`).
|
||
|
||
Other significant changes
|
||
-------------------------
|
||
|
||
- The ``COLUMNS`` and ``LINES`` environment variables are now correctly
|
||
set the first time ``fish_prompt`` is run (:issue:`4141`).
|
||
|
||
- ``complete``\ ’s ``--no-files`` option works as intended (:issue:`112`).
|
||
|
||
- ``echo -h`` now correctly echoes ``-h`` in line with other shells
|
||
(:issue:`4120`).
|
||
|
||
- The ``export`` compatibility function now returns zero on success,
|
||
rather than always returning 1 (:issue:`4435`).
|
||
|
||
- Stop converting empty elements in MANPATH to “.” (:issue:`4158`). The
|
||
behavior being changed was introduced in fish 2.6.0.
|
||
|
||
- ``count -h`` and ``count --help`` now return 1 rather than produce
|
||
command help output (:issue:`4189`).
|
||
|
||
- An attempt to ``read`` which stops because too much data is available
|
||
still defines the variables given as parameters (:issue:`4180`).
|
||
|
||
- A regression in fish 2.4.0 which prevented ``pushd +1`` from working
|
||
has been fixed (:issue:`4091`).
|
||
|
||
- A regression in fish 2.6.0 where multiple ``read`` commands in
|
||
non-interactive scripts were broken has been fixed (:issue:`4206`).
|
||
|
||
- A regression in fish 2.6.0 involving universal variables with
|
||
side-effects at startup such as ``set -U fish_escape_delay_ms 10``
|
||
has been fixed (:issue:`4196`).
|
||
|
||
- Added completions for:
|
||
|
||
- ``as`` (:issue:`4130`)
|
||
- ``cdh`` (:issue:`2847`)
|
||
- ``dhcpd`` (:issue:`4115`)
|
||
- ``ezjail-admin`` (:issue:`4324`)
|
||
- Fabric’s ``fab`` (:issue:`4153`)
|
||
- ``grub-file`` (:issue:`4119`)
|
||
- ``grub-install`` (:issue:`4119`)
|
||
- ``jest`` (:issue:`4142`)
|
||
- ``kdeconnect-cli``
|
||
- ``magneto`` (:issue:`4043`, :issue:`4108`)
|
||
- ``mdadm`` (:issue:`4198`)
|
||
- ``passwd`` (:issue:`4209`)
|
||
- ``pip`` and ``pipenv`` (:issue:`4448`)
|
||
- ``s3cmd`` (:issue:`4332`)
|
||
- ``sbt`` (:issue:`4347`)
|
||
- ``snap`` (:issue:`4215`)
|
||
- Sublime Text 3’s ``subl`` (:issue:`4277`)
|
||
|
||
- Lots of improvements to completions.
|
||
|
||
- Updated Chinese and French translations.
|
||
|
||
- Improved completions for:
|
||
|
||
- ``apt``
|
||
|
||
- ``cd`` (:issue:`4061`)
|
||
|
||
- ``composer`` (:issue:`4295`)
|
||
|
||
- ``eopkg``
|
||
|
||
- ``flatpak`` (:issue:`4456`)
|
||
|
||
- ``git`` (:issue:`4117`, :issue:`4147`, :issue:`4329`, :issue:`4368`)
|
||
|
||
- ``gphoto2``
|
||
|
||
- ``killall`` (:issue:`4052`)
|
||
|
||
- ``ln``
|
||
|
||
- ``npm`` (:issue:`4241`)
|
||
|
||
- ``ssh`` (:issue:`4377`)
|
||
|
||
- ``tail``
|
||
|
||
- ``xdg-mime`` (:issue:`4333`)
|
||
|
||
- ``zypper`` (:issue:`4325`)
|
||
|
||
fish 2.6.0 (released June 3, 2017)
|
||
==================================
|
||
|
||
Since the beta release of fish 2.6b1, fish version 2.6.0 contains a
|
||
number of minor fixes, new completions for ``magneto`` (:issue:`4043`), and
|
||
improvements to the documentation.
|
||
|
||
.. _known-issues-1:
|
||
|
||
Known issues
|
||
------------
|
||
|
||
- Apple macOS Sierra 10.12.5 introduced a problem with launching web
|
||
browsers from other programs using AppleScript. This affects the fish
|
||
Web configuration (``fish_config``); users on these platforms will
|
||
need to manually open the address displayed in the terminal, such as
|
||
by copying and pasting it into a browser. This problem will be fixed
|
||
with macOS 10.12.6.
|
||
|
||
If you are upgrading from version 2.5.0 or before, please also review
|
||
the release notes for 2.6b1 (included below).
|
||
|
||
--------------
|
||
|
||
fish 2.6b1 (released May 14, 2017)
|
||
==================================
|
||
|
||
.. _notable-fixes-and-improvements-1:
|
||
|
||
Notable fixes and improvements
|
||
------------------------------
|
||
|
||
- Jobs running in the background can now be removed from the list of
|
||
jobs with the new ``disown`` builtin, which behaves like the same
|
||
command in other shells (:issue:`2810`).
|
||
- Command substitutions now have access to the terminal, like in other
|
||
shells. This allows tools like ``fzf`` to work properly (:issue:`1362`,
|
||
:issue:`3922`).
|
||
- In cases where the operating system does not report the size of the
|
||
terminal, the ``COLUMNS`` and ``LINES`` environment variables are
|
||
used; if they are unset, a default of 80x24 is assumed.
|
||
- New French (:issue:`3772` & :issue:`3788`) and improved German (:issue:`3834`) translations.
|
||
- fish no longer depends on the ``which`` external command.
|
||
|
||
.. _other-significant-changes-1:
|
||
|
||
Other significant changes
|
||
-------------------------
|
||
|
||
- Performance improvements in launching processes, including major
|
||
reductions in signal blocking. Although this has been heavily tested,
|
||
it may cause problems in some circumstances; set the
|
||
``FISH_NO_SIGNAL_BLOCK`` variable to 0 in your fish configuration
|
||
file to return to the old behaviour (:issue:`2007`).
|
||
- Performance improvements in prompts and functions that set lots of
|
||
colours (:issue:`3793`).
|
||
- The Delete key no longer deletes backwards (a regression in 2.5.0).
|
||
- ``functions`` supports a new ``--details`` option, which identifies
|
||
where the function was loaded from (:issue:`3295`), and a
|
||
``--details --verbose`` option which includes the function
|
||
description (:issue:`597`).
|
||
- ``read`` will read up to 10 MiB by default, leaving the target
|
||
variable empty and exiting with status 122 if the line is too long.
|
||
You can set a different limit with the ``FISH_READ_BYTE_LIMIT``
|
||
variable.
|
||
- ``read`` supports a new ``--silent`` option to hide the characters
|
||
typed (:issue:`838`), for when reading sensitive data from the terminal.
|
||
``read`` also now accepts simple strings for the prompt (rather than
|
||
scripts) with the new ``-P`` and ``--prompt-str`` options (:issue:`802`).
|
||
- ``export`` and ``setenv`` now understand colon-separated ``PATH``,
|
||
``CDPATH`` and ``MANPATH`` variables.
|
||
- ``setenv`` is no longer a simple alias for ``set -gx`` and will
|
||
complain, just like the csh version, if given more than one value
|
||
(:issue:`4103`).
|
||
- ``bind`` supports a new ``--list-modes`` option (:issue:`3872`).
|
||
- ``bg`` will check all of its arguments before backgrounding any jobs;
|
||
any invalid arguments will cause a failure, but non-existent (eg
|
||
recently exited) jobs are ignored (:issue:`3909`).
|
||
- ``funced`` warns if the function being edited has not been modified
|
||
(:issue:`3961`).
|
||
- ``printf`` correctly outputs “long long” integers (:issue:`3352`).
|
||
- ``status`` supports a new ``current-function`` subcommand to print
|
||
the current function name (:issue:`1743`).
|
||
- ``string`` supports a new ``repeat`` subcommand (:issue:`3864`).
|
||
``string match`` supports a new ``--entire`` option to emit the
|
||
entire line matched by a pattern (:issue:`3957`). ``string replace`` supports
|
||
a new ``--filter`` option to only emit lines which underwent a
|
||
replacement (:issue:`3348`).
|
||
- ``test`` supports the ``-k`` option to test for sticky bits (:issue:`733`).
|
||
- ``umask`` understands symbolic modes (:issue:`738`).
|
||
- Empty components in the ``CDPATH``, ``MANPATH`` and ``PATH``
|
||
variables are now converted to “.” (:issue:`2106`, :issue:`3914`).
|
||
- New versions of ncurses (6.0 and up) wipe terminal scrollback buffers
|
||
with certain commands; the ``C-l`` binding tries to avoid this
|
||
(:issue:`2855`).
|
||
- Some systems’ ``su`` implementations do not set the ``USER``
|
||
environment variable; it is now reset for root users (:issue:`3916`).
|
||
- Under terminals which support it, bracketed paste is enabled,
|
||
escaping problematic characters for security and convience (:issue:`3871`).
|
||
Inside single quotes (``'``), single quotes and backslashes in pasted
|
||
text are escaped (:issue:`967`). The ``fish_clipboard_paste`` function (bound
|
||
to ``C-v`` by default) is still the recommended pasting method where
|
||
possible as it includes this functionality and more.
|
||
- Processes in pipelines are no longer signalled as soon as one command
|
||
in the pipeline has completed (:issue:`1926`). This behaviour matches other
|
||
shells mre closely.
|
||
- All functions requiring Python work with whichever version of Python
|
||
is installed (:issue:`3970`). Python 3 is preferred, but Python 2.6 remains
|
||
the minimum version required.
|
||
- The color of the cancellation character can be controlled by the
|
||
``fish_color_cancel`` variable (:issue:`3963`).
|
||
- Added completions for:
|
||
- ``caddy`` (:issue:`4008`)
|
||
- ``castnow`` (:issue:`3744`)
|
||
- ``climate`` (:issue:`3760`)
|
||
- ``flatpak``
|
||
- ``gradle`` (:issue:`3859`)
|
||
- ``gsettings`` (:issue:`4001`)
|
||
- ``helm`` (:issue:`3829`)
|
||
- ``i3-msg`` (:issue:`3787`)
|
||
- ``ipset`` (:issue:`3924`)
|
||
- ``jq`` (:issue:`3804`)
|
||
- ``light`` (:issue:`3752`)
|
||
- ``minikube`` (:issue:`3778`)
|
||
- ``mocha`` (:issue:`3828`)
|
||
- ``mkdosfs`` (:issue:`4017`)
|
||
- ``pv`` (:issue:`3773`)
|
||
- ``setsid`` (:issue:`3791`)
|
||
- ``terraform`` (:issue:`3960`)
|
||
- ``usermod`` (:issue:`3775`)
|
||
- ``xinput``
|
||
- ``yarn`` (:issue:`3816`)
|
||
- Improved completions for ``adb`` (:issue:`3853`), ``apt`` (:issue:`3771`), ``bzr``
|
||
(:issue:`3769`), ``dconf``, ``git`` (including :issue:`3743`), ``grep`` (:issue:`3789`),
|
||
``go`` (:issue:`3789`), ``help`` (:issue:`3789`), ``hg`` (:issue:`3975`), ``htop`` (:issue:`3789`),
|
||
``killall`` (:issue:`3996`), ``lua``, ``man`` (:issue:`3762`), ``mount`` (:issue:`3764` &
|
||
:issue:`3841`), ``obnam`` (:issue:`3924`), ``perl`` (:issue:`3856`), ``portmaster`` (:issue:`3950`),
|
||
``python`` (:issue:`3840`), ``ssh`` (:issue:`3781`), ``scp`` (:issue:`3781`), ``systemctl``
|
||
(:issue:`3757`) and ``udisks`` (:issue:`3764`).
|
||
|
||
--------------
|
||
|
||
fish 2.5.0 (released February 3, 2017)
|
||
======================================
|
||
|
||
There are no major changes between 2.5b1 and 2.5.0. If you are upgrading
|
||
from version 2.4.0 or before, please also review the release notes for
|
||
2.5b1 (included below).
|
||
|
||
.. _notable-fixes-and-improvements-2:
|
||
|
||
Notable fixes and improvements
|
||
------------------------------
|
||
|
||
- The Home, End, Insert, Delete, Page Up and Page Down keys work in
|
||
Vi-style key bindings (:issue:`3731`).
|
||
|
||
--------------
|
||
|
||
fish 2.5b1 (released January 14, 2017)
|
||
======================================
|
||
|
||
Platform Changes
|
||
----------------
|
||
|
||
Starting with version 2.5, fish requires a more up-to-date version of
|
||
C++, specifically C++11 (from 2011). This affects some older platforms:
|
||
|
||
Linux
|
||
^^^^^
|
||
|
||
For users building from source, GCC’s g++ 4.8 or later, or LLVM’s clang
|
||
3.3 or later, are known to work. Older platforms may require a newer
|
||
compiler installed.
|
||
|
||
Unfortunately, because of the complexity of the toolchain, binary
|
||
packages are no longer published by the fish-shell developers for the
|
||
following platforms:
|
||
|
||
- Red Hat Enterprise Linux and CentOS 5 & 6 for 64-bit builds
|
||
- Ubuntu 12.04 (EoLTS April 2017)
|
||
- Debian 7 (EoLTS May 2018)
|
||
|
||
Installing newer version of fish on these systems will require building
|
||
from source.
|
||
|
||
OS X SnowLeopard
|
||
^^^^^^^^^^^^^^^^
|
||
|
||
Starting with version 2.5, fish requires a C++11 standard library on OS
|
||
X 10.6 (“SnowLeopard”). If this library is not installed, you will see
|
||
this error: ``dyld: Library not loaded: /usr/lib/libc++.1.dylib``
|
||
|
||
MacPorts is the easiest way to obtain this library. After installing the
|
||
SnowLeopard MacPorts release from the install page, run:
|
||
|
||
::
|
||
|
||
sudo port -v install libcxx
|
||
|
||
Now fish should launch successfully. (Please open an issue if it does
|
||
not.)
|
||
|
||
This is only necessary on 10.6. OS X 10.7 and later include the required
|
||
library by default.
|
||
|
||
.. _other-significant-changes-2:
|
||
|
||
Other significant changes
|
||
-------------------------
|
||
|
||
- Attempting to exit with running processes in the background produces
|
||
a warning, then signals them to terminate if a second attempt to exit
|
||
is made. This brings the behaviour for running background processes
|
||
into line with stopped processes. (:issue:`3497`)
|
||
- ``random`` can now have start, stop and step values specified, or the
|
||
new ``choice`` subcommand can be used to pick an argument from a list
|
||
(:issue:`3619`).
|
||
- A new key bindings preset, ``fish_hybrid_key_bindings``, including
|
||
all the Emacs-style and Vi-style bindings, which behaves like
|
||
``fish_vi_key_bindings`` in fish 2.3.0 (:issue:`3556`).
|
||
- ``function`` now returns an error when called with invalid options,
|
||
rather than defining the function anyway (:issue:`3574`). This was a
|
||
regression present in fish 2.3 and 2.4.0.
|
||
- fish no longer prints a warning when it identifies a running instance
|
||
of an old version (2.1.0 and earlier). Changes to universal variables
|
||
may not propagate between these old versions and 2.5b1.
|
||
- Improved compatiblity with Android (:issue:`3585`), MSYS/mingw (:issue:`2360`), and
|
||
Solaris (:issue:`3456`, :issue:`3340`).
|
||
- Like other shells, the ``test`` builting now returns an error for
|
||
numeric operations on invalid integers (:issue:`3346`, :issue:`3581`).
|
||
- ``complete`` no longer recognises ``--authoritative`` and
|
||
``--unauthoritative`` options, and they are marked as obsolete.
|
||
- ``status`` accepts subcommands, and should be used like
|
||
``status is-interactive``. The old options continue to be supported
|
||
for the foreseeable future (:issue:`3526`), although only one subcommand or
|
||
option can be specified at a time.
|
||
- Selection mode (used with “begin-selection”) no longer selects a
|
||
character the cursor does not move over (:issue:`3684`).
|
||
- List indexes are handled better, and a bit more liberally in some
|
||
cases (``echo $PATH[1 .. 3]`` is now valid) (:issue:`3579`).
|
||
- The ``fish_mode_prompt`` function is now simply a stub around
|
||
``fish_default_mode_prompt``, which allows the mode prompt to be
|
||
included more easily in customised prompt functions (:issue:`3641`).
|
||
|
||
.. _notable-fixes-and-improvements-3:
|
||
|
||
Notable fixes and improvements
|
||
------------------------------
|
||
|
||
- ``alias``, run without options or arguments, lists all defined
|
||
aliases, and aliases now include a description in the function
|
||
signature that identifies them.
|
||
- ``complete`` accepts empty strings as descriptions (:issue:`3557`).
|
||
- ``command`` accepts ``-q``/``--quiet`` in combination with
|
||
``--search`` (:issue:`3591`), providing a simple way of checking whether a
|
||
command exists in scripts.
|
||
- Abbreviations can now be renamed with
|
||
``abbr --rename OLD_KEY NEW_KEY`` (:issue:`3610`).
|
||
- The command synopses printed by ``--help`` options work better with
|
||
copying and pasting (:issue:`2673`).
|
||
- ``help`` launches the browser specified by the
|
||
``$fish_help_browser variable`` if it is set (:issue:`3131`).
|
||
- History merging could lose items under certain circumstances and is
|
||
now fixed (:issue:`3496`).
|
||
- The ``$status`` variable is now set to 123 when a syntactically
|
||
invalid command is entered (:issue:`3616`).
|
||
- Exiting fish now signals all background processes to terminate, not
|
||
just stopped jobs (:issue:`3497`).
|
||
- A new ``prompt_hostname`` function which prints a hostname suitable
|
||
for use in prompts (:issue:`3482`).
|
||
- The ``__fish_man_page`` function (bound to Alt-h by default) now
|
||
tries to recognize subcommands (e.g. ``git add`` will now open the
|
||
“git-add” man page) (:issue:`3678`).
|
||
- A new function ``edit_command_buffer`` (bound to Alt-e & Alt-v by
|
||
default) to edit the command buffer in an external editor (:issue:`1215`,
|
||
:issue:`3627`).
|
||
- ``set_color`` now supports italics (``--italics``), dim (``--dim``)
|
||
and reverse (``--reverse``) modes (:issue:`3650`).
|
||
- Filesystems with very slow locking (eg incorrectly-configured NFS)
|
||
will no longer slow fish down (:issue:`685`).
|
||
- Improved completions for ``apt`` (:issue:`3695`), ``fusermount`` (:issue:`3642`),
|
||
``make`` (:issue:`3628`), ``netctl-auto`` (:issue:`3378`), ``nmcli`` (:issue:`3648`),
|
||
``pygmentize`` (:issue:`3378`), and ``tar`` (:issue:`3719`).
|
||
- Added completions for:
|
||
- ``VBoxHeadless`` (:issue:`3378`)
|
||
- ``VBoxSDL`` (:issue:`3378`)
|
||
- ``base64`` (:issue:`3378`)
|
||
- ``caffeinate`` (:issue:`3524`)
|
||
- ``dconf`` (:issue:`3638`)
|
||
- ``dig`` (:issue:`3495`)
|
||
- ``dpkg-reconfigure`` (:issue:`3521` & :issue:`3522`)
|
||
- ``feh`` (:issue:`3378`)
|
||
- ``launchctl`` (:issue:`3682`)
|
||
- ``lxc`` (:issue:`3554` & :issue:`3564`),
|
||
- ``mddiagnose`` (:issue:`3524`)
|
||
- ``mdfind`` (:issue:`3524`)
|
||
- ``mdimport`` (:issue:`3524`)
|
||
- ``mdls`` (:issue:`3524`)
|
||
- ``mdutil`` (:issue:`3524`)
|
||
- ``mkvextract`` (:issue:`3492`)
|
||
- ``nvram`` (:issue:`3524`)
|
||
- ``objdump`` (:issue:`3378`)
|
||
- ``sysbench`` (:issue:`3491`)
|
||
- ``tmutil`` (:issue:`3524`)
|
||
|
||
--------------
|
||
|
||
fish 2.4.0 (released November 8, 2016)
|
||
======================================
|
||
|
||
There are no major changes between 2.4b1 and 2.4.0.
|
||
|
||
.. _notable-fixes-and-improvements-4:
|
||
|
||
Notable fixes and improvements
|
||
------------------------------
|
||
|
||
- The documentation is now generated properly and with the correct
|
||
version identifier.
|
||
- Automatic cursor changes are now only enabled on the subset of XTerm
|
||
versions known to support them, resolving a problem where older
|
||
versions printed garbage to the terminal before and after every
|
||
prompt (:issue:`3499`).
|
||
- Improved the title set in Apple Terminal.app.
|
||
- Added completions for ``defaults`` and improved completions for
|
||
``diskutil`` (:issue:`3478`).
|
||
|
||
--------------
|
||
|
||
fish 2.4b1 (released October 18, 2016)
|
||
======================================
|
||
|
||
Significant changes
|
||
-------------------
|
||
|
||
- The clipboard integration has been revamped with explicit bindings.
|
||
The killring commands no longer copy from, or paste to, the X11
|
||
clipboard - use the new copy (``C-x``) and paste (``C-v``) bindings
|
||
instead. The clipboard is now available on OS X as well as systems
|
||
using X11 (e.g. Linux). (:issue:`3061`)
|
||
- ``history`` uses subcommands (``history delete``) rather than options
|
||
(``history --delete``) for its actions (:issue:`3367`). You can no longer
|
||
specify multiple actions via flags (e.g.,
|
||
``history --delete --save something``).
|
||
- New ``history`` options have been added, including ``--max=n`` to
|
||
limit the number of history entries, ``--show-time`` option to show
|
||
timestamps (:issue:`3175`, :issue:`3244`), and ``--null`` to null terminate history
|
||
entries in the search output.
|
||
- ``history search`` is now case-insensitive by default (which also
|
||
affects ``history delete``) (:issue:`3236`).
|
||
- ``history delete`` now correctly handles multiline commands (:issue:`31`).
|
||
- Vi-style bindings no longer include all of the default emacs-style
|
||
bindings; instead, they share some definitions (:issue:`3068`).
|
||
- If there is no locale set in the environment, various known system
|
||
configuration files will be checked for a default. If no locale can
|
||
be found, ``en_US-UTF.8`` will be used (:issue:`277`).
|
||
- A number followed by a caret (e.g. ``5^``) is no longer treated as a
|
||
redirection (:issue:`1873`).
|
||
- The ``$version`` special variable can be overwritten, so that it can
|
||
be used for other purposes if required.
|
||
|
||
.. _notable-fixes-and-improvements-5:
|
||
|
||
Notable fixes and improvements
|
||
------------------------------
|
||
|
||
- The ``fish_realpath`` builtin has been renamed to ``realpath`` and
|
||
made compatible with GNU ``realpath`` when run without arguments
|
||
(:issue:`3400`). It is used only for systems without a ``realpath`` or
|
||
``grealpath`` utility (:issue:`3374`).
|
||
- Improved color handling on terminals/consoles with 8-16 colors,
|
||
particularly the use of bright named color (:issue:`3176`, :issue:`3260`).
|
||
- ``fish_indent`` can now read from files given as arguments, rather
|
||
than just standard input (:issue:`3037`).
|
||
- Fuzzy tab completions behave in a less surprising manner (:issue:`3090`,
|
||
:issue:`3211`).
|
||
- ``jobs`` should only print its header line once (:issue:`3127`).
|
||
- Wildcards in redirections are highlighted appropriately (:issue:`2789`).
|
||
- Suggestions will be offered more often, like after removing
|
||
characters (:issue:`3069`).
|
||
- ``history --merge`` now correctly interleaves items in chronological
|
||
order (:issue:`2312`).
|
||
- Options for ``fish_indent`` have been aligned with the other binaries
|
||
- in particular, ``-d`` now means ``--debug``. The ``--dump`` option
|
||
has been renamed to ``--dump-parse-tree`` (:issue:`3191`).
|
||
- The display of bindings in the Web-based configuration has been
|
||
greatly improved (:issue:`3325`), as has the rendering of prompts (:issue:`2924`).
|
||
- fish should no longer hang using 100% CPU in the C locale (:issue:`3214`).
|
||
- A bug in FreeBSD 11 & 12, Dragonfly BSD & illumos prevented fish from
|
||
working correctly on these platforms under UTF-8 locales; fish now
|
||
avoids the buggy behaviour (:issue:`3050`).
|
||
- Prompts which show git repository information (via
|
||
``__fish_git_prompt``) are faster in large repositories (:issue:`3294`) and
|
||
slow filesystems (:issue:`3083`).
|
||
- fish 2.3.0 reintroduced a problem where the greeting was printed even
|
||
when using ``read``; this has been corrected again (:issue:`3261`).
|
||
- Vi mode changes the cursor depending on the current mode (:issue:`3215`).
|
||
- Command lines with escaped space characters at the end tab-complete
|
||
correctly (:issue:`2447`).
|
||
- Added completions for:
|
||
|
||
- ``arcanist`` (:issue:`3256`)
|
||
- ``connmanctl`` (:issue:`3419`)
|
||
- ``figlet`` (:issue:`3378`)
|
||
- ``mdbook`` (:issue:`3378`)
|
||
- ``ninja`` (:issue:`3415`)
|
||
- ``p4``, the Perforce client (:issue:`3314`)
|
||
- ``pygmentize`` (:issue:`3378`)
|
||
- ``ranger`` (:issue:`3378`)
|
||
|
||
- Improved completions for ``aura`` (:issue:`3297`), ``abbr`` (:issue:`3267`), ``brew``
|
||
(:issue:`3309`), ``chown`` (:issue:`3380`, :issue:`3383`),\ ``cygport`` (:issue:`3392`), ``git``
|
||
(:issue:`3274`, :issue:`3226`, :issue:`3225`, :issue:`3094`, :issue:`3087`, :issue:`3035`, :issue:`3021`, :issue:`2982`, :issue:`3230`),
|
||
``kill`` & ``pkill`` (:issue:`3200`), ``screen`` (:issue:`3271`), ``wget`` (:issue:`3470`),
|
||
and ``xz`` (:issue:`3378`).
|
||
- Distributors, packagers and developers will notice that the build
|
||
process produces more succinct output by default; use ``make V=1`` to
|
||
get verbose output (:issue:`3248`).
|
||
- Improved compatibility with minor platforms including musl (:issue:`2988`),
|
||
Cygwin (:issue:`2993`), Android (:issue:`3441`, :issue:`3442`), Haiku (:issue:`3322`) and Solaris .
|
||
|
||
--------------
|
||
|
||
fish 2.3.1 (released July 3, 2016)
|
||
==================================
|
||
|
||
This is a functionality and bugfix release. This release does not
|
||
contain all the changes to fish since the last release, but fixes a
|
||
number of issues directly affecting users at present and includes a
|
||
small number of new features.
|
||
|
||
.. _significant-changes-1:
|
||
|
||
Significant changes
|
||
-------------------
|
||
|
||
- A new ``fish_key_reader`` binary for decoding interactive keypresses
|
||
(:issue:`2991`).
|
||
- ``fish_mode_prompt`` has been updated to reflect the changes in the
|
||
way the Vi input mode is set up (:issue:`3067`), making this more reliable.
|
||
- ``fish_config`` can now properly be launched from the OS X app bundle
|
||
(:issue:`3140`).
|
||
|
||
.. _notable-fixes-and-improvements-6:
|
||
|
||
Notable fixes and improvements
|
||
------------------------------
|
||
|
||
- Extra lines were sometimes inserted into the output under Windows
|
||
(Cygwin and Microsoft Windows Subsystem for Linux) due to TTY
|
||
timestamps not being updated (:issue:`2859`).
|
||
- The ``string`` builtin’s ``match`` mode now handles the combination
|
||
of ``-rnv`` (match, invert and count) correctly (:issue:`3098`).
|
||
- Improvements to TTY special character handling (:issue:`3064`), locale
|
||
handling (:issue:`3124`) and terminal environment variable handling (:issue:`3060`).
|
||
- Work towards handling the terminal modes for external commands
|
||
launched from initialisation files (:issue:`2980`).
|
||
- Ease the upgrade path from fish 2.2.0 and before by warning users to
|
||
restart fish if the ``string`` builtin is not available (:issue:`3057`).
|
||
- ``type -a`` now syntax-colorizes function source output.
|
||
- Added completions for ``alsamixer``, ``godoc``, ``gofmt``,
|
||
``goimports``, ``gorename``, ``lscpu``, ``mkdir``, ``modinfo``,
|
||
``netctl-auto``, ``poweroff``, ``termite``, ``udisksctl`` and ``xz``
|
||
(:issue:`3123`).
|
||
- Improved completions for ``apt`` (:issue:`3097`), ``aura`` (:issue:`3102`),\ ``git``
|
||
(:issue:`3114`), ``npm`` (:issue:`3158`), ``string`` and ``suspend`` (:issue:`3154`).
|
||
|
||
--------------
|
||
|
||
fish 2.3.0 (released May 20, 2016)
|
||
==================================
|
||
|
||
There are no significant changes between 2.3.0 and 2.3b2.
|
||
|
||
Other notable fixes and improvements
|
||
------------------------------------
|
||
|
||
- ``abbr`` now allows non-letter keys (:issue:`2996`).
|
||
- Define a few extra colours on first start (:issue:`2987`).
|
||
- Multiple documentation updates.
|
||
- Added completions for rmmod (:issue:`3007`).
|
||
- Improved completions for git (:issue:`2998`).
|
||
|
||
.. _known-issues-2:
|
||
|
||
Known issues
|
||
------------
|
||
|
||
- Interactive commands started from fish configuration files or from
|
||
the ``-c`` option may, under certain circumstances, be started with
|
||
incorrect terminal modes and fail to behave as expected. A fix is
|
||
planned but requires further testing (:issue:`2619`).
|
||
|
||
--------------
|
||
|
||
fish 2.3b2 (released May 5, 2016)
|
||
=================================
|
||
|
||
.. _significant-changes-2:
|
||
|
||
Significant changes
|
||
-------------------
|
||
|
||
- A new ``fish_realpath`` builtin and associated function to allow the
|
||
use of ``realpath`` even on those platforms that don’t ship an
|
||
appropriate command (:issue:`2932`).
|
||
- Alt-# toggles the current command line between commented and
|
||
uncommented states, making it easy to save a command in history
|
||
without executing it.
|
||
- The ``fish_vi_mode`` function is now deprecated in favour of
|
||
``fish_vi_key_bindings``.
|
||
|
||
.. _other-notable-fixes-and-improvements-1:
|
||
|
||
Other notable fixes and improvements
|
||
------------------------------------
|
||
|
||
- Fix the build on Cygwin (:issue:`2952`) and RedHat Enterprise Linux/CentOS 5
|
||
(:issue:`2955`).
|
||
- Avoid confusing the terminal line driver with non-printing characters
|
||
in ``fish_title`` (:issue:`2453`).
|
||
- Improved completions for busctl, git (:issue:`2585`, :issue:`2879`, :issue:`2984`), and
|
||
netctl.
|
||
|
||
--------------
|
||
|
||
fish 2.3b1 (released April 19, 2016)
|
||
====================================
|
||
|
||
.. _significant-changes-3:
|
||
|
||
Significant Changes
|
||
-------------------
|
||
|
||
- A new ``string`` builtin to handle… strings! This builtin will
|
||
measure, split, search and replace text strings, including using
|
||
regular expressions. It can also be used to turn lists into plain
|
||
strings using ``join``. ``string`` can be used in place of ``sed``,
|
||
``grep``, ``tr``, ``cut``, and ``awk`` in many situations. (:issue:`2296`)
|
||
- Allow using escape as the Meta modifier key, by waiting after seeing
|
||
an escape character wait up to 300ms for an additional character.
|
||
This is consistent with readline (e.g. bash) and can be configured
|
||
via the ``fish_escape_delay_ms variable``. This allows using escape
|
||
as the Meta modifier. (:issue:`1356`)
|
||
- Add new directories for vendor functions and configuration snippets
|
||
(:issue:`2500`)
|
||
- A new ``fish_realpath`` builtin and associated ``realpath`` function
|
||
should allow scripts to resolve path names via ``realpath``
|
||
regardless of whether there is an external command of that name;
|
||
albeit with some limitations. See the associated documentation.
|
||
|
||
Backward-incompatible changes
|
||
-----------------------------
|
||
|
||
- Unmatched globs will now cause an error, except when used with
|
||
``for``, ``set`` or ``count`` (:issue:`2719`)
|
||
- ``and`` and ``or`` will now bind to the closest ``if`` or ``while``,
|
||
allowing compound conditions without ``begin`` and ``end`` (:issue:`1428`)
|
||
- ``set -ql`` now searches up to function scope for variables (:issue:`2502`)
|
||
- ``status -f`` will now behave the same when run as the main script or
|
||
using ``source`` (:issue:`2643`)
|
||
- ``source`` no longer puts the file name in ``$argv`` if no arguments
|
||
are given (:issue:`139`)
|
||
- History files are stored under the ``XDG_DATA_HOME`` hierarchy (by
|
||
default, in ``~/.local/share``), and existing history will be moved
|
||
on first use (:issue:`744`)
|
||
|
||
.. _other-notable-fixes-and-improvements-2:
|
||
|
||
Other notable fixes and improvements
|
||
------------------------------------
|
||
|
||
- Fish no longer silences errors in config.fish (:issue:`2702`)
|
||
- Directory autosuggestions will now descend as far as possible if
|
||
there is only one child directory (:issue:`2531`)
|
||
- Add support for bright colors (:issue:`1464`)
|
||
- Allow Ctrl-J (`\cj`) to be bound separately from Ctrl-M
|
||
(`\cm`) (:issue:`217`)
|
||
- psub now has a “-s”/“–suffix” option to name the temporary file with
|
||
that suffix
|
||
- Enable 24-bit colors on select terminals (:issue:`2495`)
|
||
- Support for SVN status in the prompt (:issue:`2582`)
|
||
- Mercurial and SVN support have been added to the Classic + Git (now
|
||
Classic + VCS) prompt (via the new \__fish_vcs_prompt function)
|
||
(:issue:`2592`)
|
||
- export now handles variables with a “=” in the value (:issue:`2403`)
|
||
- New completions for:
|
||
|
||
- alsactl
|
||
- Archlinux’s asp, makepkg
|
||
- Atom’s apm (:issue:`2390`)
|
||
- entr - the “Event Notify Test Runner” (:issue:`2265`)
|
||
- Fedora’s dnf (:issue:`2638`)
|
||
- OSX diskutil (:issue:`2738`)
|
||
- pkgng (:issue:`2395`)
|
||
- pulseaudio’s pacmd and pactl
|
||
- rust’s rustc and cargo (:issue:`2409`)
|
||
- sysctl (:issue:`2214`)
|
||
- systemd’s machinectl (:issue:`2158`), busctl (:issue:`2144`), systemd-nspawn,
|
||
systemd-analyze, localectl, timedatectl
|
||
- and more
|
||
|
||
- Fish no longer has a function called sgrep, freeing it for user
|
||
customization (:issue:`2245`)
|
||
- A rewrite of the completions for cd, fixing a few bugs (:issue:`2299`, :issue:`2300`,
|
||
:issue:`562`)
|
||
- Linux VTs now run in a simplified mode to avoid issues (:issue:`2311`)
|
||
- The vi-bindings now inherit from the emacs bindings
|
||
- Fish will also execute ``fish_user_key_bindings`` when in vi-mode
|
||
- ``funced`` will now also check $VISUAL (:issue:`2268`)
|
||
- A new ``suspend`` function (:issue:`2269`)
|
||
- Subcommand completion now works better with split /usr (:issue:`2141`)
|
||
- The command-not-found-handler can now be overridden by defining a
|
||
function called ``__fish_command_not_found_handler`` in config.fish
|
||
(:issue:`2332`)
|
||
- A few fixes to the Sorin theme
|
||
- PWD shortening in the prompt can now be configured via the
|
||
``fish_prompt_pwd_dir_length`` variable, set to the length per path
|
||
component (:issue:`2473`)
|
||
- fish no longer requires ``/etc/fish/config.fish`` to correctly start,
|
||
and now ships a skeleton file that only contains some documentation
|
||
(:issue:`2799`)
|
||
|
||
--------------
|
||
|
||
fish 2.2.0 (released July 12, 2015)
|
||
===================================
|
||
|
||
.. _significant-changes-4:
|
||
|
||
Significant changes
|
||
-------------------
|
||
|
||
- Abbreviations: the new ``abbr`` command allows for
|
||
interactively-expanded abbreviations, allowing quick access to
|
||
frequently-used commands (:issue:`731`).
|
||
- Vi mode: run ``fish_vi_mode`` to switch fish into the key bindings
|
||
and prompt familiar to users of the Vi editor (:issue:`65`).
|
||
- New inline and interactive pager, which will be familiar to users of
|
||
zsh (:issue:`291`).
|
||
- Underlying architectural changes: the ``fishd`` universal variable
|
||
server has been removed as it was a source of many bugs and security
|
||
problems. Notably, old fish sessions will not be able to communicate
|
||
universal variable changes with new fish sessions. For best results,
|
||
restart all running instances of ``fish``.
|
||
- The web-based configuration tool has been redesigned, featuring a
|
||
prompt theme chooser and other improvements.
|
||
- New German, Brazilian Portuguese, and Chinese translations.
|
||
|
||
.. _backward-incompatible-changes-1:
|
||
|
||
Backward-incompatible changes
|
||
-----------------------------
|
||
|
||
These are kept to a minimum, but either change undocumented features or
|
||
are too hard to use in their existing forms. These changes may break
|
||
existing scripts.
|
||
|
||
- ``commandline`` no longer interprets functions “in reverse”, instead
|
||
behaving as expected (:issue:`1567`).
|
||
- The previously-undocumented ``CMD_DURATION`` variable is now set for
|
||
all commands and contains the execution time of the last command in
|
||
milliseconds (:issue:`1585`). It is no longer exported to other commands
|
||
(:issue:`1896`).
|
||
- ``if`` / ``else`` conditional statements now return values consistent
|
||
with the Single Unix Specification, like other shells (:issue:`1443`).
|
||
- A new “top-level” local scope has been added, allowing local
|
||
variables declared on the commandline to be visible to subsequent
|
||
commands. (:issue:`1908`)
|
||
|
||
.. _other-notable-fixes-and-improvements-3:
|
||
|
||
Other notable fixes and improvements
|
||
------------------------------------
|
||
|
||
- New documentation design (:issue:`1662`), which requires a Doxygen version
|
||
1.8.7 or newer to build.
|
||
- Fish now defines a default directory for other packages to provide
|
||
completions. By default this is
|
||
``/usr/share/fish/vendor-completions.d``; on systems with
|
||
``pkgconfig`` installed this path is discoverable with
|
||
``pkg-config --variable completionsdir fish``.
|
||
- A new parser removes many bugs; all existing syntax should keep
|
||
working.
|
||
- New ``fish_preexec`` and ``fish_postexec`` events are fired before
|
||
and after job execution respectively (:issue:`1549`).
|
||
- Unmatched wildcards no longer prevent a job from running. Wildcards
|
||
used interactively will still print an error, but the job will
|
||
proceed and the wildcard will expand to zero arguments (:issue:`1482`).
|
||
- The ``.`` command is deprecated and the ``source`` command is
|
||
preferred (:issue:`310`).
|
||
- ``bind`` supports “bind modes”, which allows bindings to be set for a
|
||
particular named mode, to support the implementation of Vi mode.
|
||
- A new ``export`` alias, which behaves like other shells (:issue:`1833`).
|
||
- ``command`` has a new ``--search`` option to print the name of the
|
||
disk file that would be executed, like other shells’ ``command -v``
|
||
(:issue:`1540`).
|
||
- ``commandline`` has a new ``--paging-mode`` option to support the new
|
||
pager.
|
||
- ``complete`` has a new ``--wraps`` option, which allows a command to
|
||
(recursively) inherit the completions of a wrapped command (:issue:`393`),
|
||
and ``complete -e`` now correctly erases completions (:issue:`380`).
|
||
- Completions are now generated from manual pages by default on the
|
||
first run of fish (:issue:`997`).
|
||
- ``fish_indent`` can now produce colorized (``--ansi``) and HTML
|
||
(``--html``) output (:issue:`1827`).
|
||
- ``functions --erase`` now prevents autoloaded functions from being
|
||
reloaded in the current session.
|
||
- ``history`` has a new ``--merge`` option, to incorporate history from
|
||
other sessions into the current session (:issue:`825`).
|
||
- ``jobs`` returns 1 if there are no active jobs (:issue:`1484`).
|
||
- ``read`` has several new options:
|
||
- ``--array`` to break input into an array (:issue:`1540`)
|
||
- ``--null`` to break lines on NUL characters rather than newlines
|
||
(:issue:`1694`)
|
||
- ``--nchars`` to read a specific number of characters (:issue:`1616`)
|
||
- ``--right-prompt`` to display a right-hand-side prompt during
|
||
interactive read (:issue:`1698`).
|
||
- ``type`` has a new ``-q`` option to suppress output (:issue:`1540` and, like
|
||
other shells, ``type -a`` now prints all matches for a command
|
||
(:issue:`261`).
|
||
- Pressing F1 now shows the manual page for the current command
|
||
(:issue:`1063`).
|
||
- ``fish_title`` functions have access to the arguments of the
|
||
currently running argument as ``$argv[1]`` (:issue:`1542`).
|
||
- The OS command-not-found handler is used on Arch Linux (:issue:`1925`), nixOS
|
||
(:issue:`1852`), openSUSE and Fedora (:issue:`1280`).
|
||
- ``Alt``\ +\ ``.`` searches backwards in the token history, mapping to
|
||
the same behavior as inserting the last argument of the previous
|
||
command, like other shells (:issue:`89`).
|
||
- The ``SHLVL`` environment variable is incremented correctly (:issue:`1634` &
|
||
:issue:`1693`).
|
||
- Added completions for ``adb`` (:issue:`1165` & :issue:`1211`), ``apt`` (:issue:`2018`),
|
||
``aura`` (:issue:`1292`), ``composer`` (:issue:`1607`), ``cygport`` (:issue:`1841`),
|
||
``dropbox`` (:issue:`1533`), ``elixir`` (:issue:`1167`), ``fossil``, ``heroku``
|
||
(:issue:`1790`), ``iex`` (:issue:`1167`), ``kitchen`` (:issue:`2000`), ``nix`` (:issue:`1167`),
|
||
``node``/``npm`` (:issue:`1566`), ``opam`` (:issue:`1615`), ``setfacl`` (:issue:`1752`),
|
||
``tmuxinator`` (:issue:`1863`), and ``yast2`` (:issue:`1739`).
|
||
- Improved completions for ``brew`` (:issue:`1090` & :issue:`1810`), ``bundler``
|
||
(:issue:`1779`), ``cd`` (:issue:`1135`), ``emerge`` (:issue:`1840`),\ ``git`` (:issue:`1680`, :issue:`1834` &
|
||
:issue:`1951`), ``man`` (:issue:`960`), ``modprobe`` (:issue:`1124`), ``pacman`` (:issue:`1292`),
|
||
``rpm`` (:issue:`1236`), ``rsync`` (:issue:`1872`), ``scp`` (:issue:`1145`), ``ssh`` (:issue:`1234`),
|
||
``sshfs`` (:issue:`1268`), ``systemctl`` (:issue:`1462`, :issue:`1950` & :issue:`1972`), ``tmux``
|
||
(:issue:`1853`), ``vagrant`` (:issue:`1748`), ``yum`` (:issue:`1269`), and ``zypper``
|
||
(:issue:`1787`).
|
||
|
||
--------------
|
||
|
||
fish 2.1.2 (released Feb 24, 2015)
|
||
==================================
|
||
|
||
fish 2.1.2 contains a workaround for a filesystem bug in Mac OS X
|
||
Yosemite. :issue:`1859`
|
||
|
||
Specifically, after installing fish 2.1.1 and then rebooting, “Verify
|
||
Disk” in Disk Utility will report “Invalid number of hard links.” We
|
||
don’t have any reports of data loss or other adverse consequences. fish
|
||
2.1.2 avoids triggering the bug, but does not repair an already affected
|
||
filesystem. To repair the filesystem, you can boot into Recovery Mode
|
||
and use Repair Disk from Disk Utility. Linux and versions of OS X prior
|
||
to Yosemite are believed to be unaffected.
|
||
|
||
There are no other changes in this release.
|
||
|
||
--------------
|
||
|
||
fish 2.1.1 (released September 26, 2014)
|
||
========================================
|
||
|
||
**Important:** if you are upgrading, stop all running instances of
|
||
``fishd`` as soon as possible after installing this release; it will be
|
||
restarted automatically. On most systems, there will be no further
|
||
action required. Note that some environments (where ``XDG_RUNTIME_DIR``
|
||
is set), such as Fedora 20, will require a restart of all running fish
|
||
processes before universal variables work as intended.
|
||
|
||
Distributors are highly encouraged to call ``killall fishd``,
|
||
``pkill fishd`` or similar in installation scripts, or to warn their
|
||
users to do so.
|
||
|
||
Security fixes
|
||
--------------
|
||
|
||
- The fish_config web interface now uses an authentication token to
|
||
protect requests and only responds to requests from the local machine
|
||
with this token, preventing a remote code execution attack. (closing
|
||
CVE-2014-2914). :issue:`1438`
|
||
- ``psub`` and ``funced`` are no longer vulnerable to attacks which
|
||
allow local privilege escalation and data tampering (closing
|
||
CVE-2014-2906 and CVE-2014-3856). :issue:`1437`
|
||
- ``fishd`` uses a secure path for its socket, preventing a local
|
||
privilege escalation attack (closing CVE-2014-2905). :issue:`1436`
|
||
- ``__fish_print_packages`` is no longer vulnerable to attacks which
|
||
would allow local privilege escalation and data tampering (closing
|
||
CVE-2014-3219). :issue:`1440`
|
||
|
||
Other fixes
|
||
-----------
|
||
|
||
- ``fishd`` now ignores SIGPIPE, fixing crashes using tools like GNU
|
||
Parallel and which occurred more often as a result of the other
|
||
``fishd`` changes. :issue:`1084` & :issue:`1690`
|
||
|
||
--------------
|
||
|
||
fish 2.1.0
|
||
==========
|
||
|
||
.. _significant-changes-5:
|
||
|
||
Significant Changes
|
||
-------------------
|
||
|
||
- **Tab completions will fuzzy-match files.** :issue:`568`
|
||
|
||
When tab-completing a file, fish will first attempt prefix matches
|
||
(``foo`` matches ``foobar``), then substring matches (``ooba``
|
||
matches ``foobar``), and lastly subsequence matches (``fbr`` matches
|
||
``foobar``). For example, in a directory with files foo1.txt,
|
||
foo2.txt, foo3.txt…, you can type only the numeric part and hit tab
|
||
to fill in the rest.
|
||
|
||
This feature is implemented for files and executables. It is not yet
|
||
implemented for options (like ``--foobar``), and not yet implemented
|
||
across path components (like ``/u/l/b`` to match ``/usr/local/bin``).
|
||
|
||
- **Redirections now work better across pipelines.** :issue:`110`, :issue:`877`
|
||
|
||
In particular, you can pipe stderr and stdout together, for example,
|
||
with ``cmd ^&1 | tee log.txt``, or the more familiar
|
||
``cmd 2>&1 | tee log.txt``.
|
||
|
||
- **A single ``%`` now expands to the last job backgrounded.** :issue:`1008`
|
||
|
||
Previously, a single ``%`` would pid-expand to either all
|
||
backgrounded jobs, or all jobs owned by your user. Now it expands to
|
||
the last job backgrounded. If no job is in the background, it will
|
||
fail to expand. In particular, ``fg %`` can be used to put the most
|
||
recent background job in the foreground.
|
||
|
||
Other Notable Fixes
|
||
-------------------
|
||
|
||
- alt-U and alt+C now uppercase and capitalize words, respectively.
|
||
:issue:`995`
|
||
|
||
- VTE based terminals should now know the working directory. :issue:`906`
|
||
|
||
- The autotools build now works on Mavericks. :issue:`968`
|
||
|
||
- The end-of-line binding (ctrl+E) now accepts autosuggestions. :issue:`932`
|
||
|
||
- Directories in ``/etc/paths`` (used on OS X) are now prepended
|
||
instead of appended, similar to other shells. :issue:`927`
|
||
|
||
- Option-right-arrow (used for partial autosuggestion completion) now
|
||
works on iTerm2. :issue:`920`
|
||
|
||
- Tab completions now work properly within nested subcommands. :issue:`913`
|
||
|
||
- ``printf`` supports `\e`, the escape character. :issue:`910`
|
||
|
||
- ``fish_config history`` no longer shows duplicate items. :issue:`900`
|
||
|
||
- ``$fish_user_paths`` is now prepended to $PATH instead of appended.
|
||
:issue:`888`
|
||
|
||
- Jobs complete when all processes complete. :issue:`876`
|
||
|
||
For example, in previous versions of fish, ``sleep 10 | echo Done``
|
||
returns control immediately, because echo does not read from stdin.
|
||
Now it does not complete until sleep exits (presumably after 10
|
||
seconds).
|
||
|
||
- Better error reporting for square brackets. :issue:`875`
|
||
|
||
- fish no longer tries to add ``/bin`` to ``$PATH`` unless PATH is
|
||
totally empty. :issue:`852`
|
||
|
||
- History token substitution (alt-up) now works correctly inside
|
||
subshells. :issue:`833`
|
||
|
||
- Flow control is now disabled, freeing up ctrl-S and ctrl-Q for other
|
||
uses. :issue:`814`
|
||
|
||
- sh-style variable setting like ``foo=bar`` now produces better error
|
||
messages. :issue:`809`
|
||
|
||
- Commands with wildcards no longer produce autosuggestions. :issue:`785`
|
||
|
||
- funced no longer freaks out when supplied with no arguments. :issue:`780`
|
||
|
||
- fish.app now works correctly in a directory containing spaces. :issue:`774`
|
||
|
||
- Tab completion cycling no longer occasionally fails to repaint. :issue:`765`
|
||
|
||
- Comments now work in eval’d strings. :issue:`684`
|
||
|
||
- History search (up-arrow) now shows the item matching the
|
||
autosuggestion, if that autosuggestion was truncated. :issue:`650`
|
||
|
||
- Ctrl-T now transposes characters, as in other shells. :issue:`128`
|
||
|
||
--------------
|
||
|
||
fish 2.0.0
|
||
==========
|
||
|
||
.. _significant-changes-6:
|
||
|
||
Significant Changes
|
||
-------------------
|
||
|
||
- **Command substitutions now modify ``$status`` :issue:`547`.** Previously the
|
||
exit status of command substitutions (like ``(pwd)``) was ignored;
|
||
however now it modifies $status. Furthermore, the ``set`` command now
|
||
only sets $status on failure; it is untouched on success. This allows
|
||
for the following pattern:
|
||
|
||
.. code:: sh
|
||
|
||
if set python_path (which python)
|
||
...
|
||
end
|
||
|
||
Because set does not modify $status on success, the if branch
|
||
effectively tests whether ``which`` succeeded, and if so, whether the
|
||
``set`` also succeeded.
|
||
|
||
- Improvements to PATH handling. There is a new variable, fish_user_paths,
|
||
which can be set universally, and whose contents are appended to
|
||
$PATH :issue:`527`
|
||
|
||
- /etc/paths and /etc/paths.d are now respected on OS X
|
||
- fish no longer modifies $PATH to find its own binaries
|
||
|
||
- **Long lines no longer use ellipsis for line breaks**, and copy and
|
||
paste should no longer include a newline even if the line was broken
|
||
:issue:`300`
|
||
|
||
- **New syntax for index ranges** (sometimes known as “slices”) :issue:`212`
|
||
|
||
- **fish now supports an ``else if`` statement** :issue:`134`
|
||
|
||
- **Process and pid completion now works on OS X** :issue:`129`
|
||
|
||
- **fish is now relocatable**, and no longer depends on compiled-in
|
||
paths :issue:`125`
|
||
|
||
- **fish now supports a right prompt (RPROMPT)** through the
|
||
fish_right_prompt function :issue:`80`
|
||
|
||
- **fish now uses posix_spawn instead of fork when possible**, which is
|
||
much faster on BSD and OS X :issue:`11`
|
||
|
||
.. _other-notable-fixes-1:
|
||
|
||
Other Notable Fixes
|
||
-------------------
|
||
|
||
- Updated VCS completions (darcs, cvs, svn, etc.)
|
||
- Avoid calling getcwd on the main thread, as it can hang :issue:`696`
|
||
- Control-D (forward delete) no longer stops at a period :issue:`667`
|
||
- Completions for many new commands
|
||
- fish now respects rxvt’s unique keybindings :issue:`657`
|
||
- xsel is no longer built as part of fish. It will still be invoked if
|
||
installed separately :issue:`633`
|
||
- \__fish_filter_mime no longer spews :issue:`628`
|
||
- The –no-execute option to fish no longer falls over when reaching the
|
||
end of a block :issue:`624`
|
||
- fish_config knows how to find fish even if it’s not in the $PATH :issue:`621`
|
||
- A leading space now prevents writing to history, as is done in bash
|
||
and zsh :issue:`615`
|
||
- Hitting enter after a backslash only goes to a new line if it is
|
||
followed by whitespace or the end of the line :issue:`613`
|
||
- printf is now a builtin :issue:`611`
|
||
- Event handlers should no longer fire if signals are blocked :issue:`608`
|
||
- set_color is now a builtin :issue:`578`
|
||
- man page completions are now located in a new generated_completions
|
||
directory, instead of your completions directory :issue:`576`
|
||
- tab now clears autosuggestions :issue:`561`
|
||
- tab completion from within a pair of quotes now attempts to
|
||
“appropriate” the closing quote :issue:`552`
|
||
- $EDITOR can now be a list: for example, ``set EDITOR gvim -f``) :issue:`541`
|
||
- ``case`` bodies are now indented :issue:`530`
|
||
- The profile switch ``-p`` no longer crashes :issue:`517`
|
||
- You can now control-C out of ``read`` :issue:`516`
|
||
- ``umask`` is now functional on OS X :issue:`515`
|
||
- Avoid calling getpwnam on the main thread, as it can hang :issue:`512`
|
||
- Alt-F or Alt-right-arrow (Option-F or option-right-arrow) now accepts
|
||
one word of an autosuggestion :issue:`435`
|
||
- Setting fish as your login shell no longer kills OpenSUSE :issue:`367`
|
||
- Backslashes now join lines, instead of creating multiple commands
|
||
:issue:`347`
|
||
- echo now implements the -e flag to interpret escapes :issue:`337`
|
||
- When the last token in the user’s input contains capital letters, use
|
||
its case in preference to that of the autosuggestion :issue:`335`
|
||
- Descriptions now have their own muted color :issue:`279`
|
||
- Wildcards beginning with a . (for example, ``ls .*``) no longer match
|
||
. and .. :issue:`270`
|
||
- Recursive wildcards now handle symlink loops :issue:`268`
|
||
- You can now delete history items from the fish_config web interface
|
||
:issue:`250`
|
||
- The OS X build now weak links ``wcsdup`` and ``wcscasecmp`` :issue:`240`
|
||
- fish now saves and restores the process group, which prevents certain
|
||
processes from being erroneously reported as stopped :issue:`197`
|
||
- funced now takes an editor option :issue:`187`
|
||
- Alternating row colors are available in fish pager through
|
||
``fish_pager_color_secondary`` :issue:`186`
|
||
- Universal variable values are now stored based on your MAC address,
|
||
not your hostname :issue:`183`
|
||
- The caret ^ now only does a stderr redirection if it is the first
|
||
character of a token, making git users happy :issue:`168`
|
||
- Autosuggestions will no longer cause line wrapping :issue:`167`
|
||
- Better handling of Unicode combining characters :issue:`155`
|
||
- fish SIGHUPs processes more often :issue:`138`
|
||
- fish no longer causes ``sudo`` to ask for a password every time
|
||
- fish behaves better under Midnight Commander :issue:`121`
|
||
- ``set -e`` no longer crashes :issue:`100`
|
||
- fish now will automatically import history from bash, if there is no
|
||
fish history :issue:`66`
|
||
- Backslashed-newlines inside quoted strings now behave more
|
||
intuitively :issue:`52`
|
||
- Tab titles should be shown correctly in iTerm2 :issue:`47`
|
||
- scp remote path completion now sometimes works :issue:`42`
|
||
- The ``read`` builtin no longer shows autosuggestions :issue:`29`
|
||
- Custom key bindings can now be set via the ``fish_user_key_bindings``
|
||
function :issue:`21`
|
||
- All Python scripts now run correctly under both Python 2 and Python 3
|
||
:issue:`14`
|
||
- The “accept autosuggestion” key can now be configured :issue:`19`
|
||
- Autosuggestions will no longer suggest invalid commands :issue:`6`
|
||
|
||
--------------
|
||
|
||
fishfish Beta r2
|
||
================
|
||
|
||
Bug Fixes
|
||
---------
|
||
|
||
- **Implicit cd** is back, for paths that start with one or two dots, a
|
||
slash, or a tilde.
|
||
- **Overrides of default functions should be fixed.** The “internalized
|
||
scripts” feature is disabled for now.
|
||
- **Disabled delayed suspend.** This is a strange job-control feature
|
||
of BSD systems, including OS X. Disabling it frees up Control Y for
|
||
other purposes; in particular, for yank, which now works on OS X.
|
||
- **fish_indent is fixed.** In particular, the ``funced`` and
|
||
``funcsave`` functions work again.
|
||
- A SIGTERM now ends the whole execution stack again (resolving :issue:`13`).
|
||
- Bumped the \__fish_config_interactive version number so the default
|
||
fish_color_autosuggestion kicks in.
|
||
- fish_config better handles combined term256 and classic colors like
|
||
“555 yellow”.
|
||
|
||
New Features
|
||
------------
|
||
|
||
- **A history builtin**, and associated interactive function that
|
||
enables deleting history items. Example usage: \* Print all history
|
||
items beginning with echo: ``history --prefix echo`` \* Print all
|
||
history items containing foo: ``history --contains foo`` \*
|
||
Interactively delete some items containing foo:
|
||
``history --delete --contains foo``
|
||
|
||
Credit to @siteshwar for implementation. Thanks @siteshwar!
|
||
|
||
--------------
|
||
|
||
fishfish Beta r1
|
||
================
|
||
|
||
Scripting
|
||
---------
|
||
|
||
- No changes! All existing fish scripts, config files, completions,
|
||
etc. from trunk should continue to work.
|
||
|
||
.. _new-features-1:
|
||
|
||
New Features
|
||
------------
|
||
|
||
- **Autosuggestions**. Think URL fields in browsers. When you type a
|
||
command, fish will suggest the rest of the command after the cursor,
|
||
in a muted gray when possible. You can accept the suggestion with the
|
||
right arrow key or Ctrl-F. Suggestions come from command history,
|
||
completions, and some custom code for cd; there’s a lot of potential
|
||
for improvement here. The suggestions are computed on a background
|
||
pthread, so they never slow down your typing. The autosuggestion
|
||
feature is incredible. I miss it dearly every time I use anything
|
||
else.
|
||
|
||
- **term256 support** where available, specifically modern xterms and
|
||
OS X Lion. You can specify colors the old way (‘set_color cyan’) or
|
||
by specifying RGB hex values (‘set_color FF3333’); fish will pick the
|
||
closest supported color. Some xterms do not advertise term256 support
|
||
either in the $TERM or terminfo max_colors field, but nevertheless
|
||
support it. For that reason, fish will default into using it on any
|
||
xterm (but it can be disabled with an environment variable).
|
||
|
||
- **Web-based configuration** page. There is a new function
|
||
‘fish_config’. This spins up a simple Python web server and opens a
|
||
browser window to it. From this web page, you can set your shell
|
||
colors and view your functions, variables, and history; all changes
|
||
apply immediately to all running shells. Eventually all configuration
|
||
ought to be supported via this mechanism (but in addition to, not
|
||
instead of, command line mechanisms).
|
||
|
||
- **Man page completions**. There is a new function
|
||
‘fish_update_completions’. This function reads all the man1 files
|
||
from your manpath, removes the roff formatting, parses them to find
|
||
the commands and options, and outputs fish completions into
|
||
~/.config/fish/completions. It won’t overwrite existing completion
|
||
files (except ones that it generated itself).
|
||
|
||
Programmatic Changes
|
||
--------------------
|
||
|
||
- fish is now entirely in C++. I have no particular love for C++, but
|
||
it provides a ready memory-model to replace halloc. We’ve made an
|
||
effort to keep it to a sane and portable subset (no C++11, no boost,
|
||
no going crazy with templates or smart pointers), but we do use the
|
||
STL and a little tr1.
|
||
- halloc is entirely gone, replaced by normal C++ ownership semantics.
|
||
If you don’t know what halloc is, well, now you have two reasons to
|
||
be happy.
|
||
- All the crufty C data structures are entirely gone. array_list_t,
|
||
priority_queue_t, hash_table_t, string_buffer_t have been removed and
|
||
replaced by STL equivalents like std::vector, std::map, and
|
||
std::wstring. A lot of the string handling now uses std::wstring
|
||
instead of wchar_t \*
|
||
- fish now spawns pthreads for tasks like syntax highlighting that
|
||
require blocking I/O.
|
||
- History has been completely rewritten. History files now use an
|
||
extensible YAML-style syntax. History “merging” (multiple shells
|
||
writing to the same history file) now works better. There is now a
|
||
maximum history length of about 250k items (256 \* 1024).
|
||
- The parser has been “instanced,” so you can now create more than one.
|
||
- Total #LoC has shrunk slightly even with the new features.
|
||
|
||
Performance
|
||
-----------
|
||
|
||
- fish now runs syntax highlighting in a background thread, so typing
|
||
commands is always responsive even on slow filesystems.
|
||
- echo, test, and pwd are now builtins, which eliminates many forks.
|
||
- The files in share/functions and share/completions now get
|
||
‘internalized’ into C strings that get compiled in with fish. This
|
||
substantially reduces the number of files touched at startup. A
|
||
consequence is that you cannot change these functions without
|
||
recompiling, but often other functions depend on these “standard”
|
||
functions, so changing them is perhaps not a good idea anyways.
|
||
|
||
Here are some system call counts for launching and then exiting fish
|
||
with the default configuration, on OS X. The first column is fish trunk,
|
||
the next column is with our changes, and the last column is bash for
|
||
comparison. This data was collected via dtrace.
|
||
|
||
.. raw:: html
|
||
|
||
<table>
|
||
|
||
.. raw:: html
|
||
|
||
<tr>
|
||
|
||
.. raw:: html
|
||
|
||
<th>
|
||
|
||
.. raw:: html
|
||
|
||
<th>
|
||
|
||
before
|
||
|
||
.. raw:: html
|
||
|
||
<th>
|
||
|
||
after
|
||
|
||
.. raw:: html
|
||
|
||
<th>
|
||
|
||
bash
|
||
|
||
.. raw:: html
|
||
|
||
<tr>
|
||
|
||
.. raw:: html
|
||
|
||
<th>
|
||
|
||
open
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
9
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
4
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
5
|
||
|
||
.. raw:: html
|
||
|
||
<tr>
|
||
|
||
.. raw:: html
|
||
|
||
<th>
|
||
|
||
fork
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
28
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
14
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
0
|
||
|
||
.. raw:: html
|
||
|
||
<tr>
|
||
|
||
.. raw:: html
|
||
|
||
<th>
|
||
|
||
stat
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
131
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
85
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
11
|
||
|
||
.. raw:: html
|
||
|
||
<tr>
|
||
|
||
.. raw:: html
|
||
|
||
<th>
|
||
|
||
lstat
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
670
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
0
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
0
|
||
|
||
.. raw:: html
|
||
|
||
<tr>
|
||
|
||
.. raw:: html
|
||
|
||
<th>
|
||
|
||
read
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
332
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
80
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
4
|
||
|
||
.. raw:: html
|
||
|
||
<tr>
|
||
|
||
.. raw:: html
|
||
|
||
<th>
|
||
|
||
write
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
172
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
149
|
||
|
||
.. raw:: html
|
||
|
||
<td>
|
||
|
||
0
|
||
|
||
.. raw:: html
|
||
|
||
</table>
|
||
|
||
The large number of forks relative to bash are due to fish’s insanely
|
||
expensive default prompt, which is unchanged in my version. If we switch
|
||
to a prompt comparable to bash’s (lame) default, the forks drop to 16
|
||
with trunk, 4 after our changes.
|
||
|
||
The large reduction in lstat() numbers is due to fish no longer needing
|
||
to call ttyname() on OS X.
|
||
|
||
We’ve got some work to do to be as lean as bash, but we’re on the right
|
||
track.
|