These folders contain localisation ('l10n') files.  They are used to
translate words, phrases, and sentences from the native language of the
application (which is usually English) to another language.  There might
be several files like these, each file translating a different language and
a different part of the application.

If you disagree with translations in a file, or wish to send a
translation to a new language, then please submit your new file to
<translate@steambird.com> and we will attempt to investigate a superior
translation in future releases.  Thank you.


FURTHER INFORMATION FOR TRANSLATORS:

The name and location of a file indicates which part of the application
it belongs to, and which language it translate the program's text into.
For example, a file called 'misc_fr.lua' in the 'misc' folder of the 'l10n'
folder would be used for translating phrases in the application's 'misc'
module into the Franais (French) language.

The general pattern of a l10n file (for example, misc_fr.lua) is lines
like this:
E["Good morning."] = "Bonjour."
In that example, the English phrase "Good morning." when used by the
application, will be translated into "Bonjour." for the user if the
user's settings indicate that she wants the French language.

Lines in the file beginning with '--' are comments and do not require
translating.  They are there to provide hints for the translation.

The only character coding currently officially accepted is ISO-8859-1
(other similar 8-bit encodings may work on a per-font per-application basis).

When translating, punctuation should also be translated appropriately.
However, inverted commas " inside a translated phrase should be entered
as \" (there are other minor 'escaping rules'; if bitten then please see
'Literal strings' here: http://www.lua.org/manual/5.0/manual.html#2.1 )
An improperly-formatted translation file will fail to load, which will
usually cause the application to default to English.

When the English phrase contains words which look like '%s', '%d' or
similar, then these are special markers which will be replaced by other
words in the program.  These markers should be put into the translated
string in similar places in the phrase, and IN THE SAME ORDER.  (This
may cause unnatural-sounding phrases in non-English, sadly.)

A special line may be entered, of the form ...
__PARENT_LANGUAGE__ = "sv"
... to indicate that this file's translation is based upon that of
another similar language (in that example, Svenska [Swedish]).  Then,
only the phrases which differ from this other language need to be
re-translated and filled-in.
