[t] (0) Let tools decide how to render <hgroup>s in ToCs and so on.

Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=14707 Affected topics: HTML git-svn-id: http://svn.whatwg.org/webapps@7234 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Aug 9, 2012 · ca5fe40 · ca5fe40
1 parent 928853c
commit ca5fe40
Show file tree

Hide file tree

Showing 3 changed files with 84 additions and 66 deletions.
diff --git a/complete.html b/complete.html
@@ -18460,15 +18460,6 @@ <h4 id=the-hgroup-element><span class=secno>4.4.7 </span>The <dfn><code>hgroup</
   multiple levels, such as subheadings, alternative titles, or
   taglines.</p>
 
-  <p>For the purposes of document summaries, outlines, and the like,
-  the text of <code><a href=#the-hgroup-element>hgroup</a></code> elements is defined to be the text
-  of the highest <a href=#rank title=rank>ranked</a>
-  <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>&ndash;<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> element descendant of the
-  <code><a href=#the-hgroup-element>hgroup</a></code> element, if there are any such elements, and the
-  first such element if there are multiple elements with that
-  <a href=#rank>rank</a>. If there are no such elements, then the text of
-  the <code><a href=#the-hgroup-element>hgroup</a></code> element is the empty string.</p>
-
   <p>Other elements of <a href=#heading-content>heading content</a> in the
   <code><a href=#the-hgroup-element>hgroup</a></code> element indicate subheadings or subtitles.</p>
 
@@ -18484,26 +18475,41 @@ <h4 id=the-hgroup-element><span class=secno>4.4.7 </span>The <dfn><code>hgroup</
 
   <div class=example>
 
-   <p>Here are some examples of valid headings. In each case, the
-   emphasized text represents the text that would be used as the
-   heading in an application extracting heading data and ignoring
-   subheadings.</p>
+   <p>Here are some examples of valid headings.</p>
 
-   <pre>&lt;hgroup&gt;
- &lt;h1&gt;<strong>The reality dysfunction</strong>&lt;/h1&gt;
+    <pre>&lt;hgroup&gt;
+ &lt;h1&gt;The reality dysfunction&lt;/h1&gt;
  &lt;h2&gt;Space is not the only void&lt;/h2&gt;
 &lt;/hgroup&gt;</pre>
 
-   <pre>&lt;hgroup&gt;
- &lt;h1&gt;<strong>Dr. Strangelove</strong>&lt;/h1&gt;
+    <pre>&lt;hgroup&gt;
+ &lt;h1&gt;Dr. Strangelove&lt;/h1&gt;
  &lt;h2&gt;Or: How I Learned to Stop Worrying and Love the Bomb&lt;/h2&gt;
 &lt;/hgroup&gt;</pre>
 
-  <p>The point of using <code><a href=#the-hgroup-element>hgroup</a></code> in these examples is to
-  mask the <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h2</a></code> element (which acts as a secondary title)
-  from the <a href=#outline>outline</a> algorithm.</p><!--
-  http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
-  -->
+   <p>The point of using <code><a href=#the-hgroup-element>hgroup</a></code> in these examples is to
+   mask the <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h2</a></code> element (which acts as a secondary title)
+   from the <a href=#outline>outline</a> algorithm.</p><!--
+   http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
+   -->
+
+   <p>How a user agent exposes such multi-level headings in user
+   interfaces (e.g. in tables of contents or search results) is left
+   open to implementors, as it is a user interface issue. The first
+   example above could be rendered as:</p>
+
+   <pre>The reality dysfunction: Space is not the only void</pre>
+
+   <p>Alternatively, it could look like this:
+
+   <pre>The reality dysfunction (Space is not the only void)</pre>
+
+   <p>In interfaces where a title can be rendered on multiple lines,
+   it could be rendered as follows, maybe with the first line in a
+   bigger font size:</p>
+
+   <pre>The reality dysfunction
+Space is not the only void</pre>
 
   </div>
 

diff --git a/index b/index
@@ -18460,15 +18460,6 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
   multiple levels, such as subheadings, alternative titles, or
   taglines.</p>
 
-  <p>For the purposes of document summaries, outlines, and the like,
-  the text of <code><a href=#the-hgroup-element>hgroup</a></code> elements is defined to be the text
-  of the highest <a href=#rank title=rank>ranked</a>
-  <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>&ndash;<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> element descendant of the
-  <code><a href=#the-hgroup-element>hgroup</a></code> element, if there are any such elements, and the
-  first such element if there are multiple elements with that
-  <a href=#rank>rank</a>. If there are no such elements, then the text of
-  the <code><a href=#the-hgroup-element>hgroup</a></code> element is the empty string.</p>
-
   <p>Other elements of <a href=#heading-content>heading content</a> in the
   <code><a href=#the-hgroup-element>hgroup</a></code> element indicate subheadings or subtitles.</p>
 
@@ -18484,26 +18475,41 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
 
   <div class=example>
 
-   <p>Here are some examples of valid headings. In each case, the
-   emphasized text represents the text that would be used as the
-   heading in an application extracting heading data and ignoring
-   subheadings.</p>
+   <p>Here are some examples of valid headings.</p>
 
-   <pre>&lt;hgroup&gt;
- &lt;h1&gt;<strong>The reality dysfunction</strong>&lt;/h1&gt;
+    <pre>&lt;hgroup&gt;
+ &lt;h1&gt;The reality dysfunction&lt;/h1&gt;
  &lt;h2&gt;Space is not the only void&lt;/h2&gt;
 &lt;/hgroup&gt;</pre>
 
-   <pre>&lt;hgroup&gt;
- &lt;h1&gt;<strong>Dr. Strangelove</strong>&lt;/h1&gt;
+    <pre>&lt;hgroup&gt;
+ &lt;h1&gt;Dr. Strangelove&lt;/h1&gt;
  &lt;h2&gt;Or: How I Learned to Stop Worrying and Love the Bomb&lt;/h2&gt;
 &lt;/hgroup&gt;</pre>
 
-  <p>The point of using <code><a href=#the-hgroup-element>hgroup</a></code> in these examples is to
-  mask the <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h2</a></code> element (which acts as a secondary title)
-  from the <a href=#outline>outline</a> algorithm.</p><!--
-  http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
-  -->
+   <p>The point of using <code><a href=#the-hgroup-element>hgroup</a></code> in these examples is to
+   mask the <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h2</a></code> element (which acts as a secondary title)
+   from the <a href=#outline>outline</a> algorithm.</p><!--
+   http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
+   -->
+
+   <p>How a user agent exposes such multi-level headings in user
+   interfaces (e.g. in tables of contents or search results) is left
+   open to implementors, as it is a user interface issue. The first
+   example above could be rendered as:</p>
+
+   <pre>The reality dysfunction: Space is not the only void</pre>
+
+   <p>Alternatively, it could look like this:
+
+   <pre>The reality dysfunction (Space is not the only void)</pre>
+
+   <p>In interfaces where a title can be rendered on multiple lines,
+   it could be rendered as follows, maybe with the first line in a
+   bigger font size:</p>
+
+   <pre>The reality dysfunction
+Space is not the only void</pre>
 
   </div>
 

diff --git a/source b/source
@@ -19785,15 +19785,6 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
   multiple levels, such as subheadings, alternative titles, or
   taglines.</p>
 
-  <p>For the purposes of document summaries, outlines, and the like,
-  the text of <code>hgroup</code> elements is defined to be the text
-  of the highest <span title="rank">ranked</span>
-  <code>h1</code>&ndash;<code>h6</code> element descendant of the
-  <code>hgroup</code> element, if there are any such elements, and the
-  first such element if there are multiple elements with that
-  <span>rank</span>. If there are no such elements, then the text of
-  the <code>hgroup</code> element is the empty string.</p>
-
   <p>Other elements of <span>heading content</span> in the
   <code>hgroup</code> element indicate subheadings or subtitles.</p>
 
@@ -19809,26 +19800,41 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
 
   <div class="example">
 
-   <p>Here are some examples of valid headings. In each case, the
-   emphasized text represents the text that would be used as the
-   heading in an application extracting heading data and ignoring
-   subheadings.</p>
+   <p>Here are some examples of valid headings.</p>
 
-   <pre>&lt;hgroup&gt;
- &lt;h1&gt;<strong>The reality dysfunction</strong>&lt;/h1&gt;
+    <pre>&lt;hgroup&gt;
+ &lt;h1&gt;The reality dysfunction&lt;/h1&gt;
  &lt;h2&gt;Space is not the only void&lt;/h2&gt;
 &lt;/hgroup&gt;</pre>
 
-   <pre>&lt;hgroup&gt;
- &lt;h1&gt;<strong>Dr. Strangelove</strong>&lt;/h1&gt;
+    <pre>&lt;hgroup&gt;
+ &lt;h1&gt;Dr. Strangelove&lt;/h1&gt;
  &lt;h2&gt;Or: How I Learned to Stop Worrying and Love the Bomb&lt;/h2&gt;
 &lt;/hgroup&gt;</pre>
 
-  <p>The point of using <code>hgroup</code> in these examples is to
-  mask the <code>h2</code> element (which acts as a secondary title)
-  from the <span>outline</span> algorithm.</p><!--
-  http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
-  -->
+   <p>The point of using <code>hgroup</code> in these examples is to
+   mask the <code>h2</code> element (which acts as a secondary title)
+   from the <span>outline</span> algorithm.</p><!--
+   http://www.brucelawson.co.uk/2009/html-5-is-a-mess/#comment-618895
+   -->
+
+   <p>How a user agent exposes such multi-level headings in user
+   interfaces (e.g. in tables of contents or search results) is left
+   open to implementors, as it is a user interface issue. The first
+   example above could be rendered as:</p>
+
+   <pre>The reality dysfunction: Space is not the only void</pre>
+
+   <p>Alternatively, it could look like this:
+
+   <pre>The reality dysfunction (Space is not the only void)</pre>
+
+   <p>In interfaces where a title can be rendered on multiple lines,
+   it could be rendered as follows, maybe with the first line in a
+   bigger font size:</p>
+
+   <pre>The reality dysfunction
+Space is not the only void</pre>
 
   </div>