From fb023da0fdcbfca104b39c2315a79186d7254c99 Mon Sep 17 00:00:00 2001 From: Jacob Nevins Date: Sun, 30 Apr 2017 10:42:02 +0100 Subject: [PATCH] Be less vague in the description of IUTF8. --- doc/config.but | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/doc/config.but b/doc/config.but index a7d45689..bb18b794 100644 --- a/doc/config.but +++ b/doc/config.but @@ -3006,18 +3006,19 @@ PuTTY in a variety of ways, such as \cw{true}/\cw{false}, \cw{no} is different from not sending the mode at all.) \b The boolean mode \I{IUTF8 terminal mode}\cw{IUTF8} signals to the -server whether the terminal character set is \i{UTF-8} or not. -If this is set incorrectly, keys like backspace may do the wrong thing -in some circumstances. However, setting this is not usually -sufficient to cause servers to expect the terminal to be in UTF-8 mode; -POSIX servers will generally require the locale to be set (by some -server-dependent means), although many default to UTF-8. Also, -since this mode was added to the SSH protocol much later than the -others, \#{circa 2016} many servers (particularly older servers) do -not honour this mode sent over SSH; indeed, a few poorly-written -servers object to its mere presence, so you may find you need to set -it to not be sent at all. When set to \q{Auto}, this follows the local -configured character set (see \k{config-charset}). +server whether the terminal character set is \i{UTF-8} or not, for +purposes such as basic line editing; if this is set incorrectly, +the backspace key may erase the wrong amount of text, for instance. +However, simply setting this is not usually sufficient for the server +to use UTF-8; POSIX servers will generally also require the locale to +be set (by some server-dependent means), although many newer +installations default to UTF-8. Also, since this mode was added to the +SSH protocol much later than the others, \#{circa 2016} many servers +(particularly older servers) do not honour this mode sent over SSH; +indeed, a few poorly-written servers object to its mere presence, so +you may find you need to set it to not be sent at all. When set to +\q{Auto}, this follows the local configured character set (see +\k{config-charset}). \b Terminal speeds are configured elsewhere; see \k{config-termspeed}.