[mediaqueries] Add an optional-paged value to overflow-block, and add extra examples to all values.

--HG--
extra : rebase_source : 3c1f695e34fe44f48b53a4e5b0f3cf9e6c03d58f

Author: tabatkins

mediaqueries/Overview.html

@@ -60,7 +60,7 @@
 </p>
   <h1 class="p-name no-ref" id=title>Media Queries Level 4</h1>
   <h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>Editor’s Draft,
-    <span class=dt-updated><span class=value-title title=20140128>28 January 2014</span></span></span></h2>
+    <span class=dt-updated><span class=value-title title=20140129>29 January 2014</span></span></span></h2>
   <div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://dev.w3.org/csswg/mediaqueries4/>http://dev.w3.org/csswg/mediaqueries4/</a><dt>Editor’s Draft:<dd><a href=http://dev.w3.org/csswg/mediaqueries4/>http://dev.w3.org/csswg/mediaqueries4/</a>
     <dt>Feedback:</dt>
         <dd><a href="mailto:www-style@w3.org?subject=%5Bmediaqueries%5D%20feedback">www-style@w3.org</a>
@@ -1479,7 +1479,7 @@ <h3 class="heading settled heading" data-level=5.4 id=updates><span class=secno>
 <h3 class="heading settled heading" data-level=5.5 id=mf-overflow-block><span class=secno>5.5 </span><span class=content>
 overflow-block</span><a class=self-link href=#mf-overflow-block></a></h3>
 
-<table class="definition descdef mq" data-dfn-for=@media><tr><th>Name:<td><dfn class=css-code data-dfn-for=@media data-dfn-type=descriptor data-export="" id=descdef-overflow-block>overflow-block<a class=self-link href=#descdef-overflow-block></a></dfn><tr><th>For:<td><a class=css-code data-link-type=at-rule href=http://dev.w3.org/csswg/css-conditional-3/#at-ruledef-media title=@media>@media</a><tr><th>Value:<td>none | scroll | paged<tr><th>Type:<td>discrete</table>
+<table class="definition descdef mq" data-dfn-for=@media><tr><th>Name:<td><dfn class=css-code data-dfn-for=@media data-dfn-type=descriptor data-export="" id=descdef-overflow-block>overflow-block<a class=self-link href=#descdef-overflow-block></a></dfn><tr><th>For:<td><a class=css-code data-link-type=at-rule href=http://dev.w3.org/csswg/css-conditional-3/#at-ruledef-media title=@media>@media</a><tr><th>Value:<td>none | scroll | optional-paged | paged<tr><th>Type:<td>discrete</table>
 <p>	The <a class=property data-link-type=propdesc href=#descdef-overflow-block title=overflow-block>overflow-block</a> media feature describes the behavior of the device 
 	when content overflows the viewport in the <a data-link-type=dfn href=http://dev.w3.org/csswg/css-writing-modes-3/#block-axis- title="block axis">block axis</a>.
 
@@ -1488,16 +1488,27 @@ <h3 class="heading settled heading" data-level=5.5 id=mf-overflow-block><span cl
 		<dd>
 			There is no affordance for overflow in the <a data-link-type=dfn href=http://dev.w3.org/csswg/css-writing-modes-3/#block-axis- title="block axis">block axis</a>;
 			any overflowing content is simply not displayed.
+			Examples: billboards
 
 		<dt><dfn class=css-code data-dfn-for=@media/overflow-block data-dfn-type=value data-export="" id=valuedef-scroll0>scroll<a class=self-link href=#valuedef-scroll0></a></dfn>
 		<dd>
 			Overflowing content in the <a data-link-type=dfn href=http://dev.w3.org/csswg/css-writing-modes-3/#block-axis- title="block axis">block axis</a> is exposed by allowing users to scroll to it.
+			Examples: computer screens
+
+		<dt><dfn class=css-code data-dfn-for=@media/overflow-block data-dfn-type=value data-export="" id=valuedef-optional-paged>optional-paged<a class=self-link href=#valuedef-optional-paged></a></dfn>
+		<dd>
+			Overflowing content in the <a data-link-type=dfn href=http://dev.w3.org/csswg/css-writing-modes-3/#block-axis- title="block axis">block axis</a> is exposed by allowing users to scroll to it,
+			but page breaks can be manually triggered
+			(such as via <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-multicol-1/#break-inside title=break-inside>break-inside</a>/etc)
+			to cause the following content to display on the following page.
+			Examples: slideshows
 
 		<dt><dfn class=css-code data-dfn-for=@media/overflow-block data-dfn-type=value data-export="" id=valuedef-paged>paged<a class=self-link href=#valuedef-paged></a></dfn>
 		<dd>
 			Content is broken up into discrete pages;
 			content that overflows one page in the <a data-link-type=dfn href=http://dev.w3.org/csswg/css-writing-modes-3/#block-axis- title="block axis">block axis</a>
 			is displayed on the following page.
+			Examples: printers, ebook readers
 	</dl>
 
 	<p class=issue id=issue-379b3dad><a class=self-link href=#issue-379b3dad></a>
@@ -2176,6 +2187,7 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
 </ul><li>not, <a href=#valuedef-not title="section 2.2.1">2.2.1</a>
 <li>on-demand, <a href=#valuedef-on-demand title="section 7.2">7.2</a>
 <li>only, <a href=#valuedef-only title="section 2.2.2">2.2.2</a>
+<li>optional-paged, <a href=#valuedef-optional-paged title="section 5.5">5.5</a>
 <li>orientation, <a href=#descdef-orientation title="section 4.4">4.4</a>
 <li>overflow-block, <a href=#descdef-overflow-block title="section 5.5">5.5</a>
 <li>overflow-inline, <a href=#descdef-overflow-inline title="section 5.6">5.6</a>
@@ -2215,7 +2227,7 @@ <h2 class="no-num no-ref heading settled heading" id=property-index><span class=
 <tr><th scope-row=""><a data-property="">scan</a><td>interlace | progressive<td><td>discrete
 <tr><th scope-row=""><a data-property="">grid</a><td>&lt;mq-boolean&gt;<td><td>discrete
 <tr><th scope-row=""><a data-property="">updates</a><td>none | slow | normal<td><td>discrete
-<tr><th scope-row=""><a data-property="">overflow-block</a><td>none | scroll | paged<td><td>discrete
+<tr><th scope-row=""><a data-property="">overflow-block</a><td>none | scroll | optional-paged | paged<td><td>discrete
 <tr><th scope-row=""><a data-property="">overflow-inline</a><td>none | scroll<td><td>discrete
 <tr><th scope-row=""><a data-property="">color</a><td>&lt;integer&gt;<td><td>range
 <tr><th scope-row=""><a data-property="">color-index</a><td>&lt;integer&gt;<td><td>range

mediaqueries/Overview.src.html

@@ -1096,7 +1096,7 @@ <h3 id='mf-overflow-block'>
 
 	<pre class='descdef mq'>
 	Name: overflow-block
-	Value: none | scroll | paged
+	Value: none | scroll | optional-paged | paged
 	For: @media
 	Type: discrete
 	</pre>
@@ -1109,16 +1109,27 @@ <h3 id='mf-overflow-block'>
 		<dd>
 			There is no affordance for overflow in the <a>block axis</a>;
 			any overflowing content is simply not displayed.
+			Examples: billboards
 
 		<dt><dfn>scroll</dfn>
 		<dd>
 			Overflowing content in the <a>block axis</a> is exposed by allowing users to scroll to it.
+			Examples: computer screens
+
+		<dt><dfn>optional-paged</dfn>
+		<dd>
+			Overflowing content in the <a>block axis</a> is exposed by allowing users to scroll to it,
+			but page breaks can be manually triggered
+			(such as via 'break-inside'/etc)
+			to cause the following content to display on the following page.
+			Examples: slideshows
 
 		<dt><dfn>paged</dfn>
 		<dd>
 			Content is broken up into discrete pages;
 			content that overflows one page in the <a>block axis</a>
 			is displayed on the following page.
+			Examples: printers, ebook readers
 	</dl>
 
 	<p class='issue'>