procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve documentation of <Delete> in user manual

Browse source 
* doc/emacs/basic.texi (Erasing): Document that <Delete> deletes
entire grapheme clusters.
This commit is contained in:
Eli Zaretskii 2024-03-25 21:49:55 +02:00
parent 9d3d77f12d
commit 38faacf353
1 changed files with 9 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
doc/emacs/basic.texi
View file

@ -406,8 +406,8 @@ Delete the character before point, or the region if it is active
(@code{delete-backward-char}). (@code{delete-backward-char}).
@item @key{Delete} @item @key{Delete}
Delete the character after point, or the region if it is active Delete the character or grapheme cluster after point, or the region if
(@code{delete-forward-char}). it is active (@code{delete-forward-char}).
@item C-d @item C-d
Delete the character after point (@code{delete-char}). Delete the character after point (@code{delete-char}).
@ -438,11 +438,18 @@ with the @key{Delete} key; we will discuss @key{Delete} momentarily.)
On some text terminals, Emacs may not recognize the @key{DEL} key On some text terminals, Emacs may not recognize the @key{DEL} key
properly. @xref{DEL Does Not Delete}, if you encounter this problem. properly. @xref{DEL Does Not Delete}, if you encounter this problem.
@cindex grapheme cluster, deletion
@cindex delete entire grapheme cluster
The @key{Delete} (@code{delete-forward-char}) command deletes in the The @key{Delete} (@code{delete-forward-char}) command deletes in the
opposite direction: it deletes the character after point, i.e., the opposite direction: it deletes the character after point, i.e., the
character under the cursor. If point was at the end of a line, this character under the cursor. If point was at the end of a line, this
joins the following line onto this one. Like @kbd{@key{DEL}}, it joins the following line onto this one. Like @kbd{@key{DEL}}, it
deletes the text in the region if the region is active (@pxref{Mark}). deletes the text in the region if the region is active (@pxref{Mark}).
If the character after point is composed with following characters and
displayed as a single display unit, a so-called @dfn{grapheme cluster}
representing the entire sequence, @key{Delete} deletes the entire
sequence in one go. This is in contrast to @key{DEL} which always
deletes a single character, even if the character is composed.
@kbd{C-d} (@code{delete-char}) deletes the character after point, @kbd{C-d} (@code{delete-char}) deletes the character after point,
similar to @key{Delete}, but regardless of whether the region is similar to @key{Delete}, but regardless of whether the region is