--- a/Symbian3/SDK/Source/GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita Fri Jul 16 17:23:46 2010 +0100
+++ b/Symbian3/SDK/Source/GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita Tue Jul 20 12:00:49 2010 +0100
@@ -1,112 +1,112 @@
-<?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-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A" xml:lang="en"><title>Creating
-registration resource files</title><prolog><metadata><keywords/></metadata></prolog><conbody>
-
-<p>You need to register your applications
-in order to make them visible to the application menu and to provide other
-information to the underlying system. To register, you need to provide a registration
-resource file, typically named <parmname><application_name>_reg.rss</parmname>,
-that contains the non-localized information for your application. You also
-need to provide the <xref href="GUID-9F90A2F0-9C76-4871-A766-D1AE0FC42C08.dita">localizable
-registration information</xref>. The registration resource file is compiled
-during the build process and included in the <parmname>pkg</parmname> file
-used to make the <parmname>sis</parmname> installation file.</p>
-
-<p>To create a registration resource file:</p>
-<ol>
-<li id="GUID-D97F1C74-A29A-4EF1-92C1-8FBAF2EE6F2F"><p>Determine
-the requirements of your application.</p></li>
-<li id="GUID-41830892-AA07-44F7-BCEE-4FACD88932FF"><p>Create a text
-file with the name <parmname><application_name>_reg.rss</parmname>.</p>
-</li>
-<li id="GUID-7EE5ADE9-C5D4-43E0-BB94-977CB064CF2D"><p>Include the
-appropriate header files. Typically, you need to include the following files:</p>
-<itemgroup>
-<ul>
-<li><p><parmname>appinfo.rh</parmname>, which is the resource header
-file that includes the data structure declaration for the resource statement
-used in the registration resource file.</p></li>
-<li><p>compiled resource header file for the resource file with
-the symbolic ID for the<xref href="GUID-9F90A2F0-9C76-4871-A766-D1AE0FC42C08.dita"> localizable
-registration information</xref>.</p></li>
-<li><p>localization file, depending on you implementation of the
-registration resource file.</p></li>
-</ul>
-<p>For more information on pre-processor statement syntax, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/ToolsAndUtilities94/DevTools-ref/ResourceFileFormat/Tool_Ref_RSS-file-format.preprocess.html#DevTools%2dref%2erss%2e3" format="application/java-archive">C++ pre-processor statements</xref>.</p>
-</itemgroup>
-</li>
-<li id="GUID-42A15A31-6A2C-4937-9615-A128068E2F76"><p>Add a statement
-for the UID2 value for the registration resource file as follows:</p>
-<itemgroup>
-<codeblock id="GUID-A82F0146-5B48-48C8-A5F5-F200D08A6C4D" xml:space="preserve">UID2 KUidAppRegistrationResourceFile</codeblock>
-<p>UID2 always has the same value in registration resource files.</p>
-</itemgroup>
-</li>
-<li id="GUID-4C96D57D-FBA2-4BF6-A1AF-715467663A27"><p>Add a statement
-for the <xref href="GUID-EA05F9B6-52C7-4BD9-8B9A-4BA3456E70B5.dita">UID3</xref> value
-of the application as follows:</p>
-<itemgroup>
-<codeblock id="GUID-EA7F044D-2BB2-4552-B768-3248DF6DAF7F" xml:space="preserve">UID3 <uid3 value for application></codeblock>
-</itemgroup>
-</li>
-<li id="GUID-6A8002EA-AFF5-4750-833C-81ED5F355C6C"><p>Create a <parmname>APP_REGISTRATION_INFO</parmname> resource
-for your application. The definition for the registration code block is as
-follows:</p>
-<itemgroup>
-<codeblock id="GUID-EF44E298-635E-40BD-8FBE-8A6712FCA0FB" xml:space="preserve">
-RESOURCE APP_REGISTRATION_INFO
- {
- app_file = ""; // name of application binary file (not including extension) - mandatory
- attributes = 0;
- localisable_resource_file = ""; // path (not including drive) and name of localisable resource file
- localisable_resource_id = r_name36;
- hidden = KAppNotHidden;
- embeddability = KAppNotEmbeddable;
- newfile = KAppDoesNotSupportNewFile;
- launch = KAppLaunchInForeground;
- group_name(KAppMaxGroupName) = "";
- default_screen_number = 0;
- datatype_list[]; // SUPPORTED DATATYPES
- file_ownership_list[]; // FILE_OWNERSHIP_INFO
- service_list[]; // SERVICE_INFO
- opaque_data = 0; // use for opaque data to send to non-native application launchers i.e. MIDlet id
- }</codeblock>
-<p>where,</p>
-<ul>
-<li><p><parmname>app_file</parmname> indicates the name of the application
-executable binary file without the extension.</p></li>
-<li><p><parmname>localisable_resource_file</parmname> indicates
-the path and name of the localizable resource file for the application.</p>
-</li>
-<li><p><parmname>localisable_resource_id</parmname> indicates the
-symbolic name of the resource for the <xref href="GUID-9F90A2F0-9C76-4871-A766-D1AE0FC42C08.dita">localizable
-registration resource</xref>.</p></li>
-<li><p><parmname>newfile</parmname> indicates whether the application
-is document-based and supports the creation of new files. The default value
-is <parmname>KAppDoesNotSupportNewFile</parmname>.</p></li>
-<li><p><parmname>embeddability</parmname> indicates whether an application
-is embeddable.</p>
-<itemgroup>
-<p>The default value is <parmname>KAppNotEmbeddable</parmname>.</p>
-<p>For more information on embeddability, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/faqSDK/faq_1129.html" format="application/java-archive">FAQ-1129 What is an embeddable application?</xref>.</p>
-</itemgroup>
-</li>
-</ul>
-<p>The header file for the registration resource files is <parmname>appinfo.rh</parmname> and
-is located in the <parmname>./epoc32/include</parmname> folder.</p>
-<p>For more information on the other values in the resource, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/ToolsAndUtilities94/DevTools/RegFiles/Tool_Guide_Reg_Properties.html#DevTools%2eRegProperties" format="application/java-archive">Defining application icons, captions and properties</xref>.</p>
-</itemgroup>
-</li>
-</ol>
-<p>For a commented example, see <xref href="GUID-C99BA704-4E9F-482C-942F-1B4D7F385BD8.dita">HelloWorldBasic_reg.rss</xref>.</p>
+<?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-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A" xml:lang="en"><title>Creating registration resource files</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+
+<p>You need to register your
+applications in order to make them visible to the application menu
+and to provide other information to the underlying system. To register,
+you need to provide a registration resource file, typically named <parmname><application_name>_reg.rss</parmname>, that contains the non-localized
+information for your application. You also need to provide the <xref href="GUID-9F90A2F0-9C76-4871-A766-D1AE0FC42C08.dita">localizable registration
+information</xref>. The registration resource file is compiled during
+the build process and included in the <parmname>pkg</parmname> file
+used to make the <parmname>sis</parmname> installation file.</p>
+
+<p>To create a registration resource file:</p>
+<ol>
+<li id="GUID-D97F1C74-A29A-4EF1-92C1-8FBAF2EE6F2F"><p>Determine
+the requirements of your application.</p></li>
+<li id="GUID-41830892-AA07-44F7-BCEE-4FACD88932FF"><p>Create
+a text file with the name <parmname><application_name>_reg.rss</parmname>.</p></li>
+<li id="GUID-7EE5ADE9-C5D4-43E0-BB94-977CB064CF2D"><p>Include
+the appropriate header files. Typically, you need to include the following
+files:</p>
+<itemgroup>
+<ul>
+<li><p><parmname>appinfo.rh</parmname>, which is the resource
+header file that includes the data structure declaration for the resource
+statement used in the registration resource file.</p></li>
+<li><p>compiled resource header file for the resource file
+with the symbolic ID for the<xref href="GUID-9F90A2F0-9C76-4871-A766-D1AE0FC42C08.dita"> localizable registration
+information</xref>.</p></li>
+<li><p>localization file, depending on you implementation
+of the registration resource file.</p></li>
+</ul>
+<p>For more information on pre-processor statement syntax, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/ToolsAndUtilities94/DevTools-ref/ResourceFileFormat/Tool_Ref_RSS-file-format.preprocess.html#DevTools%2dref%2erss%2e3" format="application/java-archive">C++ pre-processor statements</xref>.</p>
+</itemgroup>
+</li>
+<li id="GUID-42A15A31-6A2C-4937-9615-A128068E2F76"><p>Add
+a statement for the UID2 value for the registration resource file
+as follows:</p>
+<itemgroup>
+<codeblock id="GUID-A82F0146-5B48-48C8-A5F5-F200D08A6C4D" xml:space="preserve">UID2 KUidAppRegistrationResourceFile</codeblock>
+<p>UID2 always has the same value in registration resource files.</p>
+</itemgroup>
+</li>
+<li id="GUID-4C96D57D-FBA2-4BF6-A1AF-715467663A27"><p>Add
+a statement for the <xref href="GUID-EA05F9B6-52C7-4BD9-8B9A-4BA3456E70B5.dita">UID3</xref> value
+of the application as follows:</p>
+<itemgroup>
+<codeblock id="GUID-EA7F044D-2BB2-4552-B768-3248DF6DAF7F" xml:space="preserve">UID3 <uid3 value for application></codeblock>
+</itemgroup>
+</li>
+<li id="GUID-6A8002EA-AFF5-4750-833C-81ED5F355C6C"><p>Create
+a <parmname>APP_REGISTRATION_INFO</parmname> resource for your application.
+The definition for the registration code block is as follows:</p>
+<itemgroup>
+<codeblock id="GUID-EF44E298-635E-40BD-8FBE-8A6712FCA0FB" xml:space="preserve">
+RESOURCE APP_REGISTRATION_INFO
+ {
+ app_file = ""; // name of application binary file (not including extension) - mandatory
+ attributes = 0;
+ localisable_resource_file = ""; // path (not including drive) and name of localisable resource file
+ localisable_resource_id = r_name36;
+ hidden = KAppNotHidden;
+ embeddability = KAppNotEmbeddable;
+ newfile = KAppDoesNotSupportNewFile;
+ launch = KAppLaunchInForeground;
+ group_name(KAppMaxGroupName) = "";
+ default_screen_number = 0;
+ datatype_list[]; // SUPPORTED DATATYPES
+ file_ownership_list[]; // FILE_OWNERSHIP_INFO
+ service_list[]; // SERVICE_INFO
+ opaque_data = 0; // use for opaque data to send to non-native application launchers i.e. MIDlet id
+ }</codeblock>
+<p>where,</p>
+<ul>
+<li><p><parmname>app_file</parmname> indicates the name
+of the application executable binary file without the extension.</p>
+</li>
+<li><p><parmname>localisable_resource_file</parmname> indicates
+the path and name of the localizable resource file for the application.</p>
+</li>
+<li><p><parmname>localisable_resource_id</parmname> indicates
+the symbolic name of the resource for the <xref href="GUID-9F90A2F0-9C76-4871-A766-D1AE0FC42C08.dita">localizable registration
+resource</xref>.</p></li>
+<li><p><parmname>newfile</parmname> indicates whether the
+application is document-based and supports the creation of new files.
+The default value is <parmname>KAppDoesNotSupportNewFile</parmname>.</p></li>
+<li><p><parmname>embeddability</parmname> indicates whether
+an application is embeddable.</p>
+<itemgroup>
+<p>The default value is <parmname>KAppNotEmbeddable</parmname>.</p>
+<p>For more information on embeddability, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/faqSDK/faq_1129.html" format="application/java-archive">FAQ-1129 What is an embeddable
+application?</xref>.</p>
+</itemgroup>
+</li>
+</ul>
+<p>The header file for the registration resource files is <parmname>appinfo.rh</parmname> and is located in the <parmname>./epoc32/include</parmname> folder.</p>
+<p>For more information on the other values in the resource, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/ToolsAndUtilities94/DevTools/RegFiles/Tool_Guide_Reg_Properties.html#DevTools%2eRegProperties" format="application/java-archive">Defining application icons, captions and properties</xref>.</p>
+</itemgroup>
+</li>
+</ol>
+<p>For a commented example, see <xref href="GUID-C99BA704-4E9F-482C-942F-1B4D7F385BD8.dita">HelloWorldBasic_reg.rss</xref>.</p>
</conbody></concept>
\ No newline at end of file