Decode keyboard input as latin-1 whenever appropriate

* src/keyboard.c (kbd_buffer_get_event_1): Use `coding'
property if present.

* src/termhooks.h (enum event_kind): Document meaning of
`coding' property on text strings.

* src/xterm.c (handle_one_xevent): Set coding property on text
to latin-1 if it was obtained with XLookupString.

1 files changed, 11 insertions, 1 deletions

diff --git a/src/termhooks.h b/src/termhooks.h
index 4276d8ac2f2..0a9ab61afab 100644
--- a/src/termhooks.h
+++ b/src/termhooks.h
@@ -90,7 +90,17 @@ enum event_kind
                                            decoded and the decoded
                                            string's characters will be
                                            used as .code
-                                           individually.  */
+                                           individually.
+
+                                           The string can have a
+                                           property `coding', which
+                                           should be a symbol
+                                           describing a coding system
+                                           to use to decode the string.
+
+                                           If it is nil, then the
+                                           locale coding system will
+                                           be used.  */
   NON_ASCII_KEYSTROKE_EVENT,    /* .code is a number identifying the
                                    function key.  A code N represents
                                    a key whose name is