--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-B71F0B0C-CFEB-583F-841D-07340DD6B9CE.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,29 @@
+<?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-B71F0B0C-CFEB-583F-841D-07340DD6B9CE" xml:lang="en"><title>Using
+TDes8Overflow</title><shortdesc>Use TDes8Overflow to handle overflow issues when calling the<apiname>TDes8::AppendFormat()</apiname> function.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>The <codeph>Overflow()</codeph> member function of the overflow handler, <xref href="GUID-6A13E649-D15A-3BD7-B5C2-4DC23211F276.dita"><apiname>TDes8Overflow</apiname></xref>,
+can be defined and implemented to handle a potential descriptor overflow resulting
+from a call to <xref href="GUID-445B19E5-E2EE-32E2-8D6C-C7D6A9B3C507.dita#GUID-445B19E5-E2EE-32E2-8D6C-C7D6A9B3C507/GUID-E8BE9DD1-2D96-3E8E-943A-CD2ECFD78333"><apiname>TDes8::AppendFormat()</apiname></xref>.</p>
+<p>There are many actions that the overflow function can perform but some
+possibilities are:</p>
+<ul>
+<li id="GUID-0543F1D9-4DAA-5433-BF08-55CF7DB7D690"><p>just return - in effect,
+this suppresses the panic caused by the overflow.</p> </li>
+<li id="GUID-F8D403D7-903E-5FAC-8ADC-F2FD0EE6CA6B"><p>leave.</p> </li>
+<li id="GUID-B28E1AF3-F1C0-51F4-97C3-EA8CCD2CDF2D"><p>replace the entire string
+with some error indication, e.g. "Overflowed"</p> </li>
+</ul>
+<p>For more complex recovery actions, it may be easier to set a flag in the
+implementation of the <codeph>TDes8Overflow</codeph> class and check it on
+return from the call to <codeph>AppendFormat()</codeph>.</p>
+</conbody></concept>
\ No newline at end of file