Skip to content

Commit

Permalink
Fix minor issues raised by jst and biesi in the content handler and s…
Browse files Browse the repository at this point in the history 
…torage sections

git-svn-id: http://svn.whatwg.org/webapps@25 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Apr 13, 2006
1 parent d068030 commit 8ca0bc6
Show file tree
Hide file tree
Showing 2 changed files with 91 additions and 57 deletions.
79 changes: 48 additions & 31 deletions index
View file
Expand Up @@ -11199,7 +11199,7 @@ interface <dfn id="datagriddataprovider">DataGridDataProvider</dfn> {
// helper objects
readonly attribute <span><a href="#history0">History</a></span> <span title="dom-history"><a href="#history">history</a></span>;
attribute <span><a href="#location1">Location</a></span> <span title="dom-location"><a href="#location">location</a></span>; /* <a href="#settingLocation">performs magic on setting</a> */
attribute <span><a href="#storage">Storage</a></span> <span title="dom-sessionStorage"><a href="#sessionstorage">sessionStorage</a></span>;
readonly attribute <span><a href="#storage">Storage</a></span> <span title="dom-sessionStorage"><a href="#sessionstorage">sessionStorage</a></span>;
readonly attribute <span><a href="#storagelist">StorageList</a></span> <span title="dom-globalStorage"><a href="#globalstorage">globalStorage</a></span>;
readonly attribute <span><a href="#clientinformation">ClientInformation</a></span> <span title="dom-navigator"><a href="#navigator">navigator</a></span>; <!-- XXX IE6 also has window.clientInformation pointing to this same object -->
readonly attribute <span><a href="#undomanager">UndoManager</a></span> <span title="dom-undoManager">undoManager</span>;
Expand Down Expand Up @@ -12401,7 +12401,7 @@ interface <dfn id="storageitem">StorageItem</dfn> {
href="#globalstorage">globalStorage</a></code> attribute</h4>

<pre class="idl">interface <dfn id="storagelist">StorageList</dfn> {
<span><a href="#storage">Storage</a></span> <span title="dom-storagelist-domain"><a href="#getdomain">getDomain</a></span>(in DOMString domain);
<span><a href="#storage">Storage</a></span> <span title="dom-storagelist-namedItem"><a href="#nameditem">namedItem</a></span>(in DOMString domain);
};</pre>

<p>The <dfn id="globalstorage"
Expand All @@ -12414,8 +12414,9 @@ interface <dfn id="storageitem">StorageItem</dfn> {
object (i.e. is neither a member of the <code><a
href="#storagelist">StorageList</a></code> interface nor of
<code>Object</code>) must invoke the <code
title="dom-storagelist-domain"><a href="#getdomain">getDomain()</a></code>
method with the property's name as the argument.
title="dom-storagelist-namedItem"><a
href="#nameditem">namedItem()</a></code> method with the property's name
as the argument.

<p>User agents must have a set of global storage areas, one for each
domain.
Expand All @@ -12427,8 +12428,8 @@ interface <dfn id="storageitem">StorageItem</dfn> {
potentially user-critical. It is expected that Web applications will use
the global storage areas for storing user-written documents.

<p>The <dfn id="getdomain"
title="dom-storagelist-domain"><code>getDomain(<var
<p>The <dfn id="nameditem"
title="dom-storagelist-namedItem"><code>namedItem(<var
title="">domain</var>)</code></dfn> method tries to returns a <code><a
href="#storage">Storage</a></code> object associated with the given
domain, according to the rules that follow.
Expand Down Expand Up @@ -12543,8 +12544,8 @@ interface <dfn id="storageitem">StorageItem</dfn> {
title="dom-sessionStorage"><a
href="#sessionstorage">globalStorage</a></code> attribute's <code><a
href="#storagelist">StorageList</a></code> object's <code
title="dom-storagelist-domain"><a
href="#getdomain">getDomain()</a></code> method would not raise a
title="dom-storagelist-namedItem"><a
href="#nameditem">namedItem()</a></code> method would not raise a
<span>security exception</span> according to the rules above if it was
invoked with the domain <var title="">d</var>.
</ul>
Expand Down Expand Up @@ -13045,24 +13046,38 @@ interface <dfn id="storageitem">StorageItem</dfn> {
<dd>
<p>The URI of the page that will handle the requests. When the user agent
uses this URI, it must replace the first occurrence of the exact literal
string "<code>%s</code>" with a URI-escaped version of the URI of the
content in question, and then fetch that URI using the GET method (or
equivalent for non-HTTP URIs).</p>

string "<code>%s</code>" with an escaped version of the URI of the
content in question (as defined below), and then fetch the resulting URI
using the GET method (or equivalent for non-HTTP URIs).</p>

<p>To get the escaped version of the URI, first, the domain part of the
URI (if any) must be converted to its punycode representation, and then,
every character in the URI that is not in the ranges given in the next
paragraph must be replaced by its UTF-8 byte representation, each byte
being represented by a U+0025 (%) character and two digits in the range
U+0030 (0) to U+0039 (9) and U+0041 (A) to U+0046 (F) giving the
hexadecimal representation of the byte.</p>

<p>The ranges of characters that must not be escaped are: U+002D (-),
U+002E (.), U+0030 (0) to U+0039 (9), U+0041 (A) to U+005A (Z), U+005F
(_), U+0061 (a) to U+007A (z), and U+007E (~).</p>
<!-- XXX move that to a common algorithms section if any other
part of the spec needs it -->

<div class="example">
<p>If the user had visited a site that made the following call:</p>

<pre>navigator.registerContentHandler('application/x-soup', 'http://example.com/soup?url=%s', 'SoupWeb&trade;')</pre>

<p>...and then clicked on a link such as:</p>

<pre>&lt;a href="http://www.example.net/chickenkiwi.soup">Download our Chicken Kiwi soup!&lt;/a></pre>
<pre>&lt;a href="http://www.example.net/chickenk&#xEF;wi.soup">Download our Chicken Kiwi soup!&lt;/a></pre>

<p>...then, assuming this <code>chickenkiwi.soup</code> file was served
with the MIME type <code>application/x-soup</code>, the UA might
instead navigate to the following URI:</p>

<pre>http://example.com/soup?url=http%3A%2F%2Fwww.example.net%2Fchickenkiwi.soup</pre>
<pre>http://example.com/soup?url=http%3A%2F%2Fwww.example.net%2Fchickenk%C3%AFwi.soup</pre>

<p>This site could then fetch the <code>chickenkiwi.soup</code> file and
do whatever it is that it does with soup (synthesise it and ship it to
Expand Down Expand Up @@ -23383,23 +23398,25 @@ http://lxr.mozilla.org/mozilla/source/parser/htmlparser/src/nsHTMLTokens.cpp#94

<p>Thanks to Aankhen, Aaron Leventhal, Anne van Kesteren, Asbj&oslash;rn
Ulsberg, Ben Godfrey, Ben Meadowcroft, Bjoern Hoehrmann, Boris Zbarsky,
Brad Fults, Brad Neuberg, Brendan Eich, Chriswa, Darin Fisher, David
Baron, David Hyatt, Derek Featherstone, Dimitri Glazkov, dolphinling,
Doron Rosenberg, Eira Monstad, Erik Arvidsson, fantasai, Franck 'Shift'
Qu&eacute;lain, Henri Sivonen, Henrik Lied, H&aring;kon Wium Lie, James
Graham, James Perrett, Jan-Klaas Kollhof, Jasper Bryant-Greene, Jens
Bannmann, Joel Spolsky, Johnny Stenback, Jon Perlow, Jukka K. Korpela, Kai
Hendry, Kornel Lesinski, Lachlan Hunt, Larry Page, Laurens Holst,
L&eacute;onard Bouchet, Maciej Stachowiak, Malcolm Rowe, Mark Nottingham,
Mark Schenk, Martijn Wargers, Martin Honnen, Matthew Mastracci, Matthew
Raymond, Matthew Thomas, Mattias Waldau, Max Romantschuk, Michael A.
Nachbaur, Michael Gratton, Michael 'Ratt' Iannarelli, Mihai
&#x015E;ucan<!-- from ROBO Design -->, Mike Shaver, Mikko Rantalainen,
Neil Deakin, Olav Junker Kj&aelig;r, Rimantas Liubertas, Robert
O'Callahan, Roman Ivanov, S. Mike Dierken, Shaun Inman, Simon Pieters,
Steven Garrity, Stuart Parmenter, Tantek &Ccedil;elik, Thomas O'Connor,
Tim Altman, Vladimir Vuki&#x0107;evi&#x0107;, and everyone on the WHATWG
mailing list for their useful and substantial comments.
Brad Fults, Brad Neuberg, Brendan Eich, Christian Biesinger, Chriswa,
Darin Fisher, David Baron, David Hyatt, Derek Featherstone, Dimitri
Glazkov, dolphinling, Doron Rosenberg, Eira Monstad, Erik Arvidsson,
fantasai, Franck 'Shift' Qu&eacute;lain, Henri Sivonen, Henrik Lied,
H&aring;kon Wium Lie, James Graham, James Perrett, Jan-Klaas Kollhof,
Jasper Bryant-Greene, Jens Bannmann, Joel Spolsky, Johnny Stenback, Jon
Perlow, Jukka K. Korpela, Kai Hendry, Kornel Lesinski, Lachlan Hunt, Larry
Page, Laurens Holst, L&eacute;onard Bouchet, Maciej Stachowiak, Malcolm
Rowe, Mark Nottingham, Mark Schenk, Martijn Wargers, Martin Honnen,
Matthew Mastracci, Matthew Raymond, Matthew Thomas, Mattias Waldau, Max
Romantschuk, Michael A. Nachbaur, Michael Gratton, Michael 'Ratt'
Iannarelli, Mihai &#x015E;ucan<!--
from ROBO Design -->, Mike Shaver,
Mikko Rantalainen, Neil Deakin, Olav Junker Kj&aelig;r, Rimantas
Liubertas, Robert O'Callahan, Roman Ivanov, S. Mike Dierken, Shaun Inman,
Simon Pieters, Steven Garrity, Stuart Parmenter, Tantek &Ccedil;elik,
Thomas O'Connor, Tim Altman, Vladimir Vuki&#x0107;evi&#x0107;, and
everyone on the WHATWG mailing list for their useful and substantial
comments.

<p>Special thanks to Richard Williamson for creating the first
implementation of <code><a href="#canvas">canvas</a></code> in Safari,
Expand Down
69 changes: 43 additions & 26 deletions source
View file
Expand Up @@ -9412,7 +9412,7 @@ interface <dfn>DataGridDataProvider</dfn> {
// helper objects
readonly attribute <span>History</span> <span title="dom-history">history</span>;
attribute <span>Location</span> <span title="dom-location">location</span>; /* <a href="#settingLocation">performs magic on setting</a> */
attribute <span>Storage</span> <span title="dom-sessionStorage">sessionStorage</span>;
readonly attribute <span>Storage</span> <span title="dom-sessionStorage">sessionStorage</span>;
readonly attribute <span>StorageList</span> <span title="dom-globalStorage">globalStorage</span>;
readonly attribute <span>ClientInformation</span> <span title="dom-navigator">navigator</span>; <!-- XXX IE6 also has window.clientInformation pointing to this same object -->
readonly attribute <span>UndoManager</span> <span title="dom-undoManager">undoManager</span>;
Expand Down Expand Up @@ -10543,7 +10543,7 @@ interface <dfn>StorageItem</dfn> {
<h4>The <code title="dom-globalStorage">globalStorage</code> attribute</h4>

<pre class="idl">interface <dfn>StorageList</dfn> {
<span>Storage</span> <span title="dom-storagelist-domain">getDomain</span>(in DOMString domain);
<span>Storage</span> <span title="dom-storagelist-namedItem">namedItem</span>(in DOMString domain);
};</pre>

<p>The <dfn
Expand All @@ -10554,7 +10554,7 @@ interface <dfn>StorageItem</dfn> {
support dereferencing such that getting a property that is not a
member of the object (i.e. is neither a member of the
<code>StorageList</code> interface nor of <code>Object</code>) must
invoke the <code title="dom-storagelist-domain">getDomain()</code>
invoke the <code title="dom-storagelist-namedItem">namedItem()</code>
method with the property's name as the argument.</p>

<p>User agents must have a set of global storage areas, one for each
Expand All @@ -10568,7 +10568,7 @@ interface <dfn>StorageItem</dfn> {
Web applications will use the global storage areas for storing
user-written documents.</p>

<p>The <dfn title="dom-storagelist-domain"><code>getDomain(<var
<p>The <dfn title="dom-storagelist-namedItem"><code>namedItem(<var
title="">domain</var>)</code></dfn> method tries to returns a
<code>Storage</code> object associated with the given domain,
according to the rules that follow.</p>
Expand Down Expand Up @@ -10691,7 +10691,7 @@ interface <dfn>StorageItem</dfn> {
<li>Its <code>Window</code> object's <code
title="dom-sessionStorage">globalStorage</code> attribute's
<code>StorageList</code> object's <code
title="dom-storagelist-domain">getDomain()</code> method would not
title="dom-storagelist-namedItem">namedItem()</code> method would not
raise a <span>security exception</span> according to the rules above if it was
invoked with the domain <var title="">d</var>.</li>

Expand Down Expand Up @@ -11219,9 +11219,26 @@ interface <dfn>StorageItem</dfn> {

<p>The URI of the page that will handle the requests. When the
user agent uses this URI, it must replace the first occurrence of
the exact literal string "<code>%s</code>" with a URI-escaped
version of the URI of the content in question, and then fetch that
URI using the GET method (or equivalent for non-HTTP URIs).</p>
the exact literal string "<code>%s</code>" with an escaped version
of the URI of the content in question (as defined below), and then
fetch the resulting URI using the GET method (or equivalent for
non-HTTP URIs).</p>

<p>To get the escaped version of the URI, first, the domain part
of the URI (if any) must be converted to its punycode
representation, and then, every character in the URI that is not
in the ranges given in the next paragraph must be replaced by its
UTF-8 byte representation, each byte being represented by a U+0025
(%) character and two digits in the range U+0030 (0) to U+0039 (9)
and U+0041 (A) to U+0046 (F) giving the hexadecimal representation
of the byte.</p>

<p>The ranges of characters that must not be escaped are: U+002D
(-), U+002E (.), U+0030 (0) to U+0039 (9), U+0041 (A) to U+005A
(Z), U+005F (_), U+0061 (a) to U+007A (z), and U+007E (~).</p>

<!-- XXX move that to a common algorithms section if any other
part of the spec needs it -->

<div class="example">

Expand All @@ -11231,13 +11248,13 @@ interface <dfn>StorageItem</dfn> {

<p>...and then clicked on a link such as:</p>

<pre>&lt;a href="http://www.example.net/chickenkiwi.soup">Download our Chicken Kiwi soup!&lt;/a></pre>
<pre>&lt;a href="http://www.example.net/chickenk&#xEF;wi.soup">Download our Chicken Kiwi soup!&lt;/a></pre>

<p>...then, assuming this <code>chickenkiwi.soup</code> file was
served with the MIME type <code>application/x-soup</code>, the UA
might instead navigate to the following URI:</p>

<pre>http://example.com/soup?url=http%3A%2F%2Fwww.example.net%2Fchickenkiwi.soup</pre>
<pre>http://example.com/soup?url=http%3A%2F%2Fwww.example.net%2Fchickenk%C3%AFwi.soup</pre>

<p>This site could then fetch the <code>chickenkiwi.soup</code>
file and do whatever it is that it does with soup (synthesise it
Expand Down Expand Up @@ -20369,22 +20386,22 @@ http://lxr.mozilla.org/mozilla/source/parser/htmlparser/src/nsHTMLTokens.cpp#94
<p>Thanks to Aankhen, Aaron Leventhal, Anne van Kesteren,
Asbj&oslash;rn Ulsberg, Ben Godfrey, Ben Meadowcroft, Bjoern
Hoehrmann, Boris Zbarsky, Brad Fults, Brad Neuberg, Brendan Eich,
Chriswa, Darin Fisher, David Baron, David Hyatt, Derek Featherstone,
Dimitri Glazkov, dolphinling, Doron Rosenberg, Eira Monstad, Erik
Arvidsson, fantasai, Franck 'Shift' Qu&eacute;lain, Henri Sivonen,
Henrik Lied, H&aring;kon Wium Lie, James Graham, James Perrett,
Jan-Klaas Kollhof, Jasper Bryant-Greene, Jens Bannmann, Joel
Spolsky, Johnny Stenback, Jon Perlow, Jukka K. Korpela, Kai Hendry,
Kornel Lesinski, Lachlan Hunt, Larry Page, Laurens Holst,
L&eacute;onard Bouchet, Maciej Stachowiak, Malcolm Rowe, Mark
Nottingham, Mark Schenk, Martijn Wargers, Martin Honnen, Matthew
Mastracci, Matthew Raymond, Matthew Thomas, Mattias Waldau, Max
Romantschuk, Michael A. Nachbaur, Michael Gratton, Michael 'Ratt'
Iannarelli, Mihai &#x015E;ucan<!-- from ROBO Design -->, Mike
Shaver, Mikko Rantalainen, Neil Deakin, Olav Junker Kj&aelig;r,
Rimantas Liubertas, Robert O'Callahan, Roman Ivanov, S. Mike
Dierken, Shaun Inman, Simon Pieters, Steven Garrity, Stuart
Parmenter, Tantek &Ccedil;elik, Thomas O'Connor, Tim Altman,
Christian Biesinger, Chriswa, Darin Fisher, David Baron, David
Hyatt, Derek Featherstone, Dimitri Glazkov, dolphinling, Doron
Rosenberg, Eira Monstad, Erik Arvidsson, fantasai, Franck 'Shift'
Qu&eacute;lain, Henri Sivonen, Henrik Lied, H&aring;kon Wium Lie,
James Graham, James Perrett, Jan-Klaas Kollhof, Jasper
Bryant-Greene, Jens Bannmann, Joel Spolsky, Johnny Stenback, Jon
Perlow, Jukka K. Korpela, Kai Hendry, Kornel Lesinski, Lachlan Hunt,
Larry Page, Laurens Holst, L&eacute;onard Bouchet, Maciej
Stachowiak, Malcolm Rowe, Mark Nottingham, Mark Schenk, Martijn
Wargers, Martin Honnen, Matthew Mastracci, Matthew Raymond, Matthew
Thomas, Mattias Waldau, Max Romantschuk, Michael A. Nachbaur,
Michael Gratton, Michael 'Ratt' Iannarelli, Mihai &#x015E;ucan<!--
from ROBO Design -->, Mike Shaver, Mikko Rantalainen, Neil Deakin,
Olav Junker Kj&aelig;r, Rimantas Liubertas, Robert O'Callahan, Roman
Ivanov, S. Mike Dierken, Shaun Inman, Simon Pieters, Steven Garrity,
Stuart Parmenter, Tantek &Ccedil;elik, Thomas O'Connor, Tim Altman,
Vladimir Vuki&#x0107;evi&#x0107;, and everyone on the WHATWG mailing
list for their useful and substantial comments.</p>

Expand Down

0 comments on commit 8ca0bc6

Please sign in to comment.