Skip to content

Commit

Permalink
[e] (0) ref rfc2397 where appropriate
Browse files Browse the repository at this point in the history 
git-svn-id: http://svn.whatwg.org/webapps@5693 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Dec 1, 2010
1 parent 4f662a4 commit 0ef8ab2
Show file tree
Hide file tree
Showing 3 changed files with 157 additions and 89 deletions.
80 changes: 51 additions & 29 deletions complete.html
View file
Expand Up @@ -2681,6 +2681,9 @@ <h4 id=resources><span class=secno>2.1.1 </span>Resources</h4>
subresources</a>; other resources, e.g. fonts or backgrounds, are
not.</p>

<p>The term <dfn id=data-protocol title="data protocol"><code title="">data:</code>
URL</dfn> refers to <a href=#url title=URL>URLs</a> that use the <code title="">data:</code> scheme. <a href=#refsRFC2397>[RFC2397]</a></p>


<h4 id=xml><span class=secno>2.1.2 </span>XML</h4>

Expand Down Expand Up @@ -30918,8 +30921,7 @@ <h4 id=the-canvas-element><span class=secno>4.8.11 </span>The <dfn id=canvas><co

<dd>

<p>Returns a <code title="">data:</code> URL for the image in the
canvas.</p>
<p>Returns a <a href=#data-protocol title="data protocol"><code title="">data:</code> URL</a> for the image in the canvas.</p>

<p>The first argument, if provided, controls the type of the image
to be returned (e.g. PNG or JPEG). The default is <code title="">image/png</code>; that type is also used if the given
Expand All @@ -30932,17 +30934,20 @@ <h4 id=the-canvas-element><span class=secno>4.8.11 </span>The <dfn id=canvas><co
</dl><div class=impl>

<p>The <dfn id=dom-canvas-todataurl title=dom-canvas-toDataURL><code>toDataURL()</code></dfn> method
must, when called with no arguments, return a <code title="">data:</code> URL containing a representation of the image
as a PNG file. <a href=#refsPNG>[PNG]</a></p>
must, when called with no arguments, return a <a href=#data-protocol title="data
protocol"><code title="">data:</code> URL</a> containing a
representation of the image as a PNG file. <a href=#refsPNG>[PNG]</a> <a href=#refsRFC2397>[RFC2397]</a></p>

<p>If the canvas has no pixels (i.e. either its horizontal dimension
or its vertical dimension is zero) then the method must return the
string "<code title="">data:,</code>". (This is the shortest <code title="">data:</code> URL; it represents the empty string in a <code title="">text/plain</code> resource.)</p>
string "<code title="">data:,</code>". (This is the shortest <a href=#data-protocol title="data protocol"><code title="">data:</code> URL</a>; it
represents the empty string in a <code title="">text/plain</code>
resource.)</p>

<p>When the <code title=dom-canvas-toDataURL><a href=#dom-canvas-todataurl>toDataURL(<var title="">type</var>)</a></code> method is called with one <em>or
more</em> arguments, it must return a <code title="">data:</code>
URL containing a representation of the image in the format given by
<var title="">type</var>. The possible values are <a href=#mime-type title="MIME
more</em> arguments, it must return a <a href=#data-protocol title="data
protocol"><code title="">data:</code> URL</a> containing a
representation of the image in the format given by <var title="">type</var>. The possible values are <a href=#mime-type title="MIME
type">MIME types</a> with no parameters, for example
<code>image/png</code>, <code>image/jpeg</code>, or even maybe
<code>image/svg+xml</code> if the implementation actually keeps
Expand All @@ -30952,15 +30957,17 @@ <h4 id=the-canvas-element><span class=secno>4.8.11 </span>The <dfn id=canvas><co
<p>For image types that do not support an alpha channel, the image
must be composited onto a solid black background using the
source-over operator, and the resulting image must be the one used
to create the <code title="">data:</code> URL.</p>
to create the <a href=#data-protocol title="data protocol"><code title="">data:</code> URL</a>.</p>

<p>Only support for <code>image/png</code> is required. User agents
may support other types. If the user agent does not support the
requested type, it must return the image using the PNG format.</p>

<p>User agents must <a href=#converted-to-ascii-lowercase title="converted to ASCII lowercase">convert the
provided type to ASCII lowercase</a> before establishing if they
support that type and before creating the <code title="">data:</code> URL.</p>
<p>User agents must <a href=#converted-to-ascii-lowercase title="converted to ASCII
lowercase">convert the provided type to ASCII lowercase</a>
before establishing if they support that type and before creating
the <a href=#data-protocol title="data protocol"><code title="">data:</code>
URL</a>.</p>

</div>

Expand Down Expand Up @@ -31002,6 +31009,10 @@ <h4 id=the-canvas-element><span class=secno>4.8.11 </span>The <dfn id=canvas><co
more carefully control compression settings, image metadata,
etc.</p>

<!-- should we explicitly require the URL to be base64-encoded and
not have any parameters, to ensure the same exact URL is generated
in each browser? -->

</div>

<!--2DCONTEXT-->
Expand Down Expand Up @@ -47681,9 +47692,10 @@ <h5 id=form-submission-algorithm><span class=secno>4.10.22.3 </span>Form submiss
resulting escaped string. <a href=#refsRFC3986>[RFC3986]</a></p>

<p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
browsing context</var> to the potentially modified <var title="">action</var>. If <var title="">replace</var> is true,
then <var title="">target browsing context</var> must be
navigated with <a href=#replacement-enabled>replacement enabled</a>.</p>
browsing context</var> to the potentially modified <var title="">action</var> (which will be a <a href=#data-protocol title="data
protocol"><code title="">data:</code> URL</a>). If <var title="">replace</var> is true, then <var title="">target
browsing context</var> must be navigated with <a href=#replacement-enabled>replacement
enabled</a>.</p>

</dd>

Expand Down Expand Up @@ -58052,17 +58064,20 @@ <h3 id=origin-0><span class=secno>6.3 </span>Origin</h3>


<dt>If a <code><a href=#document>Document</a></code> or image was generated from a
<code title="">data:</code> URL that was returned as the location
of an HTTP redirect (<a href=#concept-http-equivalent-codes title=concept-http-equivalent-codes>or equivalent</a> in
other protocols)</dt>
<a href=#data-protocol title="data protocol"><code title="">data:</code>
URL</a> that was returned as the location of an HTTP redirect
(<a href=#concept-http-equivalent-codes title=concept-http-equivalent-codes>or equivalent</a>
in other protocols)</dt>

<dd>The <a href=#origin>origin</a> is the <a href=#origin>origin</a> of the
<a href=#url>URL</a> that redirected to the <code title="">data:</code> URL.</dd>
<a href=#url>URL</a> that redirected to the <a href=#data-protocol title="data
protocol"><code title="">data:</code> URL</a>.</dd>


<dt>If a <code><a href=#document>Document</a></code> or image was generated from a
<code title="">data:</code> URL found in another
<code><a href=#document>Document</a></code> or in a script</dt>
<a href=#data-protocol title="data protocol"><code title="">data:</code>
URL</a> found in another <code><a href=#document>Document</a></code> or in a
script</dt>

<dd>The <a href=#origin>origin</a> is the <a href=#origin>origin</a> of the
<code><a href=#document>Document</a></code> or script that initiated the <a href=#navigate title=navigate>navigation</a> to that <a href=#url>URL</a>.</dd>
Expand All @@ -58085,8 +58100,8 @@ <h3 id=origin-0><span class=secno>6.3 </span>Origin</h3>


<dt>If a <code><a href=#document>Document</a></code> or image was obtained in some
other manner (e.g. a <code title="">data:</code> URL typed in by
the user, a <code><a href=#document>Document</a></code> created using the <code title=dom-DOMImplementation-createDocument><a href=#dom-domimplementation-createdocument>createDocument()</a></code>
other manner (e.g. a <a href=#data-protocol title="data protocol"><code title="">data:</code> URL</a> typed in by the user, a
<code><a href=#document>Document</a></code> created using the <code title=dom-DOMImplementation-createDocument><a href=#dom-domimplementation-createdocument>createDocument()</a></code>
API, etc)</dt>

<dd>The <a href=#origin>origin</a> is a globally unique identifier
Expand Down Expand Up @@ -71082,9 +71097,10 @@ <h5 id=the-abstractworker-abstract-interface><span class=secno>9.2.7.1 </span>Th
<code><a href=#security_err>SECURITY_ERR</a></code> exception.</p>

<p class=note>Thus, scripts must be external files with the same
scheme as the original page: you can't load a script from a <code title="">data:</code> URL or <code title="">javascript:</code>
URL, and a <code>https:</code> page couldn't start workers using
scripts with <code>http:</code> URLs.</p>
scheme as the original page: you can't load a script from a <a href=#data-protocol title="data protocol"><code title="">data:</code> URL</a> or
<a href=#javascript-protocol title="javascript protocol"><code title="">javascript:</code> URL</a>, and an <code>https:</code>
page couldn't start workers using scripts with <code>http:</code>
URLs.</p>

</li>

Expand Down Expand Up @@ -71205,9 +71221,10 @@ <h5 id=shared-workers-and-the-sharedworker-interface><span class=secno>9.2.7.3 <
exception.</p>

<p class=note>Thus, scripts must be external files with the same
scheme as the original page: you can't load a script from a <code title="">data:</code> URL or <code title="">javascript:</code>
URL, and a <code>https:</code> page couldn't start workers using
scripts with <code>http:</code> URLs.</p>
scheme as the original page: you can't load a script from a <a href=#data-protocol title="data protocol"><code title="">data:</code> URL</a> or
<a href=#javascript-protocol title="javascript protocol"><code title="">javascript:</code> URL</a>, and a <code>https:</code>
page couldn't start workers using scripts with <code>http:</code>
URLs.</p>

</li>

Expand Down Expand Up @@ -92445,6 +92462,10 @@ <h3 class="no-num">Reflecting IDL attributes</h3>
<dd><cite><a href=http://tools.ietf.org/html/rfc2388>Returning Values from
Forms: multipart/form-data</a></cite>, L. Masinter. IETF.</dd>

<dt id=refsRFC2397>[RFC2397]</dt>
<dd><cite><a href=http://tools.ietf.org/html/rfc2397>The "data"
URL scheme</a></cite>, L. Masinter. IETF.</dd>

<dt id=refsRFC2425>[RFC2425]</dt>
<dd><cite><a href=http://tools.ietf.org/html/rfc2425>A MIME
Content-Type for Directory Information</a></cite>, T. Howes,
Expand Down Expand Up @@ -93108,6 +93129,7 @@ <h3 class="no-num">Reflecting IDL attributes</h3>
Paul Norman,
Per-Erik Brodin,
Perry Smith,
Peter Beverloo,
Peter Karlsson,
Peter Kasting,
Peter Stark,
Expand Down
66 changes: 43 additions & 23 deletions index
View file
Expand Up @@ -2658,6 +2658,9 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
subresources</a>; other resources, e.g. fonts or backgrounds, are
not.</p>

<p>The term <dfn id=data-protocol title="data protocol"><code title="">data:</code>
URL</dfn> refers to <a href=#url title=URL>URLs</a> that use the <code title="">data:</code> scheme. <a href=#refsRFC2397>[RFC2397]</a></p>


<h4 id=xml><span class=secno>2.1.2 </span>XML</h4>

Expand Down Expand Up @@ -30898,8 +30901,7 @@ interface <dfn id=timedtrackcue>TimedTrackCue</dfn> {

<dd>

<p>Returns a <code title="">data:</code> URL for the image in the
canvas.</p>
<p>Returns a <a href=#data-protocol title="data protocol"><code title="">data:</code> URL</a> for the image in the canvas.</p>

<p>The first argument, if provided, controls the type of the image
to be returned (e.g. PNG or JPEG). The default is <code title="">image/png</code>; that type is also used if the given
Expand All @@ -30912,17 +30914,20 @@ interface <dfn id=timedtrackcue>TimedTrackCue</dfn> {
</dl><div class=impl>

<p>The <dfn id=dom-canvas-todataurl title=dom-canvas-toDataURL><code>toDataURL()</code></dfn> method
must, when called with no arguments, return a <code title="">data:</code> URL containing a representation of the image
as a PNG file. <a href=#refsPNG>[PNG]</a></p>
must, when called with no arguments, return a <a href=#data-protocol title="data
protocol"><code title="">data:</code> URL</a> containing a
representation of the image as a PNG file. <a href=#refsPNG>[PNG]</a> <a href=#refsRFC2397>[RFC2397]</a></p>

<p>If the canvas has no pixels (i.e. either its horizontal dimension
or its vertical dimension is zero) then the method must return the
string "<code title="">data:,</code>". (This is the shortest <code title="">data:</code> URL; it represents the empty string in a <code title="">text/plain</code> resource.)</p>
string "<code title="">data:,</code>". (This is the shortest <a href=#data-protocol title="data protocol"><code title="">data:</code> URL</a>; it
represents the empty string in a <code title="">text/plain</code>
resource.)</p>

<p>When the <code title=dom-canvas-toDataURL><a href=#dom-canvas-todataurl>toDataURL(<var title="">type</var>)</a></code> method is called with one <em>or
more</em> arguments, it must return a <code title="">data:</code>
URL containing a representation of the image in the format given by
<var title="">type</var>. The possible values are <a href=#mime-type title="MIME
more</em> arguments, it must return a <a href=#data-protocol title="data
protocol"><code title="">data:</code> URL</a> containing a
representation of the image in the format given by <var title="">type</var>. The possible values are <a href=#mime-type title="MIME
type">MIME types</a> with no parameters, for example
<code>image/png</code>, <code>image/jpeg</code>, or even maybe
<code>image/svg+xml</code> if the implementation actually keeps
Expand All @@ -30932,15 +30937,17 @@ interface <dfn id=timedtrackcue>TimedTrackCue</dfn> {
<p>For image types that do not support an alpha channel, the image
must be composited onto a solid black background using the
source-over operator, and the resulting image must be the one used
to create the <code title="">data:</code> URL.</p>
to create the <a href=#data-protocol title="data protocol"><code title="">data:</code> URL</a>.</p>

<p>Only support for <code>image/png</code> is required. User agents
may support other types. If the user agent does not support the
requested type, it must return the image using the PNG format.</p>

<p>User agents must <a href=#converted-to-ascii-lowercase title="converted to ASCII lowercase">convert the
provided type to ASCII lowercase</a> before establishing if they
support that type and before creating the <code title="">data:</code> URL.</p>
<p>User agents must <a href=#converted-to-ascii-lowercase title="converted to ASCII
lowercase">convert the provided type to ASCII lowercase</a>
before establishing if they support that type and before creating
the <a href=#data-protocol title="data protocol"><code title="">data:</code>
URL</a>.</p>

</div>

Expand Down Expand Up @@ -30982,6 +30989,10 @@ interface <dfn id=timedtrackcue>TimedTrackCue</dfn> {
more carefully control compression settings, image metadata,
etc.</p>

<!-- should we explicitly require the URL to be base64-encoded and
not have any parameters, to ensure the same exact URL is generated
in each browser? -->

</div>

<!--2DCONTEXT-->
Expand Down Expand Up @@ -47661,9 +47672,10 @@ fur
resulting escaped string. <a href=#refsRFC3986>[RFC3986]</a></p>

<p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
browsing context</var> to the potentially modified <var title="">action</var>. If <var title="">replace</var> is true,
then <var title="">target browsing context</var> must be
navigated with <a href=#replacement-enabled>replacement enabled</a>.</p>
browsing context</var> to the potentially modified <var title="">action</var> (which will be a <a href=#data-protocol title="data
protocol"><code title="">data:</code> URL</a>). If <var title="">replace</var> is true, then <var title="">target
browsing context</var> must be navigated with <a href=#replacement-enabled>replacement
enabled</a>.</p>

</dd>

Expand Down Expand Up @@ -58032,17 +58044,20 @@ x === this; // true</pre>


<dt>If a <code><a href=#document>Document</a></code> or image was generated from a
<code title="">data:</code> URL that was returned as the location
of an HTTP redirect (<a href=#concept-http-equivalent-codes title=concept-http-equivalent-codes>or equivalent</a> in
other protocols)</dt>
<a href=#data-protocol title="data protocol"><code title="">data:</code>
URL</a> that was returned as the location of an HTTP redirect
(<a href=#concept-http-equivalent-codes title=concept-http-equivalent-codes>or equivalent</a>
in other protocols)</dt>

<dd>The <a href=#origin>origin</a> is the <a href=#origin>origin</a> of the
<a href=#url>URL</a> that redirected to the <code title="">data:</code> URL.</dd>
<a href=#url>URL</a> that redirected to the <a href=#data-protocol title="data
protocol"><code title="">data:</code> URL</a>.</dd>


<dt>If a <code><a href=#document>Document</a></code> or image was generated from a
<code title="">data:</code> URL found in another
<code><a href=#document>Document</a></code> or in a script</dt>
<a href=#data-protocol title="data protocol"><code title="">data:</code>
URL</a> found in another <code><a href=#document>Document</a></code> or in a
script</dt>

<dd>The <a href=#origin>origin</a> is the <a href=#origin>origin</a> of the
<code><a href=#document>Document</a></code> or script that initiated the <a href=#navigate title=navigate>navigation</a> to that <a href=#url>URL</a>.</dd>
Expand All @@ -58065,8 +58080,8 @@ x === this; // true</pre>


<dt>If a <code><a href=#document>Document</a></code> or image was obtained in some
other manner (e.g. a <code title="">data:</code> URL typed in by
the user, a <code><a href=#document>Document</a></code> created using the <code title=dom-DOMImplementation-createDocument><a href=#dom-domimplementation-createdocument>createDocument()</a></code>
other manner (e.g. a <a href=#data-protocol title="data protocol"><code title="">data:</code> URL</a> typed in by the user, a
<code><a href=#document>Document</a></code> created using the <code title=dom-DOMImplementation-createDocument><a href=#dom-domimplementation-createdocument>createDocument()</a></code>
API, etc)</dt>

<dd>The <a href=#origin>origin</a> is a globally unique identifier
Expand Down Expand Up @@ -88504,6 +88519,10 @@ interface <a href=#htmldocument>HTMLDocument</a> {
<dd><cite><a href=http://tools.ietf.org/html/rfc2388>Returning Values from
Forms: multipart/form-data</a></cite>, L. Masinter. IETF.</dd>

<dt id=refsRFC2397>[RFC2397]</dt>
<dd><cite><a href=http://tools.ietf.org/html/rfc2397>The "data"
URL scheme</a></cite>, L. Masinter. IETF.</dd>

<dt id=refsRFC2425>[RFC2425]</dt>
<dd><cite><a href=http://tools.ietf.org/html/rfc2425>A MIME
Content-Type for Directory Information</a></cite>, T. Howes,
Expand Down Expand Up @@ -89186,6 +89205,7 @@ interface <a href=#htmldocument>HTMLDocument</a> {
Paul Norman,
Per-Erik Brodin,
Perry Smith,
Peter Beverloo,
Peter Karlsson,
Peter Kasting,
Peter Stark,
Expand Down

0 comments on commit 0ef8ab2

Please sign in to comment.