Bug 25661 - Tweak the wording of conformance requirements language to make it clear that "algorithms" extends to "specific steps",
and not just those enumerated in the "algorithms" section (eg: 'parse an SPKI')
--- 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
@@ -306,14 +306,14 @@
uses both the terms "conforming user agent" and "user agent" to refer to this
product class.
</p>
- <p>
- User agents <span class='RFC2119'>MAY</span> implement algorithms in this
- specification in any way desired, so long as the end result is indistinguishable
- from the result that would be obtained from the specification's algorithms.
- </p>
</dd>
</dl>
<p>
+ Conformance requirements phrased as algorithms or specific steps may be implemented in any
+ manner, so long as the end result is equivalent. (In particular, the algorithms defined in
+ this specification are intended to be easy to follow, and not intended to be performant.)
+ </p>
+ <p>
User agents that use ECMAScript to implement the APIs defined in this specification
<span class='RFC2119'>MUST</span> implement them in a manner consistent with the
ECMAScript Bindings defined in the Web IDL specification [<a href="#WebIDL">WEBIDL</a>]
--- a/spec/Overview.html Mon Jun 16 00:00:00 2014 -0700
+++ b/spec/Overview.html Mon Jun 16 00:00:00 2014 -0700
@@ -314,14 +314,14 @@
uses both the terms "conforming user agent" and "user agent" to refer to this
product class.
</p>
- <p>
- User agents <span class="RFC2119">MAY</span> implement algorithms in this
- specification in any way desired, so long as the end result is indistinguishable
- from the result that would be obtained from the specification's algorithms.
- </p>
</dd>
</dl>
<p>
+ Conformance requirements phrased as algorithms or specific steps may be implemented in any
+ manner, so long as the end result is equivalent. (In particular, the algorithms defined in
+ this specification are intended to be easy to follow, and not intended to be performant.)
+ </p>
+ <p>
User agents that use ECMAScript to implement the APIs defined in this specification
<span class="RFC2119">MUST</span> implement them in a manner consistent with the
ECMAScript Bindings defined in the Web IDL specification [<a href="#WebIDL">WEBIDL</a>]