docs: Capitalize all keystroke characters

This commit is contained in:
Charles Gould 2020-03-20 00:36:10 -05:00 committed by Fabian Homborg
parent 0bb923dcec
commit fb6257ebc3
3 changed files with 27 additions and 27 deletions

View file

@ -20,7 +20,7 @@ Description
``bind`` adds a binding for the specified key sequence to the specified command. ``bind`` adds a binding for the specified key sequence to the specified command.
SEQUENCE is the character sequence to bind to. These should be written as :ref:`fish escape sequences <escapes>`. For example, because pressing the Alt key and another character sends that character prefixed with an escape character, Alt-based key bindings can be written using the ``\e`` escape. For example, :kbd:`Alt` + :kbd:`w` can be written as ``\ew``. The control character can be written in much the same way using the ``\c`` escape, for example :kbd:`Control` + :kbd:`X` (^X) can be written as ``\cx``. Note that Alt-based key bindings are case sensitive and Control-based key bindings are not. This is a constraint of text-based terminals, not ``fish``. SEQUENCE is the character sequence to bind to. These should be written as :ref:`fish escape sequences <escapes>`. For example, because pressing the Alt key and another character sends that character prefixed with an escape character, Alt-based key bindings can be written using the ``\e`` escape. For example, :kbd:`Alt` + :kbd:`W` can be written as ``\ew``. The control character can be written in much the same way using the ``\c`` escape, for example :kbd:`Control` + :kbd:`X` (^X) can be written as ``\cx``. Note that Alt-based key bindings are case sensitive and Control-based key bindings are not. This is a constraint of text-based terminals, not ``fish``.
The default key binding can be set by specifying a ``SEQUENCE`` of the empty string (that is, ``''`` ). It will be used whenever no other binding matches. For most key bindings, it makes sense to use the ``self-insert`` function (i.e. ``bind '' self-insert``) as the default keybinding. This will insert any keystrokes not specifically bound to into the editor. Non- printable characters are ignored by the editor, so this will not result in control sequences being printable. The default key binding can be set by specifying a ``SEQUENCE`` of the empty string (that is, ``''`` ). It will be used whenever no other binding matches. For most key bindings, it makes sense to use the ``self-insert`` function (i.e. ``bind '' self-insert``) as the default keybinding. This will insert any keystrokes not specifically bound to into the editor. Non- printable characters are ignored by the editor, so this will not result in control sequences being printable.

View file

@ -14,7 +14,7 @@ Synopsis
Description Description
----------- -----------
``cdh`` with no arguments presents a list of 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. If you give it a single argument it is equivalent to ``cd directory``. ``cdh`` with no arguments presents a list of 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. 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. The history is stored in the ``$dirprev`` and ``$dirnext`` variables which this command manipulates. If you make those universal variables your ``cd`` history is shared among all fish instances. Note that the ``cd`` command limits directory history to the 25 most recently visited directories. The history is stored in the ``$dirprev`` and ``$dirnext`` variables which this command manipulates. If you make those universal variables your ``cd`` history is shared among all fish instances.

View file

@ -1313,21 +1313,21 @@ Some bindings are shared between emacs- and vi-mode because they aren't text edi
- :kbd:`Control` + :kbd:`X` copies the current buffer to the system's clipboard, :kbd:`Control` + :kbd:`V` inserts the clipboard contents. - :kbd:`Control` + :kbd:`X` copies the current buffer to the system's clipboard, :kbd:`Control` + :kbd:`V` inserts the clipboard contents.
- :kbd:`Alt` + :kbd:`d` moves the next word to the `killring <#killring>`__. - :kbd:`Alt` + :kbd:`D` moves the next word to the `killring <#killring>`__.
- :kbd:`Alt` + :kbd:`h` (or :kbd:`F1`) shows the manual page for the current command, if one exists. - :kbd:`Alt` + :kbd:`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` + :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` + :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` + :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` + :kbd:`w` prints a short description of the command under the cursor. - :kbd:`Alt` + :kbd:`W` prints a short description of the command under the cursor.
- :kbd:`Alt` + :kbd:`e` edit 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:`E` edit 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` + :kbd:`V` Same as :kbd:`Alt` + :kbd:`E`.
- :kbd:`Alt` + :kbd:`s` Prepends `sudo` to the current commandline. - :kbd:`Alt` + :kbd:`S` Prepends `sudo` to the current commandline.
.. _emacs-mode: .. _emacs-mode:
@ -1346,13 +1346,13 @@ Emacs mode commands
- :kbd:`Control` + :kbd:`K` moves contents from the cursor to the end of line to the `killring <#killring>`__. - :kbd:`Control` + :kbd:`K` moves contents from the cursor to the end of line to the `killring <#killring>`__.
- :kbd:`Alt` + :kbd:`c` capitalizes the current word. - :kbd:`Alt` + :kbd:`C` capitalizes the current word.
- :kbd:`Alt` + :kbd:`u` makes the current word uppercase. - :kbd:`Alt` + :kbd:`U` makes the current word uppercase.
- :kbd:`Control` + :kbd:`t` transposes the last two characters - :kbd:`Control` + :kbd:`T` transposes the last two characters
- :kbd:`Alt` + :kbd:`t` transposes the last two words - :kbd:`Alt` + :kbd:`T` transposes the last two words
- :kbd:`Control` + :kbd:`_` (:kbd:`Control` + :kbd:`/` on some terminals) undoes the most recent edit of the line - :kbd:`Control` + :kbd:`_` (:kbd:`Control` + :kbd:`/` on some terminals) undoes the most recent edit of the line
@ -1408,27 +1408,27 @@ Command mode
Command mode is also known as normal mode. Command mode is also known as normal mode.
- :kbd:`h` moves the cursor left. - :kbd:`H` moves the cursor left.
- :kbd:`l` moves the cursor right. - :kbd:`L` moves the cursor right.
- :kbd:`i` enters `insert mode <#vi-mode-insert>`_ at the current cursor position. - :kbd:`I` enters `insert mode <#vi-mode-insert>`_ at the current cursor position.
- :kbd:`v` enters `visual mode <#vi-mode-visual>`_ at the current cursor position. - :kbd:`V` enters `visual mode <#vi-mode-visual>`_ at the current cursor position.
- :kbd:`a` enters `insert mode <#vi-mode-insert>`_ after the current cursor position. - :kbd:`A` enters `insert mode <#vi-mode-insert>`_ after the current cursor position.
- :kbd:`Shift,A` enters `insert mode <#vi-mode-insert>`_ at the end of the line. - :kbd:`Shift` + :kbd:`A` enters `insert mode <#vi-mode-insert>`_ at the end of the line.
- :kbd:`0` (zero) moves the cursor to beginning of line (remaining in command 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 `killring <#killring>`__. - :kbd:`D` + :kbd:`D` deletes the current line and moves it to the `killring <#killring>`__.
- :kbd:`Shift,D` deletes text after the current cursor position and moves it to the `killring <#killring>`__. - :kbd:`Shift` + :kbd:`D` deletes text after the current cursor position and moves it to the `killring <#killring>`__.
- :kbd:`p` pastes text from the `killring <#killring>`__. - :kbd:`P` pastes text from the `killring <#killring>`__.
- :kbd:`u` search history backwards. - :kbd:`U` search history backwards.
- :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 `history <#history-search>`_ section for more information on history searching. - :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 `history <#history-search>`_ section for more information on history searching.
@ -1450,9 +1450,9 @@ 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:`b` and :kbd:`w` extend the selection backward/forward by one word. - :kbd:`B` and :kbd:`W` extend the selection backward/forward by one word.
- :kbd:`d` and :kbd:`x` move the selection to the `killring <#killring>`__ and enter `command mode <#vi-mode-command>`__. - :kbd:`D` and :kbd:`X` move the selection to the `killring <#killring>`__ and enter `command mode <#vi-mode-command>`__.
- :kbd:`Escape` and :kbd:`Control` + :kbd:`C` enter `command mode <#vi-mode-command>`_. - :kbd:`Escape` and :kbd:`Control` + :kbd:`C` enter `command mode <#vi-mode-command>`_.
@ -1519,7 +1519,7 @@ Normally when ``fish`` starts a program, this program will be put in the foregro
- By ending a command with the ``&`` (ampersand) symbol, the user tells ``fish`` to put the specified command into the background. A background process will be run simultaneous with ``fish``. ``fish`` will retain control of the terminal, so the program will not be able to read from the keyboard. - By ending a command with the ``&`` (ampersand) symbol, the user tells ``fish`` to put the specified command into the background. A background process will be run simultaneous with ``fish``. ``fish`` will retain control of the terminal, so the program will not be able to read from the keyboard.
- By pressing :kbd:`Control` + :kbd:`Z`, the user stops a currently running foreground program and returns control to ``fish``. Some programs do not support this feature, or remap it to another key. GNU Emacs uses :kbd:`Control` + :kbd:`X` :kbd:`z` to stop running. - By pressing :kbd:`Control` + :kbd:`Z`, the user stops a currently running foreground program and returns control to ``fish``. Some programs do not support this feature, or remap it to another key. GNU Emacs uses :kbd:`Control` + :kbd:`X` :kbd:`Z` to stop running.
- By using the :ref:`bg <cmd-bg>` and :ref:`fg <cmd-fg>` builtin commands, the user can send any currently running job into the foreground or background. - By using the :ref:`bg <cmd-bg>` and :ref:`fg <cmd-fg>` builtin commands, the user can send any currently running job into the foreground or background.