Cleaned up grammar on OTR for Nadim to look at
author"arangana <arun@mozilla.com>"
Wed, 19 Dec 2012 09:40:17 -0500
changeset 14 b0821b8f4024
parent 13 9b8cf5a8851a
child 15 848287df8618
Cleaned up grammar on OTR for Nadim to look at
Overview-UseCases.xml
Overview.html
--- a/Overview-UseCases.xml	Tue Dec 18 16:56:27 2012 -0500
+++ b/Overview-UseCases.xml	Wed Dec 19 09:40:17 2012 -0500
@@ -416,10 +416,10 @@
    </div>
   <div id='realtime-messaging' class='section'>
     <h3>Off The Record Real Time Messaging</h3>
-    <p>David and Nadim wish to have an "Off The Record" chat in real time, completely between them, primarily using text, as well as the ability to share digital data such as photographs.  They log on to a chat server, and connect to each other's machines directly.  The server merely serves up the UI for the chat client, and does not log their conversation (and in fact, cannot).  The respective web pages on David and Nadim's browsers may use WebSockets and the WebCrypto API to </p>
+    <p>David and Nadim wish to have an "Off The Record" chat in real time, completely between them, primarily using text, as well as the ability to share digital data such as photographs.  They log on to a chat server, and connect to each other's machines directly.  The server merely serves up the UI for the chat client, and does not log their conversation (and in fact, cannot).  The respective web pages on David and Nadim's browsers may use the <a href="#WebCrypto">WebCrypto API</a> to do the following things:</p>
     <ol>
-      <li><p>The generation of assymetric keys for David and Nadim respectively, such that both get public and private keys.  [<a href="#derive">DERIVE</a>]</p></li>
-      <li><p>A key exchange, so that David and Nadim get each other's public keys. It is conceivable that using the WebCrypto API the chat application can enable David and Nadim to use a Diffie-Hellman key exchange, or a mechanism such as SIGMA [cf.<a href="#OTR">OTR</a>] over <code>WebSocket</code>s [cf. <a href="#HTML">HTML</a>].  The key exchange which accompanies message exchanges involves the generation of cryptographically secure random numbers.  [<a href="#random">RANDOM</a> | <a href="#keyex">KEYEX</a> | <a href="#keyex-dh">KEYEX-DH</a>]</p></li>
+      <li><p>Generate assymetric keys for David and Nadim respectively, such that both get public and private keys.  [<a href="#derive">DERIVE</a>]</p></li>
+      <li><p>Engage in a key exchange, so that David and Nadim get each other's public keys. It is conceivable that using the WebCrypto API the chat application can enable David and Nadim to use a Diffie-Hellman key exchange, or a mechanism such as SIGMA [cf.<a href="#OTR">OTR</a>] over <code>WebSocket</code>s [cf. <a href="#HTML">HTML</a>].  The key exchange which accompanies message exchanges involves the generation of cryptographically secure random numbers.  [<a href="#random">RANDOM</a> | <a href="#keyex">KEYEX</a> | <a href="#keyex-dh">KEYEX-DH</a>]</p></li>
       <li><p>David or Nadim may now compose a message to each other.  Each message exchange involves authentication, message authentication codes, further key derivation, and further key exchanges. [<a href="#sign">SIGN</a> | <a href="#verify">VERIFY</a> | <a href="#mac">MAC</a> | <a href="#random">RANDOM</a> | <a href="#derive">DERIVE</a> | <a href="#keyex">KEYEX</a> | <a href="#keyex-dh">KEYEX-DH</a>] </p></li>
     </ol>
    <div class="ednote"><p>This use case needs additional details.</p></div>
--- a/Overview.html	Tue Dec 18 16:56:27 2012 -0500
+++ b/Overview.html	Wed Dec 19 09:40:17 2012 -0500
@@ -432,10 +432,10 @@
    </div>
   <div id="realtime-messaging" class="section">
     <h3>3.5. Off The Record Real Time Messaging</h3>
-    <p>David and Nadim wish to have an "Off The Record" chat in real time, completely between them, primarily using text, as well as the ability to share digital data such as photographs.  They log on to a chat server, and connect to each other's machines directly.  The server merely serves up the UI for the chat client, and does not log their conversation (and in fact, cannot).  The respective web pages on David and Nadim's browsers may use WebSockets and the WebCrypto API to </p>
+    <p>David and Nadim wish to have an "Off The Record" chat in real time, completely between them, primarily using text, as well as the ability to share digital data such as photographs.  They log on to a chat server, and connect to each other's machines directly.  The server merely serves up the UI for the chat client, and does not log their conversation (and in fact, cannot).  The respective web pages on David and Nadim's browsers may use the <a href="#WebCrypto">WebCrypto API</a> to do the following things:</p>
     <ol>
-      <li><p>The generation of assymetric keys for David and Nadim respectively, such that both get public and private keys.  [<a href="#derive">DERIVE</a>]</p></li>
-      <li><p>A key exchange, so that David and Nadim get each other's public keys. It is conceivable that using the WebCrypto API the chat application can enable David and Nadim to use a Diffie-Hellman key exchange, or a mechanism such as SIGMA [cf.<a href="#OTR">OTR</a>] over <code>WebSocket</code>s [cf. <a href="#HTML">HTML</a>].  The key exchange which accompanies message exchanges involves the generation of cryptographically secure random numbers.  [<a href="#random">RANDOM</a> | <a href="#keyex">KEYEX</a> | <a href="#keyex-dh">KEYEX-DH</a>]</p></li>
+      <li><p>Generate assymetric keys for David and Nadim respectively, such that both get public and private keys.  [<a href="#derive">DERIVE</a>]</p></li>
+      <li><p>Engage in a key exchange, so that David and Nadim get each other's public keys. It is conceivable that using the WebCrypto API the chat application can enable David and Nadim to use a Diffie-Hellman key exchange, or a mechanism such as SIGMA [cf.<a href="#OTR">OTR</a>] over <code>WebSocket</code>s [cf. <a href="#HTML">HTML</a>].  The key exchange which accompanies message exchanges involves the generation of cryptographically secure random numbers.  [<a href="#random">RANDOM</a> | <a href="#keyex">KEYEX</a> | <a href="#keyex-dh">KEYEX-DH</a>]</p></li>
       <li><p>David or Nadim may now compose a message to each other.  Each message exchange involves authentication, message authentication codes, further key derivation, and further key exchanges. [<a href="#sign">SIGN</a> | <a href="#verify">VERIFY</a> | <a href="#mac">MAC</a> | <a href="#random">RANDOM</a> | <a href="#derive">DERIVE</a> | <a href="#keyex">KEYEX</a> | <a href="#keyex-dh">KEYEX-DH</a>] </p></li>
     </ol>
    <div class="ednote"><div class="ednoteHeader">Editorial note</div><p>This use case needs additional details.</p></div>