meyerweb
diff --git a/‎css-line-grid/Overview.html‎
Lines changed: 97 additions & 85 deletions b/‎css-line-grid/Overview.html‎
Lines changed: 97 additions & 85 deletions
@@ -5,16 +5,17 @@
  <head
   profile="http://dublincore.org/documents/2008/08/04/dc-html/ http://www.w3.org/2006/03/hcard">
   <meta content="text/html; charset=utf-8" http-equiv=Content-Type>
-  <title>CSS Line Grid Module</title>
+  <title>CSS Line Grid Module Level 1</title>
 
   <link href="http://purl.org/dc/terms/" rel=schema.dcterms>
   <link href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright"
    rel=dcterms.rights>
-  <meta content="CSS Line Grid Module" name=dcterms.title>
+  <meta content="CSS Line Grid Module Level 1" name=dcterms.title>
   <meta content=text name=dcterms.type>
-  <meta content=2014-01-28 name=dcterms.date>
+  <meta content=2014-03-28 name=dcterms.date>
   <meta content="Elika Etemad" name=dcterms.creator>
   <meta content="Koji Ishii" name=dcterms.creator>
+  <meta content="Alan Stearns" name=dcterms.creator>
   <meta content=W3C name=dcterms.publisher>
   <meta content="http://dev.w3.org/csswg/unknown-shortname/"
    name=dcterms.identifier>
@@ -48,18 +49,18 @@
    <p><a href="http://www.w3.org/"><img alt=W3C height=48
     src="http://www.w3.org/Icons/w3c_home" width=72></a> <!--end-logo-->
 
-   <h1>CSS Line Grid Module</h1>
+   <h1>CSS Line Grid Module Level 1</h1>
 
-   <h2 class="no-num no-toc">Editor's Draft 28 January 2014</h2>
+   <h2 class="no-num no-toc">Editor's Draft 28 March 2014</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a href="http://dev.w3.org/csswg/unknown-shortname/">
-     http://www.w3.org/TR/2014/ED-unknown-shortname-20140128</a> <!--
+     http://www.w3.org/TR/2014/ED-unknown-shortname-20140328</a> <!--
   <dt>Latest version:
-    <dd><a href="http://www.w3.org/TR/css-line-grid">
-    http://www.w3.org/TR/css-line-grid</a>
+    <dd><a href="http://www.w3.org/TR/css-line-grid-1/">
+    http://www.w3.org/TR/css-line-grid-1/</a>
 
   <dt>Previous version:
     <dd><a href="http://www.w3.org/PreviousVersionURI">
@@ -75,6 +76,9 @@ <h2 class="no-num no-toc">Editor's Draft 28 January 2014</h2>
     <dd class=vcard><a class="fn email"
      href="mailto:kojiishi@gluesoft.co.jp">Koji Ishii</a>, <span
      class=org>Invited Expert</span>
+
+    <dd class=vcard><a class="fn email" href="mailto:stearns@adobe.com">Alan
+     Stearns</a>, <span class=org>Adobe Systems, Inc.</span>
    </dl>
    <!--begin-copyright-->
    <p class=copyright><a
@@ -99,14 +103,11 @@ <h2 class="no-num no-toc">Editor's Draft 28 January 2014</h2>
 
   <h2 class="no-num no-toc" id=abstract>Abstract</h2>
 
-  <p>CSS is a language for describing the rendering of structured documents
-   (such as HTML and XML) on screen, on paper, in speech, etc. This module
-   contains the features of CSS level 3 relating to <var
-   class=issue>DESCRIBE HERE</var>. It includes and extends the functionality
-   of CSS level 2 <a href="#ref-CSS21"
-   rel=biblioentry>[CSS21]<!--{{CSS21}}--></a>, which builds on CSS level 1
-   <a href="#ref-CSS1" rel=biblioentry>[CSS1]<!--{{CSS1}}--></a>. The main
-   extensions compared to level 2 are <var class=issue>SUMMARIZE HERE</var>.
+  <p> <span class=p-summary> This module contains CSS features for aligning
+   content to a baseline grid. </span> <a
+   href="http://www.w3.org/TR/CSS/">CSS</a> is a language for describing the
+   rendering of structured documents (such as HTML and XML) on screen, on
+   paper, in speech, etc.
 
   <h2 class="no-num no-toc" id=status>Status of this document</h2>
   <!--begin-status-->
@@ -361,12 +362,12 @@ <h2 id=line-grid><span class=secno>2. </span> Defining a Line Grid: the
     <tr>
      <th><a href="#values">Value</a>:
 
-     <td>&lt;identifier&gt;
+     <td>match-parent | create
 
     <tr>
      <th>Initial:
 
-     <td>root-grid
+     <td>match-parent
 
     <tr>
      <th>Applies to:
@@ -376,7 +377,7 @@ <h2 id=line-grid><span class=secno>2. </span> Defining a Line Grid: the
     <tr>
      <th>Inherited:
 
-     <td>yes
+     <td>no
 
     <tr>
      <th>Animatable:
@@ -405,31 +406,50 @@ <h2 id=line-grid><span class=secno>2. </span> Defining a Line Grid: the
       grammar<abbr> </abbr></abbr>
   </table>
 
-  <p>Specifies which line grid the line boxes of this element (if any) will
-   align.
-
-  <p>If no ancestor has the same value, then this property also creates a
-   line grid using the font and line layout settings of this element. The
-   line grid consists of a series of horizontal lines corresponding to all
-   the baselines (alphabetic, text-top, text-bottom, mathematic, central,
-   hanging, etc.) and to the line-over and line-under edges, positioned where
-   they would fall if the contents of this element consisted entirely of line
-   boxes filled with text (no sub-elements) using the first available font.
-   If the element is paginated, the line grid is restarted on each page;
-   since line boxes cannot be paginated, no page begins with the bottom part
-   of a line's grid.
-
-  <p class=note>As a side effect of the initial value and this definition,
-   the root element always sets up a line grid, so that ‘<a
-   href="#line-snap0"><code class=property>line-snap</code></a>’ can be
-   used even if the author has not explicitly set up a line grid.
-
-  <p class=issue>An alternative proposal is to have a non-inherited property
-   with two values, "establish a new grid" or "use same grid as my parent".
-   (Let's call it ‘<code class=css>line-grid: create |
-   match-parent</code>’.) The grid of the nearest ancestor with ‘<code
-   class=css>line-grid: create</code>’ is used (or one is established
-   anyway, if this is the root element).
+  <p>Specifies whether this box creates a new baseline grid for its
+   descendants or uses the same baseline grid as its parent. (Each box always
+   has an associated line grid. However, whether a box or its contents snap
+   to a line grid is determined by ‘<a href="#line-snap0"><code
+   class=css>line-snap</code></a>’ and ‘<a href="#box-snap0"><code
+   class=css>box-snap</code></a>’.)
+
+  <dl>
+   <dt><dfn id=match-parent>‘<code class=css>match-parent</code>’</dfn>
+
+   <dd>Box assumes the line grid of its parent.
+
+   <dt><dfn id=create>‘<code class=css>create</code>’</dfn>
+
+   <dd>Box creates a new line grid using its own font and line layout
+    settings. The line grid consists of a series of horizontal lines
+    corresponding to all the baselines (alphabetic, text-top, text-bottom,
+    mathematic, central, hanging, etc.) and to the line-over and line-under
+    edges, positioned where they would fall if the contents of this element
+    consisted entirely of line boxes filled with text (no sub-elements) using
+    the first available font. If the box is paginated, the line grid is
+    restarted on each page; since line boxes cannot be fragmented, no page
+    begins with the bottom part of a line's grid.
+  </dl>
+
+  <p>
+
+  <p class=issue>The names of these values is currently up for debate.
+   Current suggestions for ‘<a href="#match-parent"><code
+   class=css>match-parent</code></a>’ include ‘<a
+   href="#match-parent"><code class=css>match-parent</code></a>’ and
+   ‘<code class=css>normal</code>’; those for ‘<a href="#create"><code
+   class=css>create</code></a>’ include ‘<a href="#create"><code
+   class=css>create</code></a>’ and ‘<code class=css>new</code>’.
+
+  <p class=note>The original proposal for line grids allowed an element to
+   create a named grid. This property could still be extended to do this in
+   the future.
+
+  <p class=issue><a
+   href="http://www.w3.org/mid/21262.26596.32230.32937@gargle.gargle.HOWL">Håkon
+   points out</a> that there might be a need to have line grids aligned to
+   the page box rather than the page content box. The current proposal has no
+   way to switch between the two.
 
   <p class=issue>There might need to be an offset for more complicated
    designs. How to set this offset is problematic: usually it's not a fixed
@@ -654,6 +674,9 @@ <h3 id=box-snap><span class=secno>3.3. </span> Snapping Block Boxes: the
    ‘<a href="#box-snap0"><code class=property>box-snap</code></a>’
    property</h3>
 
+  <p class=issue> This is a rough draft of trying to solve the box-snapping
+   problem.
+
   <table class=propdef>
    <tbody>
     <tr>
@@ -965,8 +988,8 @@ <h3 id=conventions><span class=secno>5.1. </span>Document Conventions</h3>
   <h3 id=conformance-classes><span class=secno>5.2. </span> Conformance
    Classes</h3>
 
-  <p>Conformance to <var class=issue>CSS TEMPLATE Module</var> is defined for
-   three conformance classes:
+  <p>Conformance to CSS Line Grid Level 1 is defined for three conformance
+   classes:
 
   <dl>
    <dt><dfn id=style-sheet title="style sheet!!as conformance class">style
@@ -987,25 +1010,22 @@ <h3 id=conformance-classes><span class=secno>5.2. </span> Conformance
     that writes a style sheet.
   </dl>
 
-  <p>A style sheet is conformant to <var class=issue>CSS TEMPLATE
-   Module</var> if all of its declarations that use properties defined in
-   this module have values that are valid according to the generic CSS
-   grammar and the individual grammars of each property as given in this
-   module.
-
-  <p>A renderer is conformant to <var class=issue>CSS TEMPLATE Module</var>
-   if, in addition to interpreting the style sheet as defined by the
-   appropriate specifications, it supports all the properties defined by <var
-   class=issue>CSS TEMPLATE Module</var> by parsing them correctly and
-   rendering the document accordingly. However, the inability of a UA to
-   correctly render a document due to limitations of the device does not make
-   the UA non-conformant. (For example, a UA is not required to render color
-   on a monochrome monitor.)
-
-  <p>An authoring tool is conformant to <var class=issue>CSS TEMPLATE
-   Module</var> if it writes syntactically correct style sheets, according to
-   the generic CSS grammar and the individual grammars of each property in
-   this module.
+  <p>A style sheet is conformant to CSS Line Grid Level 1 if all of its
+   declarations that use properties defined in this module have values that
+   are valid according to the generic CSS grammar and the individual grammars
+   of each property as given in this module.
+
+  <p>A renderer is conformant to CSS Line Grid Level 1 if, in addition to
+   interpreting the style sheet as defined by the appropriate specifications,
+   it supports all the properties defined by CSS Line Grid Level 1 by parsing
+   them correctly and rendering the document accordingly. However, the
+   inability of a UA to correctly render a document due to limitations of the
+   device does not make the UA non-conformant. (For example, a UA is not
+   required to render color on a monochrome monitor.)
+
+  <p>An authoring tool is conformant to CSS Line Grid Level 1 if it writes
+   syntactically correct style sheets, according to the generic CSS grammar
+   and the individual grammars of each property in this module.
 
   <h3 id=partial><span class=secno>5.3. </span> Partial Implementations</h3>
 
@@ -1037,10 +1057,6 @@ <h3 id=experimental><span class=secno>5.4. </span> Experimental
 
   <h3 id=cr-exit-criteria><span class=secno>5.5. </span> CR Exit Criteria</h3>
 
-  <p class=issue>[Change or remove the following CR exit criteria if the spec
-   is not a module, but, e.g., a Note or a profile. This text was <a
-   href="/Style/CSS/Tracker/actions/44"> decided on 2008-06-04.</a>]
-
   <p> For this specification to be advanced to Proposed Recommendation, there
    must be at least two independent, interoperable implementations of each
    feature. Each feature may be implemented by a different set of products,
@@ -1089,7 +1105,7 @@ <h3 id=cr-exit-criteria><span class=secno>5.5. </span> CR Exit Criteria</h3>
 
   <h2 class=no-num id=acknowledgments>Acknowledgments</h2>
 
-  <p><var class=issue>[acknowledgments]</var>
+  <p>This module was made possible by the advice and contributions of …
 
   <h2 class=no-num id=references>References</h2>
 
@@ -1114,8 +1130,8 @@ <h3 class=no-num id=normative-references>Normative references</h3>
    <dt id=ref-RFC2119>[RFC2119]
 
    <dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key
-    words for use in RFCs to Indicate Requirement Levels.</cite></a> Internet
-    RFC 2119. URL: <a
+    words for use in RFCs to Indicate Requirement Levels.</cite></a> RFC
+    2119. URL: <a
     href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a>
    </dd>
    <!---->
@@ -1130,16 +1146,6 @@ <h3 class=no-num id=other-references>Other references</h3>
    <dd style="display: none"><!-- keeps the doc valid if the DL is empty -->
     <!---->
 
-   <dt id=ref-CSS1>[CSS1]
-
-   <dd>Håkon Wium Lie; Bert Bos. <a
-    href="http://www.w3.org/TR/2008/REC-CSS1-20080411"><cite>Cascading Style
-    Sheets (CSS1) Level 1 Specification.</cite></a> 11 April 2008. W3C
-    Recommendation. URL: <a
-    href="http://www.w3.org/TR/2008/REC-CSS1-20080411">http://www.w3.org/TR/2008/REC-CSS1-20080411</a>
-   </dd>
-   <!---->
-
    <dt id=ref-CSS3COLOR>[CSS3COLOR]
 
    <dd>Tantek Çelik; Chris Lilley; L. David Baron. <a
@@ -1190,6 +1196,9 @@ <h2 class=no-num id=index>Index</h2>
    <li>‘<code class=css>contain</code>’, <a href="#contain"
     title="section 3.1."><strong>3.1.</strong></a>
 
+   <li>‘<code class=css>create</code>’, <a href="#create"
+    title="section 2."><strong>2.</strong></a>
+
    <li>half-border, <a href="#half-border"
     title="section 3.3."><strong>3.3.</strong></a>
 
@@ -1217,6 +1226,9 @@ <h2 class=no-num id=index>Index</h2>
    <li>margin-box, <a href="#margin-box"
     title="section 3.3."><strong>3.3.</strong></a>
 
+   <li>‘<code class=css>match-parent</code>’, <a href="#match-parent"
+    title="section 2."><strong>2.</strong></a>
+
    <li>none, <a href="#none1" title="section 3.3."><strong>3.3.</strong></a>
 
    <li>‘<code class=css>none</code>’, <a href="#none"
@@ -1274,13 +1286,13 @@ <h2 class=no-num id=property-index>Property index</h2>
     <tr>
      <th><a class=property href="#line-grid0">line-grid</a>
 
-     <td>&lt;identifier&gt;
+     <td>match-parent | create
 
-     <td>root-grid
+     <td>match-parent
 
      <td>block containers
 
-     <td>yes
+     <td>no
 
      <td>N/A