<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-DC77555F-ADAF-5BCA-A5D6-89B8CDC69848" xml:lang="en"><title>Localisation
Overview</title><shortdesc>Overview of localisation support that is available with Symbian
platform. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<section id="GUID-D6B74179-E4D2-58C7-8052-FC4D3A8B8901"><title>Purpose</title> <p>Localisation
allows the Symbian device to handle locale-sensitive information: for example
language used and how the date and currency are displayed. This collection
makes up what Symbian platform defines as a locale. </p> <p>On Symbian platform,
the locale settings are stored in class <xref href="GUID-53299759-C2DD-3ABC-A055-9AFE7C5081C6.dita"><apiname>TLocale</apiname></xref>. </p> </section>
<section id="GUID-1FB54949-51E2-5CE5-A048-32C55B21F90A"><title>Architecture</title> <p>There
are two sets of locale settings, those that are hard-coded into the phone
and those that are stored in a <filepath>locale.dll</filepath>. The device
creator produces both the hard-coded localisation settings and the locale.dll. </p> </section>
<section id="GUID-659B3E29-4867-5051-87BE-A23189CE8F7D"><title>Description</title> <p>The
localisation API is used to set locale-sensitive information that can be changed
by the user; namely, locale, calendar settings, country code, currency format,
date and time format, numerical values and time zone information. </p> </section>
<section id="GUID-FDB7C3AB-1731-4A8B-878A-257529491AA5"><title>Using Localisation
Support</title> <p>The locale DLL is created by the phone manufacturer and
only the settings application provided by the UI vendor can change the settings
or values. </p> <p>The locale setup process is controlled by the <xref href="GUID-BF4C6A23-EE56-3C92-B980-9D6CB5EB4784.dita"><apiname>EStart</apiname></xref> component
and goes through three phases: </p> <ul>
<li id="GUID-F908A0E6-94B9-5481-B272-21A65EA99D29"><p>Set the hard-coded defaults, </p> </li>
<li id="GUID-7B2080BD-B4B6-5668-8B65-8604C5017A6B"><p>Load the locale from
the HAL settings and load the required locale, and </p> </li>
<li id="GUID-41FF6A2A-90D7-53F0-BBCD-F75089EB0111"><p>Request update notifications </p> </li>
</ul> <p>The device creator produces both the hard-coded values and the <filepath>locale.dll</filepath>. </p> <p>The
locale DLL files are named on the pattern <filepath>eloc1.XYZ</filepath>,
where <codeph>XYZ</codeph> is the language number as defined by <xref href="GUID-698538DF-DCDC-347B-BD32-DD9EB896BAFB.dita"><apiname>TLanguage</apiname></xref> enumeration
defined in <filepath>e32lang.h</filepath>. </p> </section>
</conbody><related-links>
<link href="GUID-C497F36F-BCA8-569D-826A-64EAD75C887C.dita"><linktext>Locale Settings
                Overview</linktext></link>
<link href="GUID-80698E62-E310-59CA-A524-5CF44C437BE4.dita"><linktext>Base Starter</linktext>
</link>
</related-links></concept>