From: Drew Adams <drew.adams@oracle.com>
To: 55756@debbugs.gnu.org
Subject: bug#55756: 26.3; Document customization of `delete-selection-mode' behavior in Emacs manual
Date: Wed, 1 Jun 2022 19:35:57 +0000 [thread overview]
Message-ID: <SJ0PR10MB5488A0D49D8A7A7FDA9D9A31F3DF9@SJ0PR10MB5488.namprd10.prod.outlook.com> (raw)
Apparently (see bug #55692), starting with Emacs 29, some text is
getting added to (emacs) `Using Region' to describe the use of new
option `delete-selection-temporary-region', and that text touts the
option as the/a way to "tune the behavior" of `delete-selection-mode'.
Whether or not such text is added, the essential design of
`deletion-selection-mode' should be documented: how to customize its
behavior for individual commands. That's missing.
The existing doc describes the behavior only partially - it describes
only the default, replace-text behavior for, e.g.,
`self-insert-command'. Other commands have very different default
behavior. More importantly, any command can have any of the predefined
behaviors the mode provides, or even an arbitrary behavior.
You don't get any `delete-selection-mode' behavior at all for a command
unless it has property `delete-selection'. That's how essential this
design is to understanding and customizing the mode.
The mode does _not_ just replace selected text - even by default for
some commands.
Just put the kind of action you want on a command symbol as property
`delete-selection'. There are basic, predefined actions, and you can
define any other action you like.
The doc says nothing about this, yet it's general, elegant, and
easy-to-customize. `delete-selection-mode' doesn't have as its aim just
to replicate behavior that you might be used to outside Emacs. The doc
should make clear what it offers.
See also https://debbugs.gnu.org/cgi/bugreport.cgi?bug=55692#32.
In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.19044
Configured using:
`configure --without-dbus --host=x86_64-w64-mingw32
--without-compress-install 'CFLAGS=-O2 -static -g3''
next reply other threads:[~2022-06-01 19:35 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-06-01 19:35 Drew Adams [this message]
2022-06-02 5:11 ` bug#55756: 26.3; Document customization of `delete-selection-mode' behavior in Emacs manual Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=SJ0PR10MB5488A0D49D8A7A7FDA9D9A31F3DF9@SJ0PR10MB5488.namprd10.prod.outlook.com \
--to=drew.adams@oracle.com \
--cc=55756@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).