As of version 0.2.1, Trash has a mechanism to support simple 
internationalization.  This file describes how to translate Trash.

INTRODUCTION
------------
In addition to the standard multiple language support of the AppInfo.xml
file, Trash supports multiple languages as well.  Because Trash is 
written in shell, the translation mechanism must necessarily be a bit
different from the standard .po files used by Python or C programs.

TRANSLATION FILES
-----------------
Trash uses simple shell scripts as translation files.  Strings are 
translated simply by setting the values of certian variables.  When 
Trash runs, it will select the appropriate file based on the LANG 
environment variable and will source it (execute it in the current 
shell)to set the variables.

The appropriate translation file is determined by the first five
characters of the LANG environment variable.  These characters are used
as a file name prefix, where the full file name is defined by 
"${LANG:0:5}-text.sh".  Thus, translation files will have names like
"it_IT-text.sh" or "pt_BR-text.sh".  If a translation file for the
current LANG cannot be found, then the default file, "C-text.sh" 
(American English), will be used.  All translation files are located in
the "text" subdirectory of the Trash AppDir.

DOING A TRANSLATION
-------------------
Because the program text is assigned to specific shell variables, the 
easiest and most reliable way to make a translation is to copy an 
existing translation file and simply change the text assigned to the 
variables.  So if, for example, you wanted to make a Brazilian Portugese
translation, you could copy $APP_DIR/text/C-text.sh to 
$APP_DIR/text/pt_BR-text.sh and simple change the text assigned to the
variables from English to Portugese.

If the language you are translating into requires any special 
environment variable to be set (e.g. to display non-ASCII characters),
you should also do this in the translation file.  Because the file is
just a shell script that is sourced by the Trash AppRun script, any 
changes to the environment will also propogate up to the main program.

**PLEASE NOTE**: If you wish to contribute a translation to be distributed
with Trash, you should include both the shell file described above and a 
copy of the AppInfo.xml with the appropriate changes.  If you do not know 
how to add a translation to the XML file, just use the Italian translation 
(the lines with xml:lang="it") as a model and add corresponding sections
for your language.
