Skip to content

Commit e6133a1

Browse files
Use Bikeshed's special syntax for linking to abstract operations
Replace <a abstract-op>....</a> with [$....$].
1 parent 59eeeb6 commit e6133a1

File tree

1 file changed

+17
-17
lines changed

1 file changed

+17
-17
lines changed

index.bs

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -583,7 +583,7 @@ stored and retrieved by value rather than by reference; later changes
583583
to a value have no effect on the record stored in the database.
584584

585585
Record [=/values=] are [=/Records=] output by the
586-
<a abstract-op>StructuredSerializeForStorage</a> operation.
586+
[$StructuredSerializeForStorage$] operation.
587587

588588

589589
<!-- ============================================================ -->
@@ -754,7 +754,7 @@ from a [=/value=]. A <dfn>valid key path</dfn> is one of:
754754
</aside>
755755

756756
[=/Key path=] values can only be accessed from properties explicitly
757-
copied by <a abstract-op>StructuredSerializeForStorage</a>, as well as the
757+
copied by [$StructuredSerializeForStorage$], as well as the
758758
following type-specific properties:
759759

760760
<table class=props>
@@ -5566,9 +5566,9 @@ To <dfn>fire an error event</dfn> at a |request|, run these steps:
55665566
The [=/transaction=] is made [=transaction/inactive=] so that getters or other side effects triggered by the cloning operation are unable to make additional requests against the transaction.
55675567
</aside>
55685568

5569-
1. Let |serialized| be [=?=] <a abstract-op>StructuredSerializeForStorage</a>(|value|).
5569+
1. Let |serialized| be [=?=] [$StructuredSerializeForStorage$](|value|).
55705570

5571-
1. Let |clone| be [=?=] <a abstract-op>StructuredDeserialize</a>(|serialized|, |targetRealm|).
5571+
1. Let |clone| be [=?=] [$StructuredDeserialize$](|serialized|, |targetRealm|).
55725572

55735573
1. Set |transaction|'s [=transaction/state=] to [=transaction/active=].
55745574

@@ -5587,10 +5587,10 @@ These operations are run by the steps to [=asynchronously execute
55875587
a request=].
55885588

55895589
<aside class=note>
5590-
Invocations of <a abstract-op>StructuredDeserialize</a>() in the operation
5590+
Invocations of [$StructuredDeserialize$]() in the operation
55915591
steps below can be asserted not to throw (as indicated by the [=!=] prefix)
55925592
because they operate only on previous output of
5593-
<a abstract-op>StructuredSerializeForStorage</a>().
5593+
[$StructuredSerializeForStorage$]().
55945594
</aside>
55955595

55965596
<!-- ============================================================ -->
@@ -5631,7 +5631,7 @@ To <dfn>store a record into an object store</dfn> with
56315631
[=delete records from an object store=].
56325632

56335633
1. Store a record in |store| containing |key| as its key and
5634-
[=!=] <a abstract-op>StructuredSerializeForStorage</a>(|value|)
5634+
[=!=] [$StructuredSerializeForStorage$](|value|)
56355635
as its value. The record is stored in the object store's
56365636
[=object-store/list of records=] such that the list is sorted
56375637
according to the key of the records in [=ascending=] order.
@@ -5716,7 +5716,7 @@ To <dfn>retrieve a value from an object store</dfn> with
57165716

57175717
1. Let |serialized| be of |record|'s [=/value=].
57185718

5719-
1. Return [=!=] <a abstract-op>StructuredDeserialize</a>(|serialized|, |targetRealm|).
5719+
1. Return [=!=] [$StructuredDeserialize$](|serialized|, |targetRealm|).
57205720

57215721
</div>
57225722

@@ -5737,7 +5737,7 @@ store</dfn> with |targetRealm|, |store|, |range| and optional |count|, run these
57375737
1. [=list/For each=] |record| of |records|:
57385738

57395739
1. Let |serialized| be |record|'s [=/value=].
5740-
1. Let |entry| be [=!=] <a abstract-op>StructuredDeserialize</a>(|serialized|, |targetRealm|).
5740+
1. Let |entry| be [=!=] [$StructuredDeserialize$](|serialized|, |targetRealm|).
57415741
1. Append |entry| to |list|.
57425742

57435743
1. Return |list| converted to a <code>[=/sequence=]&lt;{{any}}&gt;</code>.
@@ -5802,7 +5802,7 @@ with |targetRealm|, |index| and |range|, run these steps:
58025802

58035803
1. Let |serialized| be |record|'s [=referenced value=].
58045804

5805-
1. Return [=!=] <a abstract-op>StructuredDeserialize</a>(|serialized|, |targetRealm|).
5805+
1. Return [=!=] [$StructuredDeserialize$](|serialized|, |targetRealm|).
58065806

58075807
</div>
58085808

@@ -5822,7 +5822,7 @@ index</dfn> with |targetRealm|, |index|, |range| and optional |count|, run these
58225822
1. [=list/For each=] |record| of |records|:
58235823

58245824
1. Let |serialized| be |record|'s [=referenced value=].
5825-
1. Let |entry| be [=!=] <a abstract-op>StructuredDeserialize</a>(|serialized|, |targetRealm|).
5825+
1. Let |entry| be [=!=] [$StructuredDeserialize$](|serialized|, |targetRealm|).
58265826
1. Append |entry| to |list|.
58275827

58285828
1. Return |list| converted to a <code>[=/sequence=]&lt;{{any}}&gt;</code>.
@@ -6090,7 +6090,7 @@ To <dfn>iterate a cursor</dfn> with |targetRealm|, |cursor|, an optional
60906090

60916091
1. Let |serialized| be |found record|'s [=referenced value=].
60926092
1. Set |cursor|'s [=cursor/value=] to
6093-
[=!=] <a abstract-op>StructuredDeserialize</a>(|serialized|, |targetRealm|)
6093+
[=!=] [$StructuredDeserialize$](|serialized|, |targetRealm|)
60946094

60956095
1. Set |cursor|'s [=cursor/got value flag=] to true.
60966096

@@ -6228,7 +6228,7 @@ ECMAScript value or failure, or the steps may throw an exception.
62286228

62296229
<aside class=note>
62306230
Assertions can be made in the above steps because this algorithm is
6231-
only applied to values that are the output of <a abstract-op>StructuredDeserialize</a>
6231+
only applied to values that are the output of [$StructuredDeserialize$]
62326232
and only access "own" properties.
62336233
</aside>
62346234

@@ -6272,7 +6272,7 @@ The result of these steps is either true or false.
62726272

62736273
<aside class=note>
62746274
Assertions can be made in the above steps because this algorithm is
6275-
only applied to values that are the output of <a abstract-op>StructuredDeserialize</a>.
6275+
only applied to values that are the output of [$StructuredDeserialize$].
62766276
</aside>
62776277

62786278
<div algorithm>
@@ -6318,7 +6318,7 @@ To <dfn>inject a key into a value using a key path</dfn> with |value|, a |key| a
63186318

63196319
<aside class=note>
63206320
Assertions can be made in the above steps because this algorithm is
6321-
only applied to values that are the output of <a abstract-op>StructuredDeserialize</a>,
6321+
only applied to values that are the output of [$StructuredDeserialize$],
63226322
and the steps to [=check that a key could be injected into a value=] have
63236323
been run.
63246324
</aside>
@@ -6719,8 +6719,8 @@ handling of older data can result in security issues. In addition to
67196719
basic serialization concerns, serialized data could encode assumptions
67206720
which are not valid in newer versions of the user agent.
67216721

6722-
A practical example of this is the [=RegExp=] type. The <a
6723-
abstract-op>StructuredSerializeForStorage</a> operation allows serializing [=RegExp=]
6722+
A practical example of this is the [=RegExp=] type. The
6723+
[$StructuredSerializeForStorage$] operation allows serializing [=RegExp=]
67246724
objects. A typical user agent will compile a regular expression into
67256725
native machine instructions, with assumptions about how the input data
67266726
is passed and results returned. If this internal state was serialized

0 commit comments

Comments
 (0)