--- a/Symbian3/PDK/Source/GUID-53E5C9EA-0A38-54A1-AE24-95B71BFFB4B5.dita Tue Jul 20 12:00:49 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-53E5C9EA-0A38-54A1-AE24-95B71BFFB4B5.dita Fri Aug 13 16:47:46 2010 +0100
@@ -1,187 +1,187 @@
-<?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-53E5C9EA-0A38-54A1-AE24-95B71BFFB4B5" xml:lang="en"><title>CenRep
-Converter Tool Tutorial</title><shortdesc>This topic describes the Central Repository Converter (<codeph>CenRepConv</codeph>)
-tool. The CenRepConv tool is used to convert text files into binary files. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
-<section id="GUID-D103CC8D-6871-46D1-B41E-85F5632324DC"><title>Overview</title> <p>The <codeph>CenRepConv</codeph> is an
-emulator based tool. The <codeph>CenRepConv</codeph> tool can be used to convert
-binary files to text files for debugging. The central repository initialisation
-files are used to register the repositories with central repository. The initialisation
-files can be either in text or binary format, although binary format is recommended
-for better efficiency. For example, the loading time of a repository with
-2000 settings on a H2 development board is 41ms for binary files and 485ms
-for text files. </p> <p>The tool uses the file extension to identify the fomats. <codeph>TXT</codeph> is
-used for the text file extension and <codeph>CRE</codeph> is used as the binary
-file extension </p> </section>
-<section id="GUID-89B11338-F42A-4704-9795-84A706DE12BB"><title>Command line syntax</title> <p>The syntax for text to binary
-conversion is: </p> <codeblock id="GUID-B6AF4E5C-A007-5E23-A30E-8F006461A6C1" xml:space="preserve">CentRepConv [-nowait] [-o output_path] [input_path\]<repository_uid>.txt</codeblock> <p>where, </p> <ul>
-<li id="GUID-3434EDE7-D5F9-5A0A-B67F-A37918304247"><p> <codeph> repository_uid</codeph> is
-the UID of repository in hexadecimal format, for example 00000001 </p> </li>
-<li id="GUID-DE6793EF-7069-55AD-AEF2-5EFED65BD209"><p> <codeph>output_path</codeph> –
-Optional, default is <codeph>C:\</codeph>. Note that if the user specifies
-the output filename, then the extension must be .cre and the filename must
-match the <repository_uid> of the input file. </p> </li>
-<li id="GUID-AA6CB0CD-8931-588F-B27A-E7EC60576B5D"><p> <codeph> -nowait</codeph> option
-should be used when CentRepConv is invoked as part of an automated process
-such as from a build script. It instructs CentRepConv not to wait for user
-acknowledgement. Without this option the tool will wait for up to 30 seconds
-for acknowledgement </p> </li>
-</ul> <p>The syntax for bianary to text conversion is: </p> <codeblock id="GUID-F814EA9C-3063-5715-98F1-550E512BE023" xml:space="preserve">CentRepConv [-nowait] [-o output_path] [input_path\]<repository_uid>.cre</codeblock> <p>where, </p> <ul>
-<li id="GUID-2EEC6C18-2CC6-530A-9B3F-6F86769D7E64"><p> <codeph> repository_uid</codeph> is
-the UID of repository in hexadecimal format, for example 00000001 </p> </li>
-<li id="GUID-A8A8D7A7-64B3-5D06-A514-216CB0F7CA7D"><p> <codeph> input_path</codeph> is
-optional, default is <codeph>C:\</codeph>. Note that location of path must
-be a Symbian path, not a path of the PC’s native OS. </p> </li>
-<li id="GUID-6F952102-D662-56AD-AF06-72FE7188DADF"><p> <codeph> output_path</codeph> is
-optional, default is <codeph>C:\</codeph>. Note that if the user specifies
-the output filename, then the extension must be .txt and the filename must
-match the <repository_uid> of the input file. </p> </li>
-</ul> </section>
-<section id="GUID-E26646C2-2194-403C-ADAB-A8DBA5C3E88D"><title>Integrating CenRepConv tool</title> <p>This section describes
-how to automate text to binary conversion whislt building the ROM. The group
-folder must contain bld.inf file, extension makefile, script to invoke the
-cenRepConv tool and the initialisation text file. </p> <ol id="GUID-31B7B304-6B48-5DAA-A72B-62260048CA3F">
-<li id="GUID-D4D0CB8F-0FCE-52A8-87A6-435B9E44876C"><p>The bld.inf file must
-contain: </p> <codeblock id="GUID-4DA91F35-AEE2-5D48-9E71-31A9FE613C66" xml:space="preserve">PRJ_PLATFORMS
-DEFAULT
-
-PRJ_MMPFILES
-gnumakefile CreateBinaryRep.mk
-</codeblock> </li>
-<li id="GUID-FF85D695-8733-58D7-BACC-BCB185045392"><p>The extension makefile
-is configured as: </p> <codeblock id="GUID-C2BF6EC5-C293-5BF9-A5BF-4C4DB15B03CC" xml:space="preserve">do_nothing :
- rem do_nothing
-
-MAKMAKE : do_nothing
-
-RESOURCE : do_nothing
-
-SAVESPACE : BLD
-
-BLD : do_nothing
-
-FREEZE : do_nothing
-
-LIB : do_nothing
-
-CLEANLIB : do_nothing
-
-FINAL :
- CreateBinaryRep.cmd build
-
-CLEAN :
- CreateBinaryRep.cmd clean
-
-RELEASABLES :
- CreateBinaryRep.cmd releasables
-</codeblock> </li>
-<li id="GUID-1429DD28-07C3-5501-A644-B23ABEBD32E0"><p>The script file is used
-to move the text files to the emulators folder, invoke the CenRepConv tool
-and copy the binary folders into the central repository private folder. </p> <codeblock id="GUID-EEB8A24A-0357-5FE2-8FF8-E4583E3A9E4F" xml:space="preserve">@ECHO OFF
-SET RETURNCODE=0
-
-IF /I "%1"=="build" goto BUILD
-
-IF /I "%1"=="clean" goto CLEAN
-
-IF /I "%1"=="releasables" goto WHAT
-
-echo error: unknown option %1 >&2
-SET RETURNCODE=1
-goto END
-
-:WHAT
-echo %EPOCROOT%epoc32\release\winscw\udeb\Z\private\10202BE9\1027431B.cre
-goto END
-
-:CLEAN
-ERASE %EPOCROOT%epoc32\release\winscw\udeb\Z\private\10202BE9\1027431B.cre 2>NUL
-goto END
-
-:BUILD
-ERASE %EPOCROOT%epoc32\winscw\c\1027431B.cre 2>NUL
-ERASE %EPOCROOT%epoc32\release\winscw\udeb\z\private\10202BE9\1027431B.cre 2>NUL
-COPY 1027431B.txt %EPOCROOT%epoc32\winscw\c
-CALL %EPOCROOT%epoc32\release\winscw\udeb\CentRepConv -nowait -o C:\1027431B.cre C:\1027431B.txt
-IF exist %EPOCROOT%epoc32\winscw\c\1027431B.cre goto BLDSUCCESS
-SET RETURNCODE=1
-ECHO error: build fail >&2
-goto END
-
-:BLDSUCCESS
-ERASE %EPOCROOT%epoc32\winscw\c\1027431B.txt
-MOVE %EPOCROOT%epoc32\winscw\c\1027431B.cre %EPOCROOT%epoc32\release\winscw\udeb\z\private\10202BE9\1027431B.cre
-goto END
-
-:END
-EXIT /B %RETURNCODE%
-</codeblock> </li>
-</ol> </section>
-<section id="GUID-CD798B16-86D7-48E1-B40F-907B251A33CD"><title>Error codes</title> <p>The following are the error codes that
-may occur during the text to binary conversion and vice versa. </p> <table id="GUID-B1A7F8DE-37AA-519F-8A87-EDB3DF80F99A">
-<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
-<thead>
-<row>
-<entry>Error condition</entry>
-<entry>Leave Code</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry><p>Input file corrupted </p> </entry>
-<entry><p> <xref href="GUID-253F06EA-F14E-3A8E-BA4C-8E787B5F0670.dita"><apiname>KErrCorrupt</apiname></xref> </p> </entry>
-</row>
-<row>
-<entry><p>Input file is not a Direct File Store </p> </entry>
-<entry><p> <xref href="GUID-253F06EA-F14E-3A8E-BA4C-8E787B5F0670.dita"><apiname>KErrCorrupt</apiname></xref> </p> </entry>
-</row>
-<row>
-<entry><p>No input file specified </p> </entry>
-<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
-</row>
-<row>
-<entry><p>Bad input file extension (not .txt or .cre) </p> </entry>
-<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
-</row>
-<row>
-<entry><p>Input filename is not a valid UID </p> </entry>
-<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
-</row>
-<row>
-<entry><p>Output filename does not match input filename </p> </entry>
-<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
-</row>
-<row>
-<entry><p>Extension of output filename does not match extension of input filename
-(if one is .txt and the other must be .cre) </p> </entry>
-<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
-</row>
-<row>
-<entry><p>Output directory is in read only drive </p> </entry>
-<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
-</row>
-<row>
-<entry><p>Cannot access input file because it is in private data cage </p> </entry>
-<entry><p> <xref href="GUID-298F3C28-48F5-34EA-8843-C75E2ECF0480.dita"><apiname>KErrAccessDenied</apiname></xref> </p> </entry>
-</row>
-<row>
-<entry><p>Cannot write output file because it is in private data cage </p> </entry>
-<entry><p> <xref href="GUID-298F3C28-48F5-34EA-8843-C75E2ECF0480.dita"><apiname>KErrAccessDenied</apiname></xref> </p> </entry>
-</row>
-<row>
-<entry><p>Input file does not exist </p> </entry>
-<entry><p> <xref href="GUID-298F3C28-48F5-34EA-8843-C75E2ECF0480.dita"><apiname>KErrAccessDenied</apiname></xref> </p> </entry>
-</row>
-</tbody>
-</tgroup>
-</table> </section>
+<?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-53E5C9EA-0A38-54A1-AE24-95B71BFFB4B5" xml:lang="en"><title>CenRep
+Converter Tool Tutorial</title><shortdesc>This topic describes the Central Repository Converter (<codeph>CenRepConv</codeph>)
+tool. The CenRepConv tool is used to convert text files into binary files. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-D103CC8D-6871-46D1-B41E-85F5632324DC"><title>Overview</title> <p>The <codeph>CenRepConv</codeph> is an
+emulator based tool. The <codeph>CenRepConv</codeph> tool can be used to convert
+binary files to text files for debugging. The central repository initialisation
+files are used to register the repositories with central repository. The initialisation
+files can be either in text or binary format, although binary format is recommended
+for better efficiency. For example, the loading time of a repository with
+2000 settings on a H2 development board is 41ms for binary files and 485ms
+for text files. </p> <p>The tool uses the file extension to identify the fomats. <codeph>TXT</codeph> is
+used for the text file extension and <codeph>CRE</codeph> is used as the binary
+file extension </p> </section>
+<section id="GUID-89B11338-F42A-4704-9795-84A706DE12BB"><title>Command line syntax</title> <p>The syntax for text to binary
+conversion is: </p> <codeblock id="GUID-B6AF4E5C-A007-5E23-A30E-8F006461A6C1" xml:space="preserve">CentRepConv [-nowait] [-o output_path] [input_path\]<repository_uid>.txt</codeblock> <p>where, </p> <ul>
+<li id="GUID-3434EDE7-D5F9-5A0A-B67F-A37918304247"><p> <codeph> repository_uid</codeph> is
+the UID of repository in hexadecimal format, for example 00000001 </p> </li>
+<li id="GUID-DE6793EF-7069-55AD-AEF2-5EFED65BD209"><p> <codeph>output_path</codeph> –
+Optional, default is <codeph>C:\</codeph>. Note that if the user specifies
+the output filename, then the extension must be .cre and the filename must
+match the <repository_uid> of the input file. </p> </li>
+<li id="GUID-AA6CB0CD-8931-588F-B27A-E7EC60576B5D"><p> <codeph> -nowait</codeph> option
+should be used when CentRepConv is invoked as part of an automated process
+such as from a build script. It instructs CentRepConv not to wait for user
+acknowledgement. Without this option the tool will wait for up to 30 seconds
+for acknowledgement </p> </li>
+</ul> <p>The syntax for bianary to text conversion is: </p> <codeblock id="GUID-F814EA9C-3063-5715-98F1-550E512BE023" xml:space="preserve">CentRepConv [-nowait] [-o output_path] [input_path\]<repository_uid>.cre</codeblock> <p>where, </p> <ul>
+<li id="GUID-2EEC6C18-2CC6-530A-9B3F-6F86769D7E64"><p> <codeph> repository_uid</codeph> is
+the UID of repository in hexadecimal format, for example 00000001 </p> </li>
+<li id="GUID-A8A8D7A7-64B3-5D06-A514-216CB0F7CA7D"><p> <codeph> input_path</codeph> is
+optional, default is <codeph>C:\</codeph>. Note that location of path must
+be a Symbian path, not a path of the PC’s native OS. </p> </li>
+<li id="GUID-6F952102-D662-56AD-AF06-72FE7188DADF"><p> <codeph> output_path</codeph> is
+optional, default is <codeph>C:\</codeph>. Note that if the user specifies
+the output filename, then the extension must be .txt and the filename must
+match the <repository_uid> of the input file. </p> </li>
+</ul> </section>
+<section id="GUID-E26646C2-2194-403C-ADAB-A8DBA5C3E88D"><title>Integrating CenRepConv tool</title> <p>This section describes
+how to automate text to binary conversion whislt building the ROM. The group
+folder must contain bld.inf file, extension makefile, script to invoke the
+cenRepConv tool and the initialisation text file. </p> <ol id="GUID-31B7B304-6B48-5DAA-A72B-62260048CA3F">
+<li id="GUID-D4D0CB8F-0FCE-52A8-87A6-435B9E44876C"><p>The bld.inf file must
+contain: </p> <codeblock id="GUID-4DA91F35-AEE2-5D48-9E71-31A9FE613C66" xml:space="preserve">PRJ_PLATFORMS
+DEFAULT
+
+PRJ_MMPFILES
+gnumakefile CreateBinaryRep.mk
+</codeblock> </li>
+<li id="GUID-FF85D695-8733-58D7-BACC-BCB185045392"><p>The extension makefile
+is configured as: </p> <codeblock id="GUID-C2BF6EC5-C293-5BF9-A5BF-4C4DB15B03CC" xml:space="preserve">do_nothing :
+ rem do_nothing
+
+MAKMAKE : do_nothing
+
+RESOURCE : do_nothing
+
+SAVESPACE : BLD
+
+BLD : do_nothing
+
+FREEZE : do_nothing
+
+LIB : do_nothing
+
+CLEANLIB : do_nothing
+
+FINAL :
+ CreateBinaryRep.cmd build
+
+CLEAN :
+ CreateBinaryRep.cmd clean
+
+RELEASABLES :
+ CreateBinaryRep.cmd releasables
+</codeblock> </li>
+<li id="GUID-1429DD28-07C3-5501-A644-B23ABEBD32E0"><p>The script file is used
+to move the text files to the emulators folder, invoke the CenRepConv tool
+and copy the binary folders into the central repository private folder. </p> <codeblock id="GUID-EEB8A24A-0357-5FE2-8FF8-E4583E3A9E4F" xml:space="preserve">@ECHO OFF
+SET RETURNCODE=0
+
+IF /I "%1"=="build" goto BUILD
+
+IF /I "%1"=="clean" goto CLEAN
+
+IF /I "%1"=="releasables" goto WHAT
+
+echo error: unknown option %1 >&2
+SET RETURNCODE=1
+goto END
+
+:WHAT
+echo %EPOCROOT%epoc32\release\winscw\udeb\Z\private\10202BE9\1027431B.cre
+goto END
+
+:CLEAN
+ERASE %EPOCROOT%epoc32\release\winscw\udeb\Z\private\10202BE9\1027431B.cre 2>NUL
+goto END
+
+:BUILD
+ERASE %EPOCROOT%epoc32\winscw\c\1027431B.cre 2>NUL
+ERASE %EPOCROOT%epoc32\release\winscw\udeb\z\private\10202BE9\1027431B.cre 2>NUL
+COPY 1027431B.txt %EPOCROOT%epoc32\winscw\c
+CALL %EPOCROOT%epoc32\release\winscw\udeb\CentRepConv -nowait -o C:\1027431B.cre C:\1027431B.txt
+IF exist %EPOCROOT%epoc32\winscw\c\1027431B.cre goto BLDSUCCESS
+SET RETURNCODE=1
+ECHO error: build fail >&2
+goto END
+
+:BLDSUCCESS
+ERASE %EPOCROOT%epoc32\winscw\c\1027431B.txt
+MOVE %EPOCROOT%epoc32\winscw\c\1027431B.cre %EPOCROOT%epoc32\release\winscw\udeb\z\private\10202BE9\1027431B.cre
+goto END
+
+:END
+EXIT /B %RETURNCODE%
+</codeblock> </li>
+</ol> </section>
+<section id="GUID-CD798B16-86D7-48E1-B40F-907B251A33CD"><title>Error codes</title> <p>The following are the error codes that
+may occur during the text to binary conversion and vice versa. </p> <table id="GUID-B1A7F8DE-37AA-519F-8A87-EDB3DF80F99A">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<thead>
+<row>
+<entry>Error condition</entry>
+<entry>Leave Code</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p>Input file corrupted </p> </entry>
+<entry><p> <xref href="GUID-253F06EA-F14E-3A8E-BA4C-8E787B5F0670.dita"><apiname>KErrCorrupt</apiname></xref> </p> </entry>
+</row>
+<row>
+<entry><p>Input file is not a Direct File Store </p> </entry>
+<entry><p> <xref href="GUID-253F06EA-F14E-3A8E-BA4C-8E787B5F0670.dita"><apiname>KErrCorrupt</apiname></xref> </p> </entry>
+</row>
+<row>
+<entry><p>No input file specified </p> </entry>
+<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
+</row>
+<row>
+<entry><p>Bad input file extension (not .txt or .cre) </p> </entry>
+<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
+</row>
+<row>
+<entry><p>Input filename is not a valid UID </p> </entry>
+<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
+</row>
+<row>
+<entry><p>Output filename does not match input filename </p> </entry>
+<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
+</row>
+<row>
+<entry><p>Extension of output filename does not match extension of input filename
+(if one is .txt and the other must be .cre) </p> </entry>
+<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
+</row>
+<row>
+<entry><p>Output directory is in read only drive </p> </entry>
+<entry><p> <xref href="GUID-0BEA3647-7888-3612-A2D3-7E27AC405E29.dita"><apiname>KErrArgument</apiname></xref> </p> </entry>
+</row>
+<row>
+<entry><p>Cannot access input file because it is in private data cage </p> </entry>
+<entry><p> <xref href="GUID-298F3C28-48F5-34EA-8843-C75E2ECF0480.dita"><apiname>KErrAccessDenied</apiname></xref> </p> </entry>
+</row>
+<row>
+<entry><p>Cannot write output file because it is in private data cage </p> </entry>
+<entry><p> <xref href="GUID-298F3C28-48F5-34EA-8843-C75E2ECF0480.dita"><apiname>KErrAccessDenied</apiname></xref> </p> </entry>
+</row>
+<row>
+<entry><p>Input file does not exist </p> </entry>
+<entry><p> <xref href="GUID-298F3C28-48F5-34EA-8843-C75E2ECF0480.dita"><apiname>KErrAccessDenied</apiname></xref> </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table> </section>
</conbody></concept>
\ No newline at end of file