W3C home > Mailing lists > Public > public-html-commits@w3.org > June 2009

html5/spec Overview.html,1.2448,1.2449

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 17 Jun 2009 07:12:15 +0000
To: public-html-commits@w3.org
Message-Id: <E1MGpJf-0002wI-MN@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv11277

Modified Files:
	Overview.html 
Log Message:
more cleanup (whatwg r3303)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2448
retrieving revision 1.2449
diff -u -d -r1.2448 -r1.2449
--- Overview.html	17 Jun 2009 07:01:59 -0000	1.2448
+++ Overview.html	17 Jun 2009 07:12:12 -0000	1.2449
@@ -44413,7 +44413,7 @@
      display of some sort of user interface indicating to the user
      that a file is being downloaded in preparation for updating the
      application.</li> <!-- XXX need to include progress
-     information -->
+     information once progress spec is stable -->
 
      <li>
 
@@ -45510,30 +45510,33 @@
   address">the current address</a> of the associated
   <code>Document</code> object, as an <a href="#absolute-url">absolute URL</a>.</p>
 
-  <p>On setting, <!--XXX Mozilla does this, but IE doesn't. What
-  should we do?: the behavior depends on the context in which the
-  script that set the attribute is running. If the script ran as the
-  direct result of the execution of a <code>script</code> element in
-  the document represented by the <code>Location</code> object's
-  associated <code>Document</code> object, then the user agent must
-  act as if the <code title="dom-location-replace">replace()</code>
-  method had been called with the new value as its
-  argument. Otherwise,--> the user agent must act as if the <code title="dom-location-assign"><a href="#dom-location-assign">assign()</a></code> method had been called
-  with the new value as its argument.</p><!-- XXX may wish to allow
-  replace instead as a UI improvement --> <!-- XXX if we decide to
-  make .href setters just be the same as calling assign(), then change
-  the magic location setter above simply refer straight to assign() as
-  well, so we don't have two levels of indirection -->
+  <p>On setting, <!-- READ ME WHEN EDITING THIS: Mozilla does this,
+  but IE doesn't. What should we do?: the behavior depends on the
+  context in which the script that set the attribute is running. If
+  the script ran as the direct result of the execution of a
+  <code>script</code> element in the document represented by the
+  <code>Location</code> object's associated <code>Document</code>
+  object, then the user agent must act as if the <code
+  title="dom-location-replace">replace()</code> method had been called
+  with the new value as its argument. Otherwise,--> the user agent
+  must act as if the <code title="dom-location-assign"><a href="#dom-location-assign">assign()</a></code>
+  method had been called with the new value as its argument.</p><!--
+  v2: may wish to allow replace instead as a UI improvement -->
+
+  <!-- we could change the magic .location setter to simply refer
+  straight to assign(), so we don't have two levels of indirection -->
 
   <p>When the <dfn id="dom-location-assign" title="dom-location-assign"><code>assign(<var title="">url</var>)</code></dfn> method is invoked, the UA must
   <a href="#resolve-a-url" title="resolve a url">resolve</a> the argument, relative to
   the <a href="#first-script">first script</a>'s <a href="#script-s-base-url" title="script's base URL">base
   URL</a>, and if that is successful, must <a href="#navigate">navigate</a>
-  the <a href="#browsing-context">browsing context</a> to the specified <var title="">url</var>.</p> <!-- XXX browsers seem to treat this as
-  having <span>replacement enabled</span> if the browsing context has
-  only one entry and that entry is about:blank. IE and Firefox only
-  seem to treat it that way if the DOM is still a virgin DOM; Safari
-  doesn't check that. -->
+  the <a href="#browsing-context">browsing context</a> to the specified <var title="">url</var>.</p> <!-- READ ME WHEN EDITING THIS: browsers
+  seem to treat this as having <span>replacement enabled</span> if the
+  browsing context has only one entry and that entry is
+  about:blank. IE and Firefox only seem to treat it that way if the
+  DOM is still a virgin DOM; Safari doesn't check that. Thus this
+  might need changing if testing shows their behaviour is required
+  here. -->
 
   <p>When the <dfn id="dom-location-replace" title="dom-location-replace"><code>replace(<var title="">url</var>)</code></dfn> method is invoked, the UA must
   <a href="#resolve-a-url" title="resolve a url">resolve</a> the argument, relative to
@@ -46093,10 +46096,7 @@
   <p class="note">Because the processing of the <code title="attr-html-manifest"><a href="#attr-html-manifest">manifest</a></code> attribute happens
   only once the root element is parsed, any URLs referenced by
   processing instructions before the root element (such as <code title="">&lt;?xml-stylesheet?&gt;</code> and <code title="">&lt;?xbl?&gt;</code> PIs) will be fetched from the network and
-  cannot be cached.</p> <!-- XXX any ideas for avoiding this, that
-  aren't a PI themselves? We can't delay the processing, since the
-  whole point of the <?xbl?> PI is to have the XBL sheet loaded before
-  the root element... -->
+  cannot be cached.</p><!-- v2: fix this somehow -->
 
   <p>User agents may examine the namespace of the root
   <code>Element</code> node of this <code>Document</code> object to
@@ -46738,10 +46738,8 @@
     bandwidth so that the target page loads faster.</li>
 
    </ul><p>Thus, while it is possible to track users without this feature,
-   authors are encouraged to use the <code title="attr-hyperlink-ping"><a href="#ping">ping</a></code> attribute so that the user agent
-   can improve <!-- XXX optimize? --> the user experience.</p> <!--
-   XXX need a better way to end that sentence. It's what I mean, but
-   it sounds kooky. -->
+   authors are encouraged to use the <code title="attr-hyperlink-ping"><a href="#ping">ping</a></code> attribute so that the user
+   agent can make the user experience more transparent.</p>
 
   </div><!-- resolving ping urls happens at audit time, so base URL changes
   affect the values of ping attributes --><h4 id="linkTypes"><span class="secno">6.12.3 </span>Link types</h4><p>The following table summarizes the link types that are defined by
@@ -46872,37 +46870,11 @@
   specified by user agents, but<!--</span>--> must not be used in
   documents.</p>
 
-  </div><!--XXX
-
-  issues for rel="", etc:
-   rel="alternate stylesheet"
-   rel="script"
-   rel="related" // see also
-   which relationship combinations are allowed
-   what multiple values might mean (multiple <a rel="top"> in the same document)
-   http://www.euronet.nl/~tekelenb/WWW/LINK/
-   http://shift.freezope.org/konq_rellinks/development_html
-   http://hixie.ch/specs/html/link/001
-   http://hixie.ch/specs/html/link/002
-   http://www.hixie.ch/specs/html/metadata
-   what UAs are supposed to do with this
-   do something about http://microformats.org/wiki/rel-enclosure
-
-mpt says:
-> "As with <a> elements, when <link> elements that use these relationships
-> are present, UAs should render them. As with <a> elements, when <link>
-> elements that use these relationships do not exist, UAs should not
-> render them. UAs should not make <link> rendering any easier to hide
-> than <a> rendering."
-
-for microformats (e.g. to refer to an hcard from an hcalendar):
-rel=xref
-<a> and <area> only
-The href attribute's value must start with a '#' character.
-Indicates an in-page cross-reference. For the purposes of data mining tools, the subtree rooted
-at the first element with the given ID must be treated as if it was cloned and replaced the <a> element.
-
-    --><h5 id="link-type-alternate"><span class="secno">6.12.3.1 </span>Link type "<dfn title="rel-alternate"><code>alternate</code></dfn>"</h5><p>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword may be
+  </div><!-- v2 ideas:
+   * rel="script"
+   * rel="related" // see also
+   * http://microformats.org/wiki/rel-enclosure
+  --><h5 id="link-type-alternate"><span class="secno">6.12.3.1 </span>Link type "<dfn title="rel-alternate"><code>alternate</code></dfn>"</h5><p>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword may be
   used with <code><a href="#the-link-element">link</a></code>, <code><a href="#the-a-element">a</a></code>, and <code><a href="#the-area-element">area</a></code>
   elements. For <code><a href="#the-link-element">link</a></code> elements, if the <code title="attr-link-rel"><a href="#attr-link-rel">rel</a></code> attribute does not also contain the
   keyword <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code>, it creates a
@@ -47257,9 +47229,7 @@
   the referenced document provides an interface specifically for
   searching the document and its related resources.<p class="note">OpenSearch description documents can be used with
   <code><a href="#the-link-element">link</a></code> elements and the <code title="rel-search"><a href="#link-type-search">search</a></code> link type to enable user agents to
-  autodiscover search interfaces. <a href="#references">[OPENSEARCH]</a></p><!-- XXX
-  http://www.opensearch.org/Specifications/OpenSearch/1.1#Autodiscovery_in_HTML.2FXHTML
-  --><h5 id="link-type-stylesheet"><span class="secno">6.12.3.15 </span>Link type "<dfn title="rel-stylesheet"><code>stylesheet</code></dfn>"</h5><p>The <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code> keyword may be
+  autodiscover search interfaces. <a href="#references">[OPENSEARCH]</a><h5 id="link-type-stylesheet"><span class="secno">6.12.3.15 </span>Link type "<dfn title="rel-stylesheet"><code>stylesheet</code></dfn>"</h5><p>The <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code> keyword may be
   used with <code><a href="#the-link-element">link</a></code> elements, for which it creates an <a href="#external-resource-link" title="external resource link">external resource link</a> that
   contributes to the <a href="#styling">styling processing model</a>.<p>The specified resource is a resource that describes how to
   present the document. Exactly how the resource is to be processed
@@ -47594,7 +47564,7 @@
    <li><p>Set the <var title="">click in progress</var> flag on the
    element to false.</li>
 
-  </ol></div><h3 id="scrolling-elements-into-view"><span class="secno">7.4 </span>Scrolling elements into view</h3><dl class="domintro"><dt><var title="">element</var> . <code title="dom-scrollIntoView"><a href="#dom-scrollintoview">scrollIntoView</a></code>( [ <var title="">top</var> ] )</dt>
+  </ol></div><h3 id="scrolling-elements-into-view"><span class="secno">7.4 </span>Scrolling elements into view</h3><!-- maybe this should move to [CSSOM] --><dl class="domintro"><dt><var title="">element</var> . <code title="dom-scrollIntoView"><a href="#dom-scrollintoview">scrollIntoView</a></code>( [ <var title="">top</var> ] )</dt>
 
    <dd>
 
@@ -47631,8 +47601,6 @@
   <p>Non-visual user agents may ignore the argument, or may treat it
   in some media-specific manner most useful to the user.</p>
 
-  <!-- XXX maybe this should move to CSSOM -->
-
   </div><h3 id="focus"><span class="secno">7.5 </span>Focus</h3><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%20%0A...%3Cform%3E%3Cinput%20name%3Da%20onfocus%3D%22value%2B%3D1%3Bd.name%3D%27a%27%3Bname%3D%27d%27%3Bb.focus()%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22value%2B%3D1%3Bc.focus()%22%3E%0A%3Cinput%20name%3Dc%20onfocus%3D%22value%2B%3D1%3Bd.focus()%22%3E%0A%3Cinput%20name%3Dd%20onfocus%3D%22value%2B%3D1%3Ba.focus()%22%3E --><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%0A...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onfocus%3D%22t.value%2B%3D%27af1%20%27%3Bb.focus()%3Balert(document.activeElement.name)%3Bt.value%2B%3D%27af2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27ab%20%27%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D%27bf1%20%27%3Bc.focus()%3Bt.value%2B%3D%27bf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27bb%20%27%3B%22%3E%0A%3Cinput%20name%3Dc%20onfocus%3D%22t.value%2B%3D%27cf1%20%27%3Bc.focus()%3Bt.value%2B%3D%27cf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27cb%20%27%3B%22%3E%0A --><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%3Cbody%20onload%3D%22document.forms%5B0%5D.a.focus()%22%3E%0A...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onblur%3D%22t.value%2B%3D'ab%20'%3B%20b.focus()%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D'bf1%20'%3Ba.focus()%3Bt.value%2B%3D'bf2%20'%3B%22%20onblur%3D%22t.value%2B%3D'bb%20'%3B%22%3E --><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%3Cbody%3E...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onfocus%3D%22t.value%2B%3D%27af%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27ab1%20%27%3Bb.focus()%3Bt.value%2B%3D%27ab2%20%27%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D%27bf1%20%27%3Ba.focus()%3Bt.value%2B%3D%27bf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27bb%20%27%3B%22%3E --><!-- XXX
    - define onfocus/onblur behaviour for Window
    - Other things to look at are IE's focus APIs (HTMLElement.setActive(),
@@ -63809,6 +63777,7 @@
   [IANACHARSET] http://www.iana.org/assignments/character-sets
   [ISO885911] http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=28263
   [MIMESNIFF] http://tools.ietf.org/html/draft-abarth-mime-sniff
+  [OPENSEARCH] http://www.opensearch.org/Specifications/OpenSearch/1.1#Autodiscovery_in_HTML.2FXHTML
   [RFC1345] Simonsen, K., "Character Mnemonics & Character Sets", RFC 1345, Rationel Almen Planlaegning, Rationel Almen Planlaegning, June 1992.
   [SCSU] http://www.unicode.org/unicode/reports/tr6/
   [SELECTORS]
Received on Wednesday, 17 June 2009 07:12:22 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 17 June 2009 07:12:23 GMT