release_notes.txt

This C++ application demonstrates how to display Chinese characters from resource files. The applica

S60 Platform: Chinese Display Example v2.1
------------------------------------------

This C++ application demonstrates how to display Chinese characters, support 
internationalization and localization, and implement context-sensitive helps. The 
application supports the following languages: English, Taiwan Chinese, Taiwan English, 
Hong Kong Chinese, Hong Kong English, Mainland Chinese, and Mainland English.


-------------------------------------------------------------------------------------

PREREQUISITES

Symbian C++ basics

-------------------------------------------------------------------------------------

IMPORTANT CLASSES

TFontSpec
CCnvCharacterSetConverter

-------------------------------------------------------------------------------------

KNOWN ISSUES

The application UID must be from a protected range to be able to show the 
Context-Sensitive Help.

-------------------------------------------------------------------------------------

NOTES ON LOCALIZATION

The supported languages and their language codes are:

01 		English
029		Taiwan Chinese
157		Taiwan English
030		HongKong Chinese
158		HongKong English
031		Mainland Chinese
159		Mainland English


Note that the localization file for Chinese language (language.l31) must be in UTF-8 
format and must NOT contain the 3-byte BOM (Byte Order Marker, <0xEF><0xBB><0xBF>) 
in the beginning of the file, otherwise the compilation will fail. Some text editors 
may automatically add the UTF-8 BOM, and it must be manually removed using a hex 
editor. Note that whenever the file is modified, the above 3 characters must be 
removed again to get the file compiled.

-------------------------------------------------------------------------------------

NOTES ON CONTEXT-SENSITIVE HELP

To build the help for another language code, please rename the corresponding 
language .rtf file to "ChineseDisplay.rtf", then rebuild the project again. The newly 
generated .hlp shoud be renamed to the corresponding help file.

For example, to build help for language code "31", delete "ChineseDisplay.rtf" first, 
rename "ChineseDisplay_31.rtf" to "ChineseDisplay.rtf". Build the project. Then, rename 
"ChineseDisplay.hlp" to "ChineseDisplay.h31".

The application UID must be from a protected range to be able to show the 
Context-Sensitive Help.

-------------------------------------------------------------------------------------

RUNNING THE EXAMPLE

The example application provides three menu commands showing an info message (on the 
emulator only), a notification and launching context-sensitive help.

The example application works on Chinese and non-Chinese S60 3rd Edition devices. On 
devices supporting Chinese, both Chinese and English language resources are installed. 
Thus the application UI is displayed either in Chinese or in English depending on the 
device language in use.

-------------------------------------------------------------------------------------


BUILD & INSTALLATION INSTRUCTIONS

The source code can be compiled on the S60 3rd Edition SDKs.

Steps for building and installing the application to a device depend on the S60 
platform version:

--Mobile device (S60 3rd Edition)

	a) Go to: "<ChineseDisplay example dir>\group"

	b) Run: "bldmake bldfiles"

	c) Run: "abld build gcce urel"

	d) Go to: "<ChineseDisplay example dir>\sis

	e) Run: "makesis ChineseDisplay_30_gcce.pkg"

	f) Sign the sis package
	   See www.symbiansigned.com for information about Developer Certificates.

	g) Install the signed .sis file to a S60 3rd Edition device.


----------------------------------------------------------------------------------------

COMPATIBILITY

S60 3rd Edition
S60 3rd Edition, FP1
S60 3rd Edition, FP2

The example application is expected to work on all S60 3rd Edition devices as it provides 
both Chinese and English language resources. However, the Chinese characters can only be 
displayed on devices supporting Chinese.

Created with S60 3rd Edition, FP1 SDK.

----------------------------------------------------------------------------------------

VERSION HISTORY

v2.1	New languages added: Taiwan Chinese, Taiwan English, Hongkong English, Mainland 
English. Support for Context-sensitive Help added. Support for S60 2nd Edition dropped.

v2.0	Ported to S60 3rd Edition (also supporting S60 2nd Edition).

v1.0	Initial version supporting English and Mainland Chinese. Supports S60 2nd Edition.

----------------------------------------------------------------------------------------

EVALUATE THIS RESOURCE

Please spare a moment to help us improve documentation quality and recognize the examples 
you find most valuable, by rating this resource at 
http://www.forum.nokia.com/main/1%2C%2C90%2C00.html?surveyId=ba05733d-bc27-4080-94fd-777
ea27aadf8/S60_Platform_Chinese_Display_Example_v2_1_en.zip