Skip to content

Commit

Permalink
fix and amend description of setting BackspaceSendsBS and its impact (#…
Browse files Browse the repository at this point in the history
  • Loading branch information
mintty committed Feb 4, 2023
1 parent 6b8d762 commit 29efabb
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 1 deletion.
8 changes: 7 additions & 1 deletion docs/mintty.1
Original file line number Diff line number Diff line change
Expand Up @@ -1745,7 +1745,13 @@ Note that the repeat rate can be adjusted dynamically by an escape sequence.
\fBBackarrow sends ^H\fP (BackspaceSendsBS=no)
By default, mintty sends \fB^?\fP (ASCII DEL) as the keycode for the backspace key.
If this option is enabled, \fB^H\fP is sent instead.
This also changes the \fBCtrl+Backspace\fP code from \fB^_\fP to \fB^?\fP.
This also changes the \fBCtrl+Backspace\fP code from \fB^H8\fP to \fB^?\fP.

\fINote:\fP This setting also causes the tty setting \fBERASE character\fP
to be aligned accordingly (see \fIman termios\fP and command \fIstty erase\fP).
Mind that this may affect certain applications, for example emacs which
cannot interpret the explicit Ctrl+h command anymore.

.br
(Corresponds to the xterm resource \fBbackarrowKey\fP.)

Expand Down
19 changes: 19 additions & 0 deletions wiki/Tips.md
Original file line number Diff line number Diff line change
Expand Up @@ -421,6 +421,13 @@ the application expects other key sequences than mintty sends.
(While mintty could be changed to send VT100 application keypad codes in
that case, the current behaviour is compatible with xterm.)

### Control+H in emacs ###

If you configure the Backarrow key to send a Backspace character rather
than the Linux default DEL character (setting `BackspaceSendsBS=yes`),
emacs will not be able to recognize an explicit Ctrl+h command anymore.
It is recommended to leave this setting at its default.

### Shift+up/down for text selection in emacs ###

The escape sequences for Shift+up/down are mapped to scroll-backward/forward
Expand Down Expand Up @@ -544,6 +551,18 @@ See the manual page for options and details about

See also the [[Keycodes]] wiki page.

### Backarrow key configuration ###

By default, mintty sends `^?` (ASCII DEL) as the keycode for the Backarrow key.
This is the Linux default (as opposed to sending `^H` which was the
default in many Unix environments).
This can be changed with setting `BackspaceSendsBS=yes`.
The tty setting `ERASE character` will be aligned accordingly
(see `man termios` and command `stty erase`).

Mind that this may affect certain applications, for example emacs which
cannot interpret the explicit Control+h command anymore.

### Windows-style copy/paste key assignments ###

If both settings `CtrlShiftShortcuts` and `CtrlExchangeShift` are enabled,
Expand Down

0 comments on commit 29efabb

Please sign in to comment.