Symbian3/SDK/Source/GUID-9C57F0C6-E2E3-58A2-907D-924A7E22EA97-GENID-1-13-1-1-5-1-4-1.dita
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-9C57F0C6-E2E3-58A2-907D-924A7E22EA97-GENID-1-13-1-1-5-1-4-1.dita Fri Jun 11 12:39:03 2010 +0100
@@ -0,0 +1,94 @@
+<?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-9C57F0C6-E2E3-58A2-907D-924A7E22EA97-GENID-1-13-1-1-5-1-4-1" xml:lang="en"><title>Resource
+compiler tool: rcomp</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-9C57F0C6-E2E3-58A2-907D-924A7E22EA97-GENID-1-13-1-1-5-1-4-1-2-1"><title>Purpose</title> <p>The
+resource compiler, <filepath>rcomp</filepath>, compiles source <filepath>rss</filepath> resource
+files into a <filepath>rsc</filepath> resource data file which can be used
+by applications, and a <filepath>rsg</filepath> resource header file. The
+operation of the resource compiler is usually wrapped in an <filepath>abld</filepath> batch
+file. That provides the most commonly used <filepath>rcomp</filepath> functionality,
+but does not provide some of the debugging options available directly through <filepath>rcomp</filepath>. </p><p><b>Note</b>:
+From Symbian^4 onwards, <filepath>rcomp</filepath> supports long strings and
+supplementary characters (not included in code point range of BMP) of the
+range <codeph>0x10000</codeph> to <codeph>0x10ffff</codeph> in rss files.</p> </section>
+<section id="GUID-C8BD2B09-0D01-4CE3-B575-0A076F1E926D"><title>Command line syntax</title><userinput>rcomp [—v] [—p] [—l]
+[—force] [—u] [—o <varname>DataOutputFile</varname>] [-{<varname>uid2</varname>,<varname>uid3</varname> }]
+[—h <varname>HeaderOutputFile</varname>] [—s <varname>SourceFileName</varname>]
+[—i <varname>BaseInputFileName</varname>]</userinput> <p><b>Arguments</b> </p> <table id="GUID-787D72D2-564C-569A-B7C4-B244DD46C87E">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<tbody>
+<row>
+<entry><p> <codeph>-v</codeph> </p> </entry>
+<entry><p>verbose output. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-p</codeph> </p> </entry>
+<entry><p>parser debugging </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-l</codeph> </p> </entry>
+<entry><p>Check localisation comments </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-force</codeph> </p> </entry>
+<entry><p>Emit warnings if the localisation comment tags are not present </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-u</codeph> </p> </entry>
+<entry><p>generate Unicode resource binary </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-o</codeph> <varname>DataOutputFile</varname> </p> </entry>
+<entry><p>Specify full path and name for data output file <varname>DataOutputFile</varname>.
+If this is not specified, no data output file is created. </p> </entry>
+</row>
+<row>
+<entry><p>[-{<varname>uid2</varname>,<varname>uid3</varname> }] </p> </entry>
+<entry><p>Second and third UIDs for the resource file </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-h</codeph> <varname>HeaderOutputFile</varname> </p> </entry>
+<entry><p>Specify header output file <varname>HeaderOutputFile</varname>;
+this is the name only, and does not include the path. If this is not specified,
+no header output file is created. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-s</codeph> <varname>SourceFileName</varname> </p> </entry>
+<entry><p>Specify resource compiler source file <varname>SourceFileName</varname> (output
+of pre-processor <varname>BaseInputFileName</varname>.rpp). If not specified,
+or specified as <codeph>-s-</codeph>, source is read from the standard input. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>-i</codeph> <varname>BaseInputFileName</varname> </p> </entry>
+<entry><p>The file given to the pre-processor </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table> <p><b>Output files</b> </p> <table id="GUID-2CF9D84F-B657-56FF-8AB3-DF14CE693ED5">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<tbody>
+<row>
+<entry><p> <varname>DataOutputFile</varname> </p> </entry>
+<entry><p>The resource data referred to by the application at run-time. Note
+that the generated file can have any name. However, before the resource file
+can be used it must be renamed to have an extension <filepath>.rsc</filepath>. </p> </entry>
+</row>
+<row>
+<entry><p> <varname>HeaderOutputFile</varname> </p> </entry>
+<entry><p>The generated header file, which contains <codeph>#define</codeph> statements
+for each resource defined in the source file. </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table> </section>
+</conbody></concept>
\ No newline at end of file