Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Editorial: Remove "designed to be subclassable" #1677

Merged
merged 1 commit into from
Jul 27, 2021
+145 −72
Merged

Editorial: Remove "designed to be subclassable" #1677

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 12 additions & 3 deletions spec/calendar.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -623,9 +623,18 @@ <h1>DefaultMergeFields ( _fields_, _additionalFields_ )</h1>
<h1>The Temporal.Calendar Constructor</h1>
<p>The Temporal.Calendar constructor:</p>
<ul>
<li>creates and initializes a new Temporal.Calendar object when called as a constructor.</li>
<li>is designed to be subclassable. It may be used as the value of an `extends` clause of a class definition. Subclass constructors that intend to inherit the specified Temporal.Calendar behaviour must include a super call to the %Temporal.Calendar% constructor to create and initialize subclass instances with the necessary internal slots.</li>
<li>has a *"length"* property whose value is 1.</li>
<li>
creates and initializes a new Temporal.Calendar object when called as a constructor.
</li>
<li>
is not intended to be called as a function and will throw an exception when called in that manner.
</li>
<li>
may be used as the value of an `extends` clause of a class definition.
Subclass constructors that intend to inherit the specified Temporal.Calendar behaviour must
include a super call to the %Temporal.Calendar% constructor to create and initialize subclass
instances with the necessary internal slots.
</li>
</ul>

<emu-clause id="sec-temporal.calendar">
Expand Down
27 changes: 16 additions & 11 deletions spec/duration.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,17 +14,22 @@ <h1>Temporal.Duration Objects</h1>

<emu-clause id="sec-temporal-duration-constructor">
<h1>The Temporal.Duration Constructor</h1>
<p>
The Temporal.Duration constructor creates and initializes a new
Temporal.Duration object when called as a constructor.
</p>
<p>
The Temporal.Duration constructor is designed to be subclassable. It may
be used as the value of an extends clause of a class definition. Subclass
constructors that intend to inherit the specified Duration behaviour must
include a super call to the %Temporal.Duration% constructor to create and
initialize subclass instances with the necessary internal slots.
</p>
<p>The Temporal.Duration constructor:</p>
<ul>
<li>
creates and initializes a new Temporal.Duration object when called as a constructor.
</li>
<li>
is not intended to be called as a function and will throw an exception when called in that manner.
</li>
<li>
may be used as the value of an `extends` clause of a class definition.
Subclass constructors that intend to inherit the specified Temporal.Duration behaviour must
include a super call to the %Temporal.Duration% constructor to create and initialize subclass
instances with the necessary internal slots.
</li>
</ul>

<emu-clause id="sec-temporal.duration">
<h1>Temporal.Duration ( [ _years_ [ , _months_ [ , _weeks_ [ , _days_ [ , _hours_ [ , _minutes_ [ , _seconds_ [ , _milliseconds_ [ , _microseconds_ [ , _nanoseconds_ ] ] ] ] ] ] ] ] ] ] )</h1>
<p>
Expand Down
23 changes: 15 additions & 8 deletions spec/instant.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,21 @@ <h1>Temporal.Instant Objects</h1>

<emu-clause id="sec-temporal-instant-constructor">
<h1>The Temporal.Instant Constructor</h1>
<p>
The Temporal.Instant constructor creates and initializes a new Temporal.Instant object when called as a constructor.
</p>
<p>
The Temporal.Instant constructor is designed to be subclassable.
It may be used as the value of an extends clause of a class definition.
Subclass constructors that intend to inherit the specified Instant behaviour must include a super call to the %Temporal.Instant% constructor to create and initialize subclass instances with the necessary internal slots.
</p>
<p>The Temporal.Instant constructor:</p>
<ul>
<li>
creates and initializes a new Temporal.Instant object when called as a constructor.
</li>
<li>
is not intended to be called as a function and will throw an exception when called in that manner.
</li>
<li>
may be used as the value of an `extends` clause of a class definition.
Subclass constructors that intend to inherit the specified Temporal.Instant behaviour must
include a super call to the %Temporal.Instant% constructor to create and initialize subclass
instances with the necessary internal slots.
</li>
</ul>

<emu-clause id="sec-temporal.instant">
<h1>Temporal.Instant ( _epochNanoseconds_ )</h1>
Expand Down
14 changes: 12 additions & 2 deletions spec/plaindate.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,18 @@ <h1>Temporal.PlainDate Objects</h1>
<h1>The Temporal.PlainDate Constructor</h1>
<p>The Temporal.PlainDate constructor:</p>
<ul>
<li>creates and initializes a new Temporal.PlainDate object when called as a constructor.</li>
<li>is designed to be subclassable. It may be used as the value of an `extends` clause of a class definition. Subclass constructors that intend to inherit the specified Temporal.PlainDate behaviour must include a super call to the %Temporal.PlainDate% constructor to create and initialize subclass instances with the necessary internal slots.</li>
<li>
creates and initializes a new Temporal.PlainDate object when called as a constructor.
</li>
<li>
is not intended to be called as a function and will throw an exception when called in that manner.
</li>
<li>
may be used as the value of an `extends` clause of a class definition.
Subclass constructors that intend to inherit the specified Temporal.PlainDate behaviour must
include a super call to the %Temporal.PlainDate% constructor to create and initialize subclass
instances with the necessary internal slots.
</li>
</ul>

<emu-clause id="sec-temporal.plaindate">
Expand Down
23 changes: 15 additions & 8 deletions spec/plaindatetime.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,21 @@ <h1>Temporal.PlainDateTime Objects</h1>

<emu-clause id="sec-temporal-plaindatetime-constructor">
<h1>The Temporal.PlainDateTime Constructor</h1>
<p>
The Temporal.PlainDateTime constructor creates and initializes a new Temporal.PlainDateTime object when called as a constructor.
</p>
<p>
The Temporal.PlainDateTime constructor is designed to be subclassable.
It may be used as the value of an extends clause of a class definition.
Subclass constructors that intend to inherit the specified DateTime behaviour must include a super call to the %Temporal.PlainDateTime% constructor to create and initialize subclass instances with the necessary internal slots.
</p>
<p>The Temporal.PlainDateTime constructor:</p>
<ul>
<li>
creates and initializes a new Temporal.PlainDateTime object when called as a constructor.
</li>
<li>
is not intended to be called as a function and will throw an exception when called in that manner.
</li>
<li>
may be used as the value of an `extends` clause of a class definition.
Subclass constructors that intend to inherit the specified Temporal.PlainDateTime behaviour must
include a super call to the %Temporal.PlainDateTime% constructor to create and initialize subclass
instances with the necessary internal slots.
</li>
</ul>

<emu-clause id="sec-temporal.plaindatetime">
<h1>Temporal.PlainDateTime ( _isoYear_, _isoMonth_, _isoDay_ [ , _hour_ [ , _minute_ [ , _second_ [ , _millisecond_ [ , _microsecond_ [ , _nanosecond_ [ , _calendarLike_ ] ] ] ] ] ] ] )</h1>
Expand Down
23 changes: 15 additions & 8 deletions spec/plainmonthday.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,21 @@ <h1>Temporal.PlainMonthDay Objects</h1>

<emu-clause id="sec-temporal-plainmonthday-constructor">
<h1>The Temporal.PlainMonthDay Constructor</h1>
<p>
The Temporal.PlainMonthDay constructor creates and initializes a new Temporal.PlainMonthDay object when called as a constructor.
</p>
<p>
The Temporal.PlainMonthDay constructor is designed to be subclassable.
It may be used as the value of an extends clause of a class definition.
Subclass constructors that intend to inherit the specified MonthDay behaviour must include a super call to the %Temporal.PlainMonthDay% constructor to create and initialize subclass instances with the necessary internal slots.
</p>
<p>The Temporal.PlainMonthDay constructor:</p>
<ul>
<li>
creates and initializes a new Temporal.PlainMonthDay object when called as a constructor.
</li>
<li>
is not intended to be called as a function and will throw an exception when called in that manner.
</li>
<li>
may be used as the value of an `extends` clause of a class definition.
Subclass constructors that intend to inherit the specified Temporal.PlainMonthDay behaviour must
include a super call to the %Temporal.PlainMonthDay% constructor to create and initialize subclass
instances with the necessary internal slots.
</li>
</ul>

<emu-clause id="sec-temporal.plainmonthday">
<h1>Temporal.PlainMonthDay ( _isoMonth_, _isoDay_ [ , _calendarLike_ [ , _referenceISOYear_ ] ] )</h1>
Expand Down
23 changes: 15 additions & 8 deletions spec/plaintime.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,21 @@ <h1>Temporal.PlainTime Objects</h1>

<emu-clause id="sec-temporal-plaintime-constructor">
<h1>The Temporal.PlainTime Constructor</h1>
<p>
The Temporal.PlainTime constructor creates and initializes a new Temporal.PlainTime object when called as a constructor.
</p>
<p>
The Temporal.PlainTime constructor is designed to be subclassable.
It may be used as the value of an extends clause of a class definition.
Subclass constructors that intend to inherit the specified Time behaviour must include a super call to the %Temporal.PlainTime% constructor to create and initialize subclass instances with the necessary internal slots.
</p>
<p>The Temporal.PlainTime constructor:</p>
<ul>
<li>
creates and initializes a new Temporal.PlainTime object when called as a constructor.
</li>
<li>
is not intended to be called as a function and will throw an exception when called in that manner.
</li>
<li>
may be used as the value of an `extends` clause of a class definition.
Subclass constructors that intend to inherit the specified Temporal.PlainTime behaviour must
include a super call to the %Temporal.PlainTime% constructor to create and initialize subclass
instances with the necessary internal slots.
</li>
</ul>

<emu-clause id="sec-temporal.plaintime">
<h1>Temporal.PlainTime ( [ _hour_ [ , _minute_ [ , _second_ [ , _millisecond_ [ , _microsecond_ [ , _nanosecond_ ] ] ] ] ] ] )</h1>
Expand Down
23 changes: 15 additions & 8 deletions spec/plainyearmonth.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,21 @@ <h1>Temporal.PlainYearMonth Objects</h1>

<emu-clause id="sec-temporal-plainyearmonth-constructor">
<h1>The Temporal.PlainYearMonth Constructor</h1>
<p>
The Temporal.PlainYearMonth constructor creates and initializes a new Temporal.PlainYearMonth object when called as a constructor.
</p>
<p>
The Temporal.PlainYearMonth constructor is designed to be subclassable.
It may be used as the value of an extends clause of a class definition.
Subclass constructors that intend to inherit the specified YearMonth behaviour must include a super call to the %Temporal.PlainYearMonth% constructor to create and initialize subclass instances with the necessary internal slots.
</p>
<p>The Temporal.PlainYearMonth constructor:</p>
<ul>
<li>
creates and initializes a new Temporal.PlainYearMonth object when called as a constructor.
</li>
<li>
is not intended to be called as a function and will throw an exception when called in that manner.
</li>
<li>
may be used as the value of an `extends` clause of a class definition.
Subclass constructors that intend to inherit the specified Temporal.PlainYearMonth behaviour must
include a super call to the %Temporal.PlainYearMonth% constructor to create and initialize subclass
instances with the necessary internal slots.
</li>
</ul>

<emu-clause id="sec-temporal.plainyearmonth">
<h1>Temporal.PlainYearMonth ( _isoYear_, _isoMonth_ [ , _calendarLike_ [ , _referenceISODay_ ] ] )</h1>
Expand Down
23 changes: 15 additions & 8 deletions spec/timezone.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -109,14 +109,21 @@ <h1>DefaultTimeZone ( )</h1>

<emu-clause id="sec-temporal-timezone-constructor">
<h1>The Temporal.TimeZone Constructor</h1>
<p>
The Temporal.TimeZone constructor creates and initializes a new Temporal.TimeZone object when called as a constructor.
</p>
<p>
The Temporal.TimeZone constructor is designed to be subclassable.
It may be used as the value of an extends clause of a class definition.
Subclass constructors that intend to inherit the specified TimeZone behaviour must include a super call to the %Temporal.TimeZone% constructor to create and initialize subclass instances with the necessary internal slots.
</p>
<p>The Temporal.TimeZone constructor:</p>
<ul>
<li>
creates and initializes a new Temporal.TimeZone object when called as a constructor.
</li>
<li>
is not intended to be called as a function and will throw an exception when called in that manner.
</li>
<li>
may be used as the value of an `extends` clause of a class definition.
Subclass constructors that intend to inherit the specified Temporal.TimeZone behaviour must
include a super call to the %Temporal.TimeZone% constructor to create and initialize subclass
instances with the necessary internal slots.
</li>
</ul>

<emu-clause id="sec-temporal.timezone">
<h1>Temporal.TimeZone ( _identifier_ )</h1>
Expand Down
23 changes: 15 additions & 8 deletions spec/zoneddatetime.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,21 @@ <h1>Temporal.ZonedDateTime Objects</h1>

<emu-clause id="sec-temporal-zoneddatetime-constructor">
<h1>The Temporal.ZonedDateTime Constructor</h1>
<p>
The Temporal.ZonedDateTime constructor creates and initializes a new Temporal.ZonedDateTime object when called as a constructor.
</p>
<p>
The Temporal.ZonedDateTime constructor is designed to be subclassable.
It may be used as the value of an extends clause of a class definition.
Subclass constructors that intend to inherit the specified ZonedDateTime behaviour must include a super call to the %Temporal.ZonedDateTime% constructor to create and initialize subclass instances with the necessary internal slots.
</p>
<p>The Temporal.ZonedDateTime constructor:</p>
<ul>
<li>
creates and initializes a new Temporal.ZonedDateTime object when called as a constructor.
</li>
<li>
is not intended to be called as a function and will throw an exception when called in that manner.
</li>
<li>
may be used as the value of an `extends` clause of a class definition.
Subclass constructors that intend to inherit the specified Temporal.ZonedDateTime behaviour must
include a super call to the %Temporal.ZonedDateTime% constructor to create and initialize subclass
instances with the necessary internal slots.
</li>
</ul>

<emu-clause id="sec-temporal.zoneddatetime">
<h1>Temporal.ZonedDateTime ( _epochNanoseconds_, _timeZoneLike_ [ , _calendarLike_ ] )</h1>
Expand Down