diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 2a1eeec0a..4ca898f6f 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -101,7 +101,7 @@ Scripting improvements Interactive improvements ------------------------ - If the terminal definition for $TERM can't be used, 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`). -- The new environment variable ``$fish_cursor_selection_mode`` can be used to configure whether the command line selection includes (``inclusive``) the character under the cursor or not (``exclusive``). The new default is ``exclusive``. Use ``set fish_cursor_selection_mode inclusive`` to get the previous behavior back (:issue:`7762`, :issue:`9262`). +- 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`, :issue:`9262`). - 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`). - ``bind`` output is now syntax-highlighted when used interacively. - The :kbd:`Alt-H` binding will now show the manpage of the command under cursor instead of the always skipping ``sudo`` and the likes (:issue:`9020`). diff --git a/doc_src/interactive.rst b/doc_src/interactive.rst index 9123ea025..62e64a636 100644 --- a/doc_src/interactive.rst +++ b/doc_src/interactive.rst @@ -534,7 +534,7 @@ In addition, when pasting inside single quotes, pasted single quotes and backsla Kill ring entries are stored in ``fish_killring`` variable. The commands ``begin-selection`` and ``end-selection`` (unbound by default; used for selection in vi visual mode) control text selection together with cursor movement commands that extend the current selection. -The configuration setting ``$fish_cursor_selection_mode`` can be used to configure if that selection should include the character under the cursor (``inclusive``) or not (``exclusive``). The default is ``exclusive``, which works well with any cursor shape. For vi mode, and particularly for the ``block`` or ``underscore`` cursor shapes you may prefer ``inclusive``. +The variable :envvar:`fish_cursor_selection_mode` can be used to configure if that selection should include the character under the cursor (``inclusive``) or not (``exclusive``). The default is ``exclusive``, which works well with any cursor shape. For vi mode, and particularly for the ``block`` or ``underscore`` cursor shapes you may prefer ``inclusive``. .. [#] These rely on external tools. Currently xsel, xclip, wl-copy/wl-paste and pbcopy/pbpaste are supported. diff --git a/doc_src/language.rst b/doc_src/language.rst index 189fdd736..194e93fcb 100644 --- a/doc_src/language.rst +++ b/doc_src/language.rst @@ -1351,6 +1351,10 @@ You can change the settings of fish by changing the values of certain variables. determines where fish looks for completion. When trying to complete for a command, fish looks for files in the directories in this variable. +.. envvar:: fish_cursor_selection_mode + + controls whether the selection is inclusive or exclusive of the character under the cursor (see :ref:`Copy and Paste `). + .. envvar:: fish_function_path determines where fish looks for functions. When fish :ref:`autoloads ` a function, it will look for files in these directories.