diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 4e8e0ffdc..50fa485fa 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -25,7 +25,7 @@ Notable backwards-incompatible changes To make this for for a wide range of terminals, fish asks terminals to speak several keyboard protocols, including CSI u, XTerm's ``modifyOtherKeys`` and some progressive enhancements from the `kitty keyboard protocol `_. Depending on terminal support, this allows to bind a lot more key combinations, - including arbitrary combinations of modifiers ``ctrl``, ``alt`` and ``shift``. + including arbitrary combinations of modifiers :kbd:`ctrl`, :kbd:`alt` and :kbd:`shift`. Previously one could only use the Control key for the 32 ASCII control characters. This comes with a new syntax for specifying keys to builtin ``bind``. @@ -63,9 +63,9 @@ Notable backwards-incompatible changes Notable improvements and fixes ------------------------------ - New function ``fish_should_add_to_history`` can be overridden to decide whether a command should be added to the history (:issue:`10302`). -- :kbd:`Control-C` during command input no longer prints ``^C`` and a new prompt but merely clears the command line. This restores the behavior from version 2.2. To revert to the old behavior use ``bind ctrl-c __fish_cancel_commandline`` (:issue:`10213`). -- The :kbd:`Control-R` history search now uses glob syntax (:issue:`10131`). -- The :kbd:`Control-R` history search now operates only on the line at cursor, making it easier to quickly compose a multi-line command by recalling previous commands. +- :kbd:`ctrl-c` during command input no longer prints ``^C`` and a new prompt but merely clears the command line. This restores the behavior from version 2.2. To revert to the old behavior use ``bind ctrl-c __fish_cancel_commandline`` (:issue:`10213`). +- The :kbd:`ctrl-r` history search now uses glob syntax (:issue:`10131`). +- The :kbd:`ctrl-r` history search now operates only on the line at cursor, making it easier to quickly compose a multi-line command by recalling previous commands. Deprecations and removed features --------------------------------- @@ -73,7 +73,7 @@ Deprecations and removed features - ``commandline --tokenize`` (short option ``-o``) has been deprecated in favor of ``commandline --tokens-expanded`` (short option ``-x``) which expands variables and other shell expressions, removing the need to use "eval" in custom completions (:issue:`10212`). - A new feature flag, ``remove-percent-self`` (see ``status features``) disables PID expansion of ``%self`` which has been supplanted by ``$fish_pid`` (:issue:`10262`). - Specifying key names as terminfo name (``bind -k``) is deprecated and may be removed in a future version. -- Flow control -- which if enabled by ``stty ixon ixoff`` allows to pause terminal input with ``ctrl-s`` and resume it with ``ctrl-q`` -- now works only while fish is executing an external command. +- Flow control -- which if enabled by ``stty ixon ixoff`` allows to pause terminal input with :kbd:`ctrl-s` and resume it with :kbd:`ctrl-q` -- now works only while fish is executing an external command. - When a terminal pastes text into fish using bracketed paste, fish used to switch to a special ``paste`` bind mode. This bind mode has been removed. The behavior on paste is currently not meant to be configurable. - When fish is stopped or terminated by a signal that cannot be caught (SIGSTOP or SIGKILL), it may leave the terminal in a state where keypresses with modifiers are sent as CSI u sequences instead of traditional control characters or escape sequecnes (that are recognized by bash/readline). If this happens, you can use the ``reset`` command from ``ncurses`` to restore the terminal state. @@ -121,9 +121,9 @@ New or improved bindings - Bindings can now mix special input functions and shell commands, so ``bind ctrl-g expand-abbr "commandline -i \n"`` works as expected (:issue:`8186`). - Special input functions run from bindings via ``commandline -f`` are now applied immediately instead of after the currently executing binding. For example, ``commandline -f yank -f yank-pop`` inserts the last-but-one entry from the kill ring. -- When the cursor is on a command that resolves to an executable script, :kbd:`Alt-O` will now open that script in your editor (:issue:`10266`). +- When the cursor is on a command that resolves to an executable script, :kbd:`alt-o` will now open that script in your editor (:issue:`10266`). - During up-arrow history search, :kbd:`shift-delete` will delete the current search item and move to the next older item. Previously this was only supported in the history pager. -- Some improvements to the :kbd:`Alt-E` binding which edits the commandline in an external editor: +- Some improvements to the :kbd:`alt-e` binding which edits the commandline in an external editor: - The editor's cursor position is copied back to fish. This is currently supported for Vim and Kakoune. - Cursor position synchronization is only supported for a set of known editors. This has been extended by also resolving aliases. For example use ``complete --wraps my-vim vim`` to synchronize cursors when `EDITOR=my-vim`. - Multiline commands are indented before being sent to the editor, which matches the rendering in fish. @@ -134,12 +134,12 @@ New or improved bindings - The ``E`` binding in vi mode now correctly handles the last character of the word, by jumping to the next word (:issue:`9700`). - If the terminal supports shifted key codes from the [kitty keyboard protocol](https://sw.kovidgoyal.net/kitty/keyboard-protocol/), ``shift-enter`` now inserts a newline instead of executing the command line. - Vi mode has seen some improvements but continues to suffer from the lack of people working on it. - - Insert-mode :kbd:`Control-N` accepts autosuggestions (:issue:`10339`). + - Insert-mode :kbd:`ctrl-n` accepts autosuggestions (:issue:`10339`). - Outside insert mode, the cursor will no longer be placed beyond the last character on the commandline. - When the cursor is at the end of the commandline, a single :kbd:`l` will accept an autosuggestion (:issue:`10286`) - The cursor position after pasting (:kbd:`p`) has been corrected. - When the cursor is at the start of a line, escaping from insert mode no longer moves the cursor to the previous line. - - Added bindings for clipboard interaction, like :kbd:`"+p` and :kbd:`"+yy`. + - Added bindings for clipboard interaction, like :kbd:`",+,p` and :kbd:`",+,y,y`. Improved prompts ^^^^^^^^^^^^^^^^ @@ -221,7 +221,7 @@ Notable improvements and fixes - Improvements to the history pager, including: - The history pager will now also attempt subsequence matches (:issue:`9476`), so you can find a command line like ``git log 3.6.1..Integration_3.7.0`` by searching for ``gitInt``. - - Opening the history pager will now fill the search field with a search string if you're already in a search (:issue:`10005`). This makes it nicer to search something with :kbd:`↑` and then later decide to switch to the full pager. + - Opening the history pager will now fill the search field with a search string if you're already in a search (:issue:`10005`). This makes it nicer to search something with :kbd:`up` and then later decide to switch to the full pager. - Closing the history pager with enter will now copy the search text to the commandline if there was no match, so you can continue editing the command you tried to find right away (:issue:`9934`). - Performance improvements for command completions and globbing, where supported by the operating system, especially on slow filesystems such as NFS (:issue:`9891`, :issue:`9931`, :issue:`10032`, :issue:`10052`). @@ -257,15 +257,15 @@ Interactive improvements - The interactive ``history delete`` interface now allows specifying index ranges like "1..5" (:issue:`9736`), and ``history delete --exact`` now properly saves the history (:issue:`10066`). - Command completion will now call the stock ``manpath`` on macOS, instead of a potential Homebrew version. This prevents awkward error messages (:issue:`9817`). - the ``redo`` special input function restores the pre-undo cursor position. -- A new bind function ``history-pager-delete``, bound to :kbd:`Shift` + :kbd:`Delete` by default, will delete the currently-selected history pager item from history (:issue:`9454`). +- A new bind function ``history-pager-delete``, bound to :kbd:`shift-delete` by default, will delete the currently-selected history pager item from history (:issue:`9454`). - ``fish_key_reader`` will now use printable characters as-is, so pressing "ö" no longer leads to it telling you to bind ``\u00F6`` (:issue:`9986`). - ``open`` can be used to launch terminal programs again, as an ``xdg-open`` bug has been fixed and a workaround has been removed (:issue:`10045`). -- The ``repaint-mode`` binding will now only move the cursor if there is repainting to be done. This fixes :kbd:`Alt` combination bindings in vi mode (:issue:`7910`). -- A new ``clear-screen`` bind function is used for :kbd:`Ctrl` + :kbd:`l` by default. This clears the screen and repaints the existing prompt at first, +- The ``repaint-mode`` binding will now only move the cursor if there is repainting to be done. This fixes :kbd:`alt` combination bindings in vi mode (:issue:`7910`). +- A new ``clear-screen`` bind function is used for :kbd:`ctrl-l` by default. This clears the screen and repaints the existing prompt at first, so it eliminates visible flicker unless the terminal is very slow (:issue:`10044`). - The ``alias`` convenience function has better support for commands with unusual characters, like ``+`` (:issue:`8720`). - A longstanding issue where items in the pager would sometimes display without proper formatting has been fixed (:issue:`9617`). -- The :kbd:`Alt` + :kbd:`l` binding, which lists the directory of the token under the cursor, correctly expands tilde (``~``) to the home directory (:issue:`9954`). +- The :kbd:`alt-l` binding, which lists the directory of the token under the cursor, correctly expands tilde (``~``) to the home directory (:issue:`9954`). - Various fish utilities that use an external pager will now try a selection of common pagers if the :envvar:`PAGER` environment variable is not set, or write the output to the screen without a pager if there is not one available (:issue:`10074`). - Command-specific tab completions may now offer results whose first character is a period. For example, it is now possible to tab-complete ``git add`` for files with leading periods. The default file completions hide these files, unless the token itself has a leading period (:issue:`3707`). @@ -392,10 +392,10 @@ Interactive improvements - Variables that were set while the locale was C (the default ASCII-only locale) will now properly be encoded if the locale is switched (:issue:`2613`, :issue:`9473`). - Escape during history search restores the original command line again (fixing a regression in 3.6.0). - Using ``--help`` on builtins now respects the ``$MANPAGER`` variable, in preference to ``$PAGER`` (:issue:`9488`). -- :kbd:`Control-G` closes the history pager, like other shells (:issue:`9484`). +- :kbd:`ctrl-g` closes the history pager, like other shells (:issue:`9484`). - The documentation for the ``:``, ``[`` and ``.`` builtin commands can now be looked up with ``man`` (:issue:`9552`). - fish no longer crashes when searching history for non-ASCII codepoints case-insensitively (:issue:`9628`). -- The :kbd:`Alt-S` binding will now also use ``please`` if available (:issue:`9635`). +- The :kbd:`alt-s` binding will now also use ``please`` if available (:issue:`9635`). - Themes that don't specify every color option can be installed correctly in the Web-based configuration (:issue:`9590`). - Compatibility with Midnight Commander's prompt integration has been improved (:issue:`9540`). - A spurious error, noted when using fish in Google Drive directories under WSL 2, has been silenced (:issue:`9550`). @@ -441,7 +441,7 @@ fish 3.6.0 (released January 7, 2023) Notable improvements and fixes ------------------------------ -- By default, :kbd:`Control-R` now opens the command history in the pager (:issue:`602`). This is fully searchable and syntax-highlighted, as an alternative to the incremental search seen in other shells. The new special input function ``history-pager`` has been added for custom bindings. +- By default, :kbd:`ctrl-r` now opens the command history in the pager (:issue:`602`). This is fully searchable and syntax-highlighted, as an alternative to the incremental search seen in other shells. The new special input function ``history-pager`` has been added for custom bindings. - Abbrevations are more flexible (:issue:`9313`, :issue:`5003`, :issue:`2287`): - They may optionally replace tokens anywhere on the command line, instead of only commands @@ -537,15 +537,15 @@ Interactive improvements - If the terminal definition for :envvar:`TERM` can't be found, fish now tries using the "xterm-256color" and "xterm" definitions before "ansi" and "dumb". As the majority of terminal emulators in common use are now more or less xterm-compatible (often even explicitly claiming the xterm-256color entry), this should often result in a fully or almost fully usable terminal (:issue:`9026`). - A new variable, :envvar:`fish_cursor_selection_mode`, can be used to configure whether the command line selection includes the character under the cursor (``inclusive``) or not (``exclusive``). The new default is ``exclusive``; use ``set fish_cursor_selection_mode inclusive`` to get the previous behavior back (:issue:`7762`). - fish's completion pager now fills half the terminal on first tab press instead of only 4 rows, which should make results visible more often and save key presses, without constantly snapping fish to the top of the terminal (:issue:`9105`, :issue:`2698`). -- The ``complete-and-search`` binding, used with :kbd:`Shift-Tab` by default, selects the first item in the results immediately (:issue:`9080`). +- The ``complete-and-search`` binding, used with :kbd:`shift-tab` by default, selects the first item in the results immediately (:issue:`9080`). - ``bind`` output is now syntax-highlighted when used interacively. -- :kbd:`Alt-H` (the default ``__fish_man_page`` binding) does a better job of showing the manual page of the command under cursor (:issue:`9020`). +- :kbd:`alt-h` (the default ``__fish_man_page`` binding) does a better job of showing the manual page of the command under cursor (:issue:`9020`). - If :envvar:`fish_color_valid_path` contains an actual color instead of just modifiers, those will be used for valid paths even if the underlying color isn't "normal" (:issue:`9159`). -- The key combination for the QUIT terminal sequence, often :kbd:`Control-Backslash` (``\x1c``), can now be sused as a binding (:issue:`9234`). +- The key combination for the QUIT terminal sequence, often :kbd:`ctrl-\\` (``\x1c``), can now be used as a binding (:issue:`9234`). - fish's vi mode uses normal xterm-style sequences to signal cursor change, instead of using the iTerm's proprietary escape sequences. This allows for a blinking cursor and makes it work in complicated scenarios with nested terminals. (:issue:`3741`, :issue:`9172`) -- When running fish on a remote system (such as inside SSH or a container), :kbd:`Control-X` now copies to the local client system's clipboard if the terminal supports OSC 52. +- When running fish on a remote system (such as inside SSH or a container), :kbd:`ctrl-x` now copies to the local client system's clipboard if the terminal supports OSC 52. - ``commandline`` gained two new options, ``--selection-start`` and ``--selection-end``, to set the start/end of the current selection (:issue:`9197`, :issue:`9215`). -- fish's builtins now handle keyboard interrupts (:kbd:`Control-C`) correctly (:issue:`9266`). +- fish's builtins now handle keyboard interrupts (:kbd:`ctrl-c`) correctly (:issue:`9266`). Completions ^^^^^^^^^^^ @@ -655,9 +655,9 @@ This release of fish introduces the following small enhancements: This release also fixes a number of problems identified in fish 3.5.0. - Completing ``git blame`` or ``git -C`` works correctly (:issue:`9053`). -- On terminals that emit a ``CSI u`` sequence for :kbd:`Shift-Space`, fish inserts a space instead of printing an error. (:issue:`9054`). +- On terminals that emit a ``CSI u`` sequence for :kbd:`shift-space`, fish inserts a space instead of printing an error. (:issue:`9054`). - ``status fish-path`` on Linux-based platforms could print the path with a " (deleted)" suffix (such as ``/usr/bin/fish (deleted)``), which is now removed (:issue:`9019`). -- Cancelling an initial command (from fish's ``--init-command`` option) with :kbd:`Control-C` no longer prevents configuration scripts from running (:issue:`9024`). +- Cancelling an initial command (from fish's ``--init-command`` option) with :kbd:`ctrl-c` no longer prevents configuration scripts from running (:issue:`9024`). - The job summary contained extra blank lines if the prompt used multiple lines, which is now fixed (:issue:`9044`). - Using special input functions in bindings, in combination with ``and``/``or`` conditionals, no longer crashes (:issue:`9051`). @@ -755,7 +755,7 @@ Interactive improvements - The ``vared`` command can now successfully edit variables named "tmp" or "prompt" (:issue:`8836`, :issue:`8837`). - ``time`` now emits an error if used after the first command in a pipeline (:issue:`8841`). - ``fish_add_path`` now prints a message for skipped non-existent paths when using the ``-v`` flag (:issue:`8884`). -- Since fish 3.2.0, pressing :kbd:`Control-D` while a command is running would end up inserting a space into the next commandline, which has been fixed (:issue:`8871`). +- Since fish 3.2.0, pressing :kbd:`ctrl-d` while a command is running would end up inserting a space into the next commandline, which has been fixed (:issue:`8871`). - A bug that caused multi-line prompts to be moved down a line when pasting or switching modes has been fixed (:issue:`3481`). - The Web-based configuration system no longer strips too many quotes in the abbreviation display (:issue:`8917`, :issue:`8918`). - Fish started with ``--no-config`` will now use the default keybindings (:issue:`8493`) @@ -766,10 +766,10 @@ Interactive improvements New or improved bindings ^^^^^^^^^^^^^^^^^^^^^^^^ -- The :kbd:`Alt-S` binding will now insert ``doas`` instead of ``sudo`` if necessary (:issue:`8942`). +- The :kbd:`alt-s` binding will now insert ``doas`` instead of ``sudo`` if necessary (:issue:`8942`). - The ``kill-whole-line`` special input function now kills the newline preceeding the last line. This makes ``dd`` in vi-mode clear the last line properly. - The new ``kill-inner-line`` special input function kills the line without any newlines, allowing ``cc`` in vi-mode to clear the line while preserving newlines (:issue:`8983`). -- On terminals that emit special sequences for these combinations, :kbd:`Shift-Space` is bound like :kbd:`Space`, and :kbd:`Ctrl-Return` is bound like :kbd:`Return` (:issue:`8874`). +- On terminals that emit special sequences for these combinations, :kbd:`shift-space` is bound like :kbd:`space`, and :kbd:`ctrl-enter` is bound like :kbd:`return` (:issue:`8874`). Improved prompts ^^^^^^^^^^^^^^^^ @@ -815,7 +815,7 @@ This release of fish fixes the following problems identified in fish 3.4.0: - An error printed after upgrading, where old instances could pick up a newer version of the ``fish_title`` function, has been fixed (:issue:`8778`) - fish builds correctly on NetBSD (:issue:`8788`) and OpenIndiana (:issue:`8780`). -- ``nextd-or-forward-word``, bound to :kbd:`Alt-Right Arrow` by default, was inadvertently changed to move like ``forward-bigword``. This has been corrected (:issue:`8790`). +- ``nextd-or-forward-word``, bound to :kbd:`alt-right` by default, was inadvertently changed to move like ``forward-bigword``. This has been corrected (:issue:`8790`). - ``funcsave -q`` and ``funcsave --quiet`` now work correctly (:issue:`8830`). - Issues with the ``csharp`` and ``nmcli`` completions were corrected. @@ -921,10 +921,10 @@ Scripting improvements Interactive improvements ------------------------ -- Vi mode cursors are now set properly after :kbd:`Control-C` (:issue:`8125`). +- Vi mode cursors are now set properly after :kbd:`ctrl-c` (:issue:`8125`). - ``funced`` will try to edit the whole file containing a function definition, if there is one (:issue:`391`). - Running a command line consisting of just spaces now deletes an ephemeral (starting with space) history item again (:issue:`8232`). -- Command substitutions no longer respect job control, instead running inside fish's own process group (:issue:`8172`). This more closely matches other shells, and improves :kbd:`Control-C` reliability inside a command substitution. +- Command substitutions no longer respect job control, instead running inside fish's own process group (:issue:`8172`). This more closely matches other shells, and improves :kbd:`ctrl-c` reliability inside a command substitution. - ``history`` and ``__fish_print_help`` now properly support ``less`` before version 530, including the version that ships with macOS. (:issue:`8157`). - ``help`` now knows which section is in which document again (:issue:`8245`). - fish's highlighter will now color options (starting with ``-`` or ``--``) with the color given in the new $fish_color_option, up to the first ``--``. It falls back on $fish_color_param, so nothing changes for existing setups (:issue:`8292`). @@ -937,7 +937,7 @@ Interactive improvements - Propagation of universal variables from a fish process that is closing is faster (:issue:`8209`). - The command line is drawn in the correct place if the prompt ends with a newline (:issue:`8298`). - ``history`` learned a new subcommand ``clear-session`` to erase all history from the current session (:issue:`5791`). -- Pressing :kbd:`Control-C` in ``fish_key_reader`` will no longer print the incorrect "Press [ctrl-C] again to exit" message (:issue:`8510`). +- Pressing :kbd:`ctrl-c` in ``fish_key_reader`` will no longer print the incorrect "Press [ctrl-C] again to exit" message (:issue:`8510`). - The default command-not-found handler for Fedora/PackageKit now passes the whole command line, allowing for functionality such as running the suggested command directly (:issue:`8579`). - When looking for locale information, the Debian configuration is now used when available (:issue:`8557`). - Pasting text containing quotes from the clipboard trims spaces more appropriately (:issue:`8550`). @@ -950,8 +950,8 @@ Interactive improvements New or improved bindings ^^^^^^^^^^^^^^^^^^^^^^^^ -- :kbd:`Escape` can now bound without breaking arrow key bindings (:issue:`8428`). -- The :kbd:`Alt-H` binding (to open a command’s manual page) now also ignores ``command`` (:issue:`8447`). +- :kbd:`escape` can now bound without breaking arrow key bindings (:issue:`8428`). +- The :kbd:`alt-h` binding (to open a command’s manual page) now also ignores ``command`` (:issue:`8447`). Improved prompts ^^^^^^^^^^^^^^^^ @@ -1017,7 +1017,7 @@ Improved terminal support - Vi mode cursors are enabled in Apple Terminal.app (:issue:`8167`). - Vi cursor shaping and $PWD reporting is now also enabled on foot (:issue:`8422`). - ``ls`` will use colors also on newer versions of Apple Terminal.app (:issue:`8309`). -- The :kbd:`Delete` and :kbd:`Shift-Tab` keys work more reliably under ``st`` (:issue:`8352`, :issue:`8354`). +- The :kbd:`delete` and :kbd:`shift-tab` keys work more reliably under ``st`` (:issue:`8352`, :issue:`8354`). Other improvements ------------------ @@ -1044,7 +1044,7 @@ This release of fish fixes the following problems identified in fish 3.3.0: - The prompt and command line are redrawn correctly in response to universal variable changes (:issue:`8088`). - A superfluous error that was produced when setting the ``PATH`` or ``CDPATH`` environment variables to include colon-delimited components that do not exist was removed (:issue:`8095`). -- The Vi mode indicator in the prompt is repainted correctly after :kbd:`Ctrl-C` cancels the current command (:issue:`8103`). +- The Vi mode indicator in the prompt is repainted correctly after :kbd:`ctrl-c` cancels the current command (:issue:`8103`). - fish builds correctly on platforms that do not have a ``spawn.h`` header, such as old versions of OS X (:issue:`8097`). A number of improvements to the documentation, and fixes for completions, are included as well. @@ -1114,15 +1114,15 @@ Interactive improvements New or improved bindings ^^^^^^^^^^^^^^^^^^^^^^^^ - Pasting in Vi mode puts text in the right place in normal mode (:issue:`7847`). -- Vi mode's :kbd:`u` is bound to ``undo`` instead of ``history-search-backward``, following GNU readline's behavior. Similarly, :kbd:`Control-R` is bound to ``redo`` instead of ``history-search-backward``, following Vim (:issue:`7908`). +- Vi mode's :kbd:`u` is bound to ``undo`` instead of ``history-search-backward``, following GNU readline's behavior. Similarly, :kbd:`ctrl-r` is bound to ``redo`` instead of ``history-search-backward``, following Vim (:issue:`7908`). - :kbd:`s` in Vi visual mode now does the same thing as :kbd:`c` (:issue:`8039`). -- The binding for :kbd:`"*y` now uses ``fish_clipboard_copy``, allowing it to support more than just ``xsel``. -- The :kbd:`Control-Space` binding can be correctly customised (:issue:`7922`). +- The binding for :kbd:`",*,y` now uses ``fish_clipboard_copy``, allowing it to support more than just ``xsel``. +- The :kbd:`ctrl-space` binding can be correctly customised (:issue:`7922`). - ``exit`` works correctly in bindings (:issue:`7967`). - The :kbd:`F1` binding, which opens the manual page for the current command, now works around a bug in certain ``less`` versions that fail to clear the screen (:issue:`7863`). -- The binding for :kbd:`Alt-S` now toggles whether ``sudo`` is prepended, even when it took the commandline from history instead of only adding it. +- The binding for :kbd:`alt-s` now toggles whether ``sudo`` is prepended, even when it took the commandline from history instead of only adding it. - The new functions ``fish_commandline_prepend`` and ``fish_commandline_append`` allow toggling the presence of a prefix/suffix on the current commandline. (:issue:`7905`). -- ``backward-kill-path-component`` :kbd:`Control-W`) no longer erases parts of two tokens when the cursor is positioned immediately after ``/``. (:issue:`6258`). +- ``backward-kill-path-component`` :kbd:`ctrl-w`) no longer erases parts of two tokens when the cursor is positioned immediately after ``/``. (:issue:`6258`). Improved prompts ^^^^^^^^^^^^^^^^ @@ -1238,8 +1238,8 @@ Notable improvements and fixes …h-shell/build (makepkg)> It is still possible to react to the ``COLUMNS`` variable inside the prompt to implement smarter behavior. -- **fish completes ambiguous completions** after pressing :kbd:`Tab` even when they - have a common prefix, without the user having to press :kbd:`Tab` again +- **fish completes ambiguous completions** after pressing :kbd:`tab` even when they + have a common prefix, without the user having to press :kbd:`tab` again (:issue:`6924`). - fish is less aggressive about resetting terminal modes, such as flow control, after every command. Although flow control remains off by default, enterprising users can now enable it with @@ -1365,7 +1365,7 @@ Interactive improvements - The interactive reader now allows ending a line in a logical operators (``&&`` and ``||``) instead of complaining about a missing command. (This was already syntactically valid, but interactive sessions didn't know about it yet). - The prompt is reprinted after a background job exits (:issue:`1018`). - fish no longer inserts a space after a completion ending in ``.``, ``,`` or ``-`` is accepted, improving completions for tools that provide dynamic completions (:issue:`6928`). -- If a filename is invalid when first pressing :kbd:`Tab`, but becomes valid, it will be completed properly on the next attempt (:issue:`6863`). +- If a filename is invalid when first pressing :kbd:`tab`, but becomes valid, it will be completed properly on the next attempt (:issue:`6863`). - ``help string match/replace/`` 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`). @@ -1402,15 +1402,15 @@ Interactive improvements 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. Previously-defined ``__fish_command_not_found_handler`` functions with an appropriate event listener will still work (:issue:`7293`). -- :kbd:`Control-C` handling has been reimplemented in C++ and is therefore quicker (:issue:`5259`), no longer occasionally prints an "unknown command" error (:issue:`7145`) or overwrites multiline prompts (:issue:`3537`). -- :kbd:`Control-C` no longer kills background jobs for which job control is +- :kbd:`ctrl-c` handling has been reimplemented in C++ and is therefore quicker (:issue:`5259`), no longer occasionally prints an "unknown command" error (:issue:`7145`) or overwrites multiline prompts (:issue:`3537`). +- :kbd:`ctrl-c` no longer kills background jobs for which job control is disabled, matching POSIX semantics (:issue:`6828`, :issue:`6861`). -- Autosuggestions work properly after :kbd:`Control-C` cancels the current commmand line (:issue:`6937`). +- Autosuggestions work properly after :kbd:`ctrl-c` cancels the current commmand line (:issue:`6937`). - History search is now case-insensitive unless the search string contains an uppercase character (:issue:`7273`). - ``fish_update_completions`` gained a new ``--keep`` option, which improves speed by skipping completions that already exist (:issue:`6775`, :issue:`6796`). - Aliases containing an embedded backslash appear properly in the output of ``alias`` (:issue:`6910`). - ``open`` no longer hangs indefinitely on certain systems, 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 :kbd:`Backspace` (:issue:`6951`). +- Long command lines no longer add a blank line after execution (:issue:`6826`) and behave better with :kbd:`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 now creates the path in the environment variable ``XDG_RUNTIME_DIR`` if it does not exist, before using it for runtime data storage (:issue:`7335`). @@ -1447,27 +1447,27 @@ Interactive improvements New or improved bindings ^^^^^^^^^^^^^^^^^^^^^^^^ -- As mentioned above, new special input functions ``undo`` (:kbd:`Control+\_` or :kbd:`Control+Z`) and ``redo`` (:kbd:`Alt-/`) can be used to revert changes to the command line or the pager search field (:issue:`6570`). -- :kbd:`Control-Z` is now available for binding (:issue:`7152`). -- Additionally, using the ``cancel`` special input function (bound to :kbd:`Escape` by default) right after fish picked an unambiguous completion will undo that (:issue:`7433`). -- ``fish_clipboard_paste`` (:kbd:`Control+V`) trims indentation from multiline commands, because fish already indents (:issue:`7662`). +- As mentioned above, new special input functions ``undo`` (:kbd:`ctrl-_` or :kbd:`ctrl-z`) and ``redo`` (:kbd:`alt-/`) can be used to revert changes to the command line or the pager search field (:issue:`6570`). +- :kbd:`ctrl-z` is now available for binding (:issue:`7152`). +- Additionally, using the ``cancel`` special input function (bound to :kbd:`escape` by default) right after fish picked an unambiguous completion will undo that (:issue:`7433`). +- ``fish_clipboard_paste`` (:kbd:`ctrl-v`) trims indentation from multiline commands, because fish already indents (:issue:`7662`). - Vi mode bindings now support ``dh``, ``dl``, ``c0``, ``cf``, ``ct``, ``cF``, ``cT``, ``ch``, ``cl``, ``y0``, ``ci``, ``ca``, ``yi``, ``ya``, ``di``, ``da``, ``d;``, ``d,``, ``o``, ``O`` and Control+left/right keys to navigate by word (:issue:`6648`, :issue:`6755`, :issue:`6769`, :issue:`7442`, :issue:`7516`). - Vi mode bindings support :kbd:`~` (tilde) to toggle the case of the selected character (:issue:`6908`). -- Functions ``up-or-search`` and ``down-or-search`` (:kbd:`Up` and :kbd:`Down`) can cross empty lines, and don't activate search mode if the search fails, which makes them easier to use to move between lines in some situations. +- Functions ``up-or-search`` and ``down-or-search`` (:kbd:`up` and :kbd:`down`) can cross empty lines, and don't activate search mode if the search fails, which makes them easier to use to move between lines in some situations. - If history search fails to find a match, the cursor is no longer moved. This is useful when accidentally starting a history search on a multi-line commandline. -- The special input function ``beginning-of-history`` (:kbd:`Page Up`) now moves to the oldest search instead of the youngest - that's ``end-of-history`` (:kbd:`Page Down`). +- The special input function ``beginning-of-history`` (:kbd:`pageup`) now moves to the oldest search instead of the youngest - that's ``end-of-history`` (:kbd:`pagedown`). - A new special input function ``forward-single-char`` moves one character to the right, and if an autosuggestion is available, only take a single character from it (:issue:`7217`, :issue:`4984`). - Special input functions can now be joined with ``or`` as a modifier (adding to ``and``), though only some commands set an exit status (:issue:`7217`). This includes ``suppress-autosuggestion`` to reflect whether an autosuggestion was suppressed (:issue:`1419`) -- A new function ``__fish_preview_current_file``, bound to :kbd:`Alt+O`, opens the +- A new function ``__fish_preview_current_file``, bound to :kbd:`alt-o`, opens the current file at the cursor in a pager (:issue:`6838`, :issue:`6855`). -- ``edit_command_buffer`` (:kbd:`Alt-E` and :kbd:`Alt-V`) passes the cursor position +- ``edit_command_buffer`` (:kbd:`alt-e` and :kbd:`alt-v`) passes the cursor position to the external editor if the editor is recognized (:issue:`6138`, :issue:`6954`). -- ``__fish_prepend_sudo`` (:kbd:`Alt-S`) now toggles a ``sudo`` prefix (:issue:`7012`) and avoids shifting the cursor (:issue:`6542`). -- ``__fish_prepend_sudo`` (:kbd:`Alt-S`) now uses the previous commandline if the current one is empty, +- ``__fish_prepend_sudo`` (:kbd:`alt-s`) now toggles a ``sudo`` prefix (:issue:`7012`) and avoids shifting the cursor (:issue:`6542`). +- ``__fish_prepend_sudo`` (:kbd:`alt-s`) now uses the previous commandline if the current one is empty, to simplify rerunning the previous command with ``sudo`` (:issue:`7079`). -- ``__fish_toggle_comment_commandline`` (:kbd:`Alt-#`) now uncomments and presents the last comment +- ``__fish_toggle_comment_commandline`` (:kbd:`alt-#`) now uncomments and presents the last comment from history if the commandline is empty (:issue:`7137`). -- ``__fish_whatis_current_token`` (:kbd:`Alt-W`) prints descriptions for functions and builtins (:issue:`7191`, :issue:`2083`). +- ``__fish_whatis_current_token`` (:kbd:`alt-w`) prints descriptions for functions and builtins (:issue:`7191`, :issue:`2083`). - The definition of "word" and "bigword" for movements was refined, fixing (eg) vi mode's behavior with :kbd:`e` on the second-to-last char, and bigword's behavior with single-character words and non-blank non-graphical characters (:issue:`7353`, :issue:`7354`, :issue:`4025`, :issue:`7328`, :issue:`7325`) - fish's clipboard bindings now also support Windows Subsystem for Linux via PowerShell and clip.exe (:issue:`7455`, :issue:`7458`) and will properly copy newlines in multi-line commands. - Using the ``*-jump`` special input functions before typing anything else no longer crashes fish. diff --git a/doc_src/cmds/abbr.rst b/doc_src/cmds/abbr.rst index 3fc86662e..0ce9fdfa6 100644 --- a/doc_src/cmds/abbr.rst +++ b/doc_src/cmds/abbr.rst @@ -25,8 +25,8 @@ Description Only typed-in commands use abbreviations. Abbreviations are not expanded in scripts. For example, a frequently-run command like ``git checkout`` can be abbreviated to ``gco``. -After entering ``gco`` and pressing :kbd:`Space` or :kbd:`Enter`, the full text ``git checkout`` will appear in the command line. -To avoid expanding something that looks like an abbreviation, the default :kbd:`Control`\ +\ :kbd:`Space` binding inserts a space without expanding. +After entering ``gco`` and pressing :kbd:`space` or :kbd:`enter`, the full text ``git checkout`` will appear in the command line. +To avoid expanding something that looks like an abbreviation, the default :kbd:`ctrl-space` binding inserts a space without expanding. An abbreviation may match a literal word, or it may match a pattern given by a regular expression. When an abbreviation matches a word, that word is replaced by new text, called its *expansion*. This expansion may be a fixed new phrase, or it can be dynamically created via a fish function. This expansion occurs after pressing space or enter. diff --git a/doc_src/cmds/bind.rst b/doc_src/cmds/bind.rst index 77dcc4d82..4c644bbf3 100644 --- a/doc_src/cmds/bind.rst +++ b/doc_src/cmds/bind.rst @@ -24,7 +24,7 @@ If only ``KEYS`` is given, any existing binding in the given ``MODE`` will be pr ``KEYS`` is a comma-separated list of key names. Modifier keys can be specified by prefixing a key name with a combination of ``ctrl-``/``c-``, ``alt-``/``a-`` and ``shift-``. -For example, :kbd:`Alt`\ +\ :kbd:`w` is written as ``alt-w``. +For example, pressing :kbd:`w` while holding the Alt modifier is written as ``alt-w``. Key names are case-sensitive; for example ``alt-W`` is the same as ``alt-shift-w``. Some keys have names, usually because they don't have an obvious printable character representation. @@ -364,22 +364,22 @@ The following functions are included as normal functions, but are particularly u Examples -------- -Exit the shell when :kbd:`Control`\ +\ :kbd:`D` is pressed:: +Exit the shell when :kbd:`ctrl-d` is pressed:: bind ctrl-d 'exit' -Perform a history search when :kbd:`Page Up` is pressed:: +Perform a history search when :kbd:`pageup` is pressed:: - bind -k ppage history-search-backward + bind pageup history-search-backward -Turn on :ref:`vi key bindings ` and rebind :kbd:`Control`\ +\ :kbd:`C` to clear the input line:: +Turn on :ref:`vi key bindings ` and rebind :kbd:`ctrl-c` to clear the input line:: set -g fish_key_bindings fish_vi_key_bindings - bind -M insert \cc kill-whole-line repaint + bind -M insert ctrl-c kill-whole-line repaint -Launch ``git diff`` and repaint the commandline afterwards when :kbd:`Control`\ +\ :kbd:`G` is pressed:: +Launch ``git diff`` and repaint the commandline afterwards when :kbd:`ctrl-g` is pressed:: - bind \cg 'git diff' repaint + bind ctrl-g 'git diff' repaint .. _cmd-bind-termlimits: @@ -390,10 +390,10 @@ Unix terminals, like the ones fish operates in, are at heart 70s technology. The For instance, the control key modifies a character by setting the top three bits to 0. This means: -- Many characters + control are indistinguishable from other keys. :kbd:`Control`\ +\ :kbd:`I` *is* tab, :kbd:`Control`\ +\ :kbd:`J` *is* newline (``\n``). +- Many characters + control are indistinguishable from other keys: :kbd:`ctrl-i` *is* :kbd:`tab`, :kbd:`ctrl-j` *is* newline (``\n``). - Control and shift don't work simultaneously -Other keys don't have a direct encoding, and are sent as escape sequences. For example :kbd:`→` (Right) often sends ``\e\[C``. These can differ from terminal to terminal, and the mapping is typically available in `terminfo(5)`. Sometimes however a terminal identifies as e.g. ``xterm-256color`` for compatibility, but then implements xterm's sequences incorrectly. +Other keys don't have a direct encoding, and are sent as escape sequences. For example :kbd:`right` (``→``) often sends ``\e\[C``. These can differ from terminal to terminal, and the mapping is typically available in `terminfo(5)`. Sometimes however a terminal identifies as e.g. ``xterm-256color`` for compatibility, but then implements xterm's sequences incorrectly. .. _cmd-bind-escape: diff --git a/doc_src/cmds/cdh.rst b/doc_src/cmds/cdh.rst index 606c0257c..c7c500fc5 100644 --- a/doc_src/cmds/cdh.rst +++ b/doc_src/cmds/cdh.rst @@ -15,7 +15,7 @@ Description ``cdh`` with no arguments presents a list of :ref:`recently visited directories `. You can then select one of the entries by letter or number. -You can also press :kbd:`Tab` to use the completion pager to select an item from the list. +You can also press :kbd:`tab` to use the completion pager to select an item from the list. If you give it a single argument it is equivalent to ``cd DIRECTORY``. Note that the ``cd`` command limits directory history to the 25 most recently visited directories. diff --git a/doc_src/cmds/fish_clipboard_copy.rst b/doc_src/cmds/fish_clipboard_copy.rst index 90abf77fc..e86fe3014 100644 --- a/doc_src/cmds/fish_clipboard_copy.rst +++ b/doc_src/cmds/fish_clipboard_copy.rst @@ -19,7 +19,7 @@ The ``fish_clipboard_copy`` function copies text to the system clipboard. If stdin is not a terminal (see :doc:`isatty `), it will read all input from there and copy it. If it is, it will use the current commandline, or the current selection if there is one. -It is bound to :kbd:`Control`\ +\ :kbd:`X` by default. +It is bound to :kbd:`ctrl-x` by default. ``fish_clipboard_copy`` works by calling a system-specific backend. If it doesn't appear to work you may need to install yours. diff --git a/doc_src/cmds/fish_clipboard_paste.rst b/doc_src/cmds/fish_clipboard_paste.rst index 9833df2b1..2022a0693 100644 --- a/doc_src/cmds/fish_clipboard_paste.rst +++ b/doc_src/cmds/fish_clipboard_paste.rst @@ -21,7 +21,7 @@ If its stdout is not a terminal (see :doc:`isatty `), it will output eve If it outputs to the commandline, it will automatically escape the output if the cursor is currently inside single-quotes so it is suitable for single-quotes (meaning it escapes ``'`` and ``\\``). -It is bound to :kbd:`Control`\ +\ :kbd:`V` by default. +It is bound to :kbd:`ctrl-v` by default. ``fish_clipboard_paste`` works by calling a system-specific backend. If it doesn't appear to work you may need to install yours. diff --git a/doc_src/cmds/fish_key_reader.rst b/doc_src/cmds/fish_key_reader.rst index 709764835..848ee57c8 100644 --- a/doc_src/cmds/fish_key_reader.rst +++ b/doc_src/cmds/fish_key_reader.rst @@ -31,8 +31,8 @@ Usage Notes ``fish_key_reader`` intentionally disables handling of many signals. To terminate ``fish_key_reader`` in ``--continuous`` mode do: -- press :kbd:`Control`\ +\ :kbd:`C` twice, or -- press :kbd:`Control`\ +\ :kbd:`D` twice, or +- press :kbd:`ctrl-c` twice, or +- press :kbd:`ctrl-d` twice, or - type ``exit``, or - type ``quit`` diff --git a/doc_src/cmds/funced.rst b/doc_src/cmds/funced.rst index f2516cc32..63dc0307f 100644 --- a/doc_src/cmds/funced.rst +++ b/doc_src/cmds/funced.rst @@ -15,7 +15,7 @@ Description ``funced`` provides an interface to edit the definition of the function *NAME*. -If the ``$VISUAL`` environment variable is set, it will be used as the program to edit the function. If ``$VISUAL`` is unset but ``$EDITOR`` is set, that will be used. Otherwise, a built-in editor will be used. Note that to enter a literal newline using the built-in editor you should press :kbd:`Alt`\ +\ :kbd:`Enter`. Pressing :kbd:`Enter` signals that you are done editing the function. This does not apply to an external editor like emacs or vim. +If the ``$VISUAL`` environment variable is set, it will be used as the program to edit the function. If ``$VISUAL`` is unset but ``$EDITOR`` is set, that will be used. Otherwise, a built-in editor will be used. Note that to enter a literal newline using the built-in editor you should press :kbd:`alt-enter`. Pressing :kbd:`enter` signals that you are done editing the function. This does not apply to an external editor like emacs or vim. ``funced`` will try to edit the original file that a function is defined in, which might include variable definitions or helper functions as well. If changes cannot be saved to the original file, a copy will be created in the user's function directory. diff --git a/doc_src/cmds/function.rst b/doc_src/cmds/function.rst index 1239873cf..c210e01b5 100644 --- a/doc_src/cmds/function.rst +++ b/doc_src/cmds/function.rst @@ -44,7 +44,7 @@ The following options are available: This will not trigger for :doc:`disowned ` jobs. **-s** *SIGSPEC* or **--on-signal** *SIGSPEC* - Run this function when the signal ``SIGSPEC`` is delivered. ``SIGSPEC`` can be a signal number, or the signal name, such as ``SIGHUP`` (or just ``HUP``). Note that the signal must have been delivered to :program:`fish`; for example, :kbd:`Ctrl-C` sends ``SIGINT`` to the foreground process group, which will not be :program:`fish` if you are running another command at the time. Observing a signal will prevent fish from exiting in response to that signal. + Run this function when the signal ``SIGSPEC`` is delivered. ``SIGSPEC`` can be a signal number, or the signal name, such as ``SIGHUP`` (or just ``HUP``). Note that the signal must have been delivered to :program:`fish`; for example, :kbd:`ctrl-c` sends ``SIGINT`` to the foreground process group, which will not be :program:`fish` if you are running another command at the time. Observing a signal will prevent fish from exiting in response to that signal. **-S** or **--no-scope-shadowing** Allows the function to access the variables of calling functions. Normally, any variables inside the function that have the same name as variables from the calling function are "shadowed", and their contents are independent of the calling function. diff --git a/doc_src/faq.rst b/doc_src/faq.rst index defce4a29..f248f72cb 100644 --- a/doc_src/faq.rst +++ b/doc_src/faq.rst @@ -154,23 +154,23 @@ in :ref:`config.fish `. How do I run a command from history? ------------------------------------ -Type some part of the command, and then hit the :kbd:`↑` (up) or :kbd:`↓` (down) arrow keys to navigate through history matches, or press :kbd:`Control`\ +\ :kbd:`R` to open the history in a searchable pager. In this pager you can press :kbd:`Control`\ +\ :kbd:`R` or :kbd:`Control`\ +\ :kbd:`S` to move to older or younger history respectively. +Type some part of the command, and then hit the :kbd:`up` (``↑``) or :kbd:`ctrl-down` (``↓``) arrow keys to navigate through history matches, or press :kbd:`ctrl-r` to open the history in a searchable pager. In this pager you can press :kbd:`ctrl-r` or :kbd:`ctrl-s` to move to older or younger history respectively. -Additional default key bindings include :kbd:`Control`\ +\ :kbd:`P` (up) and :kbd:`Control`\ +\ :kbd:`N` (down). See :ref:`Searchable command history ` for more information. +Additional default key bindings include :kbd:`ctrl-p` (up) and :kbd:`ctrl-n` (down). See :ref:`Searchable command history ` for more information. Why doesn't history substitution ("!$" etc.) work? -------------------------------------------------- Because history substitution is an awkward interface that was invented before interactive line editing was even possible. Instead of adding this pseudo-syntax, fish opts for nice history searching and recall features. Switching requires a small change of habits: if you want to modify an old line/word, first recall it, then edit. -As a special case, most of the time history substitution is used as ``sudo !!``. In that case just press :kbd:`Alt`\ +\ :kbd:`S`, and it will recall your last commandline with ``sudo`` prefixed (or toggle a ``sudo`` prefix on the current commandline if there is anything). +As a special case, most of the time history substitution is used as ``sudo !!``. In that case just press :kbd:`alt-s`, and it will recall your last commandline with ``sudo`` prefixed (or toggle a ``sudo`` prefix on the current commandline if there is anything). In general, fish's history recall works like this: -- Like other shells, the Up arrow, :kbd:`↑` recalls whole lines, starting from the last executed line. So instead of typing ``!!``, you would just hit the up-arrow. +- Like other shells, the Up arrow, ``up`` recalls whole lines, starting from the last executed line. So instead of typing ``!!``, you would just hit the up-arrow. -- If the line you want is far back in the history, type any part of the line and then press Up one or more times. This will filter the recalled lines to ones that include this text, and you will get to the line you want much faster. This replaces "!vi", "!?bar.c" and the like. If you want to see more context, you can press :kbd:`Ctrl`\ +\ :kbd:`R` to open the history in the pager. +- If the line you want is far back in the history, type any part of the line and then press Up one or more times. This will filter the recalled lines to ones that include this text, and you will get to the line you want much faster. This replaces "!vi", "!?bar.c" and the like. If you want to see more context, you can press ``ctlr-b`` to open the history in the pager. -- :kbd:`Alt`\ +\ :kbd:`↑` recalls individual arguments, starting from the last argument in the last executed line. This can be used instead of "!$". +- ``alt-up`` recalls individual arguments, starting from the last argument in the last executed line. This can be used instead of "!$". See :ref:`documentation ` for more details about line editing in fish. diff --git a/doc_src/interactive.rst b/doc_src/interactive.rst index 7621efabf..c9f92f034 100644 --- a/doc_src/interactive.rst +++ b/doc_src/interactive.rst @@ -25,7 +25,7 @@ Autosuggestions fish suggests commands as you type, based on :ref:`command history `, completions, and valid file paths. As you type commands, you will see a suggestion offered after the cursor, in a muted gray color (which can be changed with the ``fish_color_autosuggestion`` variable). -To accept the autosuggestion (replacing the command line contents), press :kbd:`→` or :kbd:`Control`\ +\ :kbd:`F`. To accept the first suggested word, press :kbd:`Alt`\ +\ :kbd:`→` or :kbd:`Alt`\ +\ :kbd:`F`. If the autosuggestion is not what you want, just ignore it: it won't execute unless you accept it. +To accept the autosuggestion (replacing the command line contents), press :kbd:`right` (``→``) or :kbd:`ctrl-f`. To accept the first suggested word, press :kbd:`alt-right` (``→``) or :kbd:`alt-f`. If the autosuggestion is not what you want, just ignore it: it won't execute unless you accept it. Autosuggestions are a powerful way to quickly summon frequently entered commands, by typing the first few characters. They are also an efficient technique for navigating through directory hierarchies. @@ -38,9 +38,9 @@ If you don't like autosuggestions, you can disable them by setting ``$fish_autos Tab Completion -------------- -Tab completion is a time saving feature of any modern shell. When you type :kbd:`Tab`, fish tries to guess the rest of the word under the cursor. If it finds just one possibility, it inserts it. If it finds more, it inserts the longest unambiguous part and then opens a menu (the "pager") that you can navigate to find what you're looking for. +Tab completion is a time saving feature of any modern shell. When you type :kbd:`tab`, fish tries to guess the rest of the word under the cursor. If it finds just one possibility, it inserts it. If it finds more, it inserts the longest unambiguous part and then opens a menu (the "pager") that you can navigate to find what you're looking for. -The pager can be navigated with the arrow keys, :kbd:`Page Up` / :kbd:`Page Down`, :kbd:`Tab` or :kbd:`Shift`\ +\ :kbd:`Tab`. Pressing :kbd:`Control`\ +\ :kbd:`S` (the ``pager-toggle-search`` binding - :kbd:`/` in vi mode) opens up a search menu that you can use to filter the list. +The pager can be navigated with the arrow keys, :kbd:`pageup` / :kbd:`pagedown`, :kbd:`tab` or :kbd:`shift-tab`. Pressing :kbd:`ctrl-s` (the ``pager-toggle-search`` binding - :kbd:`/` in vi mode) opens up a search menu that you can use to filter the list. Fish provides some general purpose completions, like for commands, variable names, usernames or files. @@ -188,7 +188,7 @@ To avoid needless typing, a frequently-run command like ``git checkout`` can be abbr -a gco git checkout -After entering ``gco`` and pressing :kbd:`Space` or :kbd:`Enter`, a ``gco`` in command position will turn into ``git checkout`` in the command line. If you want to use a literal ``gco`` sometimes, use :kbd:`Control`\ +\ :kbd:`Space` [#]_. +After entering ``gco`` and pressing :kbd:`space` or :kbd:`enter`, a ``gco`` in command position will turn into ``git checkout`` in the command line. If you want to use a literal ``gco`` sometimes, use :kbd:`ctrl-space` [#]_. Abbreviations are a lot more powerful than just replacing literal strings. For example you can make going up a number of directories easier with this:: @@ -201,7 +201,7 @@ Now, ``..`` transforms to ``cd ../``, while ``...`` turns into ``cd ../../`` and The advantage over aliases is that you can see the actual command before using it, add to it or change it, and the actual command will be stored in history. -.. [#] Any binding that executes the ``expand-abbr`` or ``execute`` :doc:`bind function ` will expand abbreviations. By default :kbd:`Control`\ +\ :kbd:`Space` is bound to just inserting a space. +.. [#] Any binding that executes the ``expand-abbr`` or ``execute`` :doc:`bind function ` will expand abbreviations. By default :kbd:`ctrl-space` is bound to just inserting a space. .. _prompt: @@ -286,7 +286,7 @@ Like bash and other shells, fish includes two sets of keyboard shortcuts (or key end set -g fish_key_bindings fish_hybrid_key_bindings -While the key bindings included with fish include many of the shortcuts popular from the respective text editors, they are not a complete implementation. They include a shortcut to open the current command line in your preferred editor (:kbd:`Alt`\ +\ :kbd:`E` by default) if you need the full power of your editor. +While the key bindings included with fish include many of the shortcuts popular from the respective text editors, they are not a complete implementation. They include a shortcut to open the current command line in your preferred editor (:kbd:`alt-e` by default) if you need the full power of your editor. .. _shared-binds: @@ -295,55 +295,55 @@ Shared bindings Some bindings are common across Emacs and vi mode, because they aren't text editing bindings, or because what vi/Vim does for a particular key doesn't make sense for a shell. -- :kbd:`Tab` :ref:`completes ` the current token. :kbd:`Shift`\ +\ :kbd:`Tab` completes the current token and starts the pager's search mode. :kbd:`Tab` is the same as :kbd:`Control`\ +\ :kbd:`I`. +- :kbd:`tab` :ref:`completes ` the current token. :kbd:`shift-tab` completes the current token and starts the pager's search mode. :kbd:`tab` is the same as :kbd:`ctrl-i`. -- :kbd:`←` (Left) and :kbd:`→` (Right) move the cursor left or right by one character. If the cursor is already at the end of the line, and an autosuggestion is available, :kbd:`→` accepts the autosuggestion. +- :kbd:`left` (``←``) and :kbd:`right` (``→``) move the cursor left or right by one character. If the cursor is already at the end of the line, and an autosuggestion is available, :kbd:`right` (``→``) accepts the autosuggestion. -- :kbd:`Enter` executes the current commandline or inserts a newline if it's not complete yet (e.g. a ``)`` or ``end`` is missing). +- :kbd:`enter` executes the current commandline or inserts a newline if it's not complete yet (e.g. a ``)`` or ``end`` is missing). -- :kbd:`Alt`\ +\ :kbd:`Enter` inserts a newline at the cursor position. This is useful to add a line to a commandline that's already complete. +- :kbd:`alt-enter` inserts a newline at the cursor position. This is useful to add a line to a commandline that's already complete. -- :kbd:`Alt`\ +\ :kbd:`←` and :kbd:`Alt`\ +\ :kbd:`→` move the cursor one word left or right (to the next space or punctuation mark), or moves forward/backward in the directory history if the command line is empty. If the cursor is already at the end of the line, and an autosuggestion is available, :kbd:`Alt`\ +\ :kbd:`→` (or :kbd:`Alt`\ +\ :kbd:`F`) accepts the first word in the suggestion. +- :kbd:`alt-left` (``←``) and :kbd:`alt-right` (``→``) move the cursor one word left or right (to the next space or punctuation mark), or moves forward/backward in the directory history if the command line is empty. If the cursor is already at the end of the line, and an autosuggestion is available, :kbd:`alt-right` (``→``) (or :kbd:`alt-f`) accepts the first word in the suggestion. -- :kbd:`Control`\ +\ :kbd:`←` and :kbd:`Control`\ +\ :kbd:`→` move the cursor one word left or right. These accept one word of the autosuggestion - the part they'd move over. +- :kbd:`ctrl-left` (``←``) and :kbd:`ctrl-right` (``→``) move the cursor one word left or right. These accept one word of the autosuggestion - the part they'd move over. -- :kbd:`Shift`\ +\ :kbd:`←` and :kbd:`Shift`\ +\ :kbd:`→` move the cursor one word left or right, without stopping on punctuation. These accept one big word of the autosuggestion. +- :kbd:`shift-left` (``←``) and :kbd:`shift-right` (``→``) move the cursor one word left or right, without stopping on punctuation. These accept one big word of the autosuggestion. -- :kbd:`↑` (Up) and :kbd:`↓` (Down) (or :kbd:`Control`\ +\ :kbd:`P` and :kbd:`Control`\ +\ :kbd:`N` for emacs aficionados) search the command history for the previous/next command containing the string that was specified on the commandline before the search was started. If the commandline was empty when the search started, all commands match. See the :ref:`history ` section for more information on history searching. +- :kbd:`up` (``↑``) and :kbd:`down` (``↓``) (or :kbd:`ctrl-p` and :kbd:`ctrl-n` for emacs aficionados) search the command history for the previous/next command containing the string that was specified on the commandline before the search was started. If the commandline was empty when the search started, all commands match. See the :ref:`history ` section for more information on history searching. -- :kbd:`Alt`\ +\ :kbd:`↑` and :kbd:`Alt`\ +\ :kbd:`↓` search the command history for the previous/next token containing the token under the cursor before the search was started. If the commandline was not on a token when the search started, all tokens match. See the :ref:`history ` section for more information on history searching. +- :kbd:`alt-up` (``↑``) and :kbd:`alt-down` (``↓``) search the command history for the previous/next token containing the token under the cursor before the search was started. If the commandline was not on a token when the search started, all tokens match. See the :ref:`history ` section for more information on history searching. -- :kbd:`Control`\ +\ :kbd:`C` interrupts/kills whatever is running (SIGINT). +- :kbd:`ctrl-c` interrupts/kills whatever is running (SIGINT). -- :kbd:`Control`\ +\ :kbd:`D` deletes one character to the right of the cursor. If the command line is empty, :kbd:`Control`\ +\ :kbd:`D` will exit fish. +- :kbd:`ctrl-d` deletes one character to the right of the cursor. If the command line is empty, :kbd:`ctrl-d` will exit fish. -- :kbd:`Control`\ +\ :kbd:`U` removes contents from the beginning of line to the cursor (moving it to the :ref:`killring `). +- :kbd:`ctrl-u` removes contents from the beginning of line to the cursor (moving it to the :ref:`killring `). -- :kbd:`Control`\ +\ :kbd:`L` clears and repaints the screen. +- :kbd:`ctrl-l` clears and repaints the screen. -- :kbd:`Control`\ +\ :kbd:`W` removes the previous path component (everything up to the previous "/", ":" or "@") (moving it to the :ref:`killring`). +- :kbd:`ctrl-w` removes the previous path component (everything up to the previous "/", ":" or "@") (moving it to the :ref:`killring`). -- :kbd:`Control`\ +\ :kbd:`X` copies the current buffer to the system's clipboard, :kbd:`Control`\ +\ :kbd:`V` inserts the clipboard contents. (see :doc:`fish_clipboard_copy ` and :doc:`fish_clipboard_paste `) +- :kbd:`ctrl-x` copies the current buffer to the system's clipboard, :kbd:`ctrl-v` inserts the clipboard contents. (see :doc:`fish_clipboard_copy ` and :doc:`fish_clipboard_paste `) -- :kbd:`Alt`\ +\ :kbd:`D` moves the next word to the :ref:`killring`. +- :kbd:`alt-d` moves the next word to the :ref:`killring`. -- :kbd:`Alt`\ +\ :kbd:`H` (or :kbd:`F1`) shows the manual page for the current command, if one exists. +- :kbd:`alt-h` (or :kbd:`F1`) shows the manual page for the current command, if one exists. -- :kbd:`Alt`\ +\ :kbd:`L` lists the contents of the current directory, unless the cursor is over a directory argument, in which case the contents of that directory will be listed. +- :kbd:`alt-l` lists the contents of the current directory, unless the cursor is over a directory argument, in which case the contents of that directory will be listed. -- :kbd:`Alt`\ +\ :kbd:`O` opens the file at the cursor in a pager. If the cursor is in command position and the command is a script, it will instead open that script in your editor. The editor is chosen from the first available of the ``$VISUAL`` or ``$EDITOR`` variables. +- :kbd:`alt-o` opens the file at the cursor in a pager. If the cursor is in command position and the command is a script, it will instead open that script in your editor. The editor is chosen from the first available of the ``$VISUAL`` or ``$EDITOR`` variables. -- :kbd:`Alt`\ +\ :kbd:`P` adds the string ``&| less;`` to the end of the job under the cursor. The result is that the output of the command will be paged. +- :kbd:`alt-p` adds the string ``&| less;`` to the end of the job under the cursor. The result is that the output of the command will be paged. -- :kbd:`Alt`\ +\ :kbd:`W` prints a short description of the command under the cursor. +- :kbd:`alt-w` prints a short description of the command under the cursor. -- :kbd:`Alt`\ +\ :kbd:`E` edits the current command line in an external editor. The editor is chosen from the first available of the ``$VISUAL`` or ``$EDITOR`` variables. +- :kbd:`alt-e` edits the current command line in an external editor. The editor is chosen from the first available of the ``$VISUAL`` or ``$EDITOR`` variables. -- :kbd:`Alt`\ +\ :kbd:`V` Same as :kbd:`Alt`\ +\ :kbd:`E`. +- :kbd:`alt-v` Same as :kbd:`alt-e`. -- :kbd:`Alt`\ +\ :kbd:`S` Prepends ``sudo`` to the current commandline. If the commandline is empty, prepend ``sudo`` to the last commandline. +- :kbd:`alt-s` Prepends ``sudo`` to the current commandline. If the commandline is empty, prepend ``sudo`` to the last commandline. -- :kbd:`Control`\ +\ :kbd:`Space` Inserts a space without expanding an :ref:`abbreviation `. For vi mode, this only applies to insert-mode. +- :kbd:`ctrl-space` Inserts a space without expanding an :ref:`abbreviation `. For vi mode, this only applies to insert-mode. .. _emacs-mode: @@ -352,37 +352,37 @@ Emacs mode commands To enable emacs mode, use :doc:`fish_default_key_bindings `. This is also the default. -- :kbd:`Home` or :kbd:`Control`\ +\ :kbd:`A` moves the cursor to the beginning of the line. +- :kbd:`home` or :kbd:`ctrl-a` moves the cursor to the beginning of the line. -- :kbd:`End` or :kbd:`Control`\ +\ :kbd:`E` moves to the end of line. If the cursor is already at the end of the line, and an autosuggestion is available, :kbd:`End` or :kbd:`Control`\ +\ :kbd:`E` accepts the autosuggestion. +- :kbd:`end` or :kbd:`ctrl-e` moves to the end of line. If the cursor is already at the end of the line, and an autosuggestion is available, :kbd:`end` or :kbd:`ctrl-e` accepts the autosuggestion. -- :kbd:`Control`\ +\ :kbd:`B`, :kbd:`Control`\ +\ :kbd:`F` move the cursor one character left or right or accept the autosuggestion just like the :kbd:`←` (Left) and :kbd:`→` (Right) shared bindings (which are available as well). +- :kbd:`ctrl-b`, :kbd:`ctrl-f` move the cursor one character left or right or accept the autosuggestion just like the :kbd:`left` (``←``) and :kbd:`right` (``→``) shared bindings (which are available as well). -- :kbd:`Control`\ +\ :kbd:`N`, :kbd:`Control`\ +\ :kbd:`P` move the cursor up/down or through history, like the up and down arrow shared bindings. +- :kbd:`ctrl-n`, :kbd:`ctrl-p` move the cursor up/down or through history, like the up and down arrow shared bindings. -- :kbd:`Delete` or :kbd:`Backspace` removes one character forwards or backwards respectively. This also goes for :kbd:`Control`\ +\ :kbd:`H`, which is indistinguishable from backspace. +- :kbd:`delete` or :kbd:`backspace` removes one character forwards or backwards respectively. This also goes for :kbd:`ctrl-h`, which is indistinguishable from backspace. -- :kbd:`Alt`\ +\ :kbd:`Backspace` removes one word backwards. +- :kbd:`alt-backspace` removes one word backwards. -- :kbd:`Alt`\ +\ :kbd:`<` moves to the beginning of the commandline, :kbd:`Alt`\ +\ :kbd:`>` moves to the end. +- :kbd:`alt-<` moves to the beginning of the commandline, :kbd:`alt->` moves to the end. -- :kbd:`Control`\ +\ :kbd:`K` deletes from the cursor to the end of line (moving it to the :ref:`killring`). +- :kbd:`ctrl-k` deletes from the cursor to the end of line (moving it to the :ref:`killring`). -- :kbd:`Escape` and :kbd:`Control`\ +\ :kbd:`G` cancel the current operation. Immediately after an unambiguous completion this undoes it. +- :kbd:`escape` and :kbd:`ctrl-g` cancel the current operation. Immediately after an unambiguous completion this undoes it. -- :kbd:`Alt`\ +\ :kbd:`C` capitalizes the current word. +- :kbd:`alt-c` capitalizes the current word. -- :kbd:`Alt`\ +\ :kbd:`U` makes the current word uppercase. +- :kbd:`alt-u` makes the current word uppercase. -- :kbd:`Control`\ +\ :kbd:`T` transposes the last two characters. +- :kbd:`ctrl-t` transposes the last two characters. -- :kbd:`Alt`\ +\ :kbd:`T` transposes the last two words. +- :kbd:`alt-t` transposes the last two words. -- :kbd:`Control`\ +\ :kbd:`Z`, :kbd:`Control`\ +\ :kbd:`_` (:kbd:`Control`\ +\ :kbd:`/` on some terminals) undo the most recent edit of the line. +- :kbd:`ctrl-z`, :kbd:`ctrl-_` (:kbd:`ctrl-/` on some terminals) undo the most recent edit of the line. -- :kbd:`Alt`\ +\ :kbd:`/` reverts the most recent undo. +- :kbd:`alt-/` reverts the most recent undo. -- :kbd:`Control`\ +\ :kbd:`R` opens the history in a pager. This will show history entries matching the search, a few at a time. Pressing :kbd:`Control`\ +\ :kbd:`R` again will search older entries, pressing :kbd:`Control`\ +\ :kbd:`S` (that otherwise toggles pager search) will go to newer entries. The search bar will always be selected. +- :kbd:`ctrl-r` opens the history in a pager. This will show history entries matching the search, a few at a time. Pressing :kbd:`ctrl-r` again will search older entries, pressing :kbd:`ctrl-s` (that otherwise toggles pager search) will go to newer entries. The search bar will always be selected. You can change these key bindings using the :doc:`bind ` builtin. @@ -393,7 +393,7 @@ You can change these key bindings using the :doc:`bind ` builtin. Vi mode commands ^^^^^^^^^^^^^^^^ -Vi mode allows for the use of vi-like commands at the prompt. Initially, :ref:`insert mode ` is active. :kbd:`Escape` enters :ref:`command mode `. The commands available in command, insert and visual mode are described below. Vi mode shares :ref:`some bindings ` with :ref:`Emacs mode `. +Vi mode allows for the use of vi-like commands at the prompt. Initially, :ref:`insert mode ` is active. :kbd:`escape` enters :ref:`command mode `. The commands available in command, insert and visual mode are described below. Vi mode shares :ref:`some bindings ` with :ref:`Emacs mode `. To enable vi mode, use :doc:`fish_vi_key_bindings `. It is also possible to add all Emacs mode bindings to vi mode by using something like:: @@ -453,13 +453,13 @@ Command mode is also known as normal mode. - :kbd:`i` enters :ref:`insert mode ` at the current cursor position. -- :kbd:`Shift`\ +\ :kbd:`I` enters :ref:`insert mode ` at the beginning of the line. +- :kbd:`I` enters :ref:`insert mode ` at the beginning of the line. - :kbd:`v` enters :ref:`visual mode ` at the current cursor position. - :kbd:`a` enters :ref:`insert mode ` after the current cursor position. -- :kbd:`Shift`\ +\ :kbd:`A` enters :ref:`insert mode ` at the end of the line. +- :kbd:`A` enters :ref:`insert mode ` at the end of the line. - :kbd:`o` inserts a new line under the current one and enters :ref:`insert mode ` @@ -467,40 +467,40 @@ Command mode is also known as normal mode. - :kbd:`0` (zero) moves the cursor to beginning of line (remaining in command mode). -- :kbd:`d`\ +\ :kbd:`d` deletes the current line and moves it to the :ref:`killring`. +- :kbd:`d,d` deletes the current line and moves it to the :ref:`killring`. -- :kbd:`Shift`\ +\ :kbd:`D` deletes text after the current cursor position and moves it to the :ref:`killring`. +- :kbd:`D` deletes text after the current cursor position and moves it to the :ref:`killring`. - :kbd:`p` pastes text from the :ref:`killring`. - :kbd:`u` undoes the most recent edit of the command line. -- :kbd:`Control`\ +\ :kbd:`R` redoes the most recent edit. +- :kbd:`ctrl-r` redoes the most recent edit. - :kbd:`[` and :kbd:`]` search the command history for the previous/next token containing the token under the cursor before the search was started. See the :ref:`history ` section for more information on history searching. -- :kbd:`/` opens the history in a pager. This will show history entries matching the search, a few at a time. Pressing it again will search older entries, pressing :kbd:`Control`\ +\ :kbd:`S` (that otherwise toggles pager search) will go to newer entries. The search bar will always be selected. +- :kbd:`/` opens the history in a pager. This will show history entries matching the search, a few at a time. Pressing it again will search older entries, pressing :kbd:`ctrl-s` (that otherwise toggles pager search) will go to newer entries. The search bar will always be selected. -- :kbd:`Backspace` moves the cursor left. +- :kbd:`backspace` moves the cursor left. - :kbd:`g` / :kbd:`G` moves the cursor to the beginning/end of the commandline, respectively. -- :kbd:`:q` exits fish. +- :kbd:`:,q` exits fish. .. _vi-mode-insert: Insert mode """"""""""" -- :kbd:`Escape` enters :ref:`command mode `. +- :kbd:`escape` enters :ref:`command mode `. -- :kbd:`Backspace` removes one character to the left. +- :kbd:`backspace` removes one character to the left. .. _vi-mode-visual: Visual mode """"""""""" -- :kbd:`←` (Left) and :kbd:`→` (Right) extend the selection backward/forward by one character. +- :kbd:`left (``←``) and :kbd:`right`(``→``) extend the selection backward/forward by one character. - :kbd:`h` moves the cursor left. @@ -514,7 +514,7 @@ Visual mode - :kbd:`d` and :kbd:`x` move the selection to the :ref:`killring` and enter :ref:`command mode `. -- :kbd:`Escape` and :kbd:`Control`\ +\ :kbd:`C` enter :ref:`command mode `. +- :kbd:`escape` and :kbd:`ctrl-c` enter :ref:`command mode `. - :kbd:`c` and :kbd:`s` remove the selection and switch to insert mode. @@ -524,7 +524,7 @@ Visual mode - :kbd:`~` toggles the case (upper/lower) on the selection, and enters :ref:`command mode `. -- :kbd:`"*y` copies the selection to the clipboard, and enters :ref:`command mode `. +- :kbd:`",*,y` copies the selection to the clipboard, and enters :ref:`command mode `. .. _custom-binds: @@ -561,9 +561,9 @@ To find out the name of a key, you can use :doc:`fish_key_reader ` command. +- Pressing the :kbd:`enter` key while a block of commands is unclosed, such as when one or more block commands such as ``for``, ``begin`` or ``if`` do not have a corresponding :doc:`end ` command. -- Pressing :kbd:`Alt`\ +\ :kbd:`Enter` instead of pressing the :kbd:`Enter` key. +- Pressing :kbd:`alt-enter` instead of pressing the :kbd:`enter` key. -- By inserting a backslash (``\``) character before pressing the :kbd:`Enter` key, escaping the newline. +- By inserting a backslash (``\``) character before pressing the :kbd:`enter` key, escaping the newline. The fish commandline editor works exactly the same in single line mode and in multiline mode. To move between lines use the left and right arrow keys and other such keyboard shortcuts. @@ -616,11 +616,11 @@ Searchable command history After a command has been executed, it is remembered in the history list. Any duplicate history items are automatically removed. By pressing the up and down keys, you can search forwards and backwards in the history. If the current command line is not empty when starting a history search, only the commands containing the string entered into the command line are shown. -By pressing :kbd:`Alt`\ +\ :kbd:`↑` and :kbd:`Alt`\ +\ :kbd:`↓`, a history search is also performed, but instead of searching for a complete commandline, each commandline is broken into separate elements just like it would be before execution, and the history is searched for an element matching that under the cursor. +By pressing :kbd:`alt-up` (``↑``) and :kbd:`alt-down` (``↓``), a history search is also performed, but instead of searching for a complete commandline, each commandline is broken into separate elements just like it would be before execution, and the history is searched for an element matching that under the cursor. -For more complicated searches, you can press :kbd:`Ctrl`\ +\ :kbd:`R` to open a pager that allows you to search the history. It shows a limited number of entries in one page, press :kbd:`Ctrl`\ +\ :kbd:`R` [#]_ again to move to the next page and :kbd:`Ctrl`\ +\ :kbd:`S` [#]_ to move to the previous page. You can change the text to refine your search. +For more complicated searches, you can press :kbd:`ctrl-r` to open a pager that allows you to search the history. It shows a limited number of entries in one page, press :kbd:`ctrl-r` [#]_ again to move to the next page and :kbd:`ctrl-s` [#]_ to move to the previous page. You can change the text to refine your search. -History searches are case-insensitive unless the search string contains an uppercase character. You can stop a search to edit your search string by pressing :kbd:`Esc` or :kbd:`Page Down`. +History searches are case-insensitive unless the search string contains an uppercase character. You can stop a search to edit your search string by pressing :kbd:`escape` or :kbd:`pagedown`. Prefixing the commandline with a space will prevent the entire line from being stored in the history. It will still be available for recall until the next command is executed, but will not be stored on disk. This is to allow you to fix misspellings and such. @@ -635,7 +635,7 @@ Examples: To search for previous entries containing the word 'make', type ``make`` in the console and press the up key. -If the commandline reads ``cd m``, place the cursor over the ``m`` character and press :kbd:`Alt`\ +\ :kbd:`↑` to search for previously typed words containing 'm'. +If the commandline reads ``cd m``, place the cursor over the ``m`` character and press :kbd:`alt-up` (``↑``) to search for previously typed words containing 'm'. .. [#] Or another binding that triggers the ``history-pager`` input function. See :doc:`bind ` for a list. .. [#] Or another binding that triggers the ``pager-toggle-search`` input function. @@ -669,8 +669,8 @@ Several commands are provided to interact with this directory history: - :doc:`dirh ` prints the history - :doc:`cdh ` displays a prompt to quickly navigate the history -- :doc:`prevd ` moves backward through the history. It is bound to :kbd:`Alt`\ +\ :kbd:`←` -- :doc:`nextd ` moves forward through the history. It is bound to :kbd:`Alt`\ +\ :kbd:`→` +- :doc:`prevd ` moves backward through the history. It is bound to :kbd:`alt-left` (``←``) +- :doc:`nextd ` moves forward through the history. It is bound to :kbd:`alt-right` (``→``) .. _directory-stack: diff --git a/doc_src/language.rst b/doc_src/language.rst index 7228a49ed..9fbd30768 100644 --- a/doc_src/language.rst +++ b/doc_src/language.rst @@ -283,7 +283,7 @@ Example:: will start the emacs text editor in the background. :doc:`fg ` can be used to bring it into the foreground again when needed. -Most programs allow you to suspend the program's execution and return control to fish by pressing :kbd:`Control`\ +\ :kbd:`Z` (also referred to as ``^Z``). Once back at the fish commandline, you can start other programs and do anything you want. If you then want you can go back to the suspended command by using the :doc:`fg ` (foreground) command. +Most programs allow you to suspend the program's execution and return control to fish by pressing :kbd:`ctrl-z` (also referred to as ``^Z``). Once back at the fish commandline, you can start other programs and do anything you want. If you then want you can go back to the suspended command by using the :doc:`fg ` (foreground) command. If you instead want to put a suspended job into the background, use the :doc:`bg ` command. @@ -2107,7 +2107,7 @@ For more information on how to define new event handlers, see the documentation Debugging fish scripts ---------------------- -Fish includes basic built-in debugging facilities that allow you to stop execution of a script at an arbitrary point. When this happens you are presented with an interactive prompt where you can execute any fish command to inspect or change state (there are no debug commands as such). For example, you can check or change the value of any variables using :doc:`printf ` and :doc:`set `. As another example, you can run :doc:`status print-stack-trace ` to see how the current breakpoint was reached. To resume normal execution of the script, simply type :doc:`exit ` or :kbd:`Control`\ +\ :kbd:`D`. +Fish includes basic built-in debugging facilities that allow you to stop execution of a script at an arbitrary point. When this happens you are presented with an interactive prompt where you can execute any fish command to inspect or change state (there are no debug commands as such). For example, you can check or change the value of any variables using :doc:`printf ` and :doc:`set `. As another example, you can run :doc:`status print-stack-trace ` to see how the current breakpoint was reached. To resume normal execution of the script, simply type :doc:`exit ` or :kbd:`ctrl-d`. To start a debug session simply insert the :doc:`builtin command ` ``breakpoint`` at the point in a function or script where you wish to gain control, then run the function or script. Also, the default action of the ``TRAP`` signal is to call this builtin, meaning a running script can be actively debugged by sending it the ``TRAP`` signal (``kill -s TRAP ``). There is limited support for interactively setting or modifying breakpoints from this debug prompt: it is possible to insert new breakpoints in (or remove old ones from) other functions by using the ``funced`` function to edit the definition of a function, but it is not possible to add or remove a breakpoint from the function/script currently loaded and being executed. diff --git a/doc_src/python_docs_theme/static/pydoctheme.css b/doc_src/python_docs_theme/static/pydoctheme.css index 8bb1033a1..efbfd8294 100644 --- a/doc_src/python_docs_theme/static/pydoctheme.css +++ b/doc_src/python_docs_theme/static/pydoctheme.css @@ -695,10 +695,6 @@ div.documentwrapper { kbd { background-color: var(--td-background); - border: 1px solid; - border-color: var(--sidebar-border-color); - border-radius: .2em; - padding: 0.1em 0.3em; } div.body a { diff --git a/doc_src/tutorial.rst b/doc_src/tutorial.rst index 7a92702a7..43f3e932a 100644 --- a/doc_src/tutorial.rst +++ b/doc_src/tutorial.rst @@ -150,7 +150,7 @@ And history too. Type a command once, and you can re-summon it by just typing a :prompt:`>` :red:`r`:gray:`sync -avze ssh . myname@somelonghost.com:/some/long/path/doo/dee/doo/dee/doo` -To accept the autosuggestion, hit :kbd:`→` (right arrow) or :kbd:`Control`\ +\ :kbd:`F`. To accept a single word of the autosuggestion, :kbd:`Alt`\ +\ :kbd:`→` (right arrow). If the autosuggestion is not what you want, just ignore it. +To accept the autosuggestion, hit :kbd:`right` (``→``) or :kbd:`ctrl-f`. To accept a single word of the autosuggestion, :kbd:`alt-right` (``→``). If the autosuggestion is not what you want, just ignore it. If you don't like autosuggestions, you can disable them by setting ``$fish_autosuggestion_enabled`` to 0:: @@ -161,12 +161,12 @@ Tab Completions A rich set of tab completions work "out of the box". -Press :kbd:`Tab` and fish will attempt to complete the command, argument, or path: +Press :kbd:`tab` and fish will attempt to complete the command, argument, or path: .. parsed-literal:: :class: highlight - :prompt:`>` :red:`/pri`:kbd:`Tab` => :command:`/private/` + :prompt:`>` :red:`/pri`:kbd:`tab` => :command:`/private/` If there's more than one possibility, it will list them: @@ -174,7 +174,7 @@ If there's more than one possibility, it will list them: .. parsed-literal:: :class: highlight - :prompt:`>` :red:`~/stuff/s`:kbd:`Tab` + :prompt:`>` :red:`~/stuff/s`:kbd:`tab` ~/stuff/script.sh :gray:`(command)` ~/stuff/sources/ :gray:`(directory)` @@ -185,8 +185,8 @@ fish can also complete many commands, like git branches: .. parsed-literal:: :class: highlight - :prompt:`>` :command:`git` :param:`merge pr`:kbd:`Tab` => :command:`git` :param:`merge prompt_designer` - :prompt:`>` :command:`git` :param:`checkout b`:kbd:`Tab` + :prompt:`>` :command:`git` :param:`merge pr`:kbd:`tab` => :command:`git` :param:`merge prompt_designer` + :prompt:`>` :command:`git` :param:`checkout b`:kbd:`tab` builtin_list_io_merge :gray:`(Branch)` builtin_set_color :gray:`(Branch)` busted_events :gray:`(Tag)` Try hitting tab and see what fish can do! @@ -356,7 +356,7 @@ The recursive wildcard ``**`` searches directories recursively:: /var/run/sntp.log -If that directory traversal is taking a long time, you can :kbd:`Control`\ +\ :kbd:`C` out of it. +If that directory traversal is taking a long time, you can :kbd:`ctrl-c` out of it. For more, see :ref:`Wildcards `.