From 99aa97616b14200d984dde52b30ba10f994fcb5d Mon Sep 17 00:00:00 2001 From: David Griffith Date: Wed, 4 Sep 2019 02:14:25 -0700 Subject: [PATCH] Update manpages for dumb and curses frotz with Unicode info. --- doc/dfrotz.6 | 20 ++++++++++++++++++++ doc/frotz.6 | 14 ++++++++++++++ 2 files changed, 34 insertions(+) diff --git a/doc/dfrotz.6 b/doc/dfrotz.6 index b34a337..7de24a7 100644 --- a/doc/dfrotz.6 +++ b/doc/dfrotz.6 @@ -415,6 +415,26 @@ A blank line emitted as part of span compression. (blank) Any other output line. +.SH UNICODE +.B Dumb Frotz +supports Unicode glyphs by way of UTF-8 if the terminal used supports +UTF-8. If you prefer using xterm, start it as uxterm. This is a +wrapper script that sets up xterm with UTF-8 locale. You can also +manually tell an xterm to switch into UTF-8 mode by holding CTRL and the +right mouse button to bring up the VT FONTS menu. Depending on how +xterm was installed, you may see an option for "UTF-8 Fonts" which will +allow Unicode to be properly displayed. + +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. + +If you are using some sort of wrapper around +.B dfrotz, +and want to make use of Unicode, it is the responsibility of the wrapper +to make sense of characters passed back and forth. + + .SH ENVIRONMENT Unlike it's curses-using sibling, .B dfrotz diff --git a/doc/frotz.6 b/doc/frotz.6 index 8c211b6..bfedb3d 100644 --- a/doc/frotz.6 +++ b/doc/frotz.6 @@ -554,6 +554,20 @@ Watch object movement. This option enables debugging messages from the interpreter which describe the movement of objects in the object tree. Default is "off". +.SH UNICODE +.B Frotz +supports Unicode glyphs by way of UTF-8 if the terminal used supports +UTF-8. If you prefer using xterm, start it as uxterm. This is a +wrapper script that sets up xterm with UTF-8 locale. You can also +manually tell an xterm to switch into UTF-8 mode by holding CTRL and the +right mouse button to bring up the VT FONTS menu. Depending on how +xterm was installed, you may see an option for "UTF-8 Fonts" which will +allow Unicode to be properly displayed. + +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. + .SH ENVIRONMENT If the ZCODE_PATH environmental variable is defined, frotz will search -- 2.34.1