diff --git a/ChangeLog b/ChangeLog
index d602687cd..2ed56132a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2005-12-18 Peter Stephenson
+
+ * 22095: INSTALL, Etc/FAQ.yo: more multibyte notes.
+
2005-12-17 Wayne Davison
* 22091: Src/hist.c: improved HIST_SAVE_BY_COPY to have it (1)
diff --git a/Etc/FAQ.yo b/Etc/FAQ.yo
index 4d098e840..7463b085a 100644
--- a/Etc/FAQ.yo
+++ b/Etc/FAQ.yo
@@ -2071,7 +2071,25 @@ sect(How do I ensure multibyte input works on my system?)
it() The terminal emulator. Those that are supplied with a recent
desktop environment, such as gnome-terminal, are likely to have
extensive support for localization and may work correctly as soon
- as they know the locale.
+ as they know the locale. You can enable UTF-8 support for
+ tt(xterm) in its application defaults file. The following are
+ the relevant resources; you donʼt actually need all of them, as
+ described below. If you use a mytt(~/.Xdefaults) or
+ mytt(~/.Xresources) file for setting resources, prefix all the lines
+ with mytt(xterm):
+ verb(
+ *wideChars: true
+ *locale: true
+ *utf8: 1
+ *vt100Graphics: true
+ )
+ This turns on support for wide characters (this is enabled by the
+ tt(utf8) resource, too); enables conversions to UTF-8 from other
+ locales (this is the key resource and actually overrides
+ mytt(utf8)); turns on UTF-8 mode (this resource is mostly used to
+ force use of UTF-8 characters if your locale system isnʼt up to it);
+ and allows certain graphic characters to work even with UTF-8
+ enabled. (Thanks to Phil Pennock for suggestions.)
it() The font. If you selected this from a menu in your terminal
emulator, there's a good chance it already selected the right
character set to go with it. If you hand-picked an old fashioned
diff --git a/INSTALL b/INSTALL
index a7635e12e..cb6f79627 100644
--- a/INSTALL
+++ b/INSTALL
@@ -276,12 +276,14 @@ be appreciated. The developers are not aware of any need to use
multibyte mode is believed to work automatically on:
- All(?) current GNU/Linux distributions
- - All(?) current BSD variants
- - OS X 10.4.3
and to work when configured with --enable-multibyte on:
- - Solaris 8 and later
+ - OS X 10.4.3 (problems have been reported with multibyte characters
+ in HFS file names)
+ - NetBSD 2.0.2
+
+Any help with Solaris 8 or 9 would be appreciated.
The main shell is not yet aware of multibyte characters, so for example the
length of a scalar parameter will return the number of bytes, not