- From: CVS User akostiai <cvsmail@w3.org>
- Date: Wed, 19 Nov 2014 11:42:24 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/vibration
In directory roscoe:/tmp/cvs-serv20734
Modified Files:
Overview.html Overview.src.html PR.html PR.src.html
Log Message:
More editorial changes, keep in sync with ED.
--- /sources/public/2009/dap/vibration/Overview.html 2014/11/18 13:40:01 1.58
+++ /sources/public/2009/dap/vibration/Overview.html 2014/11/19 11:42:24 1.59
@@ -438,7 +438,7 @@
</p>
<h1 class="title p-name" id="title" property="dcterms:title">Vibration API</h1>
- <h2 property="dcterms:issued" datatype="xsd:dateTime" content="2014-11-18T11:38:21.000Z" id="w3c-editor-s-draft-18-november-2014"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2014-11-18">18 November 2014</time></h2>
+ <h2 property="dcterms:issued" datatype="xsd:dateTime" content="2014-11-19T09:38:59.000Z" id="w3c-editor-s-draft-19-november-2014"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2014-11-19">19 November 2014</time></h2>
<dl>
<dt>This version:</dt>
@@ -513,11 +513,26 @@
</p>
<p>
- No substantive changes have been made
- since the <a href="http://www.w3.org/TR/2014/CR-vibration-20140909/">
+ The following editorial changes were made since the
+ <a href="http://www.w3.org/TR/2014/CR-vibration-20140909/">
<abbr title="World Wide Web Consortium">W3C</abbr> Candidate Recommendation 09 September 2014</a>
- (<a href="PR-diff.html">diff</a>).
+ (<a href="PR-diff.html">diff</a>):
</p>
+ <ul>
+ <li>
+ The concept of a
+ <a href="#dfn-vibration-pattern">vibration pattern</a> was given a
+ name and a
+ <code><a href="#idl-def-VibratePattern">VibratePattern</a></code>
+ shorthand was added.
+ </li>
+ <li>
+ The
+ <a href="#dfn-validate-and-normalize">validate and normalize</a> and
+ <a href="#dfn-perform-vibration">perform vibration</a> algorithms
+ were made standalone.
+ </li>
+ </ul>
<p>
This document represents the consensus of the group on the scope and
features of the Vibration API. It should be noted that the group is
@@ -640,8 +655,9 @@
<section id="vibration-interface">
<!--OddPage--><h2 role="heading" id="h2_vibration-interface"><span class="secno">4. </span>Vibration Interface</h2>
- <pre class="idl"><span class="idlInterface" id="idl-def-Navigator">partial interface <span class="idlInterfaceID">Navigator</span> {
-<span class="idlMethod"> <span class="idlMethType">boolean</span> <span class="idlMethName"><a href="#widl-Navigator-vibrate-boolean-unsigned-long-sequence-unsigned-long--pattern">vibrate</a></span> (<span class="idlParam"><span class="idlParamType">(unsigned long or sequence<unsigned long>)</span> <span class="idlParamName">pattern</span></span>);</span>
+
+ <pre class="idl"><span class="idlInterface" id="idl-def-Navigator"><span class="idlTypedef" id="idl-def-VibratePattern">typedef <span class="idlTypedefType">(unsigned long or sequence<unsigned long>)</span> <span class="idlTypedefID">VibratePattern</span>;</span><br><br>partial interface <span class="idlInterfaceID">Navigator</span> {
+<span class="idlMethod"> <span class="idlMethType">boolean</span> <span class="idlMethName"><a href="#widl-Navigator-vibrate-boolean-VibratePattern-pattern">vibrate</a></span> (<span class="idlParam"><span class="idlParamType"><a href="#idl-def-VibratePattern" class="idlType"><code>VibratePattern</code></a></span> <span class="idlParamName">pattern</span></span>);</span>
};</span></pre>
<p>
@@ -666,6 +682,18 @@
<var>pattern</var> to <a href="#dfn-validate-and-normalize" class="internalDFN">validate and normalize</a>.
</li>
<li>
+ If the <code>
+ <a href="http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-hidden">
+ hidden</a></code> attribute [<cite><a class="bibref" href="#bib-PAGE-VISIBILITY">PAGE-VISIBILITY</a></cite>] is set to true,
+ then return false and terminate these steps.
+ <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_1"><span>Note</span></div><div class="">
+ A trusted (also known as privileged) application that integrates
+ closely with the operating system's functionality may vibrate the
+ device even if such an application is not visible at all, and thus
+ may ignore the previous step.
+ </div></div>
+ </li>
+ <li>
<a href="#dfn-perform-vibration" class="internalDFN">Perform vibration</a> with <var>valid pattern</var>.
</li>
</ol>
@@ -690,7 +718,7 @@
<li>
Let <var>max length</var> be an implementation-dependent maximum
length of <var>pattern</var>.
- <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_1"><span>Note</span></div><div class="">
+ <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_2"><span>Note</span></div><div class="">
If the length of a pattern is greater than max length an
implementation of this API could consider breaking the request
effectively into multiple shorter requests internally to achieve
@@ -708,7 +736,7 @@
If the length of <var>pattern</var> is greater than
<var>max length</var>, truncate <var>pattern</var>, leaving only
the first <var>max length</var> entries.
- <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_2"><span>Note</span></div><div class="" id="remove-last-entry">
+ <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_3"><span>Note</span></div><div class="" id="remove-last-entry">
If the length of the <var>pattern</var> is even and not zero then
the last entry in the pattern will have no effect so an
implementation can remove it from the <var>pattern</var> at this point.
@@ -733,18 +761,6 @@
</p>
<ol>
<li>
- If the <code>
- <a href="http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-hidden">
- hidden</a></code> attribute [<cite><a class="bibref" href="#bib-PAGE-VISIBILITY">PAGE-VISIBILITY</a></cite>] is set to true,
- then return false and terminate these steps.
- <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_3"><span>Note</span></div><div class="">
- A trusted (also known as privileged) application that integrates
- closely with the operating system's functionality may vibrate the
- device even if such an application is not visible at all, and thus
- may ignore the previous step.
- </div></div>
- </li>
- <li>
An implementation <em class="rfc2119" title="MAY">MAY</em> return false and terminate these steps.
<div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_4"><span>Note</span></div><div class="">
For example, an implementation might abort the
--- /sources/public/2009/dap/vibration/Overview.src.html 2014/11/18 13:40:01 1.26
+++ /sources/public/2009/dap/vibration/Overview.src.html 2014/11/19 11:42:24 1.27
@@ -38,11 +38,26 @@
<section id='sotd'>
<p>
- No substantive changes have been made
- since the <a href="http://www.w3.org/TR/2014/CR-vibration-20140909/">
+ The following editorial changes were made since the
+ <a href="http://www.w3.org/TR/2014/CR-vibration-20140909/">
W3C Candidate Recommendation 09 September 2014</a>
- (<a href="PR-diff.html">diff</a>).
+ (<a href="PR-diff.html">diff</a>):
</p>
+ <ul>
+ <li>
+ The concept of a
+ <a href="#dfn-vibration-pattern">vibration pattern</a> was given a
+ name and a
+ <code><a href="#idl-def-VibratePattern">VibratePattern</a></code>
+ shorthand was added.
+ </li>
+ <li>
+ The
+ <a href="#dfn-validate-and-normalize">validate and normalize</a> and
+ <a href="#dfn-perform-vibration">perform vibration</a> algorithms
+ were made standalone.
+ </li>
+ </ul>
<p>
This document represents the consensus of the group on the scope and
features of the Vibration API. It should be noted that the group is
@@ -91,11 +106,12 @@
<section>
<h2>Vibration Interface</h2>
- <dl title='partial interface Navigator' class='idl'>
+ <dl title="typedef (unsigned long or sequence<unsigned long>) VibratePattern" class="idl"></dl>
+ <dl title='partial interface Navigator' class='idl' data-merge="VibratePattern">
<dt>boolean vibrate()</dt>
<dd>
<dl class='parameters'>
- <dt>(unsigned long or sequence<unsigned long>) pattern</dt>
+ <dt>VibratePattern pattern</dt>
<dd></dd>
</dl>
</dd>
@@ -123,6 +139,18 @@
<var>pattern</var> to <a>validate and normalize</a>.
</li>
<li>
+ If the <code>
+ <a href="http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-hidden">
+ hidden</a></code> attribute [[!PAGE-VISIBILITY]] is set to true,
+ then return false and terminate these steps.
+ <div class="note">
+ A trusted (also known as privileged) application that integrates
+ closely with the operating system's functionality may vibrate the
+ device even if such an application is not visible at all, and thus
+ may ignore the previous step.
+ </div>
+ </li>
+ <li>
<a>Perform vibration</a> with <var>valid pattern</var>.
</li>
</ol>
@@ -190,18 +218,6 @@
</p>
<ol>
<li>
- If the <code>
- <a href="http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-hidden">
- hidden</a></code> attribute [[!PAGE-VISIBILITY]] is set to true,
- then return false and terminate these steps.
- <div class="note">
- A trusted (also known as privileged) application that integrates
- closely with the operating system's functionality may vibrate the
- device even if such an application is not visible at all, and thus
- may ignore the previous step.
- </div>
- </li>
- <li>
An implementation MAY return false and terminate these steps.
<div class="note">
For example, an implementation might abort the
--- /sources/public/2009/dap/vibration/PR.html 2014/11/18 13:40:01 1.3
+++ /sources/public/2009/dap/vibration/PR.html 2014/11/19 11:42:24 1.4
@@ -521,13 +521,16 @@
</p>
<ul>
<li>
- A dedicated name has been given to the
- <a href="#dfn-vibration-pattern">vibration pattern</a>.
+ The concept of a
+ <a href="#dfn-vibration-pattern">vibration pattern</a> was given a
+ name and a
+ <code><a href="#idl-def-VibratePattern">VibratePattern</a></code>
+ shorthand was added.
</li>
<li>
The
<a href="#dfn-validate-and-normalize">validate and normalize</a> and
- <a href="#dfn-perform-vibration">perform vibration</a> algorithmss
+ <a href="#dfn-perform-vibration">perform vibration</a> algorithms
were made standalone.
</li>
</ul>
@@ -658,8 +661,9 @@
<section id="vibration-interface">
<!--OddPage--><h2 role="heading" id="h2_vibration-interface"><span class="secno">4. </span>Vibration Interface</h2>
- <pre class="idl"><span class="idlInterface" id="idl-def-Navigator">partial interface <span class="idlInterfaceID">Navigator</span> {
-<span class="idlMethod"> <span class="idlMethType">boolean</span> <span class="idlMethName"><a href="#widl-Navigator-vibrate-boolean-unsigned-long-sequence-unsigned-long--pattern">vibrate</a></span> (<span class="idlParam"><span class="idlParamType">(unsigned long or sequence<unsigned long>)</span> <span class="idlParamName">pattern</span></span>);</span>
+
+ <pre class="idl"><span class="idlInterface" id="idl-def-Navigator"><span class="idlTypedef" id="idl-def-VibratePattern">typedef <span class="idlTypedefType">(unsigned long or sequence<unsigned long>)</span> <span class="idlTypedefID">VibratePattern</span>;</span><br><br>partial interface <span class="idlInterfaceID">Navigator</span> {
+<span class="idlMethod"> <span class="idlMethType">boolean</span> <span class="idlMethName"><a href="#widl-Navigator-vibrate-boolean-VibratePattern-pattern">vibrate</a></span> (<span class="idlParam"><span class="idlParamType"><a href="#idl-def-VibratePattern" class="idlType"><code>VibratePattern</code></a></span> <span class="idlParamName">pattern</span></span>);</span>
};</span></pre>
<p>
@@ -684,6 +688,18 @@
<var>pattern</var> to <a href="#dfn-validate-and-normalize" class="internalDFN">validate and normalize</a>.
</li>
<li>
+ If the <code>
+ <a href="http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-hidden">
+ hidden</a></code> attribute [<cite><a class="bibref" href="#bib-PAGE-VISIBILITY">PAGE-VISIBILITY</a></cite>] is set to true,
+ then return false and terminate these steps.
+ <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_1"><span>Note</span></div><div class="">
+ A trusted (also known as privileged) application that integrates
+ closely with the operating system's functionality may vibrate the
+ device even if such an application is not visible at all, and thus
+ may ignore the previous step.
+ </div></div>
+ </li>
+ <li>
<a href="#dfn-perform-vibration" class="internalDFN">Perform vibration</a> with <var>valid pattern</var>.
</li>
</ol>
@@ -708,7 +724,7 @@
<li>
Let <var>max length</var> be an implementation-dependent maximum
length of <var>pattern</var>.
- <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_1"><span>Note</span></div><div class="">
+ <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_2"><span>Note</span></div><div class="">
If the length of a pattern is greater than max length an
implementation of this API could consider breaking the request
effectively into multiple shorter requests internally to achieve
@@ -726,7 +742,7 @@
If the length of <var>pattern</var> is greater than
<var>max length</var>, truncate <var>pattern</var>, leaving only
the first <var>max length</var> entries.
- <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_2"><span>Note</span></div><div class="" id="remove-last-entry">
+ <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_3"><span>Note</span></div><div class="" id="remove-last-entry">
If the length of the <var>pattern</var> is even and not zero then
the last entry in the pattern will have no effect so an
implementation can remove it from the <var>pattern</var> at this point.
@@ -751,18 +767,6 @@
</p>
<ol>
<li>
- If the <code>
- <a href="http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-hidden">
- hidden</a></code> attribute [<cite><a class="bibref" href="#bib-PAGE-VISIBILITY">PAGE-VISIBILITY</a></cite>] is set to true,
- then return false and terminate these steps.
- <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_3"><span>Note</span></div><div class="">
- A trusted (also known as privileged) application that integrates
- closely with the operating system's functionality may vibrate the
- device even if such an application is not visible at all, and thus
- may ignore the previous step.
- </div></div>
- </li>
- <li>
An implementation <em class="rfc2119" title="MAY">MAY</em> return false and terminate these steps.
<div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_4"><span>Note</span></div><div class="">
For example, an implementation might abort the
--- /sources/public/2009/dap/vibration/PR.src.html 2014/11/18 13:40:01 1.3
+++ /sources/public/2009/dap/vibration/PR.src.html 2014/11/19 11:42:24 1.4
@@ -45,13 +45,16 @@
</p>
<ul>
<li>
- A dedicated name has been given to the
- <a href="#dfn-vibration-pattern">vibration pattern</a>.
+ The concept of a
+ <a href="#dfn-vibration-pattern">vibration pattern</a> was given a
+ name and a
+ <code><a href="#idl-def-VibratePattern">VibratePattern</a></code>
+ shorthand was added.
</li>
<li>
The
<a href="#dfn-validate-and-normalize">validate and normalize</a> and
- <a href="#dfn-perform-vibration">perform vibration</a> algorithmss
+ <a href="#dfn-perform-vibration">perform vibration</a> algorithms
were made standalone.
</li>
</ul>
@@ -103,11 +106,12 @@
<section>
<h2>Vibration Interface</h2>
- <dl title='partial interface Navigator' class='idl'>
+ <dl title="typedef (unsigned long or sequence<unsigned long>) VibratePattern" class="idl"></dl>
+ <dl title='partial interface Navigator' class='idl' data-merge="VibratePattern">
<dt>boolean vibrate()</dt>
<dd>
<dl class='parameters'>
- <dt>(unsigned long or sequence<unsigned long>) pattern</dt>
+ <dt>VibratePattern pattern</dt>
<dd></dd>
</dl>
</dd>
@@ -135,6 +139,18 @@
<var>pattern</var> to <a>validate and normalize</a>.
</li>
<li>
+ If the <code>
+ <a href="http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-hidden">
+ hidden</a></code> attribute [[!PAGE-VISIBILITY]] is set to true,
+ then return false and terminate these steps.
+ <div class="note">
+ A trusted (also known as privileged) application that integrates
+ closely with the operating system's functionality may vibrate the
+ device even if such an application is not visible at all, and thus
+ may ignore the previous step.
+ </div>
+ </li>
+ <li>
<a>Perform vibration</a> with <var>valid pattern</var>.
</li>
</ol>
@@ -202,18 +218,6 @@
</p>
<ol>
<li>
- If the <code>
- <a href="http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-hidden">
- hidden</a></code> attribute [[!PAGE-VISIBILITY]] is set to true,
- then return false and terminate these steps.
- <div class="note">
- A trusted (also known as privileged) application that integrates
- closely with the operating system's functionality may vibrate the
- device even if such an application is not visible at all, and thus
- may ignore the previous step.
- </div>
- </li>
- <li>
An implementation MAY return false and terminate these steps.
<div class="note">
For example, an implementation might abort the
Received on Wednesday, 19 November 2014 11:42:26 UTC