changeset 1537:6ca679191afd

Add some information about configuring locales.
author Matti Hamalainen <ccr@tnsp.org>
date Thu, 18 Apr 2013 03:09:35 +0300
parents 5df2757bd628
children 15682433fd7a
files docs/manual.sgml
diffstat 1 files changed, 72 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
--- a/docs/manual.sgml	Thu Apr 18 03:09:06 2013 +0300
+++ b/docs/manual.sgml	Thu Apr 18 03:09:35 2013 +0300
@@ -633,11 +633,78 @@
 </para>
 
 <itemizedlist>
- <listitem><para>
- </para></listitem>
-
- <listitem><para>
- </para></listitem>
+ <listitem>
+  <para>
+   For Linux/UNIX, you need to have the ISO-8859-1 locale installed/configured.
+   How this is done depends on your OS distribution. For example in Debian,
+   you need to use <userinput>dpkg-reconfigure locales</userinput> and add
+   some ISO-8859-1 locale, for example <emphasis>en_US.iso88591</emphasis>.
+  </para>
+  <para>
+   On Ubuntu, things get a bit more complicated:
+  </para>
+  <itemizedlist>
+   <listitem>
+    <para>
+    Edit /var/lib/locales/supported.d/local with your favorite editor,
+    and on the last line put <userinput>en_US.ISO-8859-1 ISO-8859-1</userinput>.
+    It should look something like this:
+    </para>
+    <screen>en_US.UTF-8 UTF-8
+en_US.ISO-8859-1 ISO-8859-1</screen>
+   </listitem>
+   <listitem>
+    <para>
+    Then, run <userinput>sudo dpkg-reconfigure locales</userinput>
+    </para>
+   </listitem>
+  </itemizedlist>
+  <para>
+   On other Linux distributions and UNIX-like platoforms the methods
+   for installing locales vary. Your best bet is to
+   <ulink url="https://www.google.com/search?q=linux+install+locale+iso-8859-1">Use the Google</ulink>.
+  </para>
+  <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.
+  </para>
+  <screen>#!/bin/sh
+SAVE_LANG="$LANG"
+export LANG="en_US.ISO-8859-1"
+printf '\33]701;%s\007' $LANG
+
+/usr/bin/tf5 $*
+
+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
+   like "mytf" or rename the real TinyFugue executable as "tf5-bin" and
+   the script as "tf5", changing the script to point to tf5-bin.
+  </para>
+  <para>
+   Remember to set the script executable by changing
+   its permissions, '<emphasis>chmod 0755 /some/where/scriptfile</emphasis>'
+   should do it.
+  </para>
+  <para>
+   The idea is that you run the script instead of TF directly. The
+   script changes your current locale and forces the terminal via
+   special terminal control code to use it, and changes it back
+   after TF exits.
+  </para>
+ </listitem>
+
+ <listitem>
+  <para>
+  </para>
+ </listitem>
 </itemizedlist>
 
 </section>