--- a/Symbian3/PDK/Source/GUID-AB0A3E87-6725-5E83-B462-1219CE205187.dita Tue Jul 20 12:00:49 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-AB0A3E87-6725-5E83-B462-1219CE205187.dita Fri Aug 13 16:47:46 2010 +0100
@@ -1,125 +1,125 @@
-<?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-AB0A3E87-6725-5E83-B462-1219CE205187" xml:lang="en"><title>Bluetooth
-Notifiers Support Overview</title><shortdesc>The Bluetooth Notifiers Support component enables you to create
-dialogs to interact with device users about Bluetooth interactions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
-<section id="GUID-54214036-18F9-4CBD-8BFE-47949757F7B7"><title>Purpose</title> <p>The Bluetooth Notifiers component enables
-you to create dialogs for interacting with device users about Bluetooth interactions.
-You can offer Bluetooth dialogs for several purposes, but the main purpose
-is to provide security for Bluetooth interactions. </p> </section>
-<section id="GUID-098A9B42-C063-401E-AEAC-1EF8138577F7"><title>Required background</title> <p>You need to be familiar with
-the core Bluetooth concepts. </p> </section>
-<section id="GUID-4DBBEDCA-748B-4510-A30A-7D0E41E91978"><title>Key concepts and terms</title> <dl>
-<dlentry>
-<dt>Pairing</dt>
-<dd><p>Pairing takes place when two devices establish a trusted relationship
-with each other for secure communication. </p> </dd>
-</dlentry>
-<dlentry>
-<dt>Passkey</dt>
-<dd><p>A passkey is a piece of data known only to the two parties involved
-in the communication. It is also known as a shared secret. In the Symbian
-Bluetooth context, a Passkey Display notifier is a dialog that uses a 6-digit
-number, which is generated by Symbian platform and then manually entered on
-a peer device. </p> </dd>
-</dlentry>
-<dlentry>
-<dt>Secure Simple Pairing (SSP)</dt>
-<dd><p>Secure Simple Pairing is pairing that takes place with an automatically
-generated PIN. The user does not create a PIN. </p> </dd>
-</dlentry>
-</dl> </section>
-<section id="GUID-29FB501A-81B5-403C-98E7-734E8E94C5DE"><title>Architecture</title> </section>
-<section id="GUID-1B3F6608-274E-44E8-B325-64CDA1F6C3E9"><title>APIs</title> <p>The key classes of Symbian's implementation
-of Bluetooth Notifiers are as follows: </p> <table id="GUID-8DD9C644-EE92-5CA6-B9E0-97833F4675EA">
-<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
-<thead>
-<row>
-<entry>API</entry>
-<entry>Description</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry><p> <xref href="GUID-848C1394-A007-3B4A-84FF-C790EC2FECAD.dita"><apiname>CPinCodeEntryNotifier</apiname></xref> </p> </entry>
-<entry><p>The class to provide a PIN-code entry notifier. </p> </entry>
-</row>
-<row>
-<entry><p> <xref href="GUID-1D32697F-4A33-3B9B-9A53-B3ADCA8A215A.dita"><apiname>CNumericComparisonNotifier</apiname></xref> </p> </entry>
-<entry><p>The class to provide a numeric comparison notifier. </p> </entry>
-</row>
-<row>
-<entry><p> <xref href="GUID-CA141385-E969-359A-9706-42451962CE0F.dita"><apiname>CPasskeyNotifier</apiname></xref> </p> </entry>
-<entry><p>The class to provide a passkey display notifier. </p> </entry>
-</row>
-<row>
-<entry><p> <xref href="GUID-986EFB63-1F05-35AF-87DB-3FED6B8E4588.dita"><apiname>CPasskeyDisplayNotifier</apiname></xref> </p> </entry>
-<entry><p>The class to provide a passkey display notifier. The passkey entry
-display notifier can currently receive two types of updates: </p> <ul>
-<li id="GUID-5A532F95-97D6-5687-96F9-A583CF5C0EA7"><p>Updates to the remote
-device name (the same as the other notifiers). </p> <p>Updates to provide
-the notification of a key press by the remote keyboard. </p> </li>
-</ul> <p>As a Symbian platform device will be the display part of the pairing
-method, the remote device will be keyboard only and so not feature a display.
-It is highly recommended that the key press notifications provide a visual
-representation of keys being registered to help the device user. </p> </entry>
-</row>
-</tbody>
-</tgroup>
-</table> </section>
-<section id="GUID-E34A48B1-3A23-4B0E-A151-45784C5592E8"><title>Text notifiers library details</title> <p>The Bluetooth Notifiers
-component has one published library. The DLL that provides the functionality
-and the library to which your code must link is identified below. </p> <table id="GUID-C6EC280C-A748-55CE-8C82-34289E9F0B99">
-<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
-<thead>
-<row>
-<entry>DLL</entry>
-<entry>LIB</entry>
-<entry>Short description</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry><p> <filepath>textnotifiers.dll </filepath> </p> </entry>
-<entry><p> <filepath>textnotifiers.lib</filepath> </p> </entry>
-<entry><p>Basic types used to allow interactions with standard Bluetooth notifiers. </p> </entry>
-</row>
-</tbody>
-</tgroup>
-</table> </section>
-<section id="GUID-47B2A688-40B4-4441-B1D1-E55F75531E85"><title>Typical uses</title> <p>The key purpose of Bluetooth Notifiers
-is to create dialogs to enable secure pairing. The Bluetooth Notifier provides
-the following types of authentication dialog to enable secure pairing: </p> <ul>
-<li id="GUID-E2DE8A0B-33A7-5863-BE2C-28C0C2AA44AE"><p> <b>Authorisation dialog</b> </p> <p>Authorisation
-dialogs offer device users the choice to accept or reject connections. </p> </li>
-<li id="GUID-B1940F8D-12E5-50E7-9109-2CAB7758B774"><p> <b>PIN-code entry notifier</b> </p> <p>A
-user creates a PIN and sends it to the peer. </p> </li>
-<li id="GUID-07996989-0294-5CDD-8018-3450415F30D4"><p> <b>Numeric comparison
-notifier</b> </p> <p>Numeric Comparison involves the user comparing 6-digit
-numbers displayed on both devices that are authenticating. Authentication
-is completed by the users of both devices signalling a confirmation that the
-displayed numbers are identical – if one device is unable to input a confirmation
-then only the other device needs to signal confirmation </p> </li>
-<li id="GUID-0BC7AA7C-7539-510D-8D0B-179A69D43200"><p> <b>Passkey display
-notifier </b> </p> <p>Authentication by Passkey Entry involves the Symbian
-platform device displaying a 6-digit number which is manually entered on a
-device without a display (but with a numeric keypad). This is similar to PIN
-Code Entry except in this case the number is chosen for the user, and it need
-only be entered on the peer device. </p> </li>
-</ul> <p>In addition to the authentication notifiers, it is possible to use
-Bluetooth Notifiers for device selection dialogs. Device selection dialogs
-are for use by applications and profiles to decide which device the user wishes
-to connect to. Device selection dialogs do not need to be Bluetooth notifiers.
-Whereas the authentication notifiers are not associated with an application,
-device selection notifiers are. Therefore it is best to get the relevant application,
-for example a camera, to create the dialog. </p> </section>
+<?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-AB0A3E87-6725-5E83-B462-1219CE205187" xml:lang="en"><title>Bluetooth
+Notifiers Support Overview</title><shortdesc>The Bluetooth Notifiers Support component enables you to create
+dialogs to interact with device users about Bluetooth interactions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-54214036-18F9-4CBD-8BFE-47949757F7B7"><title>Purpose</title> <p>The Bluetooth Notifiers component enables
+you to create dialogs for interacting with device users about Bluetooth interactions.
+You can offer Bluetooth dialogs for several purposes, but the main purpose
+is to provide security for Bluetooth interactions. </p> </section>
+<section id="GUID-098A9B42-C063-401E-AEAC-1EF8138577F7"><title>Required background</title> <p>You need to be familiar with
+the core Bluetooth concepts. </p> </section>
+<section id="GUID-4DBBEDCA-748B-4510-A30A-7D0E41E91978"><title>Key concepts and terms</title> <dl>
+<dlentry>
+<dt>Pairing</dt>
+<dd><p>Pairing takes place when two devices establish a trusted relationship
+with each other for secure communication. </p> </dd>
+</dlentry>
+<dlentry>
+<dt>Passkey</dt>
+<dd><p>A passkey is a piece of data known only to the two parties involved
+in the communication. It is also known as a shared secret. In the Symbian
+Bluetooth context, a Passkey Display notifier is a dialog that uses a 6-digit
+number, which is generated by Symbian platform and then manually entered on
+a peer device. </p> </dd>
+</dlentry>
+<dlentry>
+<dt>Secure Simple Pairing (SSP)</dt>
+<dd><p>Secure Simple Pairing is pairing that takes place with an automatically
+generated PIN. The user does not create a PIN. </p> </dd>
+</dlentry>
+</dl> </section>
+<section id="GUID-29FB501A-81B5-403C-98E7-734E8E94C5DE"><title>Architecture</title> </section>
+<section id="GUID-1B3F6608-274E-44E8-B325-64CDA1F6C3E9"><title>APIs</title> <p>The key classes of Symbian's implementation
+of Bluetooth Notifiers are as follows: </p> <table id="GUID-8DD9C644-EE92-5CA6-B9E0-97833F4675EA">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<thead>
+<row>
+<entry>API</entry>
+<entry>Description</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p> <xref href="GUID-848C1394-A007-3B4A-84FF-C790EC2FECAD.dita"><apiname>CPinCodeEntryNotifier</apiname></xref> </p> </entry>
+<entry><p>The class to provide a PIN-code entry notifier. </p> </entry>
+</row>
+<row>
+<entry><p> <xref href="GUID-1D32697F-4A33-3B9B-9A53-B3ADCA8A215A.dita"><apiname>CNumericComparisonNotifier</apiname></xref> </p> </entry>
+<entry><p>The class to provide a numeric comparison notifier. </p> </entry>
+</row>
+<row>
+<entry><p> <xref href="GUID-CA141385-E969-359A-9706-42451962CE0F.dita"><apiname>CPasskeyNotifier</apiname></xref> </p> </entry>
+<entry><p>The class to provide a passkey display notifier. </p> </entry>
+</row>
+<row>
+<entry><p> <xref href="GUID-986EFB63-1F05-35AF-87DB-3FED6B8E4588.dita"><apiname>CPasskeyDisplayNotifier</apiname></xref> </p> </entry>
+<entry><p>The class to provide a passkey display notifier. The passkey entry
+display notifier can currently receive two types of updates: </p> <ul>
+<li id="GUID-5A532F95-97D6-5687-96F9-A583CF5C0EA7"><p>Updates to the remote
+device name (the same as the other notifiers). </p> <p>Updates to provide
+the notification of a key press by the remote keyboard. </p> </li>
+</ul> <p>As a Symbian platform device will be the display part of the pairing
+method, the remote device will be keyboard only and so not feature a display.
+It is highly recommended that the key press notifications provide a visual
+representation of keys being registered to help the device user. </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table> </section>
+<section id="GUID-E34A48B1-3A23-4B0E-A151-45784C5592E8"><title>Text notifiers library details</title> <p>The Bluetooth Notifiers
+component has one published library. The DLL that provides the functionality
+and the library to which your code must link is identified below. </p> <table id="GUID-C6EC280C-A748-55CE-8C82-34289E9F0B99">
+<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
+<thead>
+<row>
+<entry>DLL</entry>
+<entry>LIB</entry>
+<entry>Short description</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p> <filepath>textnotifiers.dll </filepath> </p> </entry>
+<entry><p> <filepath>textnotifiers.lib</filepath> </p> </entry>
+<entry><p>Basic types used to allow interactions with standard Bluetooth notifiers. </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table> </section>
+<section id="GUID-47B2A688-40B4-4441-B1D1-E55F75531E85"><title>Typical uses</title> <p>The key purpose of Bluetooth Notifiers
+is to create dialogs to enable secure pairing. The Bluetooth Notifier provides
+the following types of authentication dialog to enable secure pairing: </p> <ul>
+<li id="GUID-E2DE8A0B-33A7-5863-BE2C-28C0C2AA44AE"><p> <b>Authorisation dialog</b> </p> <p>Authorisation
+dialogs offer device users the choice to accept or reject connections. </p> </li>
+<li id="GUID-B1940F8D-12E5-50E7-9109-2CAB7758B774"><p> <b>PIN-code entry notifier</b> </p> <p>A
+user creates a PIN and sends it to the peer. </p> </li>
+<li id="GUID-07996989-0294-5CDD-8018-3450415F30D4"><p> <b>Numeric comparison
+notifier</b> </p> <p>Numeric Comparison involves the user comparing 6-digit
+numbers displayed on both devices that are authenticating. Authentication
+is completed by the users of both devices signalling a confirmation that the
+displayed numbers are identical – if one device is unable to input a confirmation
+then only the other device needs to signal confirmation </p> </li>
+<li id="GUID-0BC7AA7C-7539-510D-8D0B-179A69D43200"><p> <b>Passkey display
+notifier </b> </p> <p>Authentication by Passkey Entry involves the Symbian
+platform device displaying a 6-digit number which is manually entered on a
+device without a display (but with a numeric keypad). This is similar to PIN
+Code Entry except in this case the number is chosen for the user, and it need
+only be entered on the peer device. </p> </li>
+</ul> <p>In addition to the authentication notifiers, it is possible to use
+Bluetooth Notifiers for device selection dialogs. Device selection dialogs
+are for use by applications and profiles to decide which device the user wishes
+to connect to. Device selection dialogs do not need to be Bluetooth notifiers.
+Whereas the authentication notifiers are not associated with an application,
+device selection notifiers are. Therefore it is best to get the relevant application,
+for example a camera, to create the dialog. </p> </section>
</conbody></concept>
\ No newline at end of file