2020-07-30 23:02:41 +08:00
fish 3.2.0 (released ???)
=========================
2020-05-28 23:07:51 +08:00
Notable improvements and fixes
------------------------------
2020-11-22 23:46:48 +08:00
- 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+/.
2020-10-29 03:12:55 +08:00
- 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* '
2020-12-17 00:38:26 +08:00
- 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` ).
2020-07-30 23:02:41 +08:00
- 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
2020-11-22 23:46:48 +08:00
`` 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` ).
2020-08-05 23:55:06 +08:00
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.
2020-11-22 23:46:48 +08:00
- The `` test `` builtin now better shows where an error occured (:issue: `6030` )::
2020-08-06 00:01:22 +08:00
> 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
^
2020-12-05 00:08:25 +08:00
- The documentation (:issue: `6500` , :issue: `7371` ) and `` fish_config `` (:issue: `7523` ) received a new theme, matching the design on fishshell.com.
2020-10-29 03:12:55 +08:00
- `` fish --no-execute `` will no longer complain about unknown commands
or non-matching wildcards, as these could be defined differently at
2020-11-22 23:46:48 +08:00
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` ).
2020-12-06 22:40:46 +08:00
- `` 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.
2020-12-17 00:38:26 +08:00
- 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` ).
2020-05-28 23:07:51 +08:00
Syntax changes and new commands
2020-05-28 23:25:48 +08:00
-------------------------------
2020-10-29 03:12:55 +08:00
- 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.
2020-05-28 23:07:51 +08:00
Scripting improvements
2020-05-28 23:25:48 +08:00
----------------------
2020-12-17 00:38:26 +08:00
- `` 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` ).
2020-11-22 23:46:48 +08:00
- A new subcommand, `` string pad `` , allows extending strings to a given width (:issue: `7340` ).
2020-05-28 23:07:51 +08:00
- `` string sub `` has a new `` --end `` option to specify the end index of
2020-11-22 23:46:48 +08:00
a substring (:issue: `6765` ).
2020-05-28 23:07:51 +08:00
- `` string split `` has a new `` --fields `` option to specify fields to
2020-11-22 23:46:48 +08:00
output, similar to `` cut -f `` (:issue: `6770` ).
2020-05-28 23:07:51 +08:00
- `` printf `` no longer prints an error if not given an argument (not
even a format string)
2020-11-22 23:46:48 +08:00
- 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` ).
2020-12-17 00:38:26 +08:00
- A new `` fish_job_summary `` function is called whenever a
2020-11-22 23:46:48 +08:00
background job stops or ends, or any job terminates from a signal (:issue: `6959` ).
2020-12-17 00:38:26 +08:00
The default behaviour can now be customized by redefining it.
2020-06-01 21:51:45 +08:00
- 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,
2020-11-22 23:46:48 +08:00
use the new `` fish_read `` event instead (:issue: `7039` ).
2020-08-27 22:39:48 +08:00
- `` status `` gained new `` dirname `` and `` basename `` convenience subcommands
2020-06-05 00:29:25 +08:00
to get just the directory to the running script or the name of it,
2020-11-22 23:46:48 +08:00
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` ).
2020-08-27 22:39:48 +08:00
- 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'
2020-11-22 23:46:48 +08:00
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` ).
2020-12-27 02:33:54 +08:00
- All builtins that query if something exists now take ` ` `--quiet` ` is deprecated for ` `command` `, ` `jobs` ` and ` `type` ` (:issue:` 7276`).
2020-11-22 23:46:48 +08:00
- `` 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` ).
2020-12-27 02:33:54 +08:00
- `` math `` now has a `` --base `` option to output the result in hexadecimal or octal (:issue: `7496` ) and some more specific errors (:issue: `7508` ).
- `` 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".
2020-12-05 00:02:59 +08:00
- `` string `` subcommands now quit early when used with `` --quiet `` (:issue: `7495` ).
2020-12-14 09:01:06 +08:00
- Failed redirections will now set `` $status `` (:issue: `7540` ).
2020-12-27 02:33:54 +08:00
- `` read `` can now read interactively from other files, so e.g. forcing it to read from the terminal via `` read </dev/tty `` works (:issue: `7358` ).
2020-05-28 23:07:51 +08:00
Interactive improvements
2020-05-28 23:25:48 +08:00
------------------------
2020-05-28 23:07:51 +08:00
2020-12-17 00:38:26 +08:00
- Control-C no longer kills background jobs for which job control is
disabled, matching POSIX semantics (:issue: `6828` ).
2020-11-22 23:46:48 +08:00
- The prompt is reprinted after a background job exits (:issue: `1018` ).
2020-06-01 21:51:45 +08:00
- fish no longer inserts a space after a completion ending in `` . `` or
2020-11-22 23:46:48 +08:00
`` , `` 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` ).
2020-08-27 23:06:25 +08:00
- The `` -o `` short option to fish, for `` --debug-output `` , works correctly instead of producing an
2020-11-22 23:46:48 +08:00
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` ).
2020-08-27 23:06:25 +08:00
- The history file is now created with user-private permissions,
2020-11-22 23:46:48 +08:00
matching other shells (:issue: `6926` ). The directory containing the history
2020-09-19 04:17:51 +08:00
file was already private, so there should not have been any private data
2020-08-27 23:06:25 +08:00
revealed.
2020-11-22 23:46:48 +08:00
- 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` ).
2020-11-28 02:48:58 +08:00
- Commands run from key bindings now use the same tty modes as normal commands (:issue: `7483` ).
2020-11-29 08:15:01 +08:00
- 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` ).
2020-12-27 02:33:54 +08:00
- `` $status `` from completion scripts is no longer visible outside, like in the prompt - this prevents status display in the prompt from being overwritten (:issue: `7555` )
- A macOS regarding apropos that was fixed in later 10.15 versions was reintroduced in Big Sur. Fish now works around it again, so command completion isn't super slow anymore (:issue: `7365` ).
2020-05-28 23:07:51 +08:00
New or improved bindings
^^^^^^^^^^^^^^^^^^^^^^^^
2020-11-22 23:46:48 +08:00
- 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` ).
2020-12-17 00:38:26 +08:00
- Control-Z is now available for binding (:issue: `7152` ).
2020-11-22 23:46:48 +08:00
- Additionally, using the `` cancel `` readline command (bound to escape by default) right after fish picked an unambiguous completion will undo that (:issue: `7433` ).
2020-12-20 06:32:17 +08:00
- 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` ).
2020-11-22 23:46:48 +08:00
- Vi mode bindings support `` ~ `` (tilde) to toggle the case of the selected character (:issue: `6908` ).
2020-08-29 17:07:12 +08:00
- 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.
2020-08-03 04:22:56 +08:00
- 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).
2020-11-22 23:46:48 +08:00
- 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` ).
2020-09-27 22:36:56 +08:00
- A new function `` __fish_preview_current_file `` , bound to Alt+O, opens the
2020-11-22 23:46:48 +08:00
current file at the cursor in a pager (:issue: `6838` ).
2020-05-28 23:07:51 +08:00
- `` edit_command_buffer `` (Alt-E and Alt-V) passes the cursor position
2020-11-22 23:46:48 +08:00
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` ).
2020-06-05 00:29:25 +08:00
- `` __fish_prepend_sudo `` (Alt-S) now uses the previous commandline if the current one is empty,
2020-11-22 23:46:48 +08:00
to simplify rerunning the previous command with `` sudo `` (:issue: `7079` ).
2020-12-27 02:33:54 +08:00
- `` __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` )
- Fish's clipboard bindings now also support WSL via powershell and clip.exe (:issue: `7455` ).
2020-09-28 22:48:21 +08:00
2020-05-28 23:07:51 +08:00
Improved prompts
^^^^^^^^^^^^^^^^
- The default and example prompts print the correct exit status for
2020-11-22 23:46:48 +08:00
commands prefixed with `` not `` (:issue: `6566` ).
2020-08-24 19:51:25 +08:00
- git prompts include all untracked files in the repository, not just those in the current
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
2020-12-17 00:38:26 +08:00
Improved terminal support
^^^^^^^^^^^^^^^^^^^^^^^^^
2020-05-28 23:07:51 +08:00
2020-09-28 22:48:21 +08:00
- A new variable, `` $fish_vi_force_cursor `` , can be set to force `` fish_vi_cursor `` to attempt changing the cursor
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
- Autosuggestions now show up also when the cursor passes the right
2020-11-22 23:46:48 +08:00
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` ).
2020-12-17 00:38:26 +08:00
- 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` ).
2020-12-27 02:33:54 +08:00
- Fish now sets terminal modes sooner, which stops output from appearing before the greeting and prompt are ready (:issue: `7489` ).
2020-05-28 23:07:51 +08:00
Completions
^^^^^^^^^^^
- Added completions for
2020-11-22 23:46:48 +08:00
- `` 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` )
2020-05-28 23:07:51 +08:00
- `` dhclient ``
2020-08-27 22:39:48 +08:00
- Postgres-related commands `` dropdb `` , `` createdb `` , `` pg_restore `` , `` pg_dump `` and
2020-11-22 23:46:48 +08:00
`` pg_dumpall `` (:issue: `6620` )
2020-12-19 07:58:08 +08:00
- `` dotnet `` (:issue: `7558` )
2020-11-22 23:46:48 +08:00
- `` downgrade `` (:issue: `6751` )
- `` gapplication `` , `` gdbus `` , `` gio `` and `` gresource `` (:issue: `7300` )
- `` gh `` (:issue: `7112` )
2020-05-28 23:07:51 +08:00
- `` gitk ``
2020-11-22 23:46:48 +08:00
- `` 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` )
2020-05-28 23:07:51 +08:00
- `` rst2html `` , `` rst2html4 `` , `` rst2html5 `` , `` rst2latex `` ,
`` rst2man `` , `` rst2odt `` , `` rst2pseudoxml `` , `` rst2s5 `` ,
2020-11-22 23:46:48 +08:00
`` rst2xetex `` , `` rst2xml `` and `` rstpep2html `` (:issue: `7019` )
- `` spago `` (:issue: `7381` )
2020-05-28 23:07:51 +08:00
- `` sphinx-apidoc `` , `` sphinx-autogen `` , `` sphinx-build `` and
2020-11-22 23:46:48 +08:00
`` sphinx-quickstart `` (:issue: `7000` )
- `` strace `` (:issue: `6656` )
- `` tcpdump `` (:issue: `6690` )
2020-05-28 23:07:51 +08:00
- `` tig ``
2020-11-22 23:46:48 +08:00
- `` windscribe `` (:issue: `6788` )
2020-05-28 23:07:51 +08:00
- `` wireshark `` , `` tshark `` , and `` dumpcap ``
2020-11-22 23:46:48 +08:00
- `` xbps-* `` (:issue: `7239` )
- `` xxhsum `` , `` xxh32sum `` , `` xxh64sum `` and `` xxh128sum `` (:issue: `7103` )
- `` yadm `` (:issue: `7100` )
2020-09-28 22:48:21 +08:00
- `` zopfli `` and `` zopflipng ``
2020-05-28 23:07:51 +08:00
2020-07-30 23:02:41 +08:00
- Lots of improvements to completions.
2020-11-22 23:46:48 +08:00
- Improvements to the manpage completion generator (:issue: `7086` ).
- Significant performance improvements to completion of the available commands (:issue: `7153` ).
2020-12-13 15:27:21 +08:00
- `` __fish_complete_suffix `` completes any file but sorts files with matching suffix first (:issue: `7040` ). Previously, it only completed files with matching suffix.
2020-07-30 23:02:41 +08:00
2020-05-28 23:07:51 +08:00
Deprecations and removed features
2020-05-28 23:25:48 +08:00
---------------------------------
2020-11-22 23:46:48 +08:00
- fish no longer attempts to modify the terminal size via `TIOCSWINSZ` (:issue: `6994` ).
2020-08-04 04:33:44 +08:00
- The `fish_color_match` variable is no longer used. (Previously this controlled the color of matching quotes and parens when using `read` ).
2020-10-05 21:12:51 +08:00
- 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.
2020-05-28 23:07:51 +08:00
For distributors and developers
2020-05-28 23:25:48 +08:00
-------------------------------
2020-05-28 23:07:51 +08:00
- fish source tarballs are now distributed using the XZ compression
2020-11-22 23:46:48 +08:00
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` ).
2020-07-30 23:02:41 +08:00
- 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 `` .
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
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` ).
2020-12-05 00:02:59 +08:00
- The webconfig tool no longer requires python's distutils (:issue: `7514` )
2020-05-28 23:07:51 +08:00
--------------
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
2020-11-22 23:46:48 +08:00
fixed (:issue: `6955` ).
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
bug in the `` function --on-job-exit `` option has been fixed (:issue: `6613` ).
2020-05-28 23:07:51 +08:00
- Conflicts between upstream packages for ripgrep and bat, and the fish
2020-11-22 23:46:48 +08:00
packages, have been resolved (:issue: `5822` ).
2020-05-28 23:07:51 +08:00
- Starting fish in a directory without read access, such as via `` su `` ,
2020-11-22 23:46:48 +08:00
no longer crashes (:issue: `6597` ).
2020-05-28 23:07:51 +08:00
- Glob ordering changes which were introduced in 3.1.0 have been
2020-11-22 23:46:48 +08:00
reverted, returning the order of globs to the previous state (:issue: `6593` ).
2020-05-28 23:07:51 +08:00
- Redirections using the deprecated caret syntax to a file descriptor
2020-11-22 23:46:48 +08:00
(eg `` ^&2 `` ) work correctly (:issue: `6591` ).
2020-05-28 23:07:51 +08:00
- Redirections that append to a file descriptor (eg `` 2>>&1 `` ) work
2020-11-22 23:46:48 +08:00
correctly (:issue: `6614` ).
- Building fish on macOS (:issue: `6602` ) or with new versions of GCC (:issue: `6604` ,
:issue: `6609` ) is now successful.
2020-05-28 23:07:51 +08:00
- `` time `` is now correctly listed in the output of `` builtin -n `` , and
2020-11-22 23:46:48 +08:00
`` time --help `` works correctly (:issue: `6598` ).
- Exported universal variables now update properly (:issue: `6612` ).
2020-05-28 23:07:51 +08:00
- `` status current-command `` gives the expected output when used with
an environment override - that is, `` F=B status current-command ``
2020-11-22 23:46:48 +08:00
returns `` status `` instead of `` F=B `` (:issue: `6635` ).
2020-05-28 23:07:51 +08:00
- `` test `` no longer crashes when used with “`` nan `` ” or “`` inf `` ”
2020-11-22 23:46:48 +08:00
arguments, erroring out instead (:issue: `6655` ).
2020-05-28 23:07:51 +08:00
- Copying from the end of the command line no longer crashes fish
2020-11-22 23:46:48 +08:00
(:issue: `6680` ).
2020-05-28 23:07:51 +08:00
- `` read `` no longer removes multiple separators when splitting a
variable into a list, restoring the previous behaviour from fish 3.0
2020-11-22 23:46:48 +08:00
and before (:issue: `6650` ).
2020-05-28 23:07:51 +08:00
- Functions using `` --on-job-exit `` and `` --on-process-exit `` work
2020-11-22 23:46:48 +08:00
reliably again (:issue: `6679` ).
2020-05-28 23:07:51 +08:00
- Functions using `` --on-signal INT `` work reliably in interactive
2020-11-22 23:46:48 +08:00
sessions, as they did in fish 2.7 and before (:issue: `6649` ). These handlers
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
“`` fish_bind_mode `` ” and “`` PWD `` ” (:issue: `6653` ).
2020-05-28 23:07:51 +08:00
- 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)
2020-11-22 23:46:48 +08:00
(:issue: `6701` ).
2020-05-28 23:07:51 +08:00
- The Mercurial (`` hg `` ) prompt no longer produces an error when the
2020-11-22 23:46:48 +08:00
current working directory is removed (:issue: `6699` ). Also, for performance
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
operation (:issue: `6681` ).
- Pasting of commands has been sped up (:issue: `6713` ).
2020-05-28 23:07:51 +08:00
- Using extended Unicode characters, such as emoji, in a non-Unicode
capable locale (such as the `` C `` or `` POSIX `` locale) no longer
2020-11-22 23:46:48 +08:00
renders all output blank (:issue: `6736` ).
2020-05-28 23:07:51 +08:00
- `` help `` prefers to use `` xdg-open `` , avoiding the use of `` open `` on
2020-11-22 23:46:48 +08:00
Debian systems where this command is actually `` openvt `` (:issue: `6739` ).
2020-05-28 23:07:51 +08:00
- Command lines starting with a space, which are not saved in history,
now do not get autosuggestions. This fixes an issue with Midnight
2020-11-22 23:46:48 +08:00
Commander integration (:issue: `6763` ), but may be changed in a future
2020-05-28 23:07:51 +08:00
version.
- Copying to the clipboard no longer inserts a newline at the end of
2020-11-22 23:46:48 +08:00
the content, matching fish 2.7 and earlier (:issue: `6927` ).
2020-05-28 23:07:51 +08:00
- `` fzf `` in complex pipes no longer hangs. More generally, code run as
part of command substitutions or `` eval `` will no longer have
2020-11-22 23:46:48 +08:00
separate process groups. (:issue: `6624` , :issue: `6806` ).
2020-05-28 23:07:51 +08:00
2020-07-15 15:38:30 +08:00
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.
2020-05-28 23:07:51 +08:00
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)
=======================================
2020-07-15 15:34:41 +08:00
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
2020-11-22 23:46:48 +08:00
brace expansion not occurring (:issue: `6564` ).
2020-07-15 15:34:41 +08:00
- Fixes a number of problems in compiling and testing on Cygwin
2020-11-22 23:46:48 +08:00
(:issue: `6549` ) and Solaris-derived systems such as Illumos (:issue: `6553` , :issue: `6554` ,
:issue: `6555` , :issue: `6556` , and :issue: `6558` ).
2020-07-15 15:34:41 +08:00
- 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
2020-11-22 23:46:48 +08:00
(:issue: `6584` ).
2020-07-15 15:34:41 +08:00
- Contains some improvements to the documentation and a small number
of completions.
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
(:issue: `5632` ).
2020-05-28 23:07:51 +08:00
- fish no longer buffers pipes to the last function in a pipeline,
2020-11-22 23:46:48 +08:00
improving many cases where pipes appeared to block or hang (:issue: `1396` ).
2020-05-28 23:07:51 +08:00
- An overhaul of error messages for builtin commands, including a
removal of the overwhelming usage summary, more readable stack traces
2020-11-22 23:46:48 +08:00
(:issue: `3404` , :issue: `5434` ), and stack traces for `` test `` (aka `` [ `` ) (:issue: `5771` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
be listed via `` fish --print-debug-categories `` (:issue: `5879` ). A new
2020-05-28 23:07:51 +08:00
`` --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
2020-11-22 23:46:48 +08:00
lines (similar to `` "$(cmd)" `` in other shells) (:issue: `159` ).
2020-05-28 23:07:51 +08:00
- The fish manual, tutorial and FAQ are now available in `` man `` format
as `` fish-doc `` , `` fish-tutorial `` and `` fish-faq `` respectively
2020-11-22 23:46:48 +08:00
(:issue: `5521` ).
2020-05-28 23:07:51 +08:00
- Like other shells, `` cd `` now always looks for its argument in the
current directory as a last resort, even if the `` CDPATH `` variable
2020-11-22 23:46:48 +08:00
does not include it or “.” (:issue: `4484` ).
2020-05-28 23:07:51 +08:00
- fish now correctly handles `` CDPATH `` entries that start with `` .. ``
2020-11-22 23:46:48 +08:00
(:issue: `6220` ) or contain `` ./ `` (:issue: `5887` ).
- The `` fish_trace `` variable may be set to trace execution (:issue: `3427` ).
2020-05-28 23:07:51 +08:00
This performs a similar role as `` set -x `` in other shells.
- fish uses the temporary directory determined by the system, rather
2020-11-22 23:46:48 +08:00
than relying on `` /tmp `` (:issue: `3845` ).
2020-05-28 23:07:51 +08:00
- The fish Web configuration tool (`` fish_config `` ) prints a list of
commands it is executing, to help understanding and debugging
2020-11-22 23:46:48 +08:00
(: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` ).
2020-05-28 23:07:51 +08:00
.. _syntax-changes-and-new-commands-1:
Syntax changes and new commands
2020-05-28 23:25:48 +08:00
-------------------------------
2020-05-28 23:07:51 +08:00
- A new builtin command, `` time `` , which allows timing of fish
2020-11-22 23:46:48 +08:00
functions and builtins as well as external commands (:issue: `117` ).
2020-05-28 23:07:51 +08:00
- Brace expansion now only takes place if the braces include a “,” or a
variable expansion, meaning common commands such as
2020-11-22 23:46:48 +08:00
`` git reset HEAD@{0} `` do not require escaping (:issue: `5869` ).
2020-05-28 23:07:51 +08:00
- New redirections `` &> `` and `` &| `` may be used to redirect or pipe
2020-11-22 23:46:48 +08:00
stdout, and also redirect stderr to stdout (:issue: `6192` ).
2020-05-28 23:07:51 +08:00
- `` switch `` now allows arguments that expand to nothing, like empty
2020-11-22 23:46:48 +08:00
variables (:issue: `5677` ).
2020-05-28 23:07:51 +08:00
- The `` VAR=val cmd `` syntax can now be used to run a command in a
2020-11-22 23:46:48 +08:00
modified environment (:issue: `6287` ).
2020-05-28 23:07:51 +08:00
- `` and `` is no longer recognised as a command, so that nonsensical
2020-11-22 23:46:48 +08:00
constructs like `` and and and `` produce a syntax error (:issue: `6089` ).
2020-05-28 23:07:51 +08:00
- `` math ` ` \ ‘ s exponent operator,’ \ ` ` ^ ` ` \ ‘ , was previously
left-associative, but now uses the more commonly-used
2020-11-22 23:46:48 +08:00
right-associative behaviour (:issue: `6280` ). This means that
2020-05-28 23:07:51 +08:00
`` 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
2020-11-22 23:46:48 +08:00
inadvertent behaviour change and has been reverted (:issue: `6480` ).
2020-05-28 23:07:51 +08:00
.. _scripting-improvements-1:
Scripting improvements
2020-05-28 23:25:48 +08:00
----------------------
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- `` string split0 `` now returns 0 if it split something (:issue: `5701` ).
2020-05-28 23:07:51 +08:00
- In the interest of consistency, `` builtin -q `` and `` command -q `` can
2020-11-22 23:46:48 +08:00
now be used to query if a builtin or command exists (:issue: `5631` ).
- `` math `` now accepts `` --scale=max `` for the maximum scale (:issue: `5579` ).
2020-05-28 23:07:51 +08:00
- `` builtin $var `` now works correctly, allowing a variable as the
2020-11-22 23:46:48 +08:00
builtin name (:issue: `5639` ).
2020-05-28 23:07:51 +08:00
- `` cd `` understands the `` -- `` argument to make it possible to change
2020-11-22 23:46:48 +08:00
to directories starting with a hyphen (:issue: `6071` ).
- `` complete --do-complete `` now also does fuzzy matches (:issue: `5467` ).
2020-05-28 23:07:51 +08:00
- `` complete --do-complete `` can be used inside completions, allowing
2020-11-22 23:46:48 +08:00
limited recursion (:issue: `3474` ).
- `` count `` now also counts lines fed on standard input (:issue: `5744` ).
2020-05-28 23:07:51 +08:00
- `` eval `` produces an exit status of 0 when given no arguments, like
2020-11-22 23:46:48 +08:00
other shells (:issue: `5692` ).
2020-05-28 23:07:51 +08:00
- `` printf `` prints what it can when input hasn’ t been fully converted
2020-11-22 23:46:48 +08:00
to a number, but still prints an error (:issue: `5532` ).
2020-05-28 23:07:51 +08:00
- `` 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
2020-11-22 23:46:48 +08:00
correctly (:issue: `5646` ).
2020-05-28 23:07:51 +08:00
- `` argparse `` now defaults to showing the current function name
(instead of `` argparse `` ) in its errors, making `` --name `` often
2020-11-22 23:46:48 +08:00
superfluous (:issue: `5835` ).
2020-05-28 23:07:51 +08:00
- `` argparse `` has a new `` --ignore-unknown `` option to keep
unrecognized options, allowing multiple argparse passes to parse
2020-11-22 23:46:48 +08:00
options (:issue: `5367` ).
2020-05-28 23:07:51 +08:00
- `` argparse `` correctly handles flag value validation of options that
2020-11-22 23:46:48 +08:00
only have short names (:issue: `5864` ).
2020-05-28 23:07:51 +08:00
- `` read -S `` (short option of `` --shell `` ) is recognised correctly
2020-11-22 23:46:48 +08:00
(:issue: `5660` ).
2020-05-28 23:07:51 +08:00
- `` read `` understands `` --list `` , which acts like `` --array `` in
reading all arguments into a list inside a single variable, but is
2020-11-22 23:46:48 +08:00
better named (:issue: `5846` ).
2020-05-28 23:07:51 +08:00
- `` read `` has a new option, `` --tokenize `` , which splits a string into
variables according to the shell’ s tokenization rules, considering
2020-11-22 23:46:48 +08:00
quoting, escaping, and so on (:issue: `3823` ).
2020-05-28 23:07:51 +08:00
- `` read `` interacts more correctly with the deprecated `` $IFS ``
variable, in particular removing multiple separators when splitting a
2020-11-22 23:46:48 +08:00
variable into a list (:issue: `6406` ), matching other shells.
2020-05-28 23:07:51 +08:00
- `` fish_indent `` now handles semicolons better, including leaving them
in place for `` ; and `` and `` ; or `` instead of breaking the line
2020-11-22 23:46:48 +08:00
(:issue: `5859` ).
2020-05-28 23:07:51 +08:00
- `` fish_indent --write `` now supports multiple file arguments,
indenting them in turn.
2020-11-22 23:46:48 +08:00
- The default read limit has been increased to 100MiB (:issue: `5267` ).
2020-05-28 23:07:51 +08:00
- `` math `` now also understands `` x `` for multiplication, provided it
2020-11-22 23:46:48 +08:00
is followed by whitespace (:issue: `5906` ).
2020-05-28 23:07:51 +08:00
- `` math `` reports the right error when incorrect syntax is used inside
2020-11-22 23:46:48 +08:00
parentheses (:issue: `6063` ), and warns when unsupported logical operations
are used (:issue: `6096` ).
2020-05-28 23:07:51 +08:00
- `` functions --erase `` now also prevents fish from autoloading a
2020-11-22 23:46:48 +08:00
function for the first time (:issue: `5951` ).
2020-05-28 23:07:51 +08:00
- `` jobs --last `` returns 0 to indicate success when a job is found
2020-11-22 23:46:48 +08:00
(:issue: `6104` ).
2020-05-28 23:07:51 +08:00
- `` commandline -p `` and `` commandline -j `` now split on `` && `` and
2020-11-22 23:46:48 +08:00
`` || `` in addition to `` ; `` and `` & `` (:issue: `6214` ).
2020-05-28 23:07:51 +08:00
- A bug where `` string split `` would drop empty strings if the output
2020-11-22 23:46:48 +08:00
was only empty strings has been fixed (:issue: `5987` ).
2020-05-28 23:07:51 +08:00
- `` eval `` no long creates a new local variable scope, but affects
2020-11-22 23:46:48 +08:00
variables in the scope it is called from (:issue: `4443` ). `` source `` still
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
(:issue: `5812` ).
- Empty universal variables may now be exported (:issue: `5992` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
a list of multiple elements (:issue: `5258` ).
2020-05-28 23:07:51 +08:00
- A bug where `` for `` could use invalid variable names has been fixed
2020-11-22 23:46:48 +08:00
(:issue: `5800` ).
2020-05-28 23:07:51 +08:00
- A bug where local variables would not be exported to functions has
2020-11-22 23:46:48 +08:00
been fixed (:issue: `6153` ).
2020-05-28 23:07:51 +08:00
- The null command (`` : `` ) now always exits successfully, rather than
2020-11-22 23:46:48 +08:00
passing through the previous exit status (:issue: `6022` ).
2020-05-28 23:07:51 +08:00
- The output of `` functions FUNCTION `` matches the declaration of the
2020-11-22 23:46:48 +08:00
function, correctly including comments or blank lines (:issue: `5285` ), and
correctly includes any `` --wraps `` flags (:issue: `1625` ).
2020-05-28 23:07:51 +08:00
- `` type `` supports a new option, `` --short `` , which suppress function
2020-11-22 23:46:48 +08:00
expansion (:issue: `6403` ).
2020-05-28 23:07:51 +08:00
- `` 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
2020-11-22 23:46:48 +08:00
correctly outputs nothing, as documented (:issue: `6411` ).
2020-05-28 23:07:51 +08:00
- The `` $hostname `` variable is no longer truncated to 32 characters
2020-11-22 23:46:48 +08:00
(:issue: `5758` ).
- Line numbers in function backtraces are calculated correctly (:issue: `6350` ).
2020-05-28 23:07:51 +08:00
- A new `` fish_cancel `` event is emitted when the command line is
2020-11-22 23:46:48 +08:00
cancelled, which is useful for terminal integration (:issue: `5973` ).
2020-05-28 23:07:51 +08:00
.. _interactive-improvements-1:
Interactive improvements
2020-05-28 23:25:48 +08:00
------------------------
2020-05-28 23:07:51 +08:00
- New Base16 color options are available through the Web-based
2020-11-22 23:46:48 +08:00
configuration (:issue: `6504` ).
2020-05-28 23:07:51 +08:00
- fish only parses `` /etc/paths `` on macOS in login shells, matching
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
- The locale is now reloaded when the `` LOCPATH `` variable is changed
2020-11-22 23:46:48 +08:00
(:issue: `5815` ).
2020-05-28 23:07:51 +08:00
- `` read `` no longer keeps a history, making it suitable for operations
2020-11-22 23:46:48 +08:00
that shouldn’ t end up there, like password entry (:issue: `5904` ).
- `` dirh `` outputs its stack in the correct order (:issue: `5477` ), and behaves
2020-05-28 23:07:51 +08:00
as documented when universal variables are used for its stack
2020-11-22 23:46:48 +08:00
(:issue: `5797` ).
2020-05-28 23:07:51 +08:00
- `` funced `` and the edit-commandline-in-buffer bindings did not work
in fish 3.0 when the `` $EDITOR `` variable contained spaces; this has
2020-11-22 23:46:48 +08:00
been corrected (:issue: `5625` ).
- Builtins now pipe their help output to a pager automatically (:issue: `6227` ).
2020-05-28 23:07:51 +08:00
- `` 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
2020-11-22 23:46:48 +08:00
one (:issue: `5872` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
(: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` ).
2020-05-28 23:07:51 +08:00
- fish will not autosuggest files ending with `` ~ `` unless there are no
2020-11-22 23:46:48 +08:00
other candidates, as these are generally backup files (:issue: `985` ).
- Escape in the pager works correctly (:issue: `5818` ).
2020-05-28 23:07:51 +08:00
- Key bindings that call `` fg `` no longer leave the terminal in a
2020-11-22 23:46:48 +08:00
broken state (:issue: `2114` ).
- Brackets (:issue: `5831` ) and filenames containing `` $ `` (:issue: `6060` ) are completed
2020-05-28 23:07:51 +08:00
with appropriate escaping.
- The output of `` complete `` and `` functions `` is now colorized in
interactive terminals.
- The Web-based configuration handles aliases that include single
2020-11-22 23:46:48 +08:00
quotes correctly (:issue: `6120` ), and launches correctly under Termux (:issue: `6248` )
and OpenBSD (:issue: `6522` ).
2020-05-28 23:07:51 +08:00
- `` function `` now correctly validates parameters for
2020-11-22 23:46:48 +08:00
`` --argument-names `` as valid variable names (:issue: `6147` ) and correctly
2020-05-28 23:07:51 +08:00
parses options following `` --argument-names `` , as in
2020-11-22 23:46:48 +08:00
“`` --argument-names foo --description bar `` ” (:issue: `6186` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
warning when exiting fish (:issue: `6269` ).
2020-05-28 23:07:51 +08:00
- In private mode, setting `` $fish_greeting `` to an empty string before
starting the private session will prevent the warning about history
2020-11-22 23:46:48 +08:00
not being saved from being printed (:issue: `6299` ).
2020-05-28 23:07:51 +08:00
- In the interactive editor, a line break (Enter) inside unclosed
brackets will insert a new line, rather than executing the command
2020-11-22 23:46:48 +08:00
and producing an error (:issue: `6316` ).
- Ctrl-C always repaints the prompt (:issue: `6394` ).
2020-05-28 23:07:51 +08:00
- When run interactively from another program (such as Python), fish
2020-11-22 23:46:48 +08:00
will correctly start a new process group, like other shells (:issue: `5909` ).
2020-05-28 23:07:51 +08:00
- Job identifiers (for example, for background jobs) are assigned more
2020-11-22 23:46:48 +08:00
logically (:issue: `6053` ).
2020-05-28 23:07:51 +08:00
- A bug where history would appear truncated if an empty command was
2020-11-22 23:46:48 +08:00
executed was fixed (:issue: `6032` ).
2020-05-28 23:07:51 +08:00
.. _new-or-improved-bindings-1:
New or improved bindings
^^^^^^^^^^^^^^^^^^^^^^^^
- Pasting strips leading spaces to avoid pasted commands being omitted
2020-11-22 23:46:48 +08:00
from the history (:issue: `4327` ).
2020-05-28 23:07:51 +08:00
- Shift-Left and Shift-Right now default to moving backwards and
2020-11-22 23:46:48 +08:00
forwards by one bigword (words separated by whitespace) (:issue: `1505` ).
2020-05-28 23:07:51 +08:00
- The default escape delay (to differentiate between the escape key and
an alt-combination) has been reduced to 30ms, down from 300ms for the
2020-11-22 23:46:48 +08:00
default mode and 100ms for Vi mode (:issue: `3904` ).
2020-05-28 23:07:51 +08:00
- The `` forward-bigword `` binding now interacts correctly with
2020-11-22 23:46:48 +08:00
autosuggestions (:issue: `5336` ).
2020-05-28 23:07:51 +08:00
- The `` fish_clipboard_* `` functions support Wayland by using
2020-08-01 07:33:43 +08:00
`wl-clipboard <https://github.com/bugaevc/wl-clipboard> `_
2020-11-22 23:46:48 +08:00
(:issue: `5450` ).
2020-05-28 23:07:51 +08:00
- The `` nextd `` and `` prevd `` functions no longer print “Hit end of
history”, instead using a bell. They correctly store working
2020-11-22 23:46:48 +08:00
directories containing symbolic links (:issue: `6395` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
much more responsive with slow prompts (:issue: `5783` ).
2020-05-28 23:07:51 +08:00
- The path-component bindings (like Ctrl-w) now also stop at “:” and
“@”, because those are used to denote user and host in commands such
2020-11-22 23:46:48 +08:00
as `` ssh `` (:issue: `5841` ).
2020-05-28 23:07:51 +08:00
- The NULL character can now be bound via `` bind -k nul `` . Terminals
2020-11-22 23:46:48 +08:00
often generate this character via control-space. (:issue: `3189` ).
2020-05-28 23:07:51 +08:00
- A new readline command `` expand-abbr `` can be used to trigger
2020-11-22 23:46:48 +08:00
abbreviation expansion (:issue: `5762` ).
2020-05-28 23:07:51 +08:00
- 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.
2020-11-22 23:46:48 +08:00
- A new binding to prepend `` sudo `` , bound to Alt-S by default (:issue: `6140` ).
2020-05-28 23:07:51 +08:00
- The Alt-W binding to describe a command should now work better with
2020-11-22 23:46:48 +08:00
multiline prompts (:issue: `6110` )
2020-05-28 23:07:51 +08:00
- The Alt-H binding to open a command’ s man page now tries to ignore
2020-11-22 23:46:48 +08:00
`` sudo `` (:issue: `6122` ).
2020-05-28 23:07:51 +08:00
- A new pair of bind functions, `` history-prefix-search-backward `` (and
2020-11-22 23:46:48 +08:00
`` 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` ).
2020-05-28 23:07:51 +08:00
- In Vi mode, hitting Enter in replace-one mode no longer erases the
2020-11-22 23:46:48 +08:00
prompt (:issue: `6298` ).
2020-05-28 23:07:51 +08:00
- Selections in Vi mode are inclusive, matching the actual behaviour of
2020-11-22 23:46:48 +08:00
Vi (:issue: `5770` ).
2020-05-28 23:07:51 +08:00
.. _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
2020-11-22 23:46:48 +08:00
the host if running via SSH (:issue: `6375` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
elements of the pager’ s colors (:issue: `5524` ).
2020-05-28 23:07:51 +08:00
- Better detection and support for using fish from various system
consoles, where limited colors and special characters are supported
2020-11-22 23:46:48 +08:00
(:issue: `5552` ).
2020-05-28 23:07:51 +08:00
- fish now tries to guess if the system supports Unicode 9 (and
displays emoji as wide), eliminating the need to set
2020-11-22 23:46:48 +08:00
`` $fish_emoji_width `` in most cases (:issue: `5722` ).
2020-05-28 23:07:51 +08:00
- Improvements to the display of wide characters, particularly Korean
2020-11-22 23:46:48 +08:00
characters and emoji (:issue: `5583` , :issue: `5729` ).
2020-05-28 23:07:51 +08:00
- The Vi mode cursor is correctly redrawn when regaining focus under
2020-11-22 23:46:48 +08:00
terminals that report focus (eg tmux) (:issue: `4788` ).
2020-05-28 23:07:51 +08:00
- Variables that control background colors (such as
`` fish_pager_color_search_match `` ) can now use `` --reverse `` .
.. _completions-1:
Completions
^^^^^^^^^^^
- Added completions for
- `` aws ``
2020-11-22 23:46:48 +08:00
- `` bat `` (:issue: `6052` )
- `` bosh `` (:issue: `5700` )
2020-05-28 23:07:51 +08:00
- `` btrfs ``
- `` camcontrol ``
2020-11-22 23:46:48 +08:00
- `` 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` )
2020-05-28 23:07:51 +08:00
- `` kak ``
2020-11-22 23:46:48 +08:00
- `` 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` )
2020-05-28 23:07:51 +08:00
- `` rg ``
- `` rustup ``
2020-11-22 23:46:48 +08:00
- `` 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` )
2020-05-28 23:07:51 +08:00
- `` zstd `` , `` zstdcat `` , `` zstdgrep `` , `` zstdless `` and `` zstdmt ``
2020-11-22 23:46:48 +08:00
(:issue: `6364` )
2020-05-28 23:07:51 +08:00
- Lots of improvements to completions.
- Selecting short options which also have a long name from the
2020-11-22 23:46:48 +08:00
completion pager is possible (:issue: `5634` ).
2020-05-28 23:07:51 +08:00
- Tab completion will no longer add trailing spaces if they already
2020-11-22 23:46:48 +08:00
exist (:issue: `6107` ).
2020-05-28 23:07:51 +08:00
- Completion of subcommands to builtins like `` and `` or `` not `` now
2020-11-22 23:46:48 +08:00
works correctly (:issue: `6249` ).
2020-05-28 23:07:51 +08:00
- Completion of arguments to short options works correctly when
2020-11-22 23:46:48 +08:00
multiple short options are used together (:issue: `332` ).
2020-05-28 23:07:51 +08:00
- Activating completion in the middle of an invalid completion does not
2020-11-22 23:46:48 +08:00
move the cursor any more, making it easier to fix a mistake (:issue: `4124` ).
2020-05-28 23:07:51 +08:00
- 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
2020-05-28 23:25:48 +08:00
---------------------------------
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
old names (:issue: `5586` ).
2020-05-28 23:07:51 +08:00
- `` 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
2020-11-22 23:46:48 +08:00
`` string replace -ra '([ab])' '\\\\$1' a `` (:issue: `5556` ). As a reminder,
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
removed. Use `` fish_vi_key_bindings `` instead (:issue: `6372` ).
2020-05-28 23:07:51 +08:00
.. _for-distributors-and-developers-1:
For distributors and developers
2020-05-28 23:25:48 +08:00
-------------------------------
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
(:issue: `5777` ).
2020-05-28 23:07:51 +08:00
- mandoc can now be used to format the output from `` --help `` if
`` nroff `` is not installed, reducing the number of external
2020-11-22 23:46:48 +08:00
dependencies on systems with `` mandoc `` installed (:issue: `5489` ).
2020-05-28 23:07:51 +08:00
- Some bugs preventing building on Solaris-derived systems such as
2020-11-22 23:46:48 +08:00
Illumos were fixed (:issue: `5458` , :issue: `5461` , :issue: `5611` ).
2020-05-28 23:07:51 +08:00
- 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”
2020-11-22 23:46:48 +08:00
directory, which now defaults to `` /usr/local `` (:issue: `5029` ).
2020-05-28 23:07:51 +08:00
--------------
fish 3.0.2 (released February 19, 2019)
=======================================
This release of fish fixes an issue discovered in fish 3.0.1.
Fixes and improvements
2020-05-28 23:25:48 +08:00
----------------------
2020-05-28 23:07:51 +08:00
- The PWD environment variable is now ignored if it does not resolve to
the true working directory, fixing strange behaviour in terminals
2020-11-22 23:46:48 +08:00
started by editors and IDEs (:issue: `5647` ).
2020-05-28 23:07:51 +08:00
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
2020-05-28 23:25:48 +08:00
----------------------
2020-05-28 23:07:51 +08:00
- `` exec `` does not complain about running foreground jobs when called
2020-11-22 23:46:48 +08:00
(:issue: `5449` ).
2020-05-28 23:07:51 +08:00
- while loops now evaluate to the last executed command in the loop
body (or zero if the body was empty), matching POSIX semantics
2020-11-22 23:46:48 +08:00
(:issue: `4982` ).
2020-05-28 23:07:51 +08:00
- `` read --silent `` no longer echoes to the tty when run from a
2020-11-22 23:46:48 +08:00
non-interactive script (:issue: `5519` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
`` /etc/manpaths.d `` (:issue: `5481` ).
- fish starts correctly under Cygwin/MSYS2 (:issue: `5426` ).
2020-05-28 23:07:51 +08:00
- 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,
2020-11-22 23:46:48 +08:00
instead of once per argument (:issue: `5588` ).
2020-05-28 23:07:51 +08:00
- Fixes and improvements to the git completions, including printing
correct paths with older git versions, fuzzy matching again, reducing
2020-11-22 23:46:48 +08:00
unnecessary offers of root paths (starting with `` :/ `` ) (:issue: `5578` ,
:issue: `5574` , :issue: `5476` ), and ignoring shell aliases, so enterprising users can
2020-05-28 23:07:51 +08:00
set up the wrapping command (via
2020-11-22 23:46:48 +08:00
`` 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` ).
2020-05-28 23:07:51 +08:00
- Starting in symbolically-linked working directories works correctly
2020-11-22 23:46:48 +08:00
(:issue: `5525` ).
2020-05-28 23:07:51 +08:00
- The default `` fish_title `` function no longer contains extra spaces
2020-11-22 23:46:48 +08:00
(:issue: `5517` ).
2020-05-28 23:07:51 +08:00
- The `` nim `` prompt now works correctly when chosen in the Web-based
2020-11-22 23:46:48 +08:00
configuration (:issue: `5490` ).
- `` string `` now prints help to stdout, like other builtins (:issue: `5495` ).
2020-05-28 23:07:51 +08:00
- Killing the terminal while fish is in vi normal mode will no longer
2020-11-22 23:46:48 +08:00
send it spinning and eating CPU. (:issue: `5528` )
- A number of crashes have been fixed (:issue: `5550` , :issue: `5548` , :issue: `5479` , :issue: `5453` ).
2020-05-28 23:07:51 +08:00
- Improvements to the documentation and certain completions.
Known issues
2020-05-28 23:25:48 +08:00
------------
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
not be displayed (:issue: `5619` ).
2020-05-28 23:07:51 +08:00
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:
2020-11-22 23:46:48 +08:00
- builds correctly against musl libc (:issue: `5407` )
- handles huge numeric arguments to `` test `` correctly (:issue: `5414` )
2020-05-28 23:07:51 +08:00
- 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:
2020-11-22 23:46:48 +08:00
- 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
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
starting with `` % `` (:issue: `4230` , :issue: `1202` ).
2020-05-28 23:07:51 +08:00
- `` set x[1] x[2] a b `` , to set multiple elements of an array at once,
2020-11-22 23:46:48 +08:00
is no longer valid syntax (:issue: `4236` ).
2020-05-28 23:07:51 +08:00
- A literal `` {} `` now expands to itself, rather than nothing. This
2020-11-22 23:46:48 +08:00
makes working with `` find -exec `` easier (:issue: `1109` , :issue: `4632` ).
2020-05-28 23:07:51 +08:00
- Literally accessing a zero-index is now illegal syntax and is caught
2020-11-22 23:46:48 +08:00
by the parser (:issue: `4862` ). (fish indices start at 1)
2020-05-28 23:07:51 +08:00
- Successive commas in brace expansions are handled in less surprising
manner. For example, `` {,,,} `` expands to four empty strings rather
2020-11-22 23:46:48 +08:00
than an empty string, a comma and an empty string again (:issue: `3002` ,
:issue: `4632` ).
2020-05-28 23:07:51 +08:00
- `` for `` loop control variables are no longer local to the `` for ``
2020-11-22 23:46:48 +08:00
block (:issue: `1935` ).
2020-05-28 23:07:51 +08:00
- Variables set in `` if `` and `` while `` conditions are available
2020-11-22 23:46:48 +08:00
outside the block (:issue: `4820` ).
2020-05-28 23:07:51 +08:00
- Local exported (`` set -lx `` ) vars are now visible to functions
2020-11-22 23:46:48 +08:00
(:issue: `1091` ).
2020-05-28 23:07:51 +08:00
- The new `` math `` builtin (see below) does not support logical
2020-11-22 23:46:48 +08:00
expressions; `` test `` should be used instead (:issue: `4777` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
(:issue: `4490` ).
2020-05-28 23:07:51 +08:00
- `` cd `` no longer resolves symlinks. fish now maintains a virtual
2020-11-22 23:46:48 +08:00
path, matching other shells (:issue: `3350` ).
2020-05-28 23:07:51 +08:00
- `` source `` now requires an explicit `` - `` as the filename to read
2020-11-22 23:46:48 +08:00
from the terminal (:issue: `2633` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
prevents users unintentionally breaking stuff (:issue: `3000` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
`` fish_byte_limit `` (:issue: `4414` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
on colons (:issue: `436` ).
2020-05-28 23:07:51 +08:00
- The `` history `` builtin’ s `` --with-time `` option has been removed;
this has been deprecated in favor of `` --show-time `` since 2.7.0
2020-11-22 23:46:48 +08:00
(:issue: `4403` ).
2020-05-28 23:07:51 +08:00
- 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 ``
2020-11-22 23:46:48 +08:00
variable. (:issue: `4940` )
2020-05-28 23:07:51 +08:00
- The use of the `` IFS `` variable for `` read `` is deprecated; `` IFS ``
2020-11-22 23:46:48 +08:00
will be ignored in the future (:issue: `4156` ). Use the `` read --delimiter ``
2020-05-28 23:07:51 +08:00
option instead.
- The `` function --on-process-exit `` switch will be removed in future
2020-11-22 23:46:48 +08:00
(:issue: `4700` ). Use the `` fish_exit `` event instead:
2020-05-28 23:07:51 +08:00
`` function --on-event fish_exit `` .
2020-11-22 23:46:48 +08:00
- `` $_ `` is deprecated and will removed in the future (:issue: `813` ). Use
2020-05-28 23:07:51 +08:00
`` status current-command `` in a command substitution instead.
- `` ^ `` as a redirection deprecated and will be removed in the future.
2020-11-22 23:46:48 +08:00
(:issue: `4394` ). Use `` 2> `` to redirect stderr. This is controlled by the
2020-05-28 23:07:51 +08:00
`` stderr-nocaret `` feature flag.
- `` ? `` as a glob (wildcard) is deprecated and will be removed in the
2020-11-22 23:46:48 +08:00
future (:issue: `4520` ). This is controlled by the `` qmark-noglob `` feature
2020-05-28 23:07:51 +08:00
flag.
Notable fixes and improvements
------------------------------
.. _syntax-changes-and-new-commands-2:
Syntax changes and new commands
2020-05-28 23:25:48 +08:00
-------------------------------
2020-05-28 23:07:51 +08:00
- fish now supports `` && `` (like `` and `` ), `` || `` (like `` or `` ), and
`` ! `` (like `` not `` ), for better migration from POSIX-compliant
2020-11-22 23:46:48 +08:00
shells (:issue: `4620` ).
- Variables may be used as commands (:issue: `154` ).
2020-05-28 23:07:51 +08:00
- 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.
2020-11-22 23:46:48 +08:00
- A new `` wait `` command for waiting on backgrounded processes (:issue: `4498` ).
2020-05-28 23:07:51 +08:00
- `` math `` is now a builtin rather than a wrapper around `` bc ``
2020-11-22 23:46:48 +08:00
(:issue: `3157` ). Floating point computations is now used by default, and can
be controlled with the new `` --scale `` option (:issue: `4478` ).
2020-05-28 23:07:51 +08:00
- Setting `` $PATH `` no longer warns on non-existent directories,
allowing for a single $PATH to be shared across machines (eg via
2020-11-22 23:46:48 +08:00
dotfiles) (:issue: `2969` ).
2020-05-28 23:07:51 +08:00
- `` while `` sets `` $status `` to a non-zero value if the loop is not
2020-11-22 23:46:48 +08:00
executed (:issue: `4982` ).
2020-05-28 23:07:51 +08:00
- Command substitution output is now limited to 10 MB by default,
2020-11-22 23:46:48 +08:00
controlled by the `` fish_read_limit `` variable (:issue: `3822` ). Notably, this
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
`` hostname `` executable (:issue: `4422` ).
2020-05-28 23:07:51 +08:00
- Bare `` bind `` invocations in config.fish now work. The
`` fish_user_key_bindings `` function is no longer necessary, but will
2020-11-22 23:46:48 +08:00
still be executed if it exists (:issue: `5191` ).
2020-05-28 23:07:51 +08:00
- `` $fish_pid `` and `` $last_pid `` are available as replacements for
`` %self `` and `` %last `` .
New features in commands
2020-05-28 23:25:48 +08:00
------------------------
2020-05-28 23:07:51 +08:00
- `` alias `` has a new `` --save `` option to save the generated function
2020-11-22 23:46:48 +08:00
immediately (:issue: `4878` ).
2020-05-28 23:07:51 +08:00
- `` bind `` has a new `` --silent `` option to ignore bind requests for
2020-11-22 23:46:48 +08:00
named keys not available under the current terminal (:issue: `4188` , :issue: `4431` ).
2020-05-28 23:07:51 +08:00
- `` complete `` has a new `` --keep-order `` option to show the provided
or dynamically-generated argument list in the same order as
2020-11-22 23:46:48 +08:00
specified, rather than alphabetically (:issue: `361` ).
2020-05-28 23:07:51 +08:00
- `` exec `` prompts for confirmation if background jobs are running.
- `` funced `` has a new `` --save `` option to automatically save the
2020-11-22 23:46:48 +08:00
edited function after successfully editing (:issue: `4668` ).
2020-05-28 23:07:51 +08:00
- `` functions `` has a new `` --handlers `` option to show functions
2020-11-22 23:46:48 +08:00
registered as event handlers (:issue: `4694` ).
- `` history search `` supports globs for wildcard searching (:issue: `3136` ) and
2020-05-28 23:07:51 +08:00
has a new `` --reverse `` option to show entries from oldest to newest
2020-11-22 23:46:48 +08:00
(:issue: `4375` ).
2020-05-28 23:07:51 +08:00
- `` jobs `` has a new `` --quiet `` option to silence the output.
- `` read `` has a new `` --delimiter `` option for splitting input into
2020-11-22 23:46:48 +08:00
arrays (:issue: `4256` ).
2020-05-28 23:07:51 +08:00
- `` read `` writes directly to stdout if called without arguments
2020-11-22 23:46:48 +08:00
(:issue: `4407` ).
2020-05-28 23:07:51 +08:00
- `` read `` can now read individual lines into separate variables
without consuming the input in its entirety via the new `` /--line ``
option.
2020-11-22 23:46:48 +08:00
- `` set `` has new `` --append `` and `` --prepend `` options (:issue: `1326` ).
2020-05-28 23:07:51 +08:00
- `` string match `` with an empty pattern and `` --entire `` in glob mode
2020-11-22 23:46:48 +08:00
now matches everything instead of nothing (:issue: `4971` ).
2020-05-28 23:07:51 +08:00
- `` string split `` supports a new `` --no-empty `` option to exclude
2020-11-22 23:46:48 +08:00
empty strings from the result (:issue: `4779` ).
2020-05-28 23:07:51 +08:00
- `` string `` has new subcommands `` split0 `` and `` join0 `` for working
with NUL-delimited output.
- `` string `` no longer stops processing text after NUL characters
2020-11-22 23:46:48 +08:00
(:issue: `4605` )
2020-05-28 23:07:51 +08:00
- `` 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
2020-05-28 23:25:48 +08:00
------------------------
2020-05-28 23:07:51 +08:00
- A pipe at the end of a line now allows the job to continue on the
2020-11-22 23:46:48 +08:00
next line (:issue: `1285` ).
2020-05-28 23:07:51 +08:00
- Italics and dim support out of the box on macOS for Terminal.app and
2020-11-22 23:46:48 +08:00
iTerm (:issue: `4436` ).
2020-05-28 23:07:51 +08:00
- `` cd `` tab completions no longer descend into the deepest unambiguous
2020-11-22 23:46:48 +08:00
path (:issue: `4649` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
wrapping around (:issue: `4680` ).
2020-05-28 23:07:51 +08:00
- Typing normal characters while the completion pager is active no
longer shows the search field. Instead it enters them into the
2020-11-22 23:46:48 +08:00
command line, and ends paging (:issue: `2249` ).
2020-05-28 23:07:51 +08:00
- 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.
2020-11-22 23:46:48 +08:00
- Searching in the pager now does a full fuzzy search (:issue: `5213` ).
2020-05-28 23:07:51 +08:00
- The pager will now show the full command instead of just its last
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
- Wrapping completions (from `` complete --wraps `` or
`` function --wraps `` ) can now inject arguments. For example,
2020-11-22 23:46:48 +08:00
`` complete gco --wraps 'git checkout' `` now works properly (:issue: `1976` ).
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
command substitutions (:issue: `4962` ).
2020-05-28 23:07:51 +08:00
- The screen is no longer reset after a BEL, fixing graphical glitches
2020-11-22 23:46:48 +08:00
(:issue: `3693` ).
2020-05-28 23:07:51 +08:00
- vi-mode now supports ‘ ;’ and ‘ ,’ motions. This introduces new
{forward,backward}-jump-till and repeat-jump{,-reverse} bind
2020-11-22 23:46:48 +08:00
functions (:issue: `5140` ).
- The `` *y `` vi-mode binding now works (:issue: `5100` ).
- True color is now enabled in neovim by default (:issue: `2792` ).
2020-05-28 23:07:51 +08:00
- Terminal size variables (`` $COLUMNS `` /`` $LINES `` ) are now updated
before `` fish_prompt `` is called, allowing the prompt to react
2020-11-22 23:46:48 +08:00
(:issue: `904` ).
2020-05-28 23:07:51 +08:00
- Multi-line prompts no longer repeat when the terminal is resized
2020-11-22 23:46:48 +08:00
(:issue: `2320` ).
2020-05-28 23:07:51 +08:00
- `` xclip `` support has been added to the clipboard integration
2020-11-22 23:46:48 +08:00
(:issue: `5020` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
(:issue: `5011` ).
2020-05-28 23:07:51 +08:00
- Deleting a one-character word no longer erases the next word as well
2020-11-22 23:46:48 +08:00
(:issue: `4747` ).
- Token history search (Alt-Up) omits duplicate entries (:issue: `4795` ).
2020-05-28 23:07:51 +08:00
- 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.
2020-11-22 23:46:48 +08:00
- Completing a function shows the description properly (:issue: `5206` ).
2020-05-28 23:07:51 +08:00
- Added completions for
- `` ansible `` , including `` ansible-galaxy `` , `` ansible-playbook ``
2020-11-22 23:46:48 +08:00
and `` ansible-vault `` (:issue: `4697` )
- `` bb-power `` (:issue: `4800` )
- `` bd `` (:issue: `4472` )
2020-05-28 23:07:51 +08:00
- `` bower ``
2020-11-22 23:46:48 +08:00
- `` clang `` and `` clang++ `` (:issue: `4174` )
- `` conda `` (:issue: `4837` )
2020-05-28 23:07:51 +08:00
- `` configure `` (for autoconf-generated files only)
- `` curl ``
2020-11-22 23:46:48 +08:00
- `` doas `` (:issue: `5196` )
- `` ebuild `` (:issue: `4911` )
- `` emaint `` (:issue: `4758` )
- `` eopkg `` (:issue: `4600` )
- `` exercism `` (:issue: `4495` )
2020-05-28 23:07:51 +08:00
- `` hjson ``
2020-11-22 23:46:48 +08:00
- `` hugo `` (:issue: `4529` )
- `` j `` (from autojump :issue: `4344` )
- `` jbake `` (:issue: `4814` )
- `` jhipster `` (:issue: `4472` )
2020-05-28 23:07:51 +08:00
- `` kitty ``
- `` kldload ``
- `` kldunload ``
2020-11-22 23:46:48 +08:00
- `` makensis `` (:issue: `5242` )
2020-05-28 23:07:51 +08:00
- `` meson ``
2020-11-22 23:46:48 +08:00
- `` mkdocs `` (:issue: `4906` )
- `` ngrok `` (:issue: `4642` )
2020-05-28 23:07:51 +08:00
- OpenBSD’ s `` pkg_add `` , `` pkg_delete `` , `` pkg_info `` , `` pfctl `` ,
2020-11-22 23:46:48 +08:00
`` rcctl `` , `` signify `` , and `` vmctl `` (:issue: `4584` )
2020-05-28 23:07:51 +08:00
- `` openocd ``
- `` optipng ``
2020-11-22 23:46:48 +08:00
- `` opkg `` (:issue: `5168` )
- `` pandoc `` (:issue: `2937` )
- `` port `` (:issue: `4737` )
- `` powerpill `` (:issue: `4800` )
- `` pstack `` (:issue: `5135` )
- `` serve `` (:issue: `5026` )
2020-05-28 23:07:51 +08:00
- `` ttx ``
- `` unzip ``
2020-11-22 23:46:48 +08:00
- `` virsh `` (:issue: `5113` )
- `` xclip `` (:issue: `5126` )
2020-05-28 23:07:51 +08:00
- `` xsv ``
2020-11-22 23:46:48 +08:00
- `` zfs `` and `` zpool `` (:issue: `4608` )
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- Lots of improvements to completions (especially `` darcs `` (:issue: `5112` ),
2020-05-28 23:07:51 +08:00
`` 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
2020-05-28 23:25:48 +08:00
----------------------------
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- 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
2020-05-28 23:07:51 +08:00
(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
2020-11-22 23:46:48 +08:00
`` fish_ambiguous_width `` (:issue: `5149` ) and `` fish_emoji_width `` (:issue: `2652` )
2020-05-28 23:07:51 +08:00
variables. Alternatively, a new build-time option INTERNAL_WCWIDTH
2020-11-22 23:46:48 +08:00
can be used to use the system’ s wcwidth instead (:issue: `4816` ).
2020-05-28 23:07:51 +08:00
- `` functions `` correctly supports `` -d `` as the short form of
2020-11-22 23:46:48 +08:00
`` --description `` . (:issue: `5105` )
2020-05-28 23:07:51 +08:00
- `` /etc/paths `` is now parsed like macOS’ bash `` path_helper `` , fixing
2020-11-22 23:46:48 +08:00
$PATH order (:issue: `4336` , :issue: `4852` ) on macOS.
2020-05-28 23:07:51 +08:00
- Using a read-only variable in a `` for `` loop produces an error,
2020-11-22 23:46:48 +08:00
rather than silently producing incorrect results (:issue: `4342` ).
2020-05-28 23:07:51 +08:00
- The universal variables filename no longer contains the hostname or
MAC address. It is now at the fixed location
2020-11-22 23:46:48 +08:00
`` .config/fish/fish_variables `` (:issue: `1912` ).
2020-05-28 23:07:51 +08:00
- Exported variables in the global or universal scope no longer have
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
- Pressing Ctrl-C while running a script now reliably terminates fish
2020-11-22 23:46:48 +08:00
(:issue: `5253` ).
2020-05-28 23:07:51 +08:00
.. _for-distributors-and-developers-2:
For distributors and developers
2020-05-28 23:25:48 +08:00
-------------------------------
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
session (:issue: `4521` ).
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
(:issue: `2847` ).
2020-05-28 23:07:51 +08:00
- A new `` argparse `` command is available to allow fish script to parse
arguments with the same behavior as builtin commands. This also
2020-11-22 23:46:48 +08:00
includes the `` fish_opt `` helper command. (:issue: `4190` ).
- Invalid array indexes are now silently ignored (:issue: `826` , :issue: `4127` ).
2020-05-28 23:07:51 +08:00
- Improvements to the debugging facility, including a prompt specific
to the debugger (`` fish_breakpoint_prompt `` ) and a
2020-11-22 23:46:48 +08:00
`` status is-breakpoint `` subcommand (:issue: `1310` ).
2020-05-28 23:07:51 +08:00
- `` string `` supports new `` lower `` and `` upper `` subcommands, for
2020-11-22 23:46:48 +08:00
altering the case of strings (:issue: `4080` ). The case changing is not
2020-05-28 23:07:51 +08:00
locale-aware yet.- `` string escape `` has a new `` --style=xxx `` flag
2020-11-22 23:46:48 +08:00
where `` xxx `` can be `` script `` , `` var `` , or `` url `` (:issue: `4150` ), and can
be reversed with `` string unescape `` (:issue: `3543` ).
2020-05-28 23:07:51 +08:00
- History can now be split into sessions with the `` fish_history ``
2020-11-22 23:46:48 +08:00
variable, or not saved to disk at all (:issue: `102` ).
2020-05-28 23:07:51 +08:00
- Read history is now controlled by the `` fish_history `` variable
2020-11-22 23:46:48 +08:00
rather than the `` --mode-name `` flag (:issue: `1504` ).
2020-05-28 23:07:51 +08:00
- `` command `` now supports an `` --all `` flag to report all directories
with the command. `` which `` is no longer a runtime dependency
2020-11-22 23:46:48 +08:00
(:issue: `2778` ).
2020-05-28 23:07:51 +08:00
- fish can run commands before starting an interactive session using
2020-11-22 23:46:48 +08:00
the new `` --init-command `` /`` -C `` options (:issue: `4164` ).
2020-05-28 23:07:51 +08:00
- `` set `` has a new `` --show `` option to show lots of information about
2020-11-22 23:46:48 +08:00
variables (:issue: `4265` ).
2020-05-28 23:07:51 +08:00
Other significant changes
-------------------------
- The `` COLUMNS `` and `` LINES `` environment variables are now correctly
2020-11-22 23:46:48 +08:00
set the first time `` fish_prompt `` is run (:issue: `4141` ).
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- `` complete ` ` \ ’ s `` --no-files`` option works as intended (:issue: ` 112 ` ).
2020-05-28 23:07:51 +08:00
- `` echo -h `` now correctly echoes `` -h `` in line with other shells
2020-11-22 23:46:48 +08:00
(:issue: `4120` ).
2020-05-28 23:07:51 +08:00
- The `` export `` compatibility function now returns zero on success,
2020-11-22 23:46:48 +08:00
rather than always returning 1 (:issue: `4435` ).
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- Stop converting empty elements in MANPATH to “.” (:issue: `4158` ). The
2020-05-28 23:07:51 +08:00
behavior being changed was introduced in fish 2.6.0.
- `` count -h `` and `` count --help `` now return 1 rather than produce
2020-11-22 23:46:48 +08:00
command help output (:issue: `4189` ).
2020-05-28 23:07:51 +08:00
- An attempt to `` read `` which stops because too much data is available
2020-11-22 23:46:48 +08:00
still defines the variables given as parameters (:issue: `4180` ).
2020-05-28 23:07:51 +08:00
- A regression in fish 2.4.0 which prevented `` pushd +1 `` from working
2020-11-22 23:46:48 +08:00
has been fixed (:issue: `4091` ).
2020-05-28 23:07:51 +08:00
- A regression in fish 2.6.0 where multiple `` read `` commands in
2020-11-22 23:46:48 +08:00
non-interactive scripts were broken has been fixed (:issue: `4206` ).
2020-05-28 23:07:51 +08:00
- A regression in fish 2.6.0 involving universal variables with
side-effects at startup such as `` set -U fish_escape_delay_ms 10 ``
2020-11-22 23:46:48 +08:00
has been fixed (:issue: `4196` ).
2020-05-28 23:07:51 +08:00
- Added completions for:
2020-11-22 23:46:48 +08:00
- `` 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` )
2020-05-28 23:07:51 +08:00
- `` kdeconnect-cli ``
2020-11-22 23:46:48 +08:00
- `` 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` )
2020-05-28 23:07:51 +08:00
- Lots of improvements to completions.
- Updated Chinese and French translations.
- Improved completions for:
- `` apt ``
2020-11-22 23:46:48 +08:00
- `` cd `` (:issue: `4061` )
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- `` composer `` (:issue: `4295` )
2020-05-28 23:07:51 +08:00
- `` eopkg ``
2020-11-22 23:46:48 +08:00
- `` flatpak `` (:issue: `4456` )
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- `` git `` (:issue: `4117` , :issue: `4147` , :issue: `4329` , :issue: `4368` )
2020-05-28 23:07:51 +08:00
- `` gphoto2 ``
2020-11-22 23:46:48 +08:00
- `` killall `` (:issue: `4052` )
2020-05-28 23:07:51 +08:00
- `` ln ``
2020-11-22 23:46:48 +08:00
- `` npm `` (:issue: `4241` )
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- `` ssh `` (:issue: `4377` )
2020-05-28 23:07:51 +08:00
- `` tail ``
2020-11-22 23:46:48 +08:00
- `` xdg-mime `` (:issue: `4333` )
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- `` zypper `` (:issue: `4325` )
2020-05-28 23:07:51 +08:00
fish 2.6.0 (released June 3, 2017)
==================================
Since the beta release of fish 2.6b1, fish version 2.6.0 contains a
2020-11-22 23:46:48 +08:00
number of minor fixes, new completions for `` magneto `` (:issue: `4043` ), and
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
command in other shells (:issue: `2810` ).
2020-05-28 23:07:51 +08:00
- Command substitutions now have access to the terminal, like in other
2020-11-22 23:46:48 +08:00
shells. This allows tools like `` fzf `` to work properly (:issue: `1362` ,
:issue: `3922` ).
2020-05-28 23:07:51 +08:00
- 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.
2020-11-22 23:46:48 +08:00
- New French (:issue: `3772` & :issue: `3788` ) and improved German (:issue: `3834` ) translations.
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
file to return to the old behaviour (:issue: `2007` ).
2020-05-28 23:07:51 +08:00
- Performance improvements in prompts and functions that set lots of
2020-11-22 23:46:48 +08:00
colours (:issue: `3793` ).
2020-05-28 23:07:51 +08:00
- The Delete key no longer deletes backwards (a regression in 2.5.0).
- `` functions `` supports a new `` --details `` option, which identifies
2020-11-22 23:46:48 +08:00
where the function was loaded from (:issue: `3295` ), and a
2020-05-28 23:07:51 +08:00
`` --details --verbose `` option which includes the function
2020-11-22 23:46:48 +08:00
description (:issue: `597` ).
2020-05-28 23:07:51 +08:00
- `` 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
2020-11-22 23:46:48 +08:00
typed (:issue: `838` ), for when reading sensitive data from the terminal.
2020-05-28 23:07:51 +08:00
`` read `` also now accepts simple strings for the prompt (rather than
2020-11-22 23:46:48 +08:00
scripts) with the new `` -P `` and `` --prompt-str `` options (:issue: `802` ).
2020-05-28 23:07:51 +08:00
- `` 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
2020-11-22 23:46:48 +08:00
(:issue: `4103` ).
- `` bind `` supports a new `` --list-modes `` option (:issue: `3872` ).
2020-05-28 23:07:51 +08:00
- `` bg `` will check all of its arguments before backgrounding any jobs;
any invalid arguments will cause a failure, but non-existent (eg
2020-11-22 23:46:48 +08:00
recently exited) jobs are ignored (:issue: `3909` ).
2020-05-28 23:07:51 +08:00
- `` funced `` warns if the function being edited has not been modified
2020-11-22 23:46:48 +08:00
(:issue: `3961` ).
- `` printf `` correctly outputs “long long” integers (:issue: `3352` ).
2020-05-28 23:07:51 +08:00
- `` status `` supports a new `` current-function `` subcommand to print
2020-11-22 23:46:48 +08:00
the current function name (:issue: `1743` ).
- `` string `` supports a new `` repeat `` subcommand (:issue: `3864` ).
2020-05-28 23:07:51 +08:00
`` string match `` supports a new `` --entire `` option to emit the
2020-11-22 23:46:48 +08:00
entire line matched by a pattern (:issue: `3957` ). `` string replace `` supports
2020-05-28 23:07:51 +08:00
a new `` --filter `` option to only emit lines which underwent a
2020-11-22 23:46:48 +08:00
replacement (:issue: `3348` ).
- `` test `` supports the `` -k `` option to test for sticky bits (:issue: `733` ).
- `` umask `` understands symbolic modes (:issue: `738` ).
2020-05-28 23:07:51 +08:00
- Empty components in the `` CDPATH `` , `` MANPATH `` and `` PATH ``
2020-11-22 23:46:48 +08:00
variables are now converted to “.” (:issue: `2106` , :issue: `3914` ).
2020-05-28 23:07:51 +08:00
- New versions of ncurses (6.0 and up) wipe terminal scrollback buffers
with certain commands; the `` C-l `` binding tries to avoid this
2020-11-22 23:46:48 +08:00
(:issue: `2855` ).
2020-05-28 23:07:51 +08:00
- Some systems’ `` su `` implementations do not set the `` USER ``
2020-11-22 23:46:48 +08:00
environment variable; it is now reset for root users (:issue: `3916` ).
2020-05-28 23:07:51 +08:00
- Under terminals which support it, bracketed paste is enabled,
2020-11-22 23:46:48 +08:00
escaping problematic characters for security and convience (:issue: `3871` ).
2020-05-28 23:07:51 +08:00
Inside single quotes (`` ' `` ), single quotes and backslashes in pasted
2020-11-22 23:46:48 +08:00
text are escaped (:issue: `967` ). The `` fish_clipboard_paste `` function (bound
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
in the pipeline has completed (:issue: `1926` ). This behaviour matches other
2020-05-28 23:07:51 +08:00
shells mre closely.
- All functions requiring Python work with whichever version of Python
2020-11-22 23:46:48 +08:00
is installed (:issue: `3970` ). Python 3 is preferred, but Python 2.6 remains
2020-05-28 23:07:51 +08:00
the minimum version required.
- The color of the cancellation character can be controlled by the
2020-11-22 23:46:48 +08:00
`` fish_color_cancel `` variable (:issue: `3963` ).
2020-05-28 23:07:51 +08:00
- Added completions for:
2020-11-22 23:46:48 +08:00
- `` caddy `` (:issue: `4008` )
- `` castnow `` (:issue: `3744` )
- `` climate `` (:issue: `3760` )
2020-05-28 23:07:51 +08:00
- `` flatpak ``
2020-11-22 23:46:48 +08:00
- `` 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` )
2020-05-28 23:07:51 +08:00
- `` xinput ``
2020-11-22 23:46:48 +08:00
- `` 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` ).
2020-05-28 23:07:51 +08:00
--------------
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
2020-11-22 23:46:48 +08:00
Vi-style key bindings (:issue: `3731` ).
2020-05-28 23:07:51 +08:00
--------------
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
2020-05-28 23:25:48 +08:00
^^^^^
2020-05-28 23:07:51 +08:00
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
2020-05-28 23:25:48 +08:00
^^^^^^^^^^^^^^^^
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
into line with stopped processes. (:issue: `3497` )
2020-05-28 23:07:51 +08:00
- `` 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
2020-11-22 23:46:48 +08:00
(:issue: `3619` ).
2020-05-28 23:07:51 +08:00
- A new key bindings preset, `` fish_hybrid_key_bindings `` , including
all the Emacs-style and Vi-style bindings, which behaves like
2020-11-22 23:46:48 +08:00
`` fish_vi_key_bindings `` in fish 2.3.0 (:issue: `3556` ).
2020-05-28 23:07:51 +08:00
- `` function `` now returns an error when called with invalid options,
2020-11-22 23:46:48 +08:00
rather than defining the function anyway (:issue: `3574` ). This was a
2020-05-28 23:07:51 +08:00
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.
2020-11-22 23:46:48 +08:00
- Improved compatiblity with Android (:issue: `3585` ), MSYS/mingw (:issue: `2360` ), and
Solaris (:issue: `3456` , :issue: `3340` ).
2020-05-28 23:07:51 +08:00
- Like other shells, the `` test `` builting now returns an error for
2020-11-22 23:46:48 +08:00
numeric operations on invalid integers (:issue: `3346` , :issue: `3581` ).
2020-05-28 23:07:51 +08:00
- `` 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
2020-11-22 23:46:48 +08:00
for the foreseeable future (:issue: `3526` ), although only one subcommand or
2020-05-28 23:07:51 +08:00
option can be specified at a time.
- Selection mode (used with “begin-selection”) no longer selects a
2020-11-22 23:46:48 +08:00
character the cursor does not move over (:issue: `3684` ).
2020-05-28 23:07:51 +08:00
- List indexes are handled better, and a bit more liberally in some
2020-11-22 23:46:48 +08:00
cases (`` echo $PATH[1 .. 3] `` is now valid) (:issue: `3579` ).
2020-05-28 23:07:51 +08:00
- The `` fish_mode_prompt `` function is now simply a stub around
`` fish_default_mode_prompt `` , which allows the mode prompt to be
2020-11-22 23:46:48 +08:00
included more easily in customised prompt functions (:issue: `3641` ).
2020-05-28 23:07:51 +08:00
.. _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.
2020-11-22 23:46:48 +08:00
- `` complete `` accepts empty strings as descriptions (:issue: `3557` ).
2020-05-28 23:07:51 +08:00
- `` command `` accepts `` -q `` /`` --quiet `` in combination with
2020-11-22 23:46:48 +08:00
`` --search `` (:issue: `3591` ), providing a simple way of checking whether a
2020-05-28 23:07:51 +08:00
command exists in scripts.
- Abbreviations can now be renamed with
2020-11-22 23:46:48 +08:00
`` abbr --rename OLD_KEY NEW_KEY `` (:issue: `3610` ).
2020-05-28 23:07:51 +08:00
- The command synopses printed by `` --help `` options work better with
2020-11-22 23:46:48 +08:00
copying and pasting (:issue: `2673` ).
2020-05-28 23:07:51 +08:00
- `` help `` launches the browser specified by the
2020-11-22 23:46:48 +08:00
`` $fish_help_browser variable `` if it is set (:issue: `3131` ).
2020-05-28 23:07:51 +08:00
- History merging could lose items under certain circumstances and is
2020-11-22 23:46:48 +08:00
now fixed (:issue: `3496` ).
2020-05-28 23:07:51 +08:00
- The `` $status `` variable is now set to 123 when a syntactically
2020-11-22 23:46:48 +08:00
invalid command is entered (:issue: `3616` ).
2020-05-28 23:07:51 +08:00
- Exiting fish now signals all background processes to terminate, not
2020-11-22 23:46:48 +08:00
just stopped jobs (:issue: `3497` ).
2020-05-28 23:07:51 +08:00
- A new `` prompt_hostname `` function which prints a hostname suitable
2020-11-22 23:46:48 +08:00
for use in prompts (:issue: `3482` ).
2020-05-28 23:07:51 +08:00
- The `` __fish_man_page `` function (bound to Alt-h by default) now
tries to recognize subcommands (e.g. `` git add `` will now open the
2020-11-22 23:46:48 +08:00
“git-add” man page) (:issue: `3678` ).
2020-05-28 23:07:51 +08:00
- A new function `` edit_command_buffer `` (bound to Alt-e & Alt-v by
2020-11-22 23:46:48 +08:00
default) to edit the command buffer in an external editor (:issue: `1215` ,
:issue: `3627` ).
2020-05-28 23:07:51 +08:00
- `` set_color `` now supports italics (`` --italics `` ), dim (`` --dim `` )
2020-11-22 23:46:48 +08:00
and reverse (`` --reverse `` ) modes (:issue: `3650` ).
2020-05-28 23:07:51 +08:00
- Filesystems with very slow locking (eg incorrectly-configured NFS)
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
- Added completions for:
2020-11-22 23:46:48 +08:00
- `` 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` )
2020-05-28 23:07:51 +08:00
--------------
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
2020-11-22 23:46:48 +08:00
prompt (:issue: `3499` ).
2020-05-28 23:07:51 +08:00
- Improved the title set in Apple Terminal.app.
- Added completions for `` defaults `` and improved completions for
2020-11-22 23:46:48 +08:00
`` diskutil `` (:issue: `3478` ).
2020-05-28 23:07:51 +08:00
--------------
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
2020-11-22 23:46:48 +08:00
using X11 (e.g. Linux). (:issue: `3061` )
2020-05-28 23:07:51 +08:00
- `` history `` uses subcommands (`` history delete `` ) rather than options
2020-11-22 23:46:48 +08:00
(`` history --delete `` ) for its actions (:issue: `3367` ). You can no longer
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
timestamps (:issue: `3175` , :issue: `3244` ), and `` --null `` to null terminate history
2020-05-28 23:07:51 +08:00
entries in the search output.
- `` history search `` is now case-insensitive by default (which also
2020-11-22 23:46:48 +08:00
affects `` history delete `` ) (:issue: `3236` ).
- `` history delete `` now correctly handles multiline commands (:issue: `31` ).
2020-05-28 23:07:51 +08:00
- Vi-style bindings no longer include all of the default emacs-style
2020-11-22 23:46:48 +08:00
bindings; instead, they share some definitions (:issue: `3068` ).
2020-05-28 23:07:51 +08:00
- If there is no locale set in the environment, various known system
configuration files will be checked for a default. If no locale can
2020-11-22 23:46:48 +08:00
be found, `` en_US-UTF.8 `` will be used (:issue: `277` ).
2020-05-28 23:07:51 +08:00
- A number followed by a caret (e.g. `` 5^ `` ) is no longer treated as a
2020-11-22 23:46:48 +08:00
redirection (:issue: `1873` ).
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
(:issue: `3400` ). It is used only for systems without a `` realpath `` or
`` grealpath `` utility (:issue: `3374` ).
2020-05-28 23:07:51 +08:00
- Improved color handling on terminals/consoles with 8-16 colors,
2020-11-22 23:46:48 +08:00
particularly the use of bright named color (:issue: `3176` , :issue: `3260` ).
2020-05-28 23:07:51 +08:00
- `` fish_indent `` can now read from files given as arguments, rather
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
- Suggestions will be offered more often, like after removing
2020-11-22 23:46:48 +08:00
characters (:issue: `3069` ).
2020-05-28 23:07:51 +08:00
- `` history --merge `` now correctly interleaves items in chronological
2020-11-22 23:46:48 +08:00
order (:issue: `2312` ).
2020-05-28 23:07:51 +08:00
- Options for `` fish_indent `` have been aligned with the other binaries
- in particular, `` -d `` now means `` --debug `` . The `` --dump `` option
2020-11-22 23:46:48 +08:00
has been renamed to `` --dump-parse-tree `` (:issue: `3191` ).
2020-05-28 23:07:51 +08:00
- The display of bindings in the Web-based configuration has been
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
- A bug in FreeBSD 11 & 12, Dragonfly BSD & illumos prevented fish from
working correctly on these platforms under UTF-8 locales; fish now
2020-11-22 23:46:48 +08:00
avoids the buggy behaviour (:issue: `3050` ).
2020-05-28 23:07:51 +08:00
- Prompts which show git repository information (via
2020-11-22 23:46:48 +08:00
`` __fish_git_prompt `` ) are faster in large repositories (:issue: `3294` ) and
slow filesystems (:issue: `3083` ).
2020-05-28 23:07:51 +08:00
- fish 2.3.0 reintroduced a problem where the greeting was printed even
2020-11-22 23:46:48 +08:00
when using `` read `` ; this has been corrected again (:issue: `3261` ).
- Vi mode changes the cursor depending on the current mode (:issue: `3215` ).
2020-05-28 23:07:51 +08:00
- Command lines with escaped space characters at the end tab-complete
2020-11-22 23:46:48 +08:00
correctly (:issue: `2447` ).
2020-05-28 23:07:51 +08:00
- Added completions for:
2020-11-22 23:46:48 +08:00
- `` 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` ).
2020-05-28 23:07:51 +08:00
- Distributors, packagers and developers will notice that the build
process produces more succinct output by default; use `` make V=1 `` to
2020-11-22 23:46:48 +08:00
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 .
2020-05-28 23:07:51 +08:00
--------------
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
2020-11-22 23:46:48 +08:00
(:issue: `2991` ).
2020-05-28 23:07:51 +08:00
- `` fish_mode_prompt `` has been updated to reflect the changes in the
2020-11-22 23:46:48 +08:00
way the Vi input mode is set up (:issue: `3067` ), making this more reliable.
2020-05-28 23:07:51 +08:00
- `` fish_config `` can now properly be launched from the OS X app bundle
2020-11-22 23:46:48 +08:00
(:issue: `3140` ).
2020-05-28 23:07:51 +08:00
.. _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
2020-11-22 23:46:48 +08:00
timestamps not being updated (:issue: `2859` ).
2020-05-28 23:07:51 +08:00
- The `` string `` builtin’ s `` match `` mode now handles the combination
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
- Work towards handling the terminal modes for external commands
2020-11-22 23:46:48 +08:00
launched from initialisation files (:issue: `2980` ).
2020-05-28 23:07:51 +08:00
- Ease the upgrade path from fish 2.2.0 and before by warning users to
2020-11-22 23:46:48 +08:00
restart fish if the `` string `` builtin is not available (:issue: `3057` ).
2020-05-28 23:07:51 +08:00
- `` 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 ``
2020-11-22 23:46:48 +08:00
(:issue: `3123` ).
- Improved completions for `` apt `` (:issue: `3097` ), `` aura `` (:issue: `3102` ),\ `` git ``
(:issue: `3114` ), `` npm `` (:issue: `3158` ), `` string `` and `` suspend `` (:issue: `3154` ).
2020-05-28 23:07:51 +08:00
--------------
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
------------------------------------
2020-11-22 23:46:48 +08:00
- `` abbr `` now allows non-letter keys (:issue: `2996` ).
- Define a few extra colours on first start (:issue: `2987` ).
2020-05-28 23:07:51 +08:00
- Multiple documentation updates.
2020-11-22 23:46:48 +08:00
- Added completions for rmmod (:issue: `3007` ).
- Improved completions for git (:issue: `2998` ).
2020-05-28 23:07:51 +08:00
.. _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
2020-11-22 23:46:48 +08:00
planned but requires further testing (:issue: `2619` ).
2020-05-28 23:07:51 +08:00
--------------
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
2020-11-22 23:46:48 +08:00
appropriate command (:issue: `2932` ).
2020-05-28 23:07:51 +08:00
- 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
------------------------------------
2020-11-22 23:46:48 +08:00
- Fix the build on Cygwin (:issue: `2952` ) and RedHat Enterprise Linux/CentOS 5
(:issue: `2955` ).
2020-05-28 23:07:51 +08:00
- Avoid confusing the terminal line driver with non-printing characters
2020-11-22 23:46:48 +08:00
in `` fish_title `` (:issue: `2453` ).
- Improved completions for busctl, git (:issue: `2585` , :issue: `2879` , :issue: `2984` ), and
2020-05-28 23:07:51 +08:00
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 `` ,
2020-11-22 23:46:48 +08:00
`` grep `` , `` tr `` , `` cut `` , and `` awk `` in many situations. (:issue: `2296` )
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
as the Meta modifier. (:issue: `1356` )
2020-05-28 23:07:51 +08:00
- Add new directories for vendor functions and configuration snippets
2020-11-22 23:46:48 +08:00
(:issue: `2500` )
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
`` for `` , `` set `` or `` count `` (:issue: `2719` )
2020-05-28 23:07:51 +08:00
- `` and `` and `` or `` will now bind to the closest `` if `` or `` while `` ,
2020-11-22 23:46:48 +08:00
allowing compound conditions without `` begin `` and `` end `` (:issue: `1428` )
- `` set -ql `` now searches up to function scope for variables (:issue: `2502` )
2020-05-28 23:07:51 +08:00
- `` status -f `` will now behave the same when run as the main script or
2020-11-22 23:46:48 +08:00
using `` source `` (:issue: `2643` )
2020-05-28 23:07:51 +08:00
- `` source `` no longer puts the file name in `` $argv `` if no arguments
2020-11-22 23:46:48 +08:00
are given (:issue: `139` )
2020-05-28 23:07:51 +08:00
- History files are stored under the `` XDG_DATA_HOME `` hierarchy (by
default, in `` ~/.local/share `` ), and existing history will be moved
2020-11-22 23:46:48 +08:00
on first use (:issue: `744` )
2020-05-28 23:07:51 +08:00
.. _other-notable-fixes-and-improvements-2:
Other notable fixes and improvements
------------------------------------
2020-11-22 23:46:48 +08:00
- Fish no longer silences errors in config.fish (:issue: `2702` )
2020-05-28 23:07:51 +08:00
- Directory autosuggestions will now descend as far as possible if
2020-11-22 23:46:48 +08:00
there is only one child directory (:issue: `2531` )
- Add support for bright colors (:issue: `1464` )
2020-05-28 23:25:48 +08:00
- Allow Ctrl-J (`\cj` ) to be bound separately from Ctrl-M
2020-11-22 23:46:48 +08:00
(`\cm` ) (:issue: `217` )
2020-05-28 23:07:51 +08:00
- psub now has a “-s”/“– suffix” option to name the temporary file with
that suffix
2020-11-22 23:46:48 +08:00
- Enable 24-bit colors on select terminals (:issue: `2495` )
- Support for SVN status in the prompt (:issue: `2582` )
2020-05-28 23:07:51 +08:00
- Mercurial and SVN support have been added to the Classic + Git (now
Classic + VCS) prompt (via the new \__fish_vcs_prompt function)
2020-11-22 23:46:48 +08:00
(:issue: `2592` )
- export now handles variables with a “=” in the value (:issue: `2403` )
2020-05-28 23:07:51 +08:00
- New completions for:
- alsactl
- Archlinux’ s asp, makepkg
2020-11-22 23:46:48 +08:00
- 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` )
2020-05-28 23:07:51 +08:00
- pulseaudio’ s pacmd and pactl
2020-11-22 23:46:48 +08:00
- rust’ s rustc and cargo (:issue: `2409` )
- sysctl (:issue: `2214` )
- systemd’ s machinectl (:issue: `2158` ), busctl (:issue: `2144` ), systemd-nspawn,
2020-05-28 23:07:51 +08:00
systemd-analyze, localectl, timedatectl
- and more
- Fish no longer has a function called sgrep, freeing it for user
2020-11-22 23:46:48 +08:00
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` )
2020-05-28 23:07:51 +08:00
- The vi-bindings now inherit from the emacs bindings
- Fish will also execute `` fish_user_key_bindings `` when in vi-mode
2020-11-22 23:46:48 +08:00
- `` funced `` will now also check $VISUAL (:issue: `2268` )
- A new `` suspend `` function (:issue: `2269` )
- Subcommand completion now works better with split /usr (:issue: `2141` )
2020-05-28 23:07:51 +08:00
- The command-not-found-handler can now be overridden by defining a
function called `` __fish_command_not_found_handler `` in config.fish
2020-11-22 23:46:48 +08:00
(:issue: `2332` )
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
component (:issue: `2473` )
2020-05-28 23:07:51 +08:00
- fish no longer requires `` /etc/fish/config.fish `` to correctly start,
and now ships a skeleton file that only contains some documentation
2020-11-22 23:46:48 +08:00
(:issue: `2799` )
2020-05-28 23:07:51 +08:00
--------------
fish 2.2.0 (released July 12, 2015)
===================================
.. _significant-changes-4:
Significant changes
2020-05-28 23:25:48 +08:00
-------------------
2020-05-28 23:07:51 +08:00
- Abbreviations: the new `` abbr `` command allows for
interactively-expanded abbreviations, allowing quick access to
2020-11-22 23:46:48 +08:00
frequently-used commands (:issue: `731` ).
2020-05-28 23:07:51 +08:00
- Vi mode: run `` fish_vi_mode `` to switch fish into the key bindings
2020-11-22 23:46:48 +08:00
and prompt familiar to users of the Vi editor (:issue: `65` ).
2020-05-28 23:07:51 +08:00
- New inline and interactive pager, which will be familiar to users of
2020-11-22 23:46:48 +08:00
zsh (:issue: `291` ).
2020-05-28 23:07:51 +08:00
- 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
2020-05-28 23:25:48 +08:00
-----------------------------
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
behaving as expected (:issue: `1567` ).
2020-05-28 23:07:51 +08:00
- The previously-undocumented `` CMD_DURATION `` variable is now set for
all commands and contains the execution time of the last command in
2020-11-22 23:46:48 +08:00
milliseconds (:issue: `1585` ). It is no longer exported to other commands
(:issue: `1896` ).
2020-05-28 23:07:51 +08:00
- `` if `` / `` else `` conditional statements now return values consistent
2020-11-22 23:46:48 +08:00
with the Single Unix Specification, like other shells (:issue: `1443` ).
2020-05-28 23:07:51 +08:00
- A new “top-level” local scope has been added, allowing local
variables declared on the commandline to be visible to subsequent
2020-11-22 23:46:48 +08:00
commands. (:issue: `1908` )
2020-05-28 23:07:51 +08:00
.. _other-notable-fixes-and-improvements-3:
Other notable fixes and improvements
2020-05-28 23:25:48 +08:00
------------------------------------
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- New documentation design (:issue: `1662` ), which requires a Doxygen version
2020-05-28 23:07:51 +08:00
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
2020-11-22 23:46:48 +08:00
and after job execution respectively (:issue: `1549` ).
2020-05-28 23:07:51 +08:00
- Unmatched wildcards no longer prevent a job from running. Wildcards
used interactively will still print an error, but the job will
2020-11-22 23:46:48 +08:00
proceed and the wildcard will expand to zero arguments (:issue: `1482` ).
2020-05-28 23:07:51 +08:00
- The `` . `` command is deprecated and the `` source `` command is
2020-11-22 23:46:48 +08:00
preferred (:issue: `310` ).
2020-05-28 23:07:51 +08:00
- `` bind `` supports “bind modes”, which allows bindings to be set for a
particular named mode, to support the implementation of Vi mode.
2020-11-22 23:46:48 +08:00
- A new `` export `` alias, which behaves like other shells (:issue: `1833` ).
2020-05-28 23:07:51 +08:00
- `` command `` has a new `` --search `` option to print the name of the
disk file that would be executed, like other shells’ `` command -v ``
2020-11-22 23:46:48 +08:00
(:issue: `1540` ).
2020-05-28 23:07:51 +08:00
- `` commandline `` has a new `` --paging-mode `` option to support the new
pager.
- `` complete `` has a new `` --wraps `` option, which allows a command to
2020-11-22 23:46:48 +08:00
(recursively) inherit the completions of a wrapped command (:issue: `393` ),
and `` complete -e `` now correctly erases completions (:issue: `380` ).
2020-05-28 23:07:51 +08:00
- Completions are now generated from manual pages by default on the
2020-11-22 23:46:48 +08:00
first run of fish (:issue: `997` ).
2020-05-28 23:07:51 +08:00
- `` fish_indent `` can now produce colorized (`` --ansi `` ) and HTML
2020-11-22 23:46:48 +08:00
(`` --html `` ) output (:issue: `1827` ).
2020-05-28 23:07:51 +08:00
- `` functions --erase `` now prevents autoloaded functions from being
reloaded in the current session.
- `` history `` has a new `` --merge `` option, to incorporate history from
2020-11-22 23:46:48 +08:00
other sessions into the current session (:issue: `825` ).
- `` jobs `` returns 1 if there are no active jobs (:issue: `1484` ).
2020-05-28 23:07:51 +08:00
- `` read `` has several new options:
2020-11-22 23:46:48 +08:00
- `` --array `` to break input into an array (:issue: `1540` )
2020-05-28 23:07:51 +08:00
- `` --null `` to break lines on NUL characters rather than newlines
2020-11-22 23:46:48 +08:00
(:issue: `1694` )
- `` --nchars `` to read a specific number of characters (:issue: `1616` )
2020-05-28 23:07:51 +08:00
- `` --right-prompt `` to display a right-hand-side prompt during
2020-11-22 23:46:48 +08:00
interactive read (:issue: `1698` ).
- `` type `` has a new `` -q `` option to suppress output (:issue: `1540` and, like
2020-05-28 23:07:51 +08:00
other shells, `` type -a `` now prints all matches for a command
2020-11-22 23:46:48 +08:00
(:issue: `261` ).
2020-05-28 23:07:51 +08:00
- Pressing F1 now shows the manual page for the current command
2020-11-22 23:46:48 +08:00
(:issue: `1063` ).
2020-05-28 23:07:51 +08:00
- `` fish_title `` functions have access to the arguments of the
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
- `` Alt ` ` \ +\ `` .`` searches backwards in the token history, mapping to
the same behavior as inserting the last argument of the previous
2020-11-22 23:46:48 +08:00
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` ).
2020-05-28 23:07:51 +08:00
--------------
fish 2.1.2 (released Feb 24, 2015)
==================================
fish 2.1.2 contains a workaround for a filesystem bug in Mac OS X
2020-11-22 23:46:48 +08:00
Yosemite. :issue: `1859`
2020-05-28 23:07:51 +08:00
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
2020-05-28 23:25:48 +08:00
--------------
2020-05-28 23:07:51 +08:00
- 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
2020-11-22 23:46:48 +08:00
CVE-2014-2914). :issue: `1438`
2020-05-28 23:07:51 +08:00
- `` psub `` and `` funced `` are no longer vulnerable to attacks which
allow local privilege escalation and data tampering (closing
2020-11-22 23:46:48 +08:00
CVE-2014-2906 and CVE-2014-3856). :issue: `1437`
2020-05-28 23:07:51 +08:00
- `` fishd `` uses a secure path for its socket, preventing a local
2020-11-22 23:46:48 +08:00
privilege escalation attack (closing CVE-2014-2905). :issue: `1436`
2020-05-28 23:07:51 +08:00
- `` __fish_print_packages `` is no longer vulnerable to attacks which
would allow local privilege escalation and data tampering (closing
2020-11-22 23:46:48 +08:00
CVE-2014-3219). :issue: `1440`
2020-05-28 23:07:51 +08:00
Other fixes
2020-05-28 23:25:48 +08:00
-----------
2020-05-28 23:07:51 +08:00
- `` fishd `` now ignores SIGPIPE, fixing crashes using tools like GNU
Parallel and which occurred more often as a result of the other
2020-11-22 23:46:48 +08:00
`` fishd `` changes. :issue: `1084` & :issue: `1690`
2020-05-28 23:07:51 +08:00
--------------
fish 2.1.0
==========
.. _significant-changes-5:
Significant Changes
-------------------
2020-11-22 23:46:48 +08:00
- **Tab completions will fuzzy-match files.** :issue: `568`
2020-05-28 23:07:51 +08:00
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 `` ).
2020-11-22 23:46:48 +08:00
- **Redirections now work better across pipelines.** :issue: `110` , :issue: `877`
2020-05-28 23:07:51 +08:00
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 `` .
2020-11-22 23:46:48 +08:00
- **A single ``%`` now expands to the last job backgrounded.** :issue: `1008`
2020-05-28 23:07:51 +08:00
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.
2020-11-22 23:46:48 +08:00
:issue: `995`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- VTE based terminals should now know the working directory. :issue: `906`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- The autotools build now works on Mavericks. :issue: `968`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- The end-of-line binding (ctrl+E) now accepts autosuggestions. :issue: `932`
2020-05-28 23:07:51 +08:00
- Directories in `` /etc/paths `` (used on OS X) are now prepended
2020-11-22 23:46:48 +08:00
instead of appended, similar to other shells. :issue: `927`
2020-05-28 23:07:51 +08:00
- Option-right-arrow (used for partial autosuggestion completion) now
2020-11-22 23:46:48 +08:00
works on iTerm2. :issue: `920`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- Tab completions now work properly within nested subcommands. :issue: `913`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- `` printf `` supports `\e` , the escape character. :issue: `910`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- `` fish_config history `` no longer shows duplicate items. :issue: `900`
2020-05-28 23:07:51 +08:00
- `` $fish_user_paths `` is now prepended to $PATH instead of appended.
2020-11-22 23:46:48 +08:00
:issue: `888`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- Jobs complete when all processes complete. :issue: `876`
2020-05-28 23:07:51 +08:00
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).
2020-11-22 23:46:48 +08:00
- Better error reporting for square brackets. :issue: `875`
2020-05-28 23:07:51 +08:00
- fish no longer tries to add `` /bin `` to `` $PATH `` unless PATH is
2020-11-22 23:46:48 +08:00
totally empty. :issue: `852`
2020-05-28 23:07:51 +08:00
- History token substitution (alt-up) now works correctly inside
2020-11-22 23:46:48 +08:00
subshells. :issue: `833`
2020-05-28 23:07:51 +08:00
- Flow control is now disabled, freeing up ctrl-S and ctrl-Q for other
2020-11-22 23:46:48 +08:00
uses. :issue: `814`
2020-05-28 23:07:51 +08:00
- sh-style variable setting like `` foo=bar `` now produces better error
2020-11-22 23:46:48 +08:00
messages. :issue: `809`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- Commands with wildcards no longer produce autosuggestions. :issue: `785`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- funced no longer freaks out when supplied with no arguments. :issue: `780`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- fish.app now works correctly in a directory containing spaces. :issue: `774`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- Tab completion cycling no longer occasionally fails to repaint. :issue: `765`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- Comments now work in eval’ d strings. :issue: `684`
2020-05-28 23:07:51 +08:00
- History search (up-arrow) now shows the item matching the
2020-11-22 23:46:48 +08:00
autosuggestion, if that autosuggestion was truncated. :issue: `650`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- Ctrl-T now transposes characters, as in other shells. :issue: `128`
2020-05-28 23:07:51 +08:00
--------------
fish 2.0.0
==========
.. _significant-changes-6:
Significant Changes
-------------------
2020-11-22 23:46:48 +08:00
- **Command substitutions now modify ``$status`` :issue:`547`.** Previously the
2020-05-28 23:07:51 +08:00
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.
2020-08-08 21:45:35 +08:00
- Improvements to PATH handling. There is a new variable, fish_user_paths,
2020-05-28 23:07:51 +08:00
which can be set universally, and whose contents are appended to
2020-11-22 23:46:48 +08:00
$PATH :issue: `527`
2020-05-28 23:07:51 +08:00
- /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
2020-11-22 23:46:48 +08:00
:issue: `300`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- **New syntax for index ranges** (sometimes known as “slices”) :issue: `212`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- **fish now supports an ``else if`` statement** :issue: `134`
2020-05-28 23:07:51 +08:00
2020-11-22 23:46:48 +08:00
- **Process and pid completion now works on OS X** :issue: `129`
2020-05-28 23:07:51 +08:00
- **fish is now relocatable** , and no longer depends on compiled-in
2020-11-22 23:46:48 +08:00
paths :issue: `125`
2020-05-28 23:07:51 +08:00
- **fish now supports a right prompt (RPROMPT)** through the
2020-11-22 23:46:48 +08:00
fish_right_prompt function :issue: `80`
2020-05-28 23:07:51 +08:00
- **fish now uses posix_spawn instead of fork when possible** , which is
2020-11-22 23:46:48 +08:00
much faster on BSD and OS X :issue: `11`
2020-05-28 23:07:51 +08:00
.. _other-notable-fixes-1:
Other Notable Fixes
-------------------
- Updated VCS completions (darcs, cvs, svn, etc.)
2020-11-22 23:46:48 +08:00
- 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`
2020-05-28 23:07:51 +08:00
- Completions for many new commands
2020-11-22 23:46:48 +08:00
- fish now respects rxvt’ s unique keybindings :issue: `657`
2020-05-28 23:07:51 +08:00
- xsel is no longer built as part of fish. It will still be invoked if
2020-11-22 23:46:48 +08:00
installed separately :issue: `633`
- \__fish_filter_mime no longer spews :issue: `628`
2020-05-28 23:07:51 +08:00
- The – no-execute option to fish no longer falls over when reaching the
2020-11-22 23:46:48 +08:00
end of a block :issue: `624`
- fish_config knows how to find fish even if it’ s not in the $PATH :issue: `621`
2020-05-28 23:07:51 +08:00
- A leading space now prevents writing to history, as is done in bash
2020-11-22 23:46:48 +08:00
and zsh :issue: `615`
2020-05-28 23:07:51 +08:00
- Hitting enter after a backslash only goes to a new line if it is
2020-11-22 23:46:48 +08:00
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`
2020-05-28 23:07:51 +08:00
- man page completions are now located in a new generated_completions
2020-11-22 23:46:48 +08:00
directory, instead of your completions directory :issue: `576`
- tab now clears autosuggestions :issue: `561`
2020-05-28 23:07:51 +08:00
- tab completion from within a pair of quotes now attempts to
2020-11-22 23:46:48 +08:00
“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`
2020-05-28 23:07:51 +08:00
- Alt-F or Alt-right-arrow (Option-F or option-right-arrow) now accepts
2020-11-22 23:46:48 +08:00
one word of an autosuggestion :issue: `435`
- Setting fish as your login shell no longer kills OpenSUSE :issue: `367`
2020-05-28 23:07:51 +08:00
- Backslashes now join lines, instead of creating multiple commands
2020-11-22 23:46:48 +08:00
:issue: `347`
- echo now implements the -e flag to interpret escapes :issue: `337`
2020-05-28 23:07:51 +08:00
- When the last token in the user’ s input contains capital letters, use
2020-11-22 23:46:48 +08:00
its case in preference to that of the autosuggestion :issue: `335`
- Descriptions now have their own muted color :issue: `279`
2020-05-28 23:07:51 +08:00
- Wildcards beginning with a . (for example, `` ls .* `` ) no longer match
2020-11-22 23:46:48 +08:00
. and .. :issue: `270`
- Recursive wildcards now handle symlink loops :issue: `268`
2020-05-28 23:07:51 +08:00
- You can now delete history items from the fish_config web interface
2020-11-22 23:46:48 +08:00
:issue: `250`
- The OS X build now weak links `` wcsdup `` and `` wcscasecmp `` :issue: `240`
2020-05-28 23:07:51 +08:00
- fish now saves and restores the process group, which prevents certain
2020-11-22 23:46:48 +08:00
processes from being erroneously reported as stopped :issue: `197`
- funced now takes an editor option :issue: `187`
2020-05-28 23:07:51 +08:00
- Alternating row colors are available in fish pager through
2020-11-22 23:46:48 +08:00
`` fish_pager_color_secondary `` :issue: `186`
2020-05-28 23:07:51 +08:00
- Universal variable values are now stored based on your MAC address,
2020-11-22 23:46:48 +08:00
not your hostname :issue: `183`
2020-05-28 23:07:51 +08:00
- The caret ^ now only does a stderr redirection if it is the first
2020-11-22 23:46:48 +08:00
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`
2020-05-28 23:07:51 +08:00
- fish no longer causes `` sudo `` to ask for a password every time
2020-11-22 23:46:48 +08:00
- fish behaves better under Midnight Commander :issue: `121`
- `` set -e `` no longer crashes :issue: `100`
2020-05-28 23:07:51 +08:00
- fish now will automatically import history from bash, if there is no
2020-11-22 23:46:48 +08:00
fish history :issue: `66`
2020-05-28 23:07:51 +08:00
- Backslashed-newlines inside quoted strings now behave more
2020-11-22 23:46:48 +08:00
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`
2020-05-28 23:07:51 +08:00
- Custom key bindings can now be set via the `` fish_user_key_bindings ``
2020-11-22 23:46:48 +08:00
function :issue: `21`
2020-05-28 23:07:51 +08:00
- All Python scripts now run correctly under both Python 2 and Python 3
2020-11-22 23:46:48 +08:00
:issue: `14`
- The “accept autosuggestion” key can now be configured :issue: `19`
- Autosuggestions will no longer suggest invalid commands :issue: `6`
2020-05-28 23:07:51 +08:00
--------------
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.
2020-11-22 23:46:48 +08:00
- A SIGTERM now ends the whole execution stack again (resolving :issue: `13` ).
2020-05-28 23:07:51 +08:00
- 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.