--- a/Symbian3/PDK/Source/GUID-ED784025-4E65-4BE9-ADA8-A13427B6EA30.dita	Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-ED784025-4E65-4BE9-ADA8-A13427B6EA30.dita	Tue Mar 30 11:56:28 2010 +0100
@@ -4,10 +4,13 @@
 "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.
+    Nokia Corporation - initial contribution.
 Contributors: 
--->  <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-ED784025-4E65-4BE9-ADA8-A13427B6EA30" xml:lang="en"><title>Markable
-list</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-ED784025-4E65-4BE9-ADA8-A13427B6EA30" xml:lang="en"><title>Markable
+list</title><prolog><metadata><keywords/></metadata></prolog><conbody>
 <p>A markable list is a selection list with the added marking feature. The
 user can mark any number of items on the list while browsing it, and then
 execute a single command, which is applied to all the marked items. This is
@@ -18,9 +21,9 @@
 operations more quickly and with less key presses than by performing the command
 separately for each of the items.</p>
 <p>Marked items are indicated graphically.</p>
-<fig id="GUID-08F82B30-CF52-42CA-97F5-D1D3A1C48460">
+<fig id="GUID-171B4713-C197-4D05-9FBC-E3296C26ABFF">
 <title>Markable list. Marked items are indicated graphically in the list.</title>
-<image href="GUID-B142FB0F-518F-436A-83D1-57BDE9671E44_d0e80133_href.png" scale="40" placement="inline"></image>
+<image href="GUID-8CCA308A-5302-4D95-8E60-DA75D8B6DC41_d0e89483_href.png" placement="inline"/>
 </fig>
 <p>The <b>Mark</b> and <b>Unmark</b> functions are available in the Options
 menu of the markable list. Alternatively, or as a shortcut, the user can keep
@@ -74,8 +77,97 @@
 options.</p>
 <p>For other keypad actions, see <xref href="GUID-0822B030-E776-4BD5-B9C9-23D3821BCE1F.dita">Selection
 list</xref>.</p>
-<section><title>Using markable lists
-in C++ applications</title><p>The API to use for markable lists is the Lists
-API. For implementation information, see Using
-the Lists API.</p></section>
+<table id="GUID-385DFE50-AC9B-4C4E-BCE4-98A088443E77"><title>Default touch
+events for Markable lists</title>
+<tgroup cols="3"><colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/><colspec colname="col3" colwidth="1.19*"/>
+<thead>
+<row>
+<entry valign="top"><p>User action</p></entry>
+<entry valign="top"><p>State change</p></entry>
+<entry valign="top"><p>Feedback</p></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p>Touch down</p></entry>
+<entry><p>The marked/unmarked status of all items remains unchanged.</p></entry>
+<entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio
+feedback is provided with touch down.</p></entry>
+</row>
+<row>
+<entry><p>Touch release, while no item is marked</p></entry>
+<entry><p>Activates the item</p></entry>
+<entry><p>Highlight disappears. </p><p>Tactile: Basic list effect is provided
+with touch release event.</p></entry>
+</row>
+<row>
+<entry><p>Touch down and hold, while no item is marked</p></entry>
+<entry><p>Stylus pop-up menu is opened with an option Mark <i>§QTN_OPTIONS_LIST_MARK_ONE§</i>. </p><p>If
+user selects Mark, the pop-up is closed, highlight removed and the item becomes
+marked.</p></entry>
+<entry><p>Highlight is shown. Animation is shown to indicate the opening pop-up. </p><p>Tactile:
+If activates a long touch, then increasing long touch effect is provided with
+hold event and pop-up effect is provided when the pop-up is opened.</p></entry>
+</row>
+<row>
+<entry><p>Touch release, while at least one item is marked</p></entry>
+<entry><p>A context specific options menu opens. The marked/unmarked status
+of all items remains unchanged. </p><p>Context specific options menu should
+contain items for Mark/Unmark and any needed items that apply to all marked
+items.</p></entry>
+<entry><p>Highlight disappears. Tactile: Pop-up open effect is provided. If
+pop-up has theme effects and they are ON, then increasing long touch effect
+is provided with touch release.</p></entry>
+</row>
+<row>
+<entry><p>Touch down and hold, while at least one item is marked</p></entry>
+<entry><p>Inactive</p></entry>
+<entry><p>Tactile: No effect</p></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<p/>
+<table id="GUID-BD658610-F69D-4CF6-9025-1BC567D3025A"><title>Default touch/key
+events for markable lists</title>
+<tgroup cols="3"><colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/><colspec colname="col3" colwidth="1.19*"/>
+<thead>
+<row>
+<entry valign="top"><p>User action</p></entry>
+<entry valign="top"><p>State change</p></entry>
+<entry valign="top"><p>Feedback</p></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p>Control and touch down</p></entry>
+<entry><p>Mark/unmark the item touched. </p><p>Toggle between marked and unmarked.</p></entry>
+<entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio
+feedback is provided with touch down.</p></entry>
+</row>
+<row>
+<entry><p>Control and touch release</p></entry>
+<entry><p>No effect</p></entry>
+<entry><p>Highlight disappears. </p><p>Tactile: No effect.</p></entry>
+</row>
+<row>
+<entry><p>Shift and touch down</p></entry>
+<entry><p>If there is highlight brought by the hardware key event, mark/unmark
+all items between focused and touched down item. </p><p>If the item touched
+down is unmarked, then all items between the item and focused item are marked,
+and vice versa.</p></entry>
+<entry><p>Highlight is shown.</p><p>Tactile: Basic list effect and audio feedback
+is provided with touch down.</p></entry>
+</row>
+<row>
+<entry><p>Control/Shift and touch down and hold</p></entry>
+<entry><p>Inactive</p></entry>
+<entry><p>Tactile: No effect</p></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<section id="GUID-69189A53-90FA-4874-AC60-D18D120C9C90"><title>Using
+markable lists in C++ applications</title><p>The API to use for markable lists
+is the <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref>. For implementation information, see <xref format="htrml" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html#Lists_API_Specification.topic3" scope="peer">Using the Lists API</xref>.</p></section>
 </conbody></concept>
\ No newline at end of file