[html5] r7822 - [e] (0) Use more WebIDL (and some minor editorial fixes I forgot to commit befor [...]
whatwg at whatwg.org
whatwg at whatwg.org
Fri Apr 12 15:55:49 PDT 2013
Author: ianh
Date: 2013-04-12 15:55:48 -0700 (Fri, 12 Apr 2013)
New Revision: 7822
Modified:
complete.html
index
source
Log:
[e] (0) Use more WebIDL (and some minor editorial fixes I forgot to commit before making the WebIDL change)
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=20286
Affected topics: Canvas, DOM APIs, HTML, HTML Syntax and Parsing
Modified: complete.html
===================================================================
--- complete.html 2013-04-12 21:58:09 UTC (rev 7821)
+++ complete.html 2013-04-12 22:55:48 UTC (rev 7822)
@@ -8308,8 +8308,8 @@
readonly attribute <a href=#htmlscriptelement>HTMLScriptElement</a>? <a href=#dom-document-currentscript title=dom-document-currentScript>currentScript</a>;
// <a href=#dynamic-markup-insertion>dynamic markup insertion</a>
- <a href=#document>Document</a> <a href=#dom-document-open title=dom-document-open>open</a>(optional DOMString type, optional DOMString replace);
- <a href=#windowproxy>WindowProxy</a> <a href=#dom-document-open title=dom-document-open>open</a>(DOMString url, DOMString name, DOMString features, optional boolean replace);
+ <a href=#document>Document</a> <a href=#dom-document-open title=dom-document-open>open</a>(optional DOMString type = "text/html", optional DOMString replace = "");
+ <a href=#windowproxy>WindowProxy</a> <a href=#dom-document-open title=dom-document-open>open</a>(DOMString url, DOMString name, DOMString features, optional boolean replace = false);
void <a href=#dom-document-close title=dom-document-close>close</a>();
void <a href=#dom-document-write title=dom-document-write>write</a>(DOMString... text);
void <a href=#dom-document-writeln title=dom-document-writeln>writeln</a>(DOMString... text);
@@ -9641,7 +9641,7 @@
<div class=example>
- <p>In this example, everything in the document is to be translated when the page is localised,
+ <p>In this example, everything in the document is to be translated when the page is localized,
except the sample keyboard input and sample program output:</p>
<pre><!DOCTYPE HTML>
@@ -11775,7 +11775,8 @@
unloaded</a>. Initially, the counter must be set to zero.</p> <!--
http://www.hixie.ch/tests/adhoc/dom/level0/document/open/unload/ -->
- <p>When called with two or fewer arguments, the <code title=dom-document-open><a href=#dom-document-open>document.open()</a></code> method must act as follows:</p>
+ <p>When called with two arguments, the <code title=dom-document-open><a href=#dom-document-open>document.open()</a></code>
+ method must act as follows:</p>
<ol><li><p>If the <code><a href=#document>Document</a></code> object is not flagged as an <a href=#html-documents title="HTML documents">HTML
document</a>, throw an <code><a href=#invalidstateerror>InvalidStateError</a></code> exception and abort these steps.</li>
@@ -11783,12 +11784,12 @@
<li><p>If the <code><a href=#document>Document</a></code> object is not an <a href=#active-document>active document</a>, then abort
these steps.</li>
- <li><p>Let <var title="">type</var> be the value of the first argument, if there is one, or
- "<code><a href=#text/html>text/html</a></code>" otherwise.</li>
+ <li><p>Let <var title="">type</var> be the value of the first argument.</li>
<li>
+<!--CLEANUP-->
- <p>If there is a second argument and it is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for the
+ <p>If the second argument is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for the
value "replace", then let <var title="">replace</var> be true.</p>
<p>Otherwise, if the <a href=#browsing-context>browsing context</a>'s <a href=#session-history>session history</a> contains only
@@ -11953,7 +11954,8 @@
whether a <code><a href=#document>Document</a></code> is <a href=#ready-for-post-load-tasks>ready for post-load tasks</a> or <a href=#completely-loaded>completely
loaded</a>.</p>
- <p>When called with three or more arguments, the <code title=dom-document-open><a href=#dom-document-open>open()</a></code>
+<!--CLEANUP-->
+ <p>When called with four arguments, the <code title=dom-document-open><a href=#dom-document-open>open()</a></code>
method on the <code><a href=#document>Document</a></code> object must call the <code title=dom-open><a href=#dom-open>open()</a></code>
method on the <code><a href=#window>Window</a></code> object of the <code><a href=#document>Document</a></code> object, with the same
arguments as the original call to the <code title=dom-document-open><a href=#dom-document-open>open()</a></code> method, and
@@ -12007,6 +12009,7 @@
<h4 id=document.write()><span class=secno>3.4.3 </span><code title=dom-document-write><a href=#dom-document-write>document.write()</a></code></h4>
+<!--CLEANUP-->
<dl class=domintro><dt><var title="">document</var> . <code title=dom-document-write><a href=#dom-document-write>write</a></code>(<var title="">text</var>...)</dt>
<dd>
@@ -12042,6 +12045,7 @@
</dl><div class=impl>
+<!--CLEANUP-->
<p><code><a href=#document>Document</a></code> objects have an
<dfn id=ignore-destructive-writes-counter>ignore-destructive-writes counter</dfn>, which is used in
conjunction with the processing of <code><a href=#the-script-element>script</a></code> elements to
@@ -12125,6 +12129,7 @@
<h4 id=document.writeln()><span class=secno>3.4.4 </span><code title=dom-document-writeln><a href=#dom-document-writeln>document.writeln()</a></code></h4>
+<!--CLEANUP-->
<dl class=domintro><dt><var title="">document</var> . <code title=dom-document-writeln><a href=#dom-document-writeln>writeln</a></code>(<var title="">text</var>...)</dt>
<dd>
@@ -33820,7 +33825,7 @@
</dd>
- </dl><div class=impl>
+ </dl><!--CLEANUP--><div class=impl>
<p>Objects that implement the <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code>
interface have attributes and methods (defined in this section) that
@@ -33919,10 +33924,10 @@
interface is created, the <code title=dom-context-2d-lineDashOffset><a href=#dom-context-2d-linedashoffset>lineDashOffset</a></code>
attribute must initially have the value <code>0.0</code>.</p>
- <hr><p>When a user agent is to <dfn id=trace-a-path>trace a <span>path</span></dfn>,
+ <hr><p>When a user agent is to <dfn id=trace-a-path>trace a <span title=concept-path>path</span></dfn>,
given an object <var title="">style</var> that implements the
<code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code> interface, it must run the following
- algorithm. This algorithm returns a new <a href=#path>path</a>.</p>
+ algorithm. This algorithm returns a new <a href=#concept-path title=concept-path>path</a>.</p>
<ol><li><p>Let <var title="">path</var> be a copy of the path being
traced.</li>
@@ -34080,7 +34085,7 @@
<li>
- <p>Create a new <a href=#path>path</a> that describes the result of
+ <p>Create a new <a href=#concept-path title=concept-path>path</a> that describes the result of
inflating the paths in <var title="">path</var> perpendicular to
the direction of the path to the <var title="">styles</var> <code title=dom-context-2d-lineWidth><a href=#dom-context-2d-linewidth>lineWidth</a></code> width, replacing
each point with the end cap necessary to satisfy the <var title="">styles</var> <code title=dom-context-2d-lineCap><a href=#dom-context-2d-linecap>lineCap</a></code> attribute as
@@ -34595,6 +34600,7 @@
</ol><h6 id=building-paths><span class=secno>4.8.11.2.6 </span>Building paths</h6>
+<!--CLEANUP-->
<p>Each object implementing the <code><a href=#canvaspathmethods>CanvasPathMethods</a></code>
interface has a <a href=#concept-path title=concept-path>path</a>. A <dfn id=concept-path title=concept-path>path</dfn> has a list of zero or more subpaths.
Each subpath consists of a list of one or more points, connected by
@@ -35319,7 +35325,7 @@
<li><p>Move all the shapes in <var title="">glyphs</var> to the right by <var title="">x</var>
CSS pixels and down by <var title="">y</var> CSS pixels.</li>
- <li><p>Let <var title="">glyph subpaths</var> be a <a href=#path>path</a> describing the shapes given
+ <li><p>Let <var title="">glyph subpaths</var> be a <a href=#concept-path title=concept-path>path</a> describing the shapes given
in <var title="">glyphs</var>, with each CSS pixel in the coordinate space of <var title="">glyphs</var> mapped to one coordinate space unit in <var title="">glyph subpaths</var>.
Subpaths in <var title="">glyph subpaths</var> must wind clockwise, regardless of how the user
agent's font subsystem renders fonts and regardless of how the fonts themselves are defined.</p>
@@ -37315,7 +37321,7 @@
<li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-role>role</code> member's value is the empty string, and the <code title=dom-HitRegionOptions-label>label</code> member's value is either null or the empty
string.</li>
- <li>The <a href=#path>path</a> <var title="">source path</var> describes a shape with no
+ <li>The <a href=#concept-path title=concept-path>path</a> <var title="">source path</var> describes a shape with no
pixels.</li>
<li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-control>control</code> member is not null but is neither an
@@ -64212,14 +64218,6 @@
<td>current
<td>master
- <tr><td>none specified, for <code title=dom-open><a href=#dom-open>window.open()</a></code> <!-- same as _blank -->
- <td>new
- <td>new
- <td>maybe new†
- <td>maybe new†
- <td>maybe new†
- <td>maybe new†
-
<tr><td>empty string
<td>current
<td>master
@@ -64231,10 +64229,10 @@
<tr><td><code title="">_blank</code>
<td>new
<td>new
- <td>maybe new
- <td>maybe new
- <td>maybe new
- <td>maybe new
+ <td>maybe new†
+ <td>maybe new†
+ <td>maybe new†
+ <td>maybe new†
<tr><td><code title="">_self</code>
<td>current
@@ -64501,7 +64499,7 @@
attribute <a href=#windowproxy>WindowProxy</a>? <a href=#dom-opener title=dom-opener>opener</a>;
readonly attribute <a href=#windowproxy>WindowProxy</a> <a href=#dom-parent title=dom-parent>parent</a>;
readonly attribute <a href=#element>Element</a>? <a href=#dom-frameelement title=dom-frameElement>frameElement</a>;
- <a href=#windowproxy>WindowProxy</a> <a href=#dom-open title=dom-open>open</a>(optional DOMString url, optional DOMString target, optional DOMString features, optional boolean replace);
+ <a href=#windowproxy>WindowProxy</a> <a href=#dom-open title=dom-open>open</a>(optional DOMString url = "about:blank", optional DOMString target = "_blank", optional DOMString features = "", optional boolean replace = false);
<a href=#dom-window-item title=dom-window-item>getter</a> <a href=#windowproxy>WindowProxy</a> (unsigned long index);
<a href=#dom-window-nameditem title=dom-window-namedItem>getter</a> object (DOMString name);
@@ -64682,15 +64680,16 @@
<p>The method has four arguments, though they are all optional.</p>
+<!--CLEANUP-->
<p>The first argument, <var title="">url</var>, must be a <a href=#valid-non-empty-url>valid non-empty URL</a> for a
- page to load in the browsing context. If no arguments are provided, or if the first argument is
- the empty string, then the <var title="">url</var> argument defaults to
- "<code><a href=#about:blank>about:blank</a></code>". The argument must be <a href=#resolve-a-url title="resolve a url">resolved</a> to an
+ page to load in the browsing context. If the first argument is
+ the empty string, then the <var title="">url</var> argument must be interpreted as
+ "<code><a href=#about:blank>about:blank</a></code>". Otherwise, the argument must be <a href=#resolve-a-url title="resolve a url">resolved</a> to an
<a href=#absolute-url>absolute URL</a> (or an error), relative to the <a href=#entry-script>entry script</a>'s <a href="#script's-base-url" title="script's base URL">base URL</a>, when the method is invoked.</p>
<p>The second argument, <var title="">target</var>, specifies the <a href=#browsing-context-name title="browsing context
name">name</a> of the browsing context that is to be navigated. It must be a <a href=#valid-browsing-context-name-or-keyword>valid
- browsing context name or keyword</a>. If fewer than two arguments are provided, then the <var title="">target</var> argument defaults to the value "<code>_blank</code>".</p>
+ browsing context name or keyword</a>.</p>
<p>The third argument, <var title="">features</var>, has no defined effect and is mentioned for
historical reasons only. User agents may interpret this argument as instructions to set the size
@@ -64700,8 +64699,7 @@
<p>The fourth argument, <var title="">replace</var>, specifies whether or not the new page will
<a href=#replacement-enabled title="replacement enabled">replace</a> the page currently loaded in the browsing
context, when <var title="">target</var> identifies an existing browsing context (as opposed to
- leaving the current page in the browsing context's <a href=#session-history>session history</a>). When three or
- fewer arguments are provided, <var title="">replace</var> defaults to false.</p>
+ leaving the current page in the browsing context's <a href=#session-history>session history</a>).</p>
<p>When the method is invoked, the user agent must first select a <a href=#browsing-context>browsing context</a> to
navigate by applying <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for choosing a browsing context given a browsing context
Modified: index
===================================================================
--- index 2013-04-12 21:58:09 UTC (rev 7821)
+++ index 2013-04-12 22:55:48 UTC (rev 7822)
@@ -8308,8 +8308,8 @@
readonly attribute <a href=#htmlscriptelement>HTMLScriptElement</a>? <a href=#dom-document-currentscript title=dom-document-currentScript>currentScript</a>;
// <a href=#dynamic-markup-insertion>dynamic markup insertion</a>
- <a href=#document>Document</a> <a href=#dom-document-open title=dom-document-open>open</a>(optional DOMString type, optional DOMString replace);
- <a href=#windowproxy>WindowProxy</a> <a href=#dom-document-open title=dom-document-open>open</a>(DOMString url, DOMString name, DOMString features, optional boolean replace);
+ <a href=#document>Document</a> <a href=#dom-document-open title=dom-document-open>open</a>(optional DOMString type = "text/html", optional DOMString replace = "");
+ <a href=#windowproxy>WindowProxy</a> <a href=#dom-document-open title=dom-document-open>open</a>(DOMString url, DOMString name, DOMString features, optional boolean replace = false);
void <a href=#dom-document-close title=dom-document-close>close</a>();
void <a href=#dom-document-write title=dom-document-write>write</a>(DOMString... text);
void <a href=#dom-document-writeln title=dom-document-writeln>writeln</a>(DOMString... text);
@@ -9641,7 +9641,7 @@
<div class=example>
- <p>In this example, everything in the document is to be translated when the page is localised,
+ <p>In this example, everything in the document is to be translated when the page is localized,
except the sample keyboard input and sample program output:</p>
<pre><!DOCTYPE HTML>
@@ -11775,7 +11775,8 @@
unloaded</a>. Initially, the counter must be set to zero.</p> <!--
http://www.hixie.ch/tests/adhoc/dom/level0/document/open/unload/ -->
- <p>When called with two or fewer arguments, the <code title=dom-document-open><a href=#dom-document-open>document.open()</a></code> method must act as follows:</p>
+ <p>When called with two arguments, the <code title=dom-document-open><a href=#dom-document-open>document.open()</a></code>
+ method must act as follows:</p>
<ol><li><p>If the <code><a href=#document>Document</a></code> object is not flagged as an <a href=#html-documents title="HTML documents">HTML
document</a>, throw an <code><a href=#invalidstateerror>InvalidStateError</a></code> exception and abort these steps.</li>
@@ -11783,12 +11784,12 @@
<li><p>If the <code><a href=#document>Document</a></code> object is not an <a href=#active-document>active document</a>, then abort
these steps.</li>
- <li><p>Let <var title="">type</var> be the value of the first argument, if there is one, or
- "<code><a href=#text/html>text/html</a></code>" otherwise.</li>
+ <li><p>Let <var title="">type</var> be the value of the first argument.</li>
<li>
+<!--CLEANUP-->
- <p>If there is a second argument and it is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for the
+ <p>If the second argument is an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for the
value "replace", then let <var title="">replace</var> be true.</p>
<p>Otherwise, if the <a href=#browsing-context>browsing context</a>'s <a href=#session-history>session history</a> contains only
@@ -11953,7 +11954,8 @@
whether a <code><a href=#document>Document</a></code> is <a href=#ready-for-post-load-tasks>ready for post-load tasks</a> or <a href=#completely-loaded>completely
loaded</a>.</p>
- <p>When called with three or more arguments, the <code title=dom-document-open><a href=#dom-document-open>open()</a></code>
+<!--CLEANUP-->
+ <p>When called with four arguments, the <code title=dom-document-open><a href=#dom-document-open>open()</a></code>
method on the <code><a href=#document>Document</a></code> object must call the <code title=dom-open><a href=#dom-open>open()</a></code>
method on the <code><a href=#window>Window</a></code> object of the <code><a href=#document>Document</a></code> object, with the same
arguments as the original call to the <code title=dom-document-open><a href=#dom-document-open>open()</a></code> method, and
@@ -12007,6 +12009,7 @@
<h4 id=document.write()><span class=secno>3.4.3 </span><code title=dom-document-write><a href=#dom-document-write>document.write()</a></code></h4>
+<!--CLEANUP-->
<dl class=domintro><dt><var title="">document</var> . <code title=dom-document-write><a href=#dom-document-write>write</a></code>(<var title="">text</var>...)</dt>
<dd>
@@ -12042,6 +12045,7 @@
</dl><div class=impl>
+<!--CLEANUP-->
<p><code><a href=#document>Document</a></code> objects have an
<dfn id=ignore-destructive-writes-counter>ignore-destructive-writes counter</dfn>, which is used in
conjunction with the processing of <code><a href=#the-script-element>script</a></code> elements to
@@ -12125,6 +12129,7 @@
<h4 id=document.writeln()><span class=secno>3.4.4 </span><code title=dom-document-writeln><a href=#dom-document-writeln>document.writeln()</a></code></h4>
+<!--CLEANUP-->
<dl class=domintro><dt><var title="">document</var> . <code title=dom-document-writeln><a href=#dom-document-writeln>writeln</a></code>(<var title="">text</var>...)</dt>
<dd>
@@ -33820,7 +33825,7 @@
</dd>
- </dl><div class=impl>
+ </dl><!--CLEANUP--><div class=impl>
<p>Objects that implement the <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code>
interface have attributes and methods (defined in this section) that
@@ -33919,10 +33924,10 @@
interface is created, the <code title=dom-context-2d-lineDashOffset><a href=#dom-context-2d-linedashoffset>lineDashOffset</a></code>
attribute must initially have the value <code>0.0</code>.</p>
- <hr><p>When a user agent is to <dfn id=trace-a-path>trace a <span>path</span></dfn>,
+ <hr><p>When a user agent is to <dfn id=trace-a-path>trace a <span title=concept-path>path</span></dfn>,
given an object <var title="">style</var> that implements the
<code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code> interface, it must run the following
- algorithm. This algorithm returns a new <a href=#path>path</a>.</p>
+ algorithm. This algorithm returns a new <a href=#concept-path title=concept-path>path</a>.</p>
<ol><li><p>Let <var title="">path</var> be a copy of the path being
traced.</li>
@@ -34080,7 +34085,7 @@
<li>
- <p>Create a new <a href=#path>path</a> that describes the result of
+ <p>Create a new <a href=#concept-path title=concept-path>path</a> that describes the result of
inflating the paths in <var title="">path</var> perpendicular to
the direction of the path to the <var title="">styles</var> <code title=dom-context-2d-lineWidth><a href=#dom-context-2d-linewidth>lineWidth</a></code> width, replacing
each point with the end cap necessary to satisfy the <var title="">styles</var> <code title=dom-context-2d-lineCap><a href=#dom-context-2d-linecap>lineCap</a></code> attribute as
@@ -34595,6 +34600,7 @@
</ol><h6 id=building-paths><span class=secno>4.8.11.2.6 </span>Building paths</h6>
+<!--CLEANUP-->
<p>Each object implementing the <code><a href=#canvaspathmethods>CanvasPathMethods</a></code>
interface has a <a href=#concept-path title=concept-path>path</a>. A <dfn id=concept-path title=concept-path>path</dfn> has a list of zero or more subpaths.
Each subpath consists of a list of one or more points, connected by
@@ -35319,7 +35325,7 @@
<li><p>Move all the shapes in <var title="">glyphs</var> to the right by <var title="">x</var>
CSS pixels and down by <var title="">y</var> CSS pixels.</li>
- <li><p>Let <var title="">glyph subpaths</var> be a <a href=#path>path</a> describing the shapes given
+ <li><p>Let <var title="">glyph subpaths</var> be a <a href=#concept-path title=concept-path>path</a> describing the shapes given
in <var title="">glyphs</var>, with each CSS pixel in the coordinate space of <var title="">glyphs</var> mapped to one coordinate space unit in <var title="">glyph subpaths</var>.
Subpaths in <var title="">glyph subpaths</var> must wind clockwise, regardless of how the user
agent's font subsystem renders fonts and regardless of how the fonts themselves are defined.</p>
@@ -37315,7 +37321,7 @@
<li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-role>role</code> member's value is the empty string, and the <code title=dom-HitRegionOptions-label>label</code> member's value is either null or the empty
string.</li>
- <li>The <a href=#path>path</a> <var title="">source path</var> describes a shape with no
+ <li>The <a href=#concept-path title=concept-path>path</a> <var title="">source path</var> describes a shape with no
pixels.</li>
<li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-control>control</code> member is not null but is neither an
@@ -64212,14 +64218,6 @@
<td>current
<td>master
- <tr><td>none specified, for <code title=dom-open><a href=#dom-open>window.open()</a></code> <!-- same as _blank -->
- <td>new
- <td>new
- <td>maybe new†
- <td>maybe new†
- <td>maybe new†
- <td>maybe new†
-
<tr><td>empty string
<td>current
<td>master
@@ -64231,10 +64229,10 @@
<tr><td><code title="">_blank</code>
<td>new
<td>new
- <td>maybe new
- <td>maybe new
- <td>maybe new
- <td>maybe new
+ <td>maybe new†
+ <td>maybe new†
+ <td>maybe new†
+ <td>maybe new†
<tr><td><code title="">_self</code>
<td>current
@@ -64501,7 +64499,7 @@
attribute <a href=#windowproxy>WindowProxy</a>? <a href=#dom-opener title=dom-opener>opener</a>;
readonly attribute <a href=#windowproxy>WindowProxy</a> <a href=#dom-parent title=dom-parent>parent</a>;
readonly attribute <a href=#element>Element</a>? <a href=#dom-frameelement title=dom-frameElement>frameElement</a>;
- <a href=#windowproxy>WindowProxy</a> <a href=#dom-open title=dom-open>open</a>(optional DOMString url, optional DOMString target, optional DOMString features, optional boolean replace);
+ <a href=#windowproxy>WindowProxy</a> <a href=#dom-open title=dom-open>open</a>(optional DOMString url = "about:blank", optional DOMString target = "_blank", optional DOMString features = "", optional boolean replace = false);
<a href=#dom-window-item title=dom-window-item>getter</a> <a href=#windowproxy>WindowProxy</a> (unsigned long index);
<a href=#dom-window-nameditem title=dom-window-namedItem>getter</a> object (DOMString name);
@@ -64682,15 +64680,16 @@
<p>The method has four arguments, though they are all optional.</p>
+<!--CLEANUP-->
<p>The first argument, <var title="">url</var>, must be a <a href=#valid-non-empty-url>valid non-empty URL</a> for a
- page to load in the browsing context. If no arguments are provided, or if the first argument is
- the empty string, then the <var title="">url</var> argument defaults to
- "<code><a href=#about:blank>about:blank</a></code>". The argument must be <a href=#resolve-a-url title="resolve a url">resolved</a> to an
+ page to load in the browsing context. If the first argument is
+ the empty string, then the <var title="">url</var> argument must be interpreted as
+ "<code><a href=#about:blank>about:blank</a></code>". Otherwise, the argument must be <a href=#resolve-a-url title="resolve a url">resolved</a> to an
<a href=#absolute-url>absolute URL</a> (or an error), relative to the <a href=#entry-script>entry script</a>'s <a href="#script's-base-url" title="script's base URL">base URL</a>, when the method is invoked.</p>
<p>The second argument, <var title="">target</var>, specifies the <a href=#browsing-context-name title="browsing context
name">name</a> of the browsing context that is to be navigated. It must be a <a href=#valid-browsing-context-name-or-keyword>valid
- browsing context name or keyword</a>. If fewer than two arguments are provided, then the <var title="">target</var> argument defaults to the value "<code>_blank</code>".</p>
+ browsing context name or keyword</a>.</p>
<p>The third argument, <var title="">features</var>, has no defined effect and is mentioned for
historical reasons only. User agents may interpret this argument as instructions to set the size
@@ -64700,8 +64699,7 @@
<p>The fourth argument, <var title="">replace</var>, specifies whether or not the new page will
<a href=#replacement-enabled title="replacement enabled">replace</a> the page currently loaded in the browsing
context, when <var title="">target</var> identifies an existing browsing context (as opposed to
- leaving the current page in the browsing context's <a href=#session-history>session history</a>). When three or
- fewer arguments are provided, <var title="">replace</var> defaults to false.</p>
+ leaving the current page in the browsing context's <a href=#session-history>session history</a>).</p>
<p>When the method is invoked, the user agent must first select a <a href=#browsing-context>browsing context</a> to
navigate by applying <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for choosing a browsing context given a browsing context
Modified: source
===================================================================
--- source 2013-04-12 21:58:09 UTC (rev 7821)
+++ source 2013-04-12 22:55:48 UTC (rev 7822)
@@ -8008,8 +8008,8 @@
readonly attribute <span>HTMLScriptElement</span>? <span title="dom-document-currentScript">currentScript</span>;
// <span>dynamic markup insertion</span>
- <span>Document</span> <span title="dom-document-open">open</span>(optional DOMString type, optional DOMString replace);
- <span>WindowProxy</span> <span title="dom-document-open">open</span>(DOMString url, DOMString name, DOMString features, optional boolean replace);
+ <span>Document</span> <span title="dom-document-open">open</span>(optional DOMString type = "text/html", optional DOMString replace = "");
+ <span>WindowProxy</span> <span title="dom-document-open">open</span>(DOMString url, DOMString name, DOMString features, optional boolean replace = false);
void <span title="dom-document-close">close</span>();
void <span title="dom-document-write">write</span>(DOMString... text);
void <span title="dom-document-writeln">writeln</span>(DOMString... text);
@@ -9551,7 +9551,7 @@
<div class="example">
- <p>In this example, everything in the document is to be translated when the page is localised,
+ <p>In this example, everything in the document is to be translated when the page is localized,
except the sample keyboard input and sample program output:</p>
<pre><!DOCTYPE HTML>
@@ -11986,8 +11986,8 @@
unloaded</span>. Initially, the counter must be set to zero.</p> <!--
http://www.hixie.ch/tests/adhoc/dom/level0/document/open/unload/ -->
- <p>When called with two or fewer arguments, the <code
- title="dom-document-open">document.open()</code> method must act as follows:</p>
+ <p>When called with two arguments, the <code title="dom-document-open">document.open()</code>
+ method must act as follows:</p>
<ol>
@@ -11997,12 +11997,12 @@
<li><p>If the <code>Document</code> object is not an <span>active document</span>, then abort
these steps.</p></li>
- <li><p>Let <var title="">type</var> be the value of the first argument, if there is one, or
- "<code>text/html</code>" otherwise.</p></li>
+ <li><p>Let <var title="">type</var> be the value of the first argument.</p></li>
<li>
+<!--CLEANUP-->
- <p>If there is a second argument and it is an <span>ASCII case-insensitive</span> match for the
+ <p>If the second argument is an <span>ASCII case-insensitive</span> match for the
value "replace", then let <var title="">replace</var> be true.</p>
<p>Otherwise, if the <span>browsing context</span>'s <span>session history</span> contains only
@@ -12177,7 +12177,8 @@
whether a <code>Document</code> is <span>ready for post-load tasks</span> or <span>completely
loaded</span>.</p>
- <p>When called with three or more arguments, the <code title="dom-document-open">open()</code>
+<!--CLEANUP-->
+ <p>When called with four arguments, the <code title="dom-document-open">open()</code>
method on the <code>Document</code> object must call the <code title="dom-open">open()</code>
method on the <code>Window</code> object of the <code>Document</code> object, with the same
arguments as the original call to the <code title="dom-document-open">open()</code> method, and
@@ -12240,6 +12241,7 @@
<h4><code title="dom-document-write">document.write()</code></h4>
+<!--CLEANUP-->
<dl class="domintro">
<dt><var title="">document</var> . <code title="dom-document-write">write</code>(<var title="">text</var>...)</dt>
@@ -12282,6 +12284,7 @@
<div class="impl">
+<!--CLEANUP-->
<p><code>Document</code> objects have an
<dfn>ignore-destructive-writes counter</dfn>, which is used in
conjunction with the processing of <code>script</code> elements to
@@ -12373,6 +12376,7 @@
<h4><code title="dom-document-writeln">document.writeln()</code></h4>
+<!--CLEANUP-->
<dl class="domintro">
<dt><var title="">document</var> . <code title="dom-document-writeln">writeln</code>(<var title="">text</var>...)</dt>
@@ -40878,6 +40882,7 @@
</dl>
+<!--CLEANUP-->
<div class="impl">
<p>Objects that implement the <code>CanvasDrawingStyles</code>
@@ -41003,10 +41008,10 @@
<hr>
- <p>When a user agent is to <dfn>trace a <span>path</span></dfn>,
+ <p>When a user agent is to <dfn>trace a <span title="concept-path">path</span></dfn>,
given an object <var title="">style</var> that implements the
<code>CanvasDrawingStyles</code> interface, it must run the following
- algorithm. This algorithm returns a new <span>path</span>.</p>
+ algorithm. This algorithm returns a new <span title="concept-path">path</span>.</p>
<ol>
@@ -41192,7 +41197,7 @@
<li>
- <p>Create a new <span>path</span> that describes the result of
+ <p>Create a new <span title="concept-path">path</span> that describes the result of
inflating the paths in <var title="">path</var> perpendicular to
the direction of the path to the <var title="">styles</var> <code
title="dom-context-2d-lineWidth">lineWidth</code> width, replacing
@@ -41807,6 +41812,7 @@
<h6>Building paths</h6>
+<!--CLEANUP-->
<p>Each object implementing the <code>CanvasPathMethods</code>
interface has a <span title="concept-path">path</span>. A <dfn
title="concept-path">path</dfn> has a list of zero or more subpaths.
@@ -42658,7 +42664,7 @@
<li><p>Move all the shapes in <var title="">glyphs</var> to the right by <var title="">x</var>
CSS pixels and down by <var title="">y</var> CSS pixels.</p></li>
- <li><p>Let <var title="">glyph subpaths</var> be a <span>path</span> describing the shapes given
+ <li><p>Let <var title="">glyph subpaths</var> be a <span title="concept-path">path</span> describing the shapes given
in <var title="">glyphs</var>, with each CSS pixel in the coordinate space of <var
title="">glyphs</var> mapped to one coordinate space unit in <var title="">glyph subpaths</var>.
Subpaths in <var title="">glyph subpaths</var> must wind clockwise, regardless of how the user
@@ -45068,7 +45074,7 @@
title="dom-HitRegionOptions-label">label</code> member's value is either null or the empty
string.</li>
- <li>The <span>path</span> <var title="">source path</var> describes a shape with no
+ <li>The <span title="concept-path">path</span> <var title="">source path</var> describes a shape with no
pixels.</li>
<li>The <var title="">arguments</var> object's <code
@@ -76098,15 +76104,6 @@
<td>master
<tr>
- <td>none specified, for <code title="dom-open">window.open()</code> <!-- same as _blank -->
- <td>new
- <td>new
- <td>maybe new†
- <td>maybe new†
- <td>maybe new†
- <td>maybe new†
-
- <tr>
<td>empty string
<td>current
<td>master
@@ -76119,10 +76116,10 @@
<td><code title="">_blank</code>
<td>new
<td>new
- <td>maybe new
- <td>maybe new
- <td>maybe new
- <td>maybe new
+ <td>maybe new†
+ <td>maybe new†
+ <td>maybe new†
+ <td>maybe new†
<tr>
<td><code title="">_self</code>
@@ -76425,7 +76422,7 @@
attribute <span>WindowProxy</span>? <span title="dom-opener">opener</span>;
readonly attribute <span>WindowProxy</span> <span title="dom-parent">parent</span>;
readonly attribute <span>Element</span>? <span title="dom-frameElement">frameElement</span>;
- <span>WindowProxy</span> <span title="dom-open">open</span>(optional DOMString url, optional DOMString target, optional DOMString features, optional boolean replace);
+ <span>WindowProxy</span> <span title="dom-open">open</span>(optional DOMString url = "about:blank", optional DOMString target = "_blank", optional DOMString features = "", optional boolean replace = false);
<span title="dom-window-item">getter</span> <span>WindowProxy</span> (unsigned long index);
<span title="dom-window-namedItem">getter</span> object (DOMString name);
@@ -76623,17 +76620,17 @@
<p>The method has four arguments, though they are all optional.</p>
+<!--CLEANUP-->
<p>The first argument, <var title="">url</var>, must be a <span>valid non-empty URL</span> for a
- page to load in the browsing context. If no arguments are provided, or if the first argument is
- the empty string, then the <var title="">url</var> argument defaults to
- "<code>about:blank</code>". The argument must be <span title="resolve a url">resolved</span> to an
+ page to load in the browsing context. If the first argument is
+ the empty string, then the <var title="">url</var> argument must be interpreted as
+ "<code>about:blank</code>". Otherwise, the argument must be <span title="resolve a url">resolved</span> to an
<span>absolute URL</span> (or an error), relative to the <span>entry script</span>'s <span
title="script's base URL">base URL</span>, when the method is invoked.</p>
<p>The second argument, <var title="">target</var>, specifies the <span title="browsing context
name">name</span> of the browsing context that is to be navigated. It must be a <span>valid
- browsing context name or keyword</span>. If fewer than two arguments are provided, then the <var
- title="">target</var> argument defaults to the value "<code>_blank</code>".</p>
+ browsing context name or keyword</span>.</p>
<p>The third argument, <var title="">features</var>, has no defined effect and is mentioned for
historical reasons only. User agents may interpret this argument as instructions to set the size
@@ -76643,8 +76640,7 @@
<p>The fourth argument, <var title="">replace</var>, specifies whether or not the new page will
<span title="replacement enabled">replace</span> the page currently loaded in the browsing
context, when <var title="">target</var> identifies an existing browsing context (as opposed to
- leaving the current page in the browsing context's <span>session history</span>). When three or
- fewer arguments are provided, <var title="">replace</var> defaults to false.</p>
+ leaving the current page in the browsing context's <span>session history</span>).</p>
<p>When the method is invoked, the user agent must first select a <span>browsing context</span> to
navigate by applying <span>the rules for choosing a browsing context given a browsing context
More information about the Commit-Watchers
mailing list