Skip to content

Commit a95f47a

Browse files
marcoscaceresreillyeon
marcoscaceres
and
reillyeon
authored
Editorial: fix 'in parallel' usage (#129)
* Editorial: fix 'in parallel' usage * Update index.html Co-authored-by: Reilly Grant <reillyeon@users.noreply.github.com> Co-authored-by: Reilly Grant <reillyeon@users.noreply.github.com>
1 parent eaa69f3 commit a95f47a

File tree

1 file changed

+59
-52
lines changed

1 file changed

+59
-52
lines changed

‎index.html‎

Lines changed: 59 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -628,8 +628,8 @@ <h2>
628628
</li>
629629
</ol>
630630
</li>
631-
<li>[=In parallel=], [=request a position=] passing
632-
|successCallback|, |errorCallback|, and |options|.
631+
<li>[=Request a position=] passing [=this=], |successCallback|,
632+
|errorCallback|, and |options|.
633633
</li>
634634
</ol>
635635
</section>
@@ -660,8 +660,8 @@ <h2>
660660
<li>[=List/Append=] |watchId| to [=this=]'s
661661
{{Geolocation/[[watchIDs]]}}.
662662
</li>
663-
<li>[=In parallel=], [=request a position=] passing
664-
|successCallback|, |errorCallback|, |options|, and |watchId|.
663+
<li>[=Request a position=] passing [=this=], |successCallback|,
664+
|errorCallback|, |options|, and |watchId|.
665665
</li>
666666
<li>Return |watchId|.
667667
</li>
@@ -685,15 +685,17 @@ <h2>
685685
Request a position
686686
</h2>
687687
<p>
688-
To <dfn>request a position</dfn>, pass a {{PositionCallback}}
688+
To <dfn>request a position</dfn>, pass a {{Geolocation}}
689+
|geolocation:Geolocation|, a {{PositionCallback}}
689690
|successCallback:PositionCallback|, a {{PositionErrorCallback?}}
690-
|errorCallback:PositionErrorCallback?|, {{PositionOptions}}
691+
|errorCallback:PositionErrorCallback?|, a {{PositionOptions}}
691692
|options:PositionOptions|, and an optional |watchId:unsigned long|:
692693
</p>
693694
<ol class="algorithm">
694-
<li>Let |watchIDs:List| be [=this=]'s {{Geolocation/[[watchIDs]]}}.
695+
<li>Let |watchIDs:List| be |geolocation|'s
696+
{{Geolocation/[[watchIDs]]}}.
695697
</li>
696-
<li>Let |document:Document| be the [=this=]'s [=relevant global
698+
<li>Let |document:Document| be the |geolocation|'s [=relevant global
697699
object=]'s [=associated `Document`=].
698700
</li>
699701
<li data-tests="">If |document| is not [=allowed to use=] the
@@ -723,56 +725,61 @@ <h2>
723725
<li>Let |descriptor| be a new {{PermissionDescriptor}} whose
724726
{{PermissionDescriptor/name}} is <a>"geolocation"</a>.
725727
</li>
726-
<li>Set |permission| to [=request permission to use=] |descriptor|.
727-
</li>
728-
<li data-tests=
729-
"getCurrentPosition_permission_allow.https.html, getCurrentPosition_permission_deny.https.html">
730-
If |permission| is "denied", then:
731-
<ol>
732-
<li>If |watchId| was passed, [=list/remove=] |watchId| from
733-
|watchIDs|.
734-
</li>
735-
<li>[=Call back with error=] passing |errorCallback| and
736-
{{GeolocationPositionError/PERMISSION_DENIED}}.
737-
</li>
738-
<li>Terminate this algorithm.
739-
</li>
740-
</ol>
741-
</li>
742-
<li>Wait to [=acquire a position=] passing |successCallback|,
743-
|errorCallback|, |options|, and |watchId|.
744-
</li>
745-
<li>If |watchId| was not passed, terminate this algorithm.
746-
</li>
747-
<li>While |watchIDs| [=list/contains=] |watchId|:
728+
<li>[=In parallel=]:
748729
<ol>
749-
<li>
750-
<span id="wait-for-change">Wait for a significant change of
751-
geographic position</span>. What constitutes a significant
752-
change of geographic position is left to the implementation.
753-
User agents MAY impose a rate limit on how frequently position
754-
changes are reported.
730+
<li>Set |permission| to [=request permission to use=]
731+
|descriptor|.
755732
</li>
756-
<li>If |document| is not [=Document/fully active=] or
757-
[=Document/visibility state=] is not "visible", go back to the
758-
previous step and again <a href="#wait-for-change">wait for a
759-
significant change of geographic position</a>.
760-
<aside class="note" title=
761-
"Position updates are exclusively for fully-active visible documents">
762-
<p>
763-
The desired effect here being that position updates are
764-
exclusively delivered to fully active documents that are
765-
visible; Otherwise the updates get silently "dropped on the
766-
floor". Only once a document again becomes fully active and
767-
visible (e.g., an [^iframe^] gets reattached to a parent
768-
document), do the position updates once again start getting
769-
delivered.
770-
</p>
771-
</aside>
733+
<li data-tests=
734+
"getCurrentPosition_permission_allow.https.html, getCurrentPosition_permission_deny.https.html">
735+
If |permission| is "denied", then:
736+
<ol>
737+
<li>If |watchId| was passed, [=list/remove=] |watchId| from
738+
|watchIDs|.
739+
</li>
740+
<li>[=Call back with error=] passing |errorCallback| and
741+
{{GeolocationPositionError/PERMISSION_DENIED}}.
742+
</li>
743+
<li>Terminate this algorithm.
744+
</li>
745+
</ol>
772746
</li>
773747
<li>Wait to [=acquire a position=] passing |successCallback|,
774748
|errorCallback|, |options|, and |watchId|.
775749
</li>
750+
<li>If |watchId| was not passed, terminate this algorithm.
751+
</li>
752+
<li>While |watchIDs| [=list/contains=] |watchId|:
753+
<ol>
754+
<li>
755+
<span id="wait-for-change">Wait for a significant change of
756+
geographic position</span>. What constitutes a significant
757+
change of geographic position is left to the
758+
implementation. User agents MAY impose a rate limit on how
759+
frequently position changes are reported.
760+
</li>
761+
<li>If |document| is not [=Document/fully active=] or
762+
[=Document/visibility state=] is not "visible", go back to
763+
the previous step and again <a href="#wait-for-change">wait
764+
for a significant change of geographic position</a>.
765+
<aside class="note" title=
766+
"Position updates are exclusively for fully-active visible documents">
767+
<p>
768+
The desired effect here being that position updates are
769+
exclusively delivered to fully active documents that
770+
are visible; Otherwise the updates get silently
771+
"dropped on the floor". Only once a document again
772+
becomes fully active and visible (e.g., an [^iframe^]
773+
gets reattached to a parent document), do the position
774+
updates once again start getting delivered.
775+
</p>
776+
</aside>
777+
</li>
778+
<li>Wait to [=acquire a position=] passing |successCallback|,
779+
|errorCallback|, |options|, and |watchId|.
780+
</li>
781+
</ol>
782+
</li>
776783
</ol>
777784
</li>
778785
</ol>

0 commit comments

Comments
 (0)