--- a/Symbian3/PDK/Source/GUID-B661DFBC-9779-597D-A1DA-4FE085DAA61A.dita Thu Mar 11 15:24:26 2010 +0000
+++ b/Symbian3/PDK/Source/GUID-B661DFBC-9779-597D-A1DA-4FE085DAA61A.dita Thu Mar 11 18:02:22 2010 +0000
@@ -1,116 +1,116 @@
-<?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-B661DFBC-9779-597D-A1DA-4FE085DAA61A" xml:lang="en"><title>CRT0
-Libraries of STDLIB</title><prolog><metadata><keywords/></metadata></prolog><conbody>
-<p>This section explains the CRT0 libraries provided by STDLIB. </p>
-<p>The following table lists the CRT0 libraries: </p>
-<table id="GUID-D74087AE-6FCA-5C46-98AE-EAC4AE3B6867">
-<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
-<thead>
-<row>
-<entry>Simple Mode (thread local mode)</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry><p> <codeph>ecrt0.lib</codeph> </p> </entry>
-<entry><p>EABI Emulators Narrow <codeph>char main (int
-argc, char *argv[], char *envp[])</codeph> </p> </entry>
-</row>
-<row>
-<entry><p> <codeph>wecrt0.lib</codeph> </p> </entry>
-<entry><p>EABI Emulators Wide <codeph>char main (int
-argc, wchar_t *argv[], wchar_t *envp[])</codeph> </p> </entry>
-</row>
-<row>
-<entry valign="bottom"><p><b>Complex Mode (multi threaded mode / POSIX server
-mode)</b></p></entry>
-<entry valign="bottom"/>
-</row>
-<row>
-<entry><p> <codeph> mcrt0.lib</codeph> </p> </entry>
-<entry><p>EABI Emulators Narrow <codeph>char main (int
-argc, char *argv[], char *envp[]</codeph> </p> </entry>
-</row>
-<row>
-<entry><p> <codeph>wcrt0.lib</codeph> </p> </entry>
-<entry><p>Emulators Narrow <codeph>char main (int argc,
-char *argv[], char *envp[])</codeph> with stdxxx redirection
-to Win32 using RWin32Stream server </p> </entry>
-</row>
-<row>
-<entry><p> <codeph>wmcrt0.lib</codeph> </p> </entry>
-<entry><p>EABI Emulators Wide <codeph>char wmain (int
-argc, wchar_t *argv[], wchar_t *envp[])</codeph> </p> </entry>
-</row>
-<row>
-<entry><p> <codeph>wwcrt0.lib</codeph> </p> </entry>
-<entry><p>Emulator Wide <codeph>char wmain (int argc,
-wchar_t *argv[], wchar_t *envp[])</codeph> with stdxxx redirection
-to Win32 using RWin32Stream server </p> </entry>
-</row>
-<row>
-<entry valign="bottom"><p><b>Other</b></p></entry>
-<entry valign="bottom"/>
-</row>
-<row>
-<entry><p> <codeph>estw32.dll</codeph> </p> </entry>
-<entry><p>Emulators: Provides the RWin32Stream server </p> </entry>
-</row>
-<row>
-<entry><p> <codeph>redircli.dll</codeph> </p> </entry>
-<entry><p>EABI Emulators: Provides application specific redirection
-(for example, to Java RT or test applications). </p> </entry>
-</row>
-</tbody>
-</tgroup>
-</table>
-<p>These static libraries provide the compiler runtime glue code that runs
-from the Symbian <codeph>E32Main()</codeph> entry point for regular Symbian
-executables into the standard C <codeph>main()</codeph> entry point. </p>
-<p>These executables are considered to be C programs hosted in a Symbian executable
-image. The glue code has a number of functions to perform, for example: </p>
-<ul>
-<li id="GUID-2692C4C1-78E3-5F5B-BA1F-53FCE4CC085C"><p>marshalling the process
-command arguments in the types used by <codeph>main()</codeph> </p> </li>
-<li id="GUID-822978FA-C8B4-5E01-A19A-F99306D31582"><p>initialising the C Standard
-library context and mode of operation for example, calling <codeph>SpawnPosixServerThread()</codeph>. </p> </li>
-</ul>
-<section><title>ECRT0.lib and the cleanup stack</title> <p>A normal Symbian
-platform executable provides an <codeph>E32Main()</codeph> function which
-is called by the operating system to start the program. The file <filepath>ecrt0.lib</filepath> provides
-an <codeph>E32Main()</codeph> function for programs which use STDLIB. This
-function prepares the traditional <codeph>argc</codeph> and <codeph>argv</codeph> arguments,
-and passes them to <codeph>main()</codeph>. </p> <p>For a simple example demonstrating
-how to link to <filepath>ecrt0.lib</filepath>, see the description of the
-project specification for "Hello World" in <xref href="GUID-F51062B0-90BB-5659-9F23-2FF25116D78A.dita">Porting</xref>.
-The user of STDLIB need not use <filepath>ecrt0.lib</filepath>, and may provide
-their own <codeph>E32Main()</codeph>. In this case, a <codeph>CTrapCleanup</codeph> pointer
-should normally be provided. This pointer is required because although STDLIB
-does not call Symbian platform functions which can leave, it uses few functions
-which require a cleanup stack. Code in <filepath>ecrt0.lib</filepath> provides
-such a cleanup stack ("<codeph>TheTrapCleanup</codeph> "), but programs which
-do not link with <filepath>ecrt0.lib</filepath> must supply one directly. </p> <p>For
-more details on the motivation behind Symbian's use of the cleanup stack,
-see <xref href="GUID-61DEE78D-4E78-5367-BC8A-F99D3B4E9D5A.dita">Cleanup support</xref>. </p> <p> <b> NOTE</b>:
-If the program is a UI application, that is, one that includes the following
-code in one of the source files: </p> <codeblock id="GUID-D8C4F7A9-9755-58EC-BED9-0232259970BE" xml:space="preserve">GLDEF_C TInt E32Main()
- {
- return EikStart::RunApplication(NewApplication);
- }</codeblock> <p>then, the <codeph>CTrapCleanup</codeph> pointer is provided
-by the application framework. </p> </section>
-</conbody><related-links>
-<link href="GUID-F51062B0-90BB-5659-9F23-2FF25116D78A.dita"><linktext>Porting Tutorials</linktext>
-</link>
-<link href="GUID-61DEE78D-4E78-5367-BC8A-F99D3B4E9D5A.dita"><linktext>Cleanup support
-guide</linktext></link>
+<?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-B661DFBC-9779-597D-A1DA-4FE085DAA61A" xml:lang="en"><title>CRT0
+Libraries of STDLIB</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>This section explains the CRT0 libraries provided by STDLIB. </p>
+<p>The following table lists the CRT0 libraries: </p>
+<table id="GUID-D74087AE-6FCA-5C46-98AE-EAC4AE3B6867">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<thead>
+<row>
+<entry>Simple Mode (thread local mode)</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p> <codeph>ecrt0.lib</codeph> </p> </entry>
+<entry><p>EABI Emulators Narrow <codeph>char main (int
+argc, char *argv[], char *envp[])</codeph> </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>wecrt0.lib</codeph> </p> </entry>
+<entry><p>EABI Emulators Wide <codeph>char main (int
+argc, wchar_t *argv[], wchar_t *envp[])</codeph> </p> </entry>
+</row>
+<row>
+<entry valign="bottom"><p><b>Complex Mode (multi threaded mode / POSIX server
+mode)</b></p></entry>
+<entry valign="bottom"/>
+</row>
+<row>
+<entry><p> <codeph> mcrt0.lib</codeph> </p> </entry>
+<entry><p>EABI Emulators Narrow <codeph>char main (int
+argc, char *argv[], char *envp[]</codeph> </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>wcrt0.lib</codeph> </p> </entry>
+<entry><p>Emulators Narrow <codeph>char main (int argc,
+char *argv[], char *envp[])</codeph> with stdxxx redirection
+to Win32 using RWin32Stream server </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>wmcrt0.lib</codeph> </p> </entry>
+<entry><p>EABI Emulators Wide <codeph>char wmain (int
+argc, wchar_t *argv[], wchar_t *envp[])</codeph> </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>wwcrt0.lib</codeph> </p> </entry>
+<entry><p>Emulator Wide <codeph>char wmain (int argc,
+wchar_t *argv[], wchar_t *envp[])</codeph> with stdxxx redirection
+to Win32 using RWin32Stream server </p> </entry>
+</row>
+<row>
+<entry valign="bottom"><p><b>Other</b></p></entry>
+<entry valign="bottom"/>
+</row>
+<row>
+<entry><p> <codeph>estw32.dll</codeph> </p> </entry>
+<entry><p>Emulators: Provides the RWin32Stream server </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>redircli.dll</codeph> </p> </entry>
+<entry><p>EABI Emulators: Provides application specific redirection
+(for example, to Java RT or test applications). </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<p>These static libraries provide the compiler runtime glue code that runs
+from the Symbian <codeph>E32Main()</codeph> entry point for regular Symbian
+executables into the standard C <codeph>main()</codeph> entry point. </p>
+<p>These executables are considered to be C programs hosted in a Symbian executable
+image. The glue code has a number of functions to perform, for example: </p>
+<ul>
+<li id="GUID-2692C4C1-78E3-5F5B-BA1F-53FCE4CC085C"><p>marshalling the process
+command arguments in the types used by <codeph>main()</codeph> </p> </li>
+<li id="GUID-822978FA-C8B4-5E01-A19A-F99306D31582"><p>initialising the C Standard
+library context and mode of operation for example, calling <codeph>SpawnPosixServerThread()</codeph>. </p> </li>
+</ul>
+<section><title>ECRT0.lib and the cleanup stack</title> <p>A normal Symbian
+platform executable provides an <codeph>E32Main()</codeph> function which
+is called by the operating system to start the program. The file <filepath>ecrt0.lib</filepath> provides
+an <codeph>E32Main()</codeph> function for programs which use STDLIB. This
+function prepares the traditional <codeph>argc</codeph> and <codeph>argv</codeph> arguments,
+and passes them to <codeph>main()</codeph>. </p> <p>For a simple example demonstrating
+how to link to <filepath>ecrt0.lib</filepath>, see the description of the
+project specification for "Hello World" in <xref href="GUID-F51062B0-90BB-5659-9F23-2FF25116D78A.dita">Porting</xref>.
+The user of STDLIB need not use <filepath>ecrt0.lib</filepath>, and may provide
+their own <codeph>E32Main()</codeph>. In this case, a <codeph>CTrapCleanup</codeph> pointer
+should normally be provided. This pointer is required because although STDLIB
+does not call Symbian platform functions which can leave, it uses few functions
+which require a cleanup stack. Code in <filepath>ecrt0.lib</filepath> provides
+such a cleanup stack ("<codeph>TheTrapCleanup</codeph> "), but programs which
+do not link with <filepath>ecrt0.lib</filepath> must supply one directly. </p> <p>For
+more details on the motivation behind Symbian's use of the cleanup stack,
+see <xref href="GUID-61DEE78D-4E78-5367-BC8A-F99D3B4E9D5A.dita">Cleanup support</xref>. </p> <p> <b> NOTE</b>:
+If the program is a UI application, that is, one that includes the following
+code in one of the source files: </p> <codeblock id="GUID-D8C4F7A9-9755-58EC-BED9-0232259970BE" xml:space="preserve">GLDEF_C TInt E32Main()
+ {
+ return EikStart::RunApplication(NewApplication);
+ }</codeblock> <p>then, the <codeph>CTrapCleanup</codeph> pointer is provided
+by the application framework. </p> </section>
+</conbody><related-links>
+<link href="GUID-F51062B0-90BB-5659-9F23-2FF25116D78A.dita"><linktext>Porting Tutorials</linktext>
+</link>
+<link href="GUID-61DEE78D-4E78-5367-BC8A-F99D3B4E9D5A.dita"><linktext>Cleanup support
+guide</linktext></link>
</related-links></concept>
\ No newline at end of file