W3C home > Mailing lists > Public > public-html-commits@w3.org > July 2008

html5/spec Overview.html,1.1156,1.1157

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 30 Jul 2008 22:27:43 +0000
To: public-html-commits@w3.org
Message-Id: <E1KOK91-0007Cr-RW@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv27650

Modified Files:
	Overview.html 
Log Message:
Make <a> elements not define paragraphs, allowing them to straddle paragraphs. (whatwg r1965)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1156
retrieving revision 1.1157
diff -u -d -r1.1156 -r1.1157
--- Overview.html	30 Jul 2008 22:15:09 -0000	1.1156
+++ Overview.html	30 Jul 2008 22:27:38 -0000	1.1157
@@ -8440,11 +8440,15 @@
 
   <p>Paragraphs in <a href="#flow-content0">flow content</a> are defined
    relative to what the document looks like without the <code><a
-   href="#ins">ins</a></code> and <code><a href="#del">del</a></code>
-   elements complicating matters. Let <var title="">view</var> be a view of
-   the DOM that replaces all <code><a href="#ins">ins</a></code> and <code><a
-   href="#del">del</a></code> elements in the document with their contents.
-   Then, in <var title="">view</var>, for each run of <a
+   href="#a">a</a></code>, <code><a href="#ins">ins</a></code> and <code><a
+   href="#del">del</a></code> elements complicating matters, since those
+   elements, with their hybrid content models, can straddle paragraph
+   boundaries.
+
+  <p>Let <var title="">view</var> be a view of the DOM that replaces all
+   <code><a href="#a">a</a></code>, <code><a href="#ins">ins</a></code> and
+   <code><a href="#del">del</a></code> elements in the document with their
+   contents. Then, in <var title="">view</var>, for each run of <a
    href="#phrasing0">phrasing content</a> uninterrupted by other types of
    content, in an element that accepts content other than <a
    href="#phrasing0">phrasing content</a>, let <var title="">first</var> be
@@ -8452,11 +8456,11 @@
    node of the run. For each run, a paragraph exists in the original DOM from
    immediately before <var title="">first</var> to immediately after <var
    title="">last</var>. (Paragraphs can thus span across <code><a
-   href="#ins">ins</a></code> and <code><a href="#del">del</a></code>
-   elements.)
+   href="#a">a</a></code>, <code><a href="#ins">ins</a></code> and <code><a
+   href="#del">del</a></code> elements.)
 
-  <p>A <a href="#paragraph">paragraph</a> is also formed by <code><a
-   href="#p">p</a></code> elements.
+  <p>A <a href="#paragraph">paragraph</a> is also formed explicitly by
+   <code><a href="#p">p</a></code> elements.
 
   <p class=note>The <code><a href="#p">p</a></code> element can be used to
    wrap individual paragraphs when there would otherwise not be any content
@@ -8491,6 +8495,36 @@
 &lt;/section></pre>
   </div>
 
+  <div class=example>
+   <p>In the following example, the link spans half of the first paragraph,
+    all of the header separating the two paragraphs, and half of the second
+    paragraph.</p>
+
+   <pre>&lt;aside>
+ Welcome!
+ &lt;a href="about.html">
+  This is home of...
+  &lt;h1>The Falcons!&lt;/h1>
+  The Lockheed Martin multirole jet fighter aircraft!
+ &lt;/a>
+ This page discusses the F-16 Fighting Falcon's innermost secrets.
+&lt;/aside></pre>
+
+   <p>Here is another way of marking this up, this time showing the
+    paragraphs explicitly, and splitting the one link element into three:</p>
+
+   <pre>&lt;aside>
+ &lt;p>Welcome! &lt;a href="about.html">This is home of...&lt;/a>&lt;/p>
+ &lt;h1>&lt;a href="about.html">The Falcons!&lt;/a>&lt;/h1>
+ &lt;p>&lt;a href="about.html">The Lockheed Martin multirole jet
+ fighter aircraft!&lt;/a> This page discusses the F-16 Fighting
+ Falcon's innermost secrets.&lt;/p>
+&lt;/aside></pre>
+  </div>
+
+  <p class=note>Generally, having elements straddle paragraph boundaries is
+   best avoided. Maintaining such markup can be difficult.
+
   <h3 id=apis-in><span class=secno>3.6 </span>APIs in HTML documents</h3>
 
   <p>For <a href="#html-">HTML documents</a>, and for <a
Received on Wednesday, 30 July 2008 22:28:20 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:32:58 GMT