Mercurial > hg > batmud > ggrtf
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>