Skip to content

Commit

Permalink
Issue w3c#396: Migrate HTML 5.0 references to HTML 5.1
Browse files Browse the repository at this point in the history 
This commit updates all HTML 5.0 references to HTML 5.1.

To help assess references stability (issue w3c#295), the spec now also directly
references the WebIDL Level 1 Recommendation, pointing out that NotAllowedError
is defined in WebIDL Level 2. References to the WHATWG version of HTML for
"current settings object" and "relevant settings object" now target HMTL 5.1
as well.

Other changes introduced in this commit:
- Correct nesting of <a>, <code>, <dfn> to make sure code definitions get
styled in red as expected
- ReSpec now automatically supports aliases such as "start()" for method, so
dropped the now redundant alias definitions.
- Turned references incorrectly marked as informative into normative references
(UUID, cookies, RFCs).
  • Loading branch information
François Daoust authored and François Daoust committed Jan 10, 2017
1 parent e2a0b1d commit 65928d2
Showing 1 changed file with 100 additions and 114 deletions.
214 changes: 100 additions & 114 deletions index.html
View file
Expand Up @@ -97,15 +97,6 @@
'YouTube'
],
publisher: 'Netflix'
},
WEBIDL: {
title: 'Web IDL (Second Edition)',
href: 'https://heycam.github.io/webidl/',
status: 'ED',
authors: [
'Cameron McCormack',
'Boris Zbarsky'
]
}
},
crEnd: '2016-09-12',
Expand Down Expand Up @@ -332,130 +323,134 @@ <h2>
</h2>
<p>
The terms <dfn><a href=
"https://www.w3.org/TR/html5/browsers.html#application-cache">application
cache</a></dfn>, <dfn data-lt=
"https://www.w3.org/TR/html51/obsolete.html#application-cache-manifest">
application cache</a></dfn>, <dfn data-lt=
"browsing context|browsing contexts"><a href=
"http://www.w3.org/TR/html5/browsers.html#browsing-context">browsing
"https://www.w3.org/TR/html51/browsers.html#browsing-context">browsing
context</a></dfn>, <dfn><a href=
"http://www.w3.org/TR/html5/webappapis.html#event-handlers">event
"https://www.w3.org/TR/html51/webappapis.html#event-handler">event
handler</a></dfn>, <dfn><a href=
"http://www.w3.org/TR/html5/webappapis.html#event-handler-event-type">event
handler event type</a></dfn>, <dfn data-lt="fire|fires"><a href=
"http://www.w3.org/TR/html5/infrastructure.html#concept-event-fire">firing
an event</a></dfn>, <dfn data-lt="fire a simple event"><a href=
"http://www.w3.org/TR/html5/webappapis.html#fire-a-simple-event">firing
a simple event</a></dfn>, <dfn><a href=
"http://www.w3.org/TR/html5/browsers.html#navigate">navigate</a></dfn>,
"https://www.w3.org/TR/html51/webappapis.html#event-handler-event-type">
event handler event type</a></dfn>, <dfn data-lt="fire|fires"><a href=
"https://www.w3.org/TR/html51/infrastructure.html#fire">firing an
event</a></dfn>, <dfn data-lt="fire a simple event"><a href=
"https://www.w3.org/TR/html51/webappapis.html#firing-a-simple-event-named-e">
firing a simple event</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html51/browsers.html#navigated">navigate</a></dfn>,
<dfn><a href=
"http://www.w3.org/TR/html5/webappapis.html#queue-a-task">queue a
"https://www.w3.org/TR/html51/webappapis.html#queuing">queue a
task</a></dfn>, <dfn><a href=
"http://www.w3.org/TR/html5/infrastructure.html#concept-events-trusted">
trusted event</a></dfn>, <dfn><a href=
"http://www.w3.org/TR/html5/browsers.html#allowed-to-show-a-popup">allowed
"https://www.w3.org/TR/html51/infrastructure.html#trusted">trusted
event</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html51/browsers.html#allowed-to-show-a-popup">allowed
to show a popup</a></dfn>, <dfn><a href=
"http://www.w3.org/TR/html5/browsers.html#top-level-browsing-context">top-level
browsing context</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html5/browsers.html#unload-a-document">unload a
"https://www.w3.org/TR/html51/browsers.html#top-level-browsing-context">
top-level browsing context</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html51/browsers.html#unloaded">unload a
document</a></dfn>, <dfn><a href=
"http://www.w3.org/TR/html5/browsers.html#session-history">session
"https://www.w3.org/TR/html51/browsers.html#session-history">session
history</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html5/browsers.html#sandboxing-flag-set">sandboxing
"https://www.w3.org/TR/html51/browsers.html#sandboxing-flag-set">sandboxing
flag set</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html5/browsers.html#active-sandboxing-flag-set">active
sandboxing flag set</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html5/browsers.html#parse-a-sandboxing-directive">
"https://www.w3.org/TR/html51/browsers.html#active-sandboxing-flag-set">
active sandboxing flag set</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html51/browsers.html#parse-the-sandboxing-directive">
parse a sandboxing directive</a></dfn>, <dfn><a href=
"http://www.w3.org/TR/html5/browsers.html#sandboxed-auxiliary-navigation-browsing-context-flag">
"https://www.w3.org/TR/html51/browsers.html#sandboxed-auxiliary-navigation-browsing-context-flag">
sandboxed auxiliary navigation browsing context flag</a></dfn>,
<dfn><a href=
"http://www.w3.org/TR/html5/browsers.html#sandboxed-top-level-navigation-browsing-context-flag">
"https://www.w3.org/TR/html51/browsers.html#sandboxed-top-level-navigation-browsing-context-flag">
sandboxed top-level navigation browsing context flag</a></dfn>,
<dfn><code><a href=
"http://www.w3.org/TR/html5/webappapis.html#eventhandler">EventHandler</a></code></dfn>
and <dfn><code><a href=
"http://www.w3.org/TR/html5/webappapis.html#navigator">Navigator</a></code></dfn>
are defined in [[!HTML5]].
</p>
<p>
The terms <dfn><a href=
"http://www.w3.org/TR/html51/infrastructure.html#in-parallel">in
parallel</a></dfn> and <dfn><a href=
<dfn><a href=
"https://www.w3.org/TR/html51/infrastructure.html#in-parallel">in
parallel</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html51/webappapis.html#task-source">task
source</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html5/browsers.html#nested-browsing-contexts">nested
browsing context</a></dfn>, and <dfn><a href=
"https://www.w3.org/TR/html51/browsers.html#nested-browsing-contexts">nested
browsing context</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html51/browsers.html#list-of-the-descendant-browsing-contexts">
list of descendant browsing contexts</a></dfn>, and <dfn><a href=
list of descendant browsing contexts</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html51/browsers.html#creating-a-new-browsing-context">
creating a new browsing context</a></dfn>, and <dfn><a href=
creating a new browsing context</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html51/webappapis.html#current">current
realm</a></dfn>, <dfn><a href=
"https://www.w3.org/TR/html51/webappapis.html#responsible-browsing-context">
responsible browsing context</a></dfn> are defined by [[!HTML51]].
responsible browsing context</a></dfn>, <dfn><a href=
"http://www.w3.org/TR/html51/webappapis.html#current-settings-object">current
settings object</a></dfn>, <dfn><a href=
"http://www.w3.org/TR/html51/webappapis.html#relevant-settings-object">relevant
settings object</a></dfn>, <a href=
"https://www.w3.org/TR/html51/webappapis.html#events-event-handlers"><dfn>
<code>EventHandler</code></dfn></a> and <a href=
"https://www.w3.org/TR/html51/webappapis.html#navigator-navigator"><dfn>
<code>Navigator</code></dfn></a> are defined in [[!HTML51]].
</p>
<p>
The term <dfn><a href=
"https://tc39.github.io/ecma262/#sec-code-realms">JavaScript
realm</a></dfn> is defined in [[!ECMASCRIPT]].
</p>
<p>
The terms <dfn><code><a href=
"https://dom.spec.whatwg.org/#eventtarget">EventTarget</a></code></dfn>,
<dfn><code><a href=
"https://dom.spec.whatwg.org/#event">Event</a></code></dfn>,
<dfn><code><a href=
"https://dom.spec.whatwg.org/#dictdef-eventinit">EventInit</a></code></dfn>
The terms <a href=
"https://dom.spec.whatwg.org/#eventtarget"><dfn><code>EventTarget</code></dfn></a>,
<a href=
"https://dom.spec.whatwg.org/#event"><dfn><code>Event</code></dfn></a>,
<a href=
"https://dom.spec.whatwg.org/#dictdef-eventinit"><dfn><code>EventInit</code></dfn></a>
are defined in [[!DOM]].
</p>
<p>
The term <dfn><code><a href=
"http://www.w3.org/TR/webmessaging/#messageevent">MessageEvent</a></code></dfn>
The term <a href=
"https://www.w3.org/TR/webmessaging/#messageevent"><dfn><code>MessageEvent</code></dfn></a>
is defined in [[!WEBMESSAGING]].
</p>
<p>
This document provides interface definitions using the Web IDL standard
([[!WEBIDL]]). The terms <dfn><a href=
"https://heycam.github.io/webidl/#idl-promise">Promise</a></dfn>,
<dfn><a href=
"https://heycam.github.io/webidl/#idl-ArrayBuffer">ArrayBuffer</a></dfn>,
<dfn><a href=
"https://heycam.github.io/webidl/#idl-ArrayBufferView">ArrayBufferView</a></dfn>
are defined in [[!WEBIDL]].
[[!WEBIDL-1]].
</p>
<p>
The term <dfn><a href=
"https://heycam.github.io/webidl/#dfn-throw">throw</a></dfn> in this
specification is used as defined in [[!WEBIDL]]. The following
exception names are defined by WebIDL and used by this specification:
specification is used as defined in [[!WEBIDL-1]].
</p>
<p>
The terms <dfn><a href=
"https://heycam.github.io/webidl/#idl-promise">Promise</a></dfn>,
<dfn><a href=
"https://heycam.github.io/webidl/#idl-ArrayBuffer">ArrayBuffer</a></dfn>,
<dfn><a href=
"https://heycam.github.io/webidl/#idl-ArrayBufferView">ArrayBufferView</a></dfn>,
and the following exception names are defined in [[!WEBIDL-1]]:
</p>
<ul>
<li>
<dfn><code><a href=
"https://heycam.github.io/webidl/#notallowederror">NotAllowedError</a></code></dfn>
<a href=
"https://heycam.github.io/webidl/#invalidaccesserror"><dfn><code>InvalidAccessError</code></dfn></a>
</li>
<li>
<dfn><code><a href=
"https://heycam.github.io/webidl/#invalidaccesserror">InvalidAccessError</a></code></dfn>
<a href=
"https://heycam.github.io/webidl/#notfounderror"><dfn><code>NotFoundError</code></dfn></a>
</li>
<li>
<dfn><code><a href=
"https://heycam.github.io/webidl/#notfounderror">NotFoundError</a></code></dfn>
<a href=
"https://heycam.github.io/webidl/#notsupportederror"><dfn><code>NotSupportedError</code></dfn></a>
</li>
<li>
<dfn><code><a href=
"https://heycam.github.io/webidl/#notsupportederror">NotSupportedError</a></code></dfn>
<a href=
"https://heycam.github.io/webidl/#operationerror"><dfn><code>OperationError</code></dfn></a>
</li>
<li>
<dfn><code><a href=
"https://heycam.github.io/webidl/#operationerror">OperationError</a></code></dfn>
<a href=
"https://heycam.github.io/webidl/#securityerror"><dfn><code>SecurityError</code></dfn></a>
</li>
<li>
<dfn><code><a href=
"https://heycam.github.io/webidl/#securityerror">SecurityError</a></code></dfn>
<a href=
"https://heycam.github.io/webidl/#syntaxerror"><dfn><code>SyntaxError</code></dfn></a>
</li>
<li>
<dfn><code><a href=
"https://heycam.github.io/webidl/#syntaxerror">SyntaxError</a></code></dfn>
<a href=
"https://heycam.github.io/webidl/#notallowederror"><dfn><code>NotAllowedError</code></dfn></a>,
defined in [[!WEBIDL-2]]
</li>
</ul>
<p>
Expand All @@ -470,41 +465,34 @@ <h2>
is defined in the WHATWG URL standard [[!URL]].
</p>
<p>
The terms <dfn><a href=
"https://html.spec.whatwg.org/multipage/webappapis.html#current-settings-object">
current settings object</a></dfn> and <dfn><a href=
"https://html.spec.whatwg.org/multipage/webappapis.html#relevant-settings-object">
relevant settings object</a></dfn> are defined in [[HTML]].
</p>
<p>
The term <dfn><a href=
"http://dev.w3.org/2006/webapi/FileAPI/#blob">Blob</a></dfn> is defined
in the File API specification [[!FILEAPI]].
The term <a href=
"http://dev.w3.org/2006/webapi/FileAPI/#blob"><dfn><code>Blob</code></dfn></a>
is defined in the File API specification [[!FILEAPI]].
</p>
<p>
The header <dfn><a href=
"https://tools.ietf.org/html/rfc7231#section-5.3.5">Accept-Language</a></dfn>
is defined in HTTP/1.1 [[rfc7231]].
is defined in HTTP/1.1 [[!rfc7231]].
</p>
<p>
<dfn><a href="https://tools.ietf.org/html/rfc7235#section-2">HTTP
authentication</a></dfn> is defined in HTTP/1.1: Authentication
[[!rfc7235]].
</p>
<p>
The term <dfn><a href=
"http://w3c.github.io/webrtc-pc/#idl-def-RTCDataChannel">RTCDataChannel</a></dfn>
The term <a href=
"http://w3c.github.io/webrtc-pc/#idl-def-RTCDataChannel"><dfn><code>RTCDataChannel</code></dfn></a>
is defined in the WebRTC API specification [[WEBRTC]].
</p>
<p>
The term <dfn><a href=
"http://tools.ietf.org/html/rfc6265#section-4.2">cookie store</a></dfn>
is defined in RFC 6265 [[COOKIES]].
is defined in RFC 6265 [[!COOKIES]].
</p>
<p>
The term <dfn><a href=
"https://tools.ietf.org/html/rfc4122">UUID</a></dfn> is defined in RFC
4122 [[rfc4122]].
4122 [[!rfc4122]].
</p>
<p>
The terms <dfn data-lt="permission|permissions"><a href=
Expand Down Expand Up @@ -1124,10 +1112,9 @@ <h4>
Selecting a presentation display
</h4>
<p>
When the <code><dfn for="PresentationRequest" data-lt=
"start()">start</dfn></code> method is called, the <a>user
agent</a> MUST run the following steps to <dfn>select a
presentation display</dfn>.
When the <code><dfn for="PresentationRequest">start</dfn></code>
method is called, the <a>user agent</a> MUST run the following
steps to <dfn>select a presentation display</dfn>.
</p>
<dl>
<dt>
Expand Down Expand Up @@ -1375,10 +1362,10 @@ <h4>
Reconnecting to a presentation
</h4>
<p>
When the <code><dfn for="PresentationRequest" data-lt=
"reconnect()">reconnect</dfn>()</code> method is called, the
<a>user agent</a> MUST run the following steps to <dfn>reconnect to
a presentation</dfn>:
When the <code><dfn for=
"PresentationRequest">reconnect</dfn>()</code> method is called,
the <a>user agent</a> MUST run the following steps to
<dfn>reconnect to a presentation</dfn>:
</p>
<dl>
<dt>
Expand Down Expand Up @@ -2017,20 +2004,19 @@ <h3>
</li>
</ul>
<p>
When the <code><dfn data-lt="close()">close</dfn>()</code> method
is called on a <a>PresentationConnection</a> <var>S</var>, the
<a>user agent</a> MUST <a>start closing the presentation
connection</a> <var>S</var> with <a for=
"PresentationConnectionCloseReason">closed</a> as
When the <code><dfn>close</dfn>()</code> method is called on a
<a>PresentationConnection</a> <var>S</var>, the <a>user agent</a>
MUST <a>start closing the presentation connection</a> <var>S</var>
with <a for="PresentationConnectionCloseReason">closed</a> as
<var>closeReason</var> and an empty message as
<var>closeMessage</var>.
</p>
<p>
When the <code><dfn data-lt="terminate()">terminate</dfn>()</code>
method is called on a <a>PresentationConnection</a> <var>S</var> in
a <a>controlling browsing context</a>, the <a>user agent</a> MUST
run the algorithm to <a>terminate a presentation in a controlling
browsing context</a> using <var>S</var>.
When the <code><dfn>terminate</dfn>()</code> method is called on a
<a>PresentationConnection</a> <var>S</var> in a <a>controlling
browsing context</a>, the <a>user agent</a> MUST run the algorithm
to <a>terminate a presentation in a controlling browsing
context</a> using <var>S</var>.
</p>
<p>
When the <a>terminate()</a> method is called on a
Expand Down Expand Up @@ -2059,7 +2045,7 @@ <h3>
</div>
<p>
When the <code><dfn data-lt=
"send!overload-1|send!overload-2|send!overload-3|send()">send</dfn>()</code>
"send!overload-1|send!overload-2|send!overload-3">send</dfn>()</code>
method is called on a <a>PresentationConnection</a> <var>S</var>,
the <a>user agent</a> MUST run the algorithm to <a>send a
message</a> through <var>S</var>.
Expand Down

0 comments on commit 65928d2

Please sign in to comment.