--- a/Symbian3/PDK/Source/GUID-B9F07057-4B31-5FE8-BE4C-98CC8151CD29.dita Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-B9F07057-4B31-5FE8-BE4C-98CC8151CD29.dita Tue Mar 30 11:56:28 2010 +0100
@@ -10,11 +10,11 @@
<!DOCTYPE task
PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="GUID-B9F07057-4B31-5FE8-BE4C-98CC8151CD29" xml:lang="en"><title>Single
-Phase Constructor Tutorial</title><shortdesc>Single phase construction is enabled by defining the <apiname>CONSTRUCTORS_MAY_LEAVE()</apiname> macro
+Phase Constructor Tutorial</title><shortdesc>Single phase construction is enabled by defining the <codeph>CONSTRUCTORS_MAY_LEAVE()</codeph> macro
in a public section of a class definition if the single phase construction
is part of the public interface of the class. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
-<prereq><p><b>Required background</b></p><p>Before beginning you must know
-the following: </p> <ul>
+<prereq id="GUID-0FCC96BD-B7C4-4604-96C1-D6E5D574AB53"><p><b>Required background</b></p><p>Before
+beginning you must know the following: </p> <ul>
<li id="GUID-DC57A39F-122C-545C-A2A1-D26F71209C10"><p> <b>RAII:</b> The Resource
Acquisition Is Initialization (RAII) idiom is the basis of the implementation
of the smart pointer class templates. </p> </li>
@@ -22,9 +22,10 @@
This macro is used for enabling single phase construction, particularly for
CBase-derived classes. </p> </li>
</ul> </prereq>
-<context><p>Single phase constructor provides a means to use the RAII concepts
-for Symbian Developers who are familiar with C++ standards. It is provided
-as a tool and needs to be used after careful consideration. </p> </context>
+<context id="GUID-D82AD7F2-633E-4A5B-9B82-4026A8F91B41"><p>Single phase constructor
+provides a means to use the RAII concepts for Symbian Developers who are familiar
+with C++ standards. It is provided as a tool and needs to be used after careful
+consideration. </p> </context>
<steps id="GUID-DF51DCE9-ACA3-4376-B4B3-4A31728670D2">
<step id="GUID-FA70E487-145A-4502-BB58-B09A42F69183"><cmd>Enabling single
phase constructor</cmd>
@@ -64,9 +65,10 @@
}</codeblock></stepxmp>
</step>
-<step id="GUID-D41D3443-FBFA-44DA-8E35-E82C12829F3D"><cmd>Need to declare the CONSTRUCTORS_MAY_LEAVE macro</cmd>
-<stepxmp><p>This is necessary because Symbian platform currently lacks the
-placement delete operator counterparts corresponding to the CBase placement
+<step id="GUID-D41D3443-FBFA-44DA-8E35-E82C12829F3D"><cmd>Need to declare
+the CONSTRUCTORS_MAY_LEAVE macro</cmd>
+<stepxmp><p>This is necessary because the Symbian platform currently lacks
+the placement delete operator counterparts corresponding to the CBase placement
new operators that take a TLeave parameter (new(ELeave)). The macro defines
these missing placement delete operators and ensures that all allocated memory
can be freed if a constructor leaves.</p></stepxmp>