Improve documentation of 'shift-select-mode'

* doc/emacs/mark.texi (Shift Selection): Document the 'permanent'
value of 'shift-select-mode'.  Add index entry for that variable.
(Bug#50954)

* etc/NEWS: Update the entry for 'shift-select-mode'.
This commit is contained in:
Eli Zaretskii 2021-10-02 09:40:44 +03:00
parent d505971894
commit a9052248da
2 changed files with 9 additions and 3 deletions

View file

@ -409,9 +409,14 @@ region by dragging the mouse, you can continue to extend the region
using shifted cursor motion commands. In either case, any unshifted using shifted cursor motion commands. In either case, any unshifted
cursor motion command deactivates the mark. cursor motion command deactivates the mark.
@vindex shift-select-mode
To turn off shift-selection, set @code{shift-select-mode} to To turn off shift-selection, set @code{shift-select-mode} to
@code{nil}. Doing so does not disable setting the mark via mouse @code{nil}. Doing so does not disable setting the mark via mouse
commands. commands. If you set @code{shift-select-mode} to the value
@code{permanent}, cursor motion keys that were not shift-translated
will not deactivate the mark, so, for example, the region set by prior
commands can be extended by shift-selection, and unshifted cursor
motion keys will extend the region set by shift-selection.
@node Disabled Transient Mark @node Disabled Transient Mark
@section Disabling Transient Mark Mode @section Disabling Transient Mark Mode

View file

@ -989,11 +989,12 @@ further tweak whether to complete or indent.
--- ---
** 'indent-tabs-mode' is now a global minor mode instead of just a variable. ** 'indent-tabs-mode' is now a global minor mode instead of just a variable.
--- +++
** New choice 'permanent' for 'shift-select-mode'. ** New choice 'permanent' for 'shift-select-mode'.
When the mark was activated by shifted motion keys, non-shifted motion When the mark was activated by shifted motion keys, non-shifted motion
keys don't deactivate the mark after customizing 'shift-select-mode' keys don't deactivate the mark after customizing 'shift-select-mode'
to 'permanent'. to 'permanent'. Similarly, the active mark will not be deactivated by
typing shifted motion keys.
+++ +++
** The "Edit => Clear" menu item now obeys a rectangular region. ** The "Edit => Clear" menu item now obeys a rectangular region.