svg2: Tweaks for comments from Dirk, and References section changes.

details:   https://svgwg.org/hg/svg2/rev/79bd8f8bd9cb
branches:  
changeset: 657:79bd8f8bd9cb
user:      Cameron McCormack <cam@mcc.id.au>
date:      Fri Apr 11 02:01:34 2014 +1000
description:
Tweaks for comments from Dirk, and References section changes.

diffstat:

 specs/integration/master/Overview.html |  56 +++++++++++++++++++--------------
 1 files changed, 32 insertions(+), 24 deletions(-)

diffs (249 lines):

diff --git a/specs/integration/master/Overview.html b/specs/integration/master/Overview.html
--- a/specs/integration/master/Overview.html
+++ b/specs/integration/master/Overview.html
@@ -6,29 +6,29 @@
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
   <link rel="stylesheet" title="Default" type="text/css" href="style/default_svg.css"/>
   <link rel="alternate stylesheet" title="No issues/annotations" type="text/css" href="style/default_no_issues.css"/>
   <style>
     .feature {
         text-align: right;
     }
     .embedcontext, table.ref_modes td {
-        width: 150px;
-        height: 150px;
+        width: 120px;
+        height: 120px;
     }
     table.ref_modes td {
         border: gainsboro 1px solid;
     }
     th, td {
         text-align: center;
     }
     .bg {
         background-image: url(./smiley.svg);
-        width: 150px;
-        height: 150px;
+        width: 120px;
+        height: 120px;
     }
     table.features {
         border: gray 1px solid;
         margin-top: 1em;
     }
     table.features th, table.features td {
         text-align: left;
         background-color: gainsboro !important;
@@ -238,20 +238,21 @@ scripting disabled.</p>
 
 <p>The primary purpose of this document, SVG Integration, is to define a number
 of <em>referencing modes</em> for SVG documents, which detail the requirements
 for processing an SVG document when it is used in a certain context.
 These requirements include the set of features that must be disabled,
 any user agent style sheet rules to apply, and more.</p>
 
 <p>Normative requirements are given for contexts in other SVG documents,
-such as how an SVG <a>'image'</a> element must treat a referenced SVG
+such as how an SVG <a>'image'</a> element must treat referenced SVG
 documents.  Non-normative recommendations are given for other languages,
 including HTML and CSS, with the expectation that these other specifications
-will normatively reference the referencing mode definitions in this document.</p>
+will in time define which referencing mode from this document to use
+when SVG documents are used in a given context.</p>
 
 <div class="issue">
   <p>There are other things we may wish to include in this document, including:</p>
   <ul>
     <li>Recommendations for how SVG can be used and responsibly extended in other,
       non-Web markup languages.</li>
     <li>Recommendations for how to embed data in SVG documents, and how
       to use foreign namespace elements and attributes in SVG documents
@@ -280,56 +281,64 @@ will normatively reference the referenci
 <p>There are various ways that an SVG document fragment can be
 referenced by or included in other documents and then as a consequence
 be processed by a user agent.  SVG documents can also be viewed as a
 top-level document.  Each different method by which an SVG document fragment
 can be used implies a certain set of requirements on how the SVG document
 fragment is to be processed.</p>
 
 <p>This section defines a number of <dfn id="referencing-mode">referencing
-modes</dfn> that encompass the different ways SVG document fragments can
-be used on the Web platform and which specify how the SVG document fragments must be
-processed.  Each referencing mode is defined by requiring the SVG document fragment
+modes</dfn> that encompass the different ways SVG documents can
+be used on the Web platform and which specify how the documents must be
+processed.  Each referencing mode is defined by requiring the SVG document
 be processed in a given <a href="#processing-mode">processing mode</a>.
 Processing modes are introduced in <a href="#processing-modes">section 3</a> below
 and define which features are enabled or disabled in the document.</p>
 
 <p class="note">This document does not place normative requirements on
 other specifications that can reference or include SVG documents, such as
 HTML and various CSS specifications.  The intention is for these other
 specifications to normatively point to the appropriate referencing mode
 from this document.</p>
 
+<p class="issue">In this document we might need to define exactly how
+to invoke the Fetch algorithm when resources are retrieved from a document
+running in a particular referencing mode.</p>
+
 <p>The available <a href="#referencing-mode">referencing modes</a> are as follows:</p>
 
 <dl>
   <dt><dfn id="top-level-document-mode">top-level document</dfn></dt>
   <dd>
     <p>This referencing mode is for SVG documents that are loaded as a top-level
     document in a user agent.</p>
     <p>SVG documents processed with the
     <a href="#top-level-document-mode">top-level document</a>
     <a href="#referencing-mode">referencing mode</a> must use the
     <a href="#dynamic-interactive-mode">dynamic interactive</a>
     <a href="#processing-mode">processing mode</a>.</p>
 
     <p class="note">This referencing mode is intended to be used when
     an SVG document is loaded in a browser's
-    <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#top-level-browsing-context">top-level browsing context</a>.</p>
+    <a href="http://www.w3.org/TR/2014/CR-html5-20140204/browsers.html#top-level-browsing-context">top-level browsing context</a>.
+    <a href='#ref-HTML5'>[HTML5]</a></p>
   </dd>
 
   <dt><dfn id="embedded-document-mode">embedded document</dfn></dt>
   <dd>
     <p>This referencing mode is for SVG documents that are externally referenced
     and embedded for presentation in a host document.  SVG documents referenced by the
     <a>'iframe'</a> element from SVG 2 or the
     <a>'animation'</a> element from SVG Tiny 1.2 must use the
     <a href="#embedded-document">embedded document</a>
     <a href="#referencing-mode">referencing mode</a>.</p>
 
+    <p class="note">Note that the embedded document referencing mode
+    is not used for inline SVG fragments within an HTML document.</p>
+
     <p>SVG documents processed with the
     <a href="#embedded-document-mode">embedded document</a>
     <a href="#referencing-mode">referencing mode</a> must use the
     <a href="#dynamic-interactive-mode">dynamic interactive</a>
     <a href="#processing-mode">processing mode</a>.</p>
 
     <p class="note">This referencing mode is intended to be used when
     an SVG document is loaded in an HTML
@@ -739,21 +748,16 @@ traversal, and clicking on the face test
 and script execution. The link should replace the image with a blue
 square (clicking on that will return you to the original image). The
 declarative interactivity, which uses the <a>'set'</a> element, should change
 the image from shades of yellow to shades of green. The script should fill
 in the smile.  Time-based (as opposed to interactivity-based) declarative
 animation is supported if the left eye is winking.</p>
 
 <table class="ref_modes" border="0" cellpadding="2" cellspacing="2">
-  <thead>
-    <tr>
-      <th colspan="5">Example 1: Different <a>referencing modes</a> in HTML</th>
-    </tr>
-  </thead>
   <tbody>
     <tr>
       <th>object</th>
       <th>iframe</th>
       <th>embed</th>
       <th>img</th>
       <th>CSS background</th>
     </tr>
@@ -765,17 +769,17 @@ animation is supported if the left eye i
         <iframe class="embedcontext" src="smiley.svg" frameborder="0">Please use FF1.5+, Opera 9+, WebKit/Safari3.0, or IE with an SVG plugin!</iframe>
       </td>
       <td>
         <embed class="embedcontext" src="smiley.svg" type="image/svg+xml"></embed>
       </td>
       <td>
         <img class="embedcontext" alt="smiley face" src="smiley.svg" />
       </td>
-      <td class="bg">&#xA0;</td>
+      <td><div class="bg">&#xA0;</div></td>
     </tr>
   </tbody>
 </table>
 </div>
 
 <h2 id="foreign-content">Embedding foreign content in SVG</h2>
 
 <p>The SVG <a>'foreignObject'</a> element is an extension point that
@@ -1191,17 +1195,17 @@ local cached copy, as you prefer).</p>
 <p>The RNG is under construction, and only the individual RNG snippets are
 available at this time. They have not yet been integrated into a functional
 schema. The individual RNG files are available <a href="rng">here</a>.</p>
 
 -->
 
 <h2 id="refs">References</h2>
 
-<h3 id="normrefs">Normative References</h3>
+<h3 id="normrefs">Normative references</h3>
 
 <dl>
   <dt id="ref-RFC2119"><strong class="normref">[RFC2119]</strong></dt>
   <dd><cite><a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a></cite>,
   S. Bradner, March 1997.
   <br />Available at http://tools.ietf.org/html/rfc2119.</dd>
 
   <dt id="ref-SVG11"><strong class="normref">[SVG11]</strong></dt>
@@ -1221,47 +1225,51 @@ schema. The individual RNG files are ava
   <dt id="ref-SVG2"><strong class="normref">[SVG2]</strong></dt>
   <dd><cite class="w3cwd"><a href="http://www.w3.org/TR/2014/WD-SVG2-20140211/">Scalable Vector Graphics (SVG) 2</a></cite>,
   N. Anrdronikos, T. Bah, B. Birtles, C. Concolato, E. Dahlström, C. Lilley, C. McCormack, D. Schepers, D. Schulze, R. Schwerdtfeger, S. Takagi, J. Watt, eds.
   World Wide Web Consortium, 11 February 2014.
   <br />This edition of SVG 2 is http://www.w3.org/TR/2014/WD-SVG2-20140211/.
   <br />The <a href="http://www.w3.org/TR/SVG2/">latest edition of SVG 2</a> is available at http://www.w3.org/TR/SVG2/.</dd>
 </dl>
 
-<h3 id="informrefs">Informative References</h3>
+<h3 id="nonnormrefs">Non-normative references</h3>
 
 <dl>
+<!--
   <dt class="w3ccr"><strong class="informref">[CSS2]</strong></dt>
   <dd><cite><a href="http://www.w3.org/TR/2010/CR-CSS2-20090908/">Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification</a></cite>,
   B. Bos, T. &#xC7;elik, I. Hickson, H.W. Lie, Editors. World Wide Web Consortium, 23 April 2009, <strong>Work in Progress</strong>.
   <br/>This version of the CSS 2.1 Specification is http://www.w3.org/TR/2009/CR-CSS2-20090908/.
   <br/>The <a class="normative" href="http://www.w3.org/TR/CSS2/">latest version of CSS 2.1</a> is available at http://www.w3.org/TR/CSS2/.</dd>
+-->
 
-  <dt id="references-HTML5"><strong class="informref">[HTML5]</strong></dt>
-  <dd><cite class="w3cwd"><a href="http://www.w3.org/TR/2009/WD-html5-20090825/">HTML 5</a></cite>,
-  I. Hickson, D. Hyatt, eds.
-  World Wide Web Consortium, <span class="wip">work in progress</span>, 25 August 2009.
-  <br />This edition of HTML 5 is http://www.w3.org/TR/2009/WD-html5-20090825/.
-  <br />The <a href="http://www.w3.org/TR/html5/">latest edition of HTML 5</a> is available at
+  <dt id="ref-HTML5"><strong class="informref">[HTML5]</strong></dt>
+  <dd><cite class="w3ccr"><a href="http://www.w3.org/TR/2014/CR-html5-20140204/">HTML5</a></cite>,
+  R. Berjon, S. Faulkner, T. Leithead, E. D. Navara, E. O'Connor, S. Pfeiffer, I. Hickson.
+  World Wide Web Consortium, <span class="wip">work in progress</span>, 04 February 2014.
+  <br />This edition of HTML5 is //www.w3.org/TR/2014/CR-html5-20140204/.
+  <br />The <a href="http://www.w3.org/TR/html5/">latest edition of HTML5</a> is available at
   http://www.w3.org/TR/html5/.</dd>
 
+<!--
   <dt id="ref-NVDL"><strong class="informref">[NVDL]</strong></dt>
   <dd><cite><a href="http://www.jtc1sc34.org/repository/0694.pdf">Information Technology &#x2014; Document Schema Definition Languages (DSDL) &#x2014; Part 4: Namespace-based Validation Dispatching Language</a></cite>: ISO/IEC FDIS 19757-4:2005(E),
   International Organization for Standardization, December 2005.
   <br />Available at http://www.jtc1sc34.org/repository/0694.pdf.</dd>
 
   <dt id="ref-SCHEMA2"><strong class="informref">[SCHEMA2]</strong></dt>
   <dd><cite class="w3crec"><a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/">XML Schema Part 2: Datatypes Second Edition</a></cite>.
   P. Biron, A. Malhotra, eds.
   World Wide Web Consortium, 28 October 2004.
   (See also <a href="http://www.w3.org/TR/2005/NOTE-xml11schema10-20050511/"><cite>Processing XML 1.1 documents with XML Schema 1.0 processors</cite></a>
   [<a href="#ref-XML11-SCHEMA">XML11-SCHEMA</a>].)
   <br />This edition of XML Schema Part 2 is http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/.
   <br />The <a href="http://www.w3.org/TR/xmlschema-2/">latest edition of XML Schema Part 2</a> is available at
   http://www.w3.org/TR/xmlschema-2/.</dd>
+-->
 </dl>
 
 <h2 id="Acknowledgments">Acknowledgments</h2>
 
 <p>The editors would like to acknowledge and thank the following
 people for substantive aid with this specification:
 Erik Dahlstr&#xF6;m.</p>

Received on Thursday, 10 April 2014 16:02:30 UTC