README for the encoding of various translated files in here
===========================================================
(Updated 2004-03-25)

Maintainer: Balázs Bárány <balazs@tud.at>

Most languages use characters that aren't contained in the standard ASCII
character set. Therefore, translated files in eMoviX need to be converted to
different character sets.

0. How to recode files into a different encoding
------------------------------------------------

You can use GNU recode or iconv.
Recode is easier to use and more flexible but iconv is a part of GNU libc so
it should be installed on any recent Linux system.

sourceencoding is the one you are using normally (e.g. in West Europe,
probably iso-8859-1), destencoding is the one you need for eMoviX (e.g.
"ibm437" or "utf-8").

recode sourceencoding..destencoding files

or

iconv -f sourceencoding -t destencoding file > file.new; mv file.new file

1. Boot help files ((credits,expert*,mphelp,mxhelp,trblst*).txt; movix.msg)
---------------------------------------------------------------------------

Encoding: ibm437

Some characters like the Portuguese ă or the Hungarian ő cannot be converted
because they don't exist in the ibm437 charset. Use â or ô instead.

2. MPlayer menu (menu.conf), help (helpsub.sub, mplayer.man, menu.man)
----------------------------------------------------------------------

Encoding: utf-8

They will be shown in MPlayer with a TrueType font, so they can contain any
characters in theory (Far-East and right-to-left (e.g. Arabic, Hebrew) users,
please post in the sourceforge forum how well this works).

You can take the translated man pages from the MPlayer distribution and
convert them with the following commands:

groff -t -e -mandoc -Tascii8 -rLL=60n -rLT=60n mplayer.1 | col -bx > mplayer.man
recode sourceencoding..utf-8 mplayer.man
rm mplayer.1

3. Shell help (help.sh)
------------------------

Encoding: utf-8

This one will be shown in the Unix shell after the MPlayer menu was left.
The console is in UTF-8 mode, so this file must be also. 
Unfortunately, as the Linux console can store only 500 different characters,
only European, Cyrillic, Hebrew and Arabic characters are supported.
See http://www.tldp.org/HOWTO/Unicode-HOWTO-2.html#ss2.1 for more info and
possible solutions.

4. Progress messages (progress.sh)
----------------------------------

Encoding: iso-8859-1

This is used for the progress messages while booting. There is no UTF-8 support
in the fbtruetype utility, so it can only display iso-8859-1 characters (West
European).
