Talk about locale for getting proper UTF-8 support in curses and dumb.

diff --git a/doc/dfrotz.6 b/doc/dfrotz.6
index 7de24a79feb0990d418af392d068188455d99c0e..ad9779880789f94b3327fafea7f3b4a6d2ab9181 100644 (file)
--- a/doc/dfrotz.6
+++ b/doc/dfrotz.6
@@ -435,6 +435,42 @@ and want to make use of Unicode, it is the responsibility of the wrapper
 to make sense of characters passed back and forth.
 
 
+.SS LOCALE
+An important means of ensuring the system knows to use UTF-8 is to make
+sure the locale is set appropriately.  This is valid only when
+.B Dumb Frotz
+runs under Unix-ish systems.
+
+Using the command
+.B "locale"
+will tell you what is currently in use.  Using
+.B "locale -a"
+
+will show you what's available.  Then set your LANG evironmental
+variable to something appropriate by using one of these commands:
+
+    export LANG=C.UTF-8
+    export LANG=en_US.utf8
+
+This can be put in your shell configuration file, be it
+.B .profile,
+.B .bash_profile,
+.B .login,
+.B .bashrc,
+or whatever.
+
+It can also be set system-wide in the equivalent files in
+.B /etc.
+
+.SS SEE ALSO
+.B ash(1)
+.B bash(1)
+.B csh(1)
+.B ksh(1)
+.B sh(1)
+.B zsh(1)
+
+
 .SH ENVIRONMENT
 Unlike it's curses-using sibling,
 .B dfrotz

diff --git a/doc/frotz.6 b/doc/frotz.6
index bfedb3d527678eb536bfdef0faac3dbd7b8210cb..46df087642384c2cfa96db3f1c6209fd4c902dca 100644 (file)
--- a/doc/frotz.6
+++ b/doc/frotz.6
@@ -568,6 +568,41 @@ Getting normal xterm to behave like this all the time can vary from
 system to system.  Other terminal emulators have their own ways of being
 set to use UTF-8 character encoding.
 
+.SS LOCALE
+An important means of ensuring the system knows to use UTF-8 is to make
+sure the locale is set appropriately.  This is valid only when
+.B Dumb Frotz
+runs under Unix-ish systems.
+
+Using the command
+.B "locale"
+will tell you what is currently in use.  Using
+.B "locale -a
+
+will show you what's available.  Then set your LANG evironmental
+variable to something appropriate by using one of these commands:
+
+    export LANG=C.UTF-8
+    export LANG=en_US.utf8
+
+This can be put in your shell configuration file, be it
+.B .profile,
+.B .bash_profile,
+.B .login,
+.B .bashrc,
+or whatever.
+
+It can also be set system-wide in the equivalent files in
+.B /etc.
+
+.SS SEE ALSO
+.B ash(1)
+.B bash(1)
+.B csh(1)
+.B ksh(1)
+.B sh(1)
+.B zsh(1)
+
 
 .SH ENVIRONMENT
 If the ZCODE_PATH environmental variable is defined, frotz will search