GENERAL
=======

In KDE we support localization of calendars, dates, time, numbers and
money. KDE will use this when displaying such information, giving you
a feeling that KDE was written to fit your national standards. To make
this possible, we need to gather some information on your national
standards. Currently there are some 231 countries supported. If your
country is missing, please let us know.

The official ISO codes unsupported as at 18/11/2008 are:

    * AQ Antarctica
    * BL Saint Barthelemy
    * BV Bouvet Island
    * GG Guernsey
    * GS South Georgia and the South Sandwich Islands
    * HM Heard Island and MacDonald Islands
    * IM Isle of Man
    * IO British Indian Ocean Territory
    * JE Jersey
    * MF Saint Martin
    * MP Northern Mariana Islands
    * SJ Svalbard and Jan Mayen
    * TF French Southern Territories
    * UM United States Minor Outlying Islands

Of these, the following codes are likely to be considered for support:

    * BL Saint Barthelemy
    * GG Guernsey
    * IM Isle of Man
    * JE Jersey
    * MF Saint Martin
    * MP Northern Mariana Islands
    * SJ Svalbard and Jan Mayen

The other codes are unlikely to be considered due to lack of population.

HOW TO ADD INFORMATION
======================
First you have to write a file called "entry.desktop". This file will
describe your national standards. Please read the section below for
more information on that. Please use the file "country.template" as
template.

You will need a nice flag for your country. The size should be 21x14
pixels, and it should be called "flag.png".

To add your information, we need a two letter country code for you country.
Use http://www.iso.org/iso/country_codes/ or the entities.csv document in
this folder as a guide.

Now you are done, and you can submit the files to KDE project by adding a wish
item on bugs.kde.org under Product kdelibs Componant KLocale. The files will be
added in the next release.

WHAT IS ENTRY.DESKTOP
=====================
entry.desktop is a file which defines a locale for a country. It's
stored the same way as the rest of the KDE configuration files. The
very first line should only contain "[KCM Locale]". The rest of the
file should contain one line for each of the entries below. Add "="
between the entry name and the value.

* Author
	The name of the email address to reach you.

	Default: blank

* Name
	The name of the country in English.

	Default: blank

* Region

    Defines which submenu the country belongs to. Currently there are 20 different regions
    conforming to the United Nations statistical regions, excluding the Oceania sub-divisions,
    but adding Central Europe. See http://unstats.un.org/unsd/methods/m49/m49regin.htm for details.

        centralasia    (Central Asia)
        eastasia       (East Asia)
        southasia      (South Asia)
        southeastasia  (South-East Asia)
        middleeast     (Middle-East/West Asia)
        centralafrica  (Central Africa)
        northafrica    (Northern Africa)
        southafrica    (Southern Africa)
        westafrica     (Western Africa)
        eastafrica     (Eastern Africa)
        easteurope     (Eastern Europe)
        westeurope     (Western Europe)
        southeurope    (Southern Europe)
        northeurope    (Northern Europe)
        centraleurope  (Central Europe)
        northamerica   (North America)
        southamerica   (South America)
        centralemarica (Central America)
        caribbean      (Caribbean)
        oceania        (Oceania)

	Default: blank

* Languages
	A comma separated list of locale codes for the official languages
	of the country.

	Default: blank

* DecimalSymbol
	The symbol that separates the decimals from the rest of the
	number.

	Default: "."

* DecimalPlaces
    The number of decimal places to display in a formatted number

    Default: 2

* ThousandsSeparator
	Thousands separator.

	Default: ","

* DigitSet
	The set of digits used to display numbers.

	0 Arabic
	1 Arabic-Indic
	2 Eastern Arabic-Indic
	3 Devenagari

	Default: 0


* CurrencyCode
    The ISO Code of the primary currency used in the country.

    Default: "USD"

* CurrencyCodesInUse
    A list of ISO Codes of all the currencies used in the country.

    Default: "USD"

* MonetaryDecimalSymbol
	The symbol that separates the decimals from the rest of the number
	when displaying.

	Default: "."

* MonetaryDecimalPlaces
    The number of decimal places to display in a formatted money amount

    Default: 2

* MonetaryThousandsSeparator
	Thousands separator for money.

	Default: ","

* MonetaryDigitSet
	The set of digits used to display money amounts.

	See DigitSet for possible values.

	Default: 0

* PositiveSign
	Positive sign for money.
	Note: this will be used for formatting numbers. Do not add "+" if
	      you don't really want numbers to be formatted that way.

	Default: ""

* NegativeSign
	Negative sign for money.

	Default: "-"

* PositivePrefixCurrencySymbol
	If currency symbol should be prepended (if not, it will be
	appended). This is for non-negative money values.

	Default: true

* NegativePrefixCurrencySymbol
	If currency symbol should be prepended (if not, it will be
	appended). This is for negative money values.

	Default: true

* PositiveMonetarySignPosition
	Defines which type and where the sign (if it's positive or
	negative) should be placed. This is for non-negative money values.

	0 ParensAround
	1 BeforeQuantityMoney
	2 AfterQuantityMoney
	3 BeforeMoney
	4 AfterMoney

	Default: 1

* NegativeMonetarySignPosition
	Same as PositiveMonetarySignPosition, but for negative numbers.

	Default: 0

* DateFormat[language code]
	This defines how a date is formated. The date string will be
    contructed from this string and the sequences below will be
    replaced. This should be marked with a language code as well for
    each supported language.

	%Y The year with century as a decimal number.
	%y The year without century as a decimal number (00-99).
	%m The month as a decimal number (01-12).
	%n The month as a decimal number (1-12).
	%b The national representation of the abbreviated month name,
	   where the abbreviation is the first three characters.
	%B The national representation of the full month name.
	%d The day of month as a decimal number (01-31).
	%e The day of month as a decimal number (1-31).
	%a The national representation of the abbreviated weekday name,
	   where the abbreviation is the first three characters.
	%A The national representation of the full weekday name.

	Default: "%A %d %B %Y"

* DateFormatShort
	This is the same as DateFormat, but is used when the program asks
	for a short date. Usally this is used when listing files etc.

	Default: "%Y-%m-%d"

* TimeFormat
	This defines how a times are formated. The date string will be
    contructed from this string and the sequences below will be
    replaced.

	%H The hour as a decimal number using a 24-hour clock (range 00 to
		   23).
	%k The hour (24-hour clock) as a decimal number (range 0 to 23).
	%I The hour as a decimal number using a 12-hour clock (range 01 to
           12).
	%l The hour (12-hour clock) as a decimal number (range 1 to 12).
	%M The minute as a decimal number (range 00 to 59).
	%S The second as a decimal number (range 00 to 59).
	%p Either AM or PM according to the given time value. AM or PM are
           translating to the current language. Noon is treated as PM
           and midnight as AM.

	Default: "%H:%M:%S"

* DateTimeDigitSet
	The set of digits used to display date and time numbers.

	See DigitSet for possible values.

	Default: 0

* WeekStartDay
	This defines which day is the first of the week. Accepted value is
	an integer number where 1 means Monday, 2 Tuesday, and so on.

	Default: 1

* WorkingWeekStartDay
	This defines which day is the first working day of the week. Accepted
	value is an integer number where 1 means Monday, 2 Tuesday, and so on.

	Default: 1

* WorkingWeekEndDay
	This defines which day is the last working day of the week. Accepted
	value is an integer number where 1 means Monday, 2 Tuesday, and so on.

	Default: 5

* WeekDayOfPray
	This defines which day is the day of the week for religious observance.
	Accepted value is an integer number where 1 means Monday, 2 Tuesday,
	and so on. A special value of 0 means no day of religious observance.

	Default: 7

* MeasureSystem
	This defines which measure system we should use. There are two
	values here, 0 for Metric and 1 for Imperial. Metric would give
	you meters (or cm/mm), while Imperial would give you inches.

	Default: 0

* PageSize
	This defines which page size we should use by default. It should
	be the number of the item in the QPrinter::PageSize enum. Here are
	some values:

	0	A4
	1	B5
	2	US Letter
	...and so on

	Default: 0

* CalendarSystem
	This defines which calendar system to use. Available systems are:

	gregorian
	hebrew
	hijri
	jalali
    indian-national
    ethiopian
    coptic

	Default: gregorian

* AddressFormat
* BusinessAddressFormat
* AddressCountryPosition
	These fields define the formatting of postal addresses. For
	detailled information on these fields' format, please refer to
	kdepimlibs/kabc/README.AddressFormat

Hans Petter Bieker <bieker@kde.org>
Lukas Tinkl <lukas@kde.org>
John Layt <john@layt.net>
