Skip to content

Commit

Permalink
[] (0) URLification of arguments and attributes in IDLs
Browse files Browse the repository at this point in the history 
git-svn-id: http://svn.whatwg.org/webapps@1810 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Jun 26, 2008
1 parent 8fa83d9 commit 414645d
Show file tree
Hide file tree
Showing 2 changed files with 44 additions and 44 deletions.
48 changes: 24 additions & 24 deletions index
View file
Original file line number Diff line number Diff line change
Expand Up @@ -31909,8 +31909,8 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
<pre
class=idl>interface <dfn id=clientinformation>ClientInformation</dfn> {
readonly attribute boolean <a href="#navigator.online" title=dom-navigator-onLine>onLine</a>;
void <a href="#registerprotocolhandler" title=dom-navigator-registerProtocolHandler>registerProtocolHandler</a>(in DOMString protocol, in DOMString uri, in DOMString title);
void <a href="#registercontenthandler" title=dom-navigator-registerContentHandler>registerContentHandler</a>(in DOMString mimeType, in DOMString uri, in DOMString title);
void <a href="#registerprotocolhandler" title=dom-navigator-registerProtocolHandler>registerProtocolHandler</a>(in DOMString protocol, in DOMString url, in DOMString title);
void <a href="#registercontenthandler" title=dom-navigator-registerContentHandler>registerContentHandler</a>(in DOMString mimeType, in DOMString url, in DOMString title);
<!-- XXX there are other attributes! -->};</pre>
<!-- also, see window.external.AddSearchProvider() and similar DOM APIs from IE -->

Expand Down Expand Up @@ -31981,7 +31981,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
</dd>
<!-- XXXURL XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \(URI\|IRI\|URL\) -->

<dt><var title="">uri</var>
<dt><var title="">url</var>

<dd> <!-- XXXURL use url, algorithms -->
<p>The URI of the page that will handle the requests. When the user agent
Expand Down Expand Up @@ -32040,7 +32040,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
Web browser would likely cause an exception to be raised.

<p>User agents must raise a <code>SYNTAX_ERR</code> exception if the <var
title="">uri</var> argument passed to one of these methods does not
title="">url</var> argument passed to one of these methods does not
contain the exact literal string "<code>%s</code>".

<p>User agents must not raise any other exceptions (other than
Expand All @@ -32049,7 +32049,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t

<p>This section does not define how the pages registered by these methods
are used, beyond the requirements on how to process the <var
title="">uri</var> value (see above). To some extent, the <a
title="">url</var> value (see above). To some extent, the <a
href="#navigate" title=navigate>processing model for navigating across
documents</a> defines some cases where these methods are relevant, but in
general UAs may use this information wherever they would otherwise
Expand Down Expand Up @@ -32181,7 +32181,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
href="#registerprotocolhandler">registerProtocolHandler()</a></code>
method as its first argument (<var title="">protocol</var>),
"http://kittens.example.org/?show=%s" was the second argument (<var
title="">uri</var>), and "Kittens-at-work displayer" was the third
title="">url</var>), and "Kittens-at-work displayer" was the third
argument (<var title="">title</var>).

<p>If the user clicks the Cancel button, then nothing further happens. If
Expand Down Expand Up @@ -32333,7 +32333,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
entries</dfn>

<dd>Resources that were added to the cache by the <code
title=dom-appcache-add><a href="#adduri">add()</a></code> method.
title=dom-appcache-add><a href="#addurl">add()</a></code> method.
</dl>
<!-- XXXURL change to URL -->
<p class=note>A URI in the list can be flagged with multiple different
Expand Down Expand Up @@ -33390,8 +33390,8 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
// dynamic entries
readonly attribute unsigned long <a href="#length8" title=dom-appcache-length>length</a>;
DOMString <a href="#itemindex4" title=dom-appcache-item>item</a>(in unsigned long index);
void <a href="#adduri" title=dom-appcache-add>add</a>(in DOMString uri);
void <a href="#remove2" title=dom-appcache-remove>remove</a>(in DOMString uri);
void <a href="#addurl" title=dom-appcache-add>add</a>(in DOMString url);
void <a href="#remove2" title=dom-appcache-remove>remove</a>(in DOMString url);

// events
attribute <span>EventListener</span> <a href="#onchecking" title=handler-appcache-onchecking>onchecking</a>;
Expand Down Expand Up @@ -33501,7 +33501,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
<p>The <a href="#dynamic3" title=concept-appcache-dynamic>dynamic
entries</a> in the <a href="#application0">application cache</a> are
ordered in the same order as they were added to the cache by the <code
title=dom-appcache-add><a href="#adduri">add()</a></code> method, with the
title=dom-appcache-add><a href="#addurl">add()</a></code> method, with the
oldest entry being the zeroth entry, and the most recently added entry
having the index <span><code title=dom-appcache-length><a
href="#length8">length</a></code>-1</span>.</p>
Expand All @@ -33519,8 +33519,8 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
href="#length8">length</a></code>-1</span>, the method must instead raise
an <code>INDEX_SIZE_ERR</code> exception.

<p>The <dfn id=adduri title=dom-appcache-add><code>add(<var
title="">uri</var>)</code></dfn> method must run the following steps:
<p>The <dfn id=addurl title=dom-appcache-add><code>add(<var
title="">url</var>)</code></dfn> method must run the following steps:

<ol>
<li>
Expand All @@ -33531,7 +33531,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
<!-- XXXURL change to URL -->

<li>
<p>If <var title="">uri</var> is not a valid URI reference, then raise a
<p>If <var title="">url</var> is not a valid URI reference, then raise a
<code>SYNTAX_ERR</code> exception and abort these steps. <a
href="#refsRFC3986">[RFC3986]</a> <a href="#refsRFC3987">[RFC3987]</a>
</li>
Expand All @@ -33547,15 +33547,15 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
<p>If there is already a resource in in the <a
href="#application0">application cache</a> with which the <code><a
href="#applicationcache">ApplicationCache</a></code> object is
associated that has the address <var title="">uri</var>, then ensure
associated that has the address <var title="">url</var>, then ensure
that entry is categorized as a <a href="#dynamic3"
title=concept-appcache-dynamic>dynamic entry</a> and return and abort
these steps.
</li>
<!-- XXXURL change to URL -->

<li>
<p>If <var title="">uri</var> has a different &lt;scheme> component than
<p>If <var title="">url</var> has a different &lt;scheme> component than
the manifest's URI, then raise a <a href="#security9">security
exception</a>.

Expand All @@ -33565,7 +33565,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
<!-- XXXURL change to URL, maybe xref "fetch"? -->

<li>
<p>Fetch the resource referenced by <var title="">uri</var>.
<p>Fetch the resource referenced by <var title="">url</var>.

<li>
<p>If this results 4xx or 5xx status codes or equivalent, or if there
Expand Down Expand Up @@ -33596,9 +33596,9 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
<!-- XXXURL algorithms -->

<p>The <dfn id=remove2 title=dom-appcache-remove><code>remove(<var
title="">uri</var>)</code></dfn> method must remove the <a
title="">url</var>)</code></dfn> method must remove the <a
href="#dynamic3" title=concept-appcache-dynamic>dynamic entry</a>
categorization of any entry with the address <var title="">uri</var> in
categorization of any entry with the address <var title="">url</var> in
the <a href="#application0">application cache</a> with which the <code><a
href="#applicationcache">ApplicationCache</a></code> object is associated.
<span class=big-issue>Resolve relative URIs... (ignore syntax
Expand Down Expand Up @@ -35404,8 +35404,8 @@ user reload must be equivalent to .reload()
href="#oldvalue">oldValue</a></code>, and <code
title=dom-StorageEvent-newValue>newValue</code> attributes set to null.

<p>In addition, the event must have its <code title=dom-StorageEvent-uri><a
href="#uri">uri</a></code> attribute set to the address of the page whose
<p>In addition, the event must have its <code title=dom-StorageEvent-url><a
href="#url1">url</a></code> attribute set to the address of the page whose
<code><a href="#storage0">Storage</a></code> object was affected, and its
<code title=dom-StorageEvent-source><a href="#source1">source</a></code>
attribute set to the <code><a href="#window">Window</a></code> object of
Expand All @@ -35419,10 +35419,10 @@ user reload must be equivalent to .reload()
readonly attribute DOMString <a href="#key" title=dom-StorageEvent-key>key</a>;
readonly attribute DOMString <a href="#oldvalue" title=dom-StorageEvent-oldValue>oldValue</a>;
readonly attribute DOMString <span title=dom-StorageEvent-newValue>newValue</span>;
readonly attribute DOMString <a href="#uri" title=dom-StorageEvent-uri>uri</a>;
readonly attribute DOMString <a href="#url1" title=dom-StorageEvent-url>url</a>;
readonly attribute <a href="#window">Window</a> <a href="#source1" title=dom-StorageEvent-source>source</a>;
void <a href="#initstorageevent" title=dom-StorageEvent-initStorageEvent>initStorageEvent</a>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString keyArg, in DOMString oldValueArg, in DOMString newValueArg, in DOMString uriArg, in Window sourceArg);
void <a href="#initstorageeventns" title=dom-StorageEvent-initStorageEventNS>initStorageEventNS</a>(in DOMString namespaceURI, in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString keyArg, in DOMString oldValueArg, in DOMString newValueArg, in DOMString uriArg, in Window sourceArg);
void <a href="#initstorageevent" title=dom-StorageEvent-initStorageEvent>initStorageEvent</a>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString keyArg, in DOMString oldValueArg, in DOMString newValueArg, in DOMString urlArg, in Window sourceArg);
void <a href="#initstorageeventns" title=dom-StorageEvent-initStorageEventNS>initStorageEventNS</a>(in DOMString namespaceURI, in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString keyArg, in DOMString oldValueArg, in DOMString newValueArg, in DOMString urlArg, in Window sourceArg);
};</pre>

<p>The <dfn id=initstorageevent
Expand All @@ -35444,7 +35444,7 @@ user reload must be equivalent to .reload()
title=dom-StorageEvent-vnewValue><code>newValue</code></dfn> attribute
represents the new value of the key being changed.

<p>The <dfn id=uri title=dom-StorageEvent-uri><code>uri</code></dfn>
<p>The <dfn id=url1 title=dom-StorageEvent-url><code>url</code></dfn>
attribute represents the address of the document that changed the key.

<p>The <dfn id=source1
Expand Down
40 changes: 20 additions & 20 deletions source
View file
Original file line number Diff line number Diff line change
Expand Up @@ -29534,8 +29534,8 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t

<pre class="idl">interface <dfn>ClientInformation</dfn> {
readonly attribute boolean <span title="dom-navigator-onLine">onLine</span>;
void <span title="dom-navigator-registerProtocolHandler">registerProtocolHandler</span>(in DOMString protocol, in DOMString uri, in DOMString title);
void <span title="dom-navigator-registerContentHandler">registerContentHandler</span>(in DOMString mimeType, in DOMString uri, in DOMString title);
void <span title="dom-navigator-registerProtocolHandler">registerProtocolHandler</span>(in DOMString protocol, in DOMString url, in DOMString title);
void <span title="dom-navigator-registerContentHandler">registerContentHandler</span>(in DOMString mimeType, in DOMString url, in DOMString title);
<!-- XXX there are other attributes! -->};</pre>
<!-- also, see window.external.AddSearchProvider() and similar DOM APIs from IE -->

Expand Down Expand Up @@ -29611,7 +29611,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t

<!-- XXXURL XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \(URI\|IRI\|URL\) -->

<dt><var title="">uri</var></dt>
<dt><var title="">url</var></dt>

<dd>

Expand Down Expand Up @@ -29686,7 +29686,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
an exception to be raised.</p>

<p>User agents must raise a <code>SYNTAX_ERR</code> exception if the
<var title="">uri</var> argument passed to one of these methods does
<var title="">url</var> argument passed to one of these methods does
not contain the exact literal string "<code>%s</code>".</p>

<p>User agents must not raise any other exceptions (other than
Expand All @@ -29695,7 +29695,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t

<p>This section does not define how the pages registered by these
methods are used, beyond the requirements on how to process the <var
title="">uri</var> value (see above). To some extent, the <span
title="">url</var> value (see above). To some extent, the <span
title="navigate">processing model for navigating across
documents</span> defines some cases where these methods are
relevant, but in general UAs may use this information wherever they
Expand Down Expand Up @@ -29833,7 +29833,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
title="dom-navigator-registerProtocolHandler">registerProtocolHandler()</code>
method as its first argument (<var title="">protocol</var>),
"http://kittens.example.org/?show=%s" was the second argument (<var
title="">uri</var>), and "Kittens-at-work displayer" was the third
title="">url</var>), and "Kittens-at-work displayer" was the third
argument (<var title="">title</var>).</p>

<p>If the user clicks the Cancel button, then nothing further
Expand Down Expand Up @@ -31112,8 +31112,8 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
// dynamic entries
readonly attribute unsigned long <span title="dom-appcache-length">length</span>;
DOMString <span title="dom-appcache-item">item</span>(in unsigned long index);
void <span title="dom-appcache-add">add</span>(in DOMString uri);
void <span title="dom-appcache-remove">remove</span>(in DOMString uri);
void <span title="dom-appcache-add">add</span>(in DOMString url);
void <span title="dom-appcache-remove">remove</span>(in DOMString url);

// events
attribute <span>EventListener</span> <span title="handler-appcache-onchecking">onchecking</span>;
Expand Down Expand Up @@ -31228,7 +31228,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
exception.</p>

<p>The <dfn title="dom-appcache-add"><code>add(<var
title="">uri</var>)</code></dfn> method must run the following
title="">url</var>)</code></dfn> method must run the following
steps:</p>

<ol>
Expand All @@ -31239,7 +31239,7 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
steps.</p></li>

<!-- XXXURL change to URL -->
<li><p>If <var title="">uri</var> is not a valid URI reference,
<li><p>If <var title="">url</var> is not a valid URI reference,
then raise a <code>SYNTAX_ERR</code> exception and abort these
steps. <a href="#refsRFC3986">[RFC3986]</a> <a
href="#refsRFC3987">[RFC3987]</a></p></li>
Expand All @@ -31251,21 +31251,21 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
<!-- XXXURL change to URL -->
<li><p>If there is already a resource in in the <span>application
cache</span> with which the <code>ApplicationCache</code> object is
associated that has the address <var title="">uri</var>, then
associated that has the address <var title="">url</var>, then
ensure that entry is categorized as a <span
title="concept-appcache-dynamic">dynamic entry</span> and return
and abort these steps.</p></li>

<!-- XXXURL change to URL -->
<li><p>If <var title="">uri</var> has a different &lt;scheme>
<li><p>If <var title="">url</var> has a different &lt;scheme>
component than the manifest's URI, then raise a <span>security
exception</span>.</p></li>

<li><p>Return, but do not abort these steps.</p></li>

<!-- XXXURL change to URL, maybe xref "fetch"? -->
<li><p>Fetch the resource referenced by <var
title="">uri</var>.</p></li>
title="">url</var>.</p></li>

<li><p>If this results 4xx or 5xx status codes or equivalent, or if
there were network errors, or if the user canceled the download,
Expand Down Expand Up @@ -31298,9 +31298,9 @@ JSURL: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t

<!-- XXXURL algorithms -->
<p>The <dfn title="dom-appcache-remove"><code>remove(<var
title="">uri</var>)</code></dfn> method must remove the <span
title="">url</var>)</code></dfn> method must remove the <span
title="concept-appcache-dynamic">dynamic entry</span> categorization
of any entry with the address <var title="">uri</var> in the
of any entry with the address <var title="">url</var> in the
<span>application cache</span> with which the
<code>ApplicationCache</code> object is associated. <span
class="big-issue">Resolve relative URIs... (ignore syntax
Expand Down Expand Up @@ -33101,7 +33101,7 @@ user reload must be equivalent to .reload()
null.</p>

<p>In addition, the event must have its <code
title="dom-StorageEvent-uri">uri</code> attribute set to the address
title="dom-StorageEvent-url">url</code> attribute set to the address
of the page whose <code>Storage</code> object was affected, and its
<code title="dom-StorageEvent-source">source</code> attribute set to
the <code>Window</code> object of the <span>browsing context</span>
Expand All @@ -33116,10 +33116,10 @@ user reload must be equivalent to .reload()
readonly attribute DOMString <span title="dom-StorageEvent-key">key</span>;
readonly attribute DOMString <span title="dom-StorageEvent-oldValue">oldValue</span>;
readonly attribute DOMString <span title="dom-StorageEvent-newValue">newValue</span>;
readonly attribute DOMString <span title="dom-StorageEvent-uri">uri</span>;
readonly attribute DOMString <span title="dom-StorageEvent-url">url</span>;
readonly attribute <span>Window</span> <span title="dom-StorageEvent-source">source</span>;
void <span title="dom-StorageEvent-initStorageEvent">initStorageEvent</span>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString keyArg, in DOMString oldValueArg, in DOMString newValueArg, in DOMString uriArg, in Window sourceArg);
void <span title="dom-StorageEvent-initStorageEventNS">initStorageEventNS</span>(in DOMString namespaceURI, in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString keyArg, in DOMString oldValueArg, in DOMString newValueArg, in DOMString uriArg, in Window sourceArg);
void <span title="dom-StorageEvent-initStorageEvent">initStorageEvent</span>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString keyArg, in DOMString oldValueArg, in DOMString newValueArg, in DOMString urlArg, in Window sourceArg);
void <span title="dom-StorageEvent-initStorageEventNS">initStorageEventNS</span>(in DOMString namespaceURI, in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString keyArg, in DOMString oldValueArg, in DOMString newValueArg, in DOMString urlArg, in Window sourceArg);
};</pre>

<p>The <dfn
Expand All @@ -33141,7 +33141,7 @@ user reload must be equivalent to .reload()
title="dom-StorageEvent-vnewValue"><code>newValue</code></dfn>
attribute represents the new value of the key being changed.</p>

<p>The <dfn title="dom-StorageEvent-uri"><code>uri</code></dfn>
<p>The <dfn title="dom-StorageEvent-url"><code>url</code></dfn>
attribute represents the address of the document that changed the
key.</p>

Expand Down

0 comments on commit 414645d

Please sign in to comment.