Bug 25469 - Remove outdated editorial note to "password" field of PBKDF2 parameters.
authorRyan Sleevi <sleevi@google.com>
Mon, 16 Jun 2014 00:00:00 -0700
changeset 190 0841c24aa2ee
parent 189 ca21c15aed40
child 191 e0cd6df0a473
Bug 25469 - Remove outdated editorial note to "password" field of PBKDF2 parameters.
spec/Overview-WebCryptoAPI.xml
spec/Overview.html
--- a/spec/Overview-WebCryptoAPI.xml	Mon Jun 16 00:00:00 2014 -0700
+++ b/spec/Overview-WebCryptoAPI.xml	Mon Jun 16 00:00:00 2014 -0700
@@ -16323,14 +16323,6 @@
   AlgorithmIdentifier <dfn id="dfn-Pbkdf2Params-hash">hash</dfn>;
 };
             </x:codeblock>
-            <div class="ednote">
-              <p>
-                In the above snippet, <code>password</code> is an optional field. The intent is
-                that conforming user agents <span class="RFC2119">MAY</span> support applications
-                that wish to use PBKDF2 by providing password entry via an un-spoofable (by the
-                web application) UI.
-              </p>
-            </div>
           </div>
           <div id="pbkdf2-operations" class="section">
             <h4>Operations</h4>
@@ -16411,16 +16403,15 @@
                   <li>
                     <p>
                       If <var>usages</var> contains any element that is not
-                       <code>"deriveKey"</code>,
-                              then <a href="#concept-return-an-error">return an error</a> named
-                              <a href="#dfn-DataError"><code>DataError</code></a>.
-                    </p>
-                  </li>
-                  <li>
-                    <p>
-                      If <var>extractable</var> is true, 
-                              then <a href="#concept-return-an-error">return an error</a> named
-                              <a href="#dfn-DataError"><code>DataError</code></a>.
+                      <code>"deriveKey"</code>, then <a href="#concept-return-an-error">return an
+                      error</a> named <a href="#dfn-DataError"><code>DataError</code></a>.
+                    </p>
+                  </li>
+                  <li>
+                    <p>
+                      If <var>extractable</var> is true, then <a
+                      href="#concept-return-an-error">return an error</a> named <a
+                      href="#dfn-DataError"><code>DataError</code></a>.
                     </p>
                   </li>
                   <li>
@@ -16431,7 +16422,7 @@
                   <li>
                     <p>
                       Let <var>key</var> be a new <a href="#dfn-CryptoKey">CryptoKey</a> object
-                      representing the provided password, encoded using UTF-8.
+                      representing the provided password as a series of bytes encoded using UTF-8.
                     </p>
                   </li>
                   <li>
@@ -16483,18 +16474,16 @@
                 <ol>
                   <li>
                     <p>
-                      If <var>format</var> is not
-                      <code>"raw"</code>,
-                      <a href="#concept-return-an-error">return an error</a> named
-                      <a href="#dfn-NotSupportedError"><code>NotSupportedError</code></a>
+                      If <var>format</var> is not <code>"raw"</code>, <a
+                      href="#concept-return-an-error">return an error</a> named <a
+                      href="#dfn-NotSupportedError"><code>NotSupportedError</code></a>
                     </p>
                   </li>
                   <li>
                     <p>
                       If <var>usages</var> contains any element that is not
-                       <code>"deriveKey"</code>,
-                       then <a href="#concept-return-an-error">return an error</a> named
-                       <a href="#dfn-DataError"><code>DataError</code></a>.
+                      <code>"deriveKey"</code>, then <a href="#concept-return-an-error">return an
+                      error</a> named <a href="#dfn-DataError"><code>DataError</code></a>.
                     </p>
                   </li>
                   <li>
--- a/spec/Overview.html	Mon Jun 16 00:00:00 2014 -0700
+++ b/spec/Overview.html	Mon Jun 16 00:00:00 2014 -0700
@@ -44,7 +44,7 @@
         communications.
       </p>
   
-      <div class="ednote"><div class="ednoteHeader">Editorial note</div><p>There are 20 further editorial notes in the document.</p></div>
+      <div class="ednote"><div class="ednoteHeader">Editorial note</div><p>There are 19 further editorial notes in the document.</p></div>
     </div>
 
     <div class="section">
@@ -15932,14 +15932,6 @@
   AlgorithmIdentifier <dfn id="dfn-Pbkdf2Params-hash">hash</dfn>;
 };
             </code></pre></div></div>
-            <div class="ednote"><div class="ednoteHeader">Editorial note</div>
-              <p>
-                In the above snippet, <code>password</code> is an optional field. The intent is
-                that conforming user agents <span class="RFC2119">MAY</span> support applications
-                that wish to use PBKDF2 by providing password entry via an un-spoofable (by the
-                web application) UI.
-              </p>
-            </div>
           </div>
           <div id="pbkdf2-operations" class="section">
             <h4>18.21.4. Operations</h4>
@@ -16015,16 +16007,13 @@
                   <li>
                     <p>
                       If <var>usages</var> contains any element that is not
-                       <code>"deriveKey"</code>,
-                              then <a href="#concept-return-an-error">return an error</a> named
-                              <a href="#dfn-DataError"><code>DataError</code></a>.
-                    </p>
-                  </li>
-                  <li>
-                    <p>
-                      If <var>extractable</var> is true, 
-                              then <a href="#concept-return-an-error">return an error</a> named
-                              <a href="#dfn-DataError"><code>DataError</code></a>.
+                      <code>"deriveKey"</code>, then <a href="#concept-return-an-error">return an
+                      error</a> named <a href="#dfn-DataError"><code>DataError</code></a>.
+                    </p>
+                  </li>
+                  <li>
+                    <p>
+                      If <var>extractable</var> is true, then <a href="#concept-return-an-error">return an error</a> named <a href="#dfn-DataError"><code>DataError</code></a>.
                     </p>
                   </li>
                   <li>
@@ -16035,7 +16024,7 @@
                   <li>
                     <p>
                       Let <var>key</var> be a new <a href="#dfn-CryptoKey">CryptoKey</a> object
-                      representing the provided password, encoded using UTF-8.
+                      representing the provided password as a series of bytes encoded using UTF-8.
                     </p>
                   </li>
                   <li>
@@ -16087,18 +16076,14 @@
                 <ol>
                   <li>
                     <p>
-                      If <var>format</var> is not
-                      <code>"raw"</code>,
-                      <a href="#concept-return-an-error">return an error</a> named
-                      <a href="#dfn-NotSupportedError"><code>NotSupportedError</code></a>
+                      If <var>format</var> is not <code>"raw"</code>, <a href="#concept-return-an-error">return an error</a> named <a href="#dfn-NotSupportedError"><code>NotSupportedError</code></a>
                     </p>
                   </li>
                   <li>
                     <p>
                       If <var>usages</var> contains any element that is not
-                       <code>"deriveKey"</code>,
-                       then <a href="#concept-return-an-error">return an error</a> named
-                       <a href="#dfn-DataError"><code>DataError</code></a>.
+                      <code>"deriveKey"</code>, then <a href="#concept-return-an-error">return an
+                      error</a> named <a href="#dfn-DataError"><code>DataError</code></a>.
                     </p>
                   </li>
                   <li>