|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE task |
|
11 PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd"> |
|
12 <task id="GUID-1B93FFF8-5DDD-491F-86F5-5246B321D3C2-GENID-1-12-1-12-1-1-8-1-5-1-5-1" xml:lang="en"><title>Updating |
|
13 System TZ Data Using Software Installation</title><prolog><metadata><keywords/></metadata></prolog><taskbody> |
|
14 <context id="GUID-115F9FEC-AAE7-4DAB-9490-261BDA7CA4B6-GENID-1-12-1-12-1-1-8-1-5-1-5-1-2-1"> <p>This tutorial |
|
15 describes how to update System TZ Data.</p><p>A client may need to update |
|
16 the system time zone database as changes in existing time zone rules are introduced. |
|
17 An example is the recent change in DST (daylight saving time) start and end |
|
18 times in North America. </p><p>If there are new time zones in the updated |
|
19 TZ database, the update also needs to include localization data for these |
|
20 time zones. </p><p>There may also be a need to make changes to existing |
|
21 time zones’ localization data. Examples of this include the correction of |
|
22 typographic errors and reflecting city name changes. Notable city name changes |
|
23 include Peking to Beijing and Leningrad to Saint Petersburg. </p><p>To update |
|
24 system TZ data a client must create a SIS (Symbian installation) file that |
|
25 contains the updated TZ database. </p><p>Create a Symbian Installation (SIS) |
|
26 file that contains the updated TZ database. The SIS file may also contain |
|
27 TZ localization resources. To create a SIS file you need to write a PKG (package) |
|
28 file, which is a normal text file with the extension <codeph>.pkg</codeph>. |
|
29 Example content of this file is given in the following steps:</p></context> |
|
30 <steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-12-1-12-1-1-8-1-5-1-5-1-2-2"> |
|
31 <step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-12-1-12-1-1-8-1-5-1-5-1-2-2-1"><cmd>Specify a language. |
|
32 An example is English.</cmd> |
|
33 <stepxmp><p><codeblock xml:space="preserve">&EN</codeblock></p></stepxmp> |
|
34 </step> |
|
35 <step id="GUID-3100AA24-CEA9-47EC-9C8F-B12A701C4FD5-GENID-1-12-1-12-1-1-8-1-5-1-5-1-2-2-2"><cmd>Set a header.</cmd> |
|
36 <stepxmp><p><codeblock xml:space="preserve">#{"System TZ Data Update"}, (0x200020B0), 1, 1, 0, TYPE=SP</codeblock></p></stepxmp> |
|
37 </step> |
|
38 <step id="GUID-37445712-0B81-4F31-AF3C-DA43DB7D4670-GENID-1-12-1-12-1-1-8-1-5-1-5-1-2-2-3"><cmd>Specify the vendor. (This is Symbian):</cmd> |
|
39 <stepxmp><p><codeblock xml:space="preserve">%{"Symbian Software Ltd."} |
|
40 :"Symbian Software Ltd." |
|
41 </codeblock></p></stepxmp> |
|
42 </step> |
|
43 <step id="GUID-9208FDAF-7774-412A-9371-00EC964E297F-GENID-1-12-1-12-1-1-8-1-5-1-5-1-2-2-4"><cmd>Define local files and the target location to be updated (eclipsed).</cmd> |
|
44 <stepxmp><p><codeblock xml:space="preserve">"..\data\tzdb.dbz"-"$:\private\1020383E\tzdb.dbz" |
|
45 "..\data\tz.r01 "-"$:\resource\timezonelocalization\timezones.r01" |
|
46 "..\data\tzg.r01"-"$:\resource\timezonelocalization\timezonegroups.r01" |
|
47 "..\data\tz.r02 "-"$:\resource\timezonelocalization\timezones.r02" |
|
48 "..\data\tzg.r02"-"$:\resource\timezonelocalization\timezonegroups.r02"</codeblock></p></stepxmp> |
|
49 <info><p>The sample includes the TZ database and two sets of TZ localization |
|
50 resources files, one for English (<codeph>*.r01</codeph>) and one for French |
|
51 (<codeph>*.r02</codeph>). </p><p>The PKG file can reference one TZ database. |
|
52 The TZ database may be omitted if the update does not require any changes |
|
53 to the TZ rules within the TZ database. </p><p>The PKG file can reference |
|
54 any number of sets of TZ localization resources. These resources may be omitted |
|
55 if the update does not require any changes to the TZ localization strings. |
|
56 </p><p>For information on building SIS files from PKG files see <xref href="GUID-ED2D5BEA-AD2A-51CE-8CBC-8B5E33DD6356.dita">Secure |
|
57 Software Install SIS Tools</xref>. </p></info> |
|
58 </step> |
|
59 </steps> |
|
60 </taskbody><related-links> |
|
61 <linklist> |
|
62 <link href="GUID-100F41B4-67BE-5978-99DA-C9B6DE8760F7.dita"><linktext>Secure Software |
|
63 Install SIS Tools Reference</linktext></link> |
|
64 <link href="GUID-43B4B4E7-413E-5D18-811C-4B9E38CDEB69.dita"><linktext>Package file |
|
65 format</linktext></link> |
|
66 </linklist> |
|
67 </related-links></task> |