Symbian3/SDK/Source/GUID-FF6846AA-7E8B-40DC-B6EC-32A8550F4942.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-FF6846AA-7E8B-40DC-B6EC-32A8550F4942.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,59 @@
+<?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-FF6846AA-7E8B-40DC-B6EC-32A8550F4942" xml:lang="en"><title>Using
+Carbide.c++ and P.I.P.S.</title><shortdesc/><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>To be able to use P.I.P.S. and Carbide.c++ efficiently, perform the following
+steps:</p>
+<ul>
+<li><p>Define the system include files required by P.I.P.S.. This is done
+in the <uicontrol>System Options</uicontrol> view in the <uicontrol>Project
+Properties</uicontrol> window.</p></li>
+<li><p>Specify the needed P.I.P.S. libraries:<ul>
+<li><p><filepath>libc.lib</filepath> must always be specified.</p></li>
+<li><p>Libraries must be specified for all build configurations.</p></li>
+</ul>  </p></li>
+</ul>
+<note>The include paths for P.I.P.S. headers must be specified as well as
+the used P.I.P.S. libraries. </note>
+<note>This must be done for all possible build configurations.</note>
+<section id="GUID-140C883C-819A-472A-8759-26566A62941C">       <title>Inclusion
+of <filepath>libc.lib</filepath> in the MMP file</title><p><filepath>libc.lib</filepath> must
+be included in the MMP file for both the <codeph>WINSCW</codeph> as well as
+the target. The code will compile and link for <codeph>WINSCW</codeph> even
+if <filepath>libc.lib</filepath> is not mentioned in the MMP file, but will
+fail during execution. If <filepath>libc.lib</filepath> is not mentioned in
+the MMP file for the target, the code will compile but will fail during linking.</p> 
+   </section>
+<section id="GUID-DB21F39C-8FF9-47BF-BC56-8599F22F330E"><title>Order of the <codeph>SYSTEMINCLUDE</codeph> in
+the MMP file</title><p>Carbide.c++ 1.1 does not take into account the header
+file inclusion order as mentioned in the MMP file. This is a typical scenario
+when the user needs the headers from both P.I.P.S. and <filepath>estlib.lib</filepath>.
+Although, the order of the <codeph>SYSTEMINCLUDE</codeph> in the MMP file
+is:</p><codeblock xml:space="preserve">epoc32\include\stdapis
+epoc32\include\libc </codeblock><p><filepath>epoc32\include\libc</filepath> will
+be included first followed by <filepath>epoc32\include\stdapis</filepath>.
+(It might be included on the basis of alphabetical order). </p><p>This issue
+can be resolved by manually changing the project properties in carbide.c++
+IDE. In order to change the <uicontrol>Project Properties</uicontrol> in Carbide.c++
+IDE:</p><ol>
+<li id="GUID-E280C86C-F29C-45E2-BCA1-A0161790578A"><p>Go to <uicontrol>Project</uicontrol>.</p></li>
+<li id="GUID-BED1ED11-BB1B-4C08-B4AD-ABF043A69955"><p>Click on <uicontrol>Property</uicontrol>.</p></li>
+<li id="GUID-F0A81703-9804-4A5C-8D25-FBF266AF2382"><p>Click on <uicontrol>C
+\C++. Build</uicontrol> and choose the <uicontrol>ToolSettings</uicontrol> Tab </p></li>
+</ol></section>
+<section id="GUID-7DCA8B26-BC6F-4709-AA45-6316F0B5CEDB"><title>Suppressing
+"illegal implicit conversion error"</title><p>The code that makes use of implicit
+pointer casts will not compile with the <codeph>WINSCW</codeph> compiler.
+The compilation breaks with "illegal implicit conversion error". However,
+the same code will compile with GCC compiler. A work around for this problem
+without changing the code is to define a pragma.</p></section>
+</conbody></concept>
\ No newline at end of file