Skip to content

Commit 29ea31b

Browse files
committed
Editorial: remove remaining UTF-8 and UTF-16 references
Infra already explains the relevant details and ByteString is not at all suitable for UTF-8 data. Also hyphenate "x bit" throughout.
1 parent 4c018c6 commit 29ea31b

File tree

1 file changed

+16
-25
lines changed

1 file changed

+16
-25
lines changed

index.bs

Lines changed: 16 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -5738,15 +5738,15 @@ tokens.
57385738
<h4 oldids="dom-float" id="idl-float" interface>float</h4>
57395739

57405740
The {{float}} type is a floating point numeric
5741-
type that corresponds to the set of finite single-precision 32 bit
5741+
type that corresponds to the set of finite single-precision 32-bit
57425742
IEEE 754 floating point numbers. [[!IEEE-754]]
57435743

57445744
{{float}} constant values in IDL are
57455745
represented with <emu-t class="regex"><a href="#prod-decimal">decimal</a></emu-t>
57465746
tokens.
57475747

57485748
<p class="warning">
5749-
Unless there are specific reasons to use a 32 bit floating point type,
5749+
Unless there are specific reasons to use a 32-bit floating point type,
57505750
specifications should use
57515751
{{double}} rather than {{float}},
57525752
since the set of values that a {{double}} can
@@ -5756,7 +5756,7 @@ tokens.
57565756
<h4 oldids="dom-unrestrictedfloat" id="idl-unrestricted-float" interface>unrestricted float</h4>
57575757

57585758
The {{unrestricted float}} type is a floating point numeric
5759-
type that corresponds to the set of all possible single-precision 32 bit
5759+
type that corresponds to the set of all possible single-precision 32-bit
57605760
IEEE 754 floating point numbers, finite, non-finite, and special "not a number" values (NaNs). [[!IEEE-754]]
57615761

57625762
{{unrestricted float}} constant values in IDL are
@@ -5766,7 +5766,7 @@ tokens.
57665766
<h4 oldids="dom-double" id="idl-double" interface>double</h4>
57675767

57685768
The {{double}} type is a floating point numeric
5769-
type that corresponds to the set of finite double-precision 64 bit
5769+
type that corresponds to the set of finite double-precision 64-bit
57705770
IEEE 754 floating point numbers. [[!IEEE-754]]
57715771

57725772
{{double}} constant values in IDL are
@@ -5776,7 +5776,7 @@ tokens.
57765776
<h4 oldids="dom-unrestricteddouble" id="idl-unrestricted-double" interface>unrestricted double</h4>
57775777

57785778
The {{unrestricted double}} type is a floating point numeric
5779-
type that corresponds to the set of all possible double-precision 64 bit
5779+
type that corresponds to the set of all possible double-precision 64-bit
57805780
IEEE 754 floating point numbers, finite, non-finite, and special "not a number" values (NaNs). [[!IEEE-754]]
57815781

57825782
{{unrestricted double}} constant values in IDL are
@@ -5794,18 +5794,12 @@ The {{bigint}} type is an arbitrary integer type, unrestricted in range.
57945794

57955795
The {{DOMString}} type corresponds to [=strings=].
57965796

5797-
Note: Note also that <emu-val>null</emu-val>
5798-
is not a value of type {{DOMString}}.
5799-
To allow <emu-val>null</emu-val>, a
5800-
[=nullable type|nullable=] {{DOMString}},
5801-
written as <code>DOMString?</code> in IDL, needs to be used.
5797+
Note: <emu-val>null</emu-val> is not a value of type {{DOMString}}. To allow
5798+
<emu-val>null</emu-val>, a [=nullable type|nullable=] {{DOMString}}, written as
5799+
<code>DOMString?</code> in IDL, needs to be used.
58025800

5803-
Nothing in this specification requires a {{DOMString}}
5804-
value to be a valid UTF-16 string. For example, a {{DOMString}}
5805-
value might include unmatched [=surrogate=] [=code points=]. However, authors
5806-
of specifications using Web IDL might want to obtain a sequence of
5807-
[=scalar values=] given a particular sequence of
5808-
[=code units=].
5801+
Note: A {{DOMString}} value might include unmatched [=surrogate=] [=code points=]. Use {{USVString}}
5802+
if this is not desirable.
58095803

58105804
There is no way to represent a constant {{DOMString}}
58115805
value in IDL, although {{DOMString}} [=dictionary member=] [=dictionary member/default values=]
@@ -5815,10 +5809,7 @@ can be set to [=value of string literal tokens|the value=] of a
58155809

58165810
<h4 oldids="dom-ByteString" id="idl-ByteString" interface>ByteString</h4>
58175811

5818-
The {{ByteString}} type
5819-
corresponds to [=byte sequences=].
5820-
Such sequences might be interpreted as UTF-8 encoded strings [[!RFC3629]]
5821-
or strings in some other 8-bit-per-code-unit encoding, although this is not required.
5812+
The {{ByteString}} type corresponds to [=byte sequences=].
58225813

58235814
There is no way to represent a constant {{ByteString}}
58245815
value in IDL, although {{ByteString}} [=dictionary member=] [=dictionary member/default values=]
@@ -5833,10 +5824,10 @@ can be set to [=value of string literal tokens|the value=] of a
58335824
strings should be represented with
58345825
{{DOMString}} values, even if it is expected
58355826
that values of the string will always be in ASCII or some
5836-
8 bit character encoding. [=sequence types|Sequences=] or
5827+
8-bit character encoding. [=sequence types|Sequences=] or
58375828
[=frozen array type|frozen arrays=] with {{octet}} or {{byte}}
58385829
elements, {{Uint8Array}}, or {{Int8Array}} should be used for holding
5839-
8 bit data rather than {{ByteString}}.
5830+
8-bit data rather than {{ByteString}}.
58405831
</p>
58415832

58425833

@@ -6354,7 +6345,7 @@ data. The table below lists these types and the kind of buffer or view they rep
63546345
<dfn id="idl-BigUint64Array" interface>BigUint64Array</dfn></td>
63556346
<td>A view on to an {{ArrayBuffer}} that exposes it as an array of unsigned integers of the given size in bits</td></tr>
63566347
<tr><td><dfn id="idl-Uint8ClampedArray" interface>Uint8ClampedArray</dfn></td>
6357-
<td>A view on to an {{ArrayBuffer}} that exposes it as an array of unsigned 8 bit integers with clamped conversions</td></tr>
6348+
<td>A view on to an {{ArrayBuffer}} that exposes it as an array of unsigned 8-bit integers with clamped conversions</td></tr>
63586349
<tr><td><dfn id="idl-Float32Array" interface>Float32Array</dfn>,<br/>
63596350
<dfn id="idl-Float64Array" interface>Float64Array</dfn></td>
63606351
<td>A view on to an {{ArrayBuffer}} that exposes it as an array of IEEE 754 floating point numbers of the given size in bits</td></tr>
@@ -7302,7 +7293,7 @@ In effect, where <var ignore>x</var> is a Number value,
73027293
Note: Since there is only a single ECMAScript <emu-val>NaN</emu-val> value,
73037294
it must be canonicalized to a particular single precision IEEE 754 NaN value. The NaN value
73047295
mentioned above is chosen simply because it is the quiet NaN with the lowest
7305-
value when its bit pattern is interpreted as an unsigned 32 bit integer.
7296+
value when its bit pattern is interpreted as an unsigned 32-bit integer.
73067297

73077298
<div id="unrestricted-float-to-es" algorithm="convert an unrestricted float to an ECMAScript value">
73087299

@@ -7358,7 +7349,7 @@ value when its bit pattern is interpreted as an unsigned 32 bit integer.
73587349
Note: Since there is only a single ECMAScript <emu-val>NaN</emu-val> value,
73597350
it must be canonicalized to a particular double precision IEEE 754 NaN value. The NaN value
73607351
mentioned above is chosen simply because it is the quiet NaN with the lowest
7361-
value when its bit pattern is interpreted as an unsigned 64 bit integer.
7352+
value when its bit pattern is interpreted as an unsigned 64-bit integer.
73627353

73637354
<div id="unrestricted-double-to-es" algorithm="convert an unrestricted double to an ECMAScript value">
73647355

0 commit comments

Comments
 (0)