changeset 1597:d1ea70ae13c9

Updated documentation concerning the character set/locale stuff.
author Matti Hamalainen <ccr@tnsp.org>
date Tue, 05 May 2015 19:00:26 +0300
parents 5d563bcc3a78
children e3683413d8e2
files docs/manual.sgml
diffstat 1 files changed, 15 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/docs/manual.sgml	Tue May 05 18:52:59 2015 +0300
+++ b/docs/manual.sgml	Tue May 05 19:00:26 2015 +0300
@@ -649,8 +649,21 @@
 <para>
  If your system is using some locale other than ISO-8859-1 such as UTF-8,
  you will need to make the terminal use ISO-8859-1 despite the system-global
- setting. How this is done depends on the terminal, but perhaps the easiest
- way is to use the following wrapper script for starting TinyFugue.
+ setting, or alternatively use some software like <ulink url="https://www.gnu.org/software/screen/">GNU Screen</ulink>
+ to "translate" between your system's and BatMUD's ISO-8859-1. Some
+ information about how to make GNU Screen do that, can be found
+ from this website: <ulink url="http://aperiodic.net/screen/terminal">http://aperiodic.net/screen/terminal</ulink>.
+</para>
+<para>
+ However, if you choose not to use 'screen', you will have to either
+ start your terminal program (inside which TinyFugue will run) with the
+ locale set to ISO-8859-1, OR if your terminal supports the feature,
+ use the following shell script wrapper which will use terminal
+ control codes to change the effective character translation.
+ <emphasis>This feature is not supported by all terminals, XTerm and
+ Rxvt are known to support it, however.</emphasis>
+ You will need to copy+paste the script, or download it
+ <ulink url="http://tnsp.org/~ccr/ggrtf/tf5.sh">from here</ulink>.
 </para>
 <screen>#!/bin/sh
 SAVE_LANG="$LANG"
@@ -662,8 +675,6 @@
 export LANG="$SAVE_LANG"
 printf '\33]701;%s\007' $LANG</screen>
 <para>
- You will need to copy+paste the script, or download it
- <ulink url="http://tnsp.org/~ccr/ggrtf/tf5.sh">from here</ulink>.
  You should place the script in some directory in your $PATH. You
  will also need to modify it to point to the correct TinyFugye executable,
  (e.g. change "/usr/bin/tf5" if needed.) Name the script as something