Skip to content

Commit cc211a0

Browse files
committed
Add some notes on ::first-letter ::first-line conventions
1 parent 6f4a1ca commit cc211a0

File tree

2 files changed

+29
-8
lines changed

2 files changed

+29
-8
lines changed

css-module/Overview.html

+16-5
Original file line numberDiff line numberDiff line change
@@ -61,13 +61,13 @@ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 29 March 2012</h2>
6161
<dd><a href="http://www.w3.org/PreviousVersionURI">
6262
http://www.w3.org/PreviousVersionURI</a>
6363

64-
<dt>Issues List:
64+
<dt>Issue Tracking:
6565

6666
<dd><a
6767
href="http://www.w3.org/Style/CSS/Tracker/products/FIXME">http://www.w3.org/Style/CSS/Tracker/products/FIXME</a>
6868

6969

70-
<dt>Discussion:
70+
<dt>Feedback:
7171

7272
<dd><a
7373
href="http://lists.w3.org/Archives/Public/www-style/">www-style@w3.org</a>
@@ -226,9 +226,20 @@ <h3 id=placement><span class=secno>1.1. </span> Module interactions</h3>
226226
<p>This module replaces and extends the <var class=replaceme>SUMMARIZE
227227
HERE</var> features defined in <a href="#CSS21"
228228
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> sections <var
229-
class=replaceme>W.X and Y.Z</var>. All properties in this module apply to
230-
the <code>::first-line</code> and <code>::first-letter</code>
231-
pseudo-elements.
229+
class=replaceme>W.X and Y.Z</var>.
230+
231+
<p class=replaceme>All properties in this module apply to the
232+
<code>::first-line</code> and <code>::first-letter</code> pseudo-elements.
233+
<!-- HANDLE, THEN REMOVE THIS COMMENT
234+
Properties that affect box layout should be excluded from ::first-line.
235+
Properties that take things out-of-flow or alter box construction should
236+
be excluded from both ::first-line and ::first-letter. (A special exception
237+
is made for float on ::first-letter, which is defined to emulate drop-caps.)
238+
Examples of ::first-line / ::first-letter statements:
239+
http://dev.w3.org/csswg/css3-background/#placement
240+
(All properties apply to ::first-letter; some apply to ::first-line)
241+
-->
242+
232243

233244
<h3 id=values><span class=secno>1.2. </span> Values</h3>
234245

css-module/Overview.src.html

+13-3
Original file line numberDiff line numberDiff line change
@@ -46,10 +46,10 @@ <h2 class="no-num no-toc">[LONGSTATUS] [DATE]</h2>
4646
<dd><a href="http://www.w3.org/PreviousVersionURI">
4747
http://www.w3.org/PreviousVersionURI</a>
4848

49-
<dt>Issues List:</dt>
49+
<dt>Issue Tracking:</dt>
5050
<dd><a href="http://www.w3.org/Style/CSS/Tracker/products/FIXME">http://www.w3.org/Style/CSS/Tracker/products/FIXME</a>
5151

52-
<dt>Discussion:</dt>
52+
<dt>Feedback:</dt>
5353
<dd><a href="http://lists.w3.org/Archives/Public/www-style/">www-style@w3.org</a> with subject line &ldquo;<kbd>[[SHORTNAME]] <var>&hellip; message topic &hellip;</var></kbd>&rdquo;
5454

5555
<dt>Editors:
@@ -103,8 +103,18 @@ <h3 id="placement">
103103

104104
<p>This module replaces and extends the <var class="replaceme">SUMMARIZE HERE</var>
105105
features defined in [[!CSS21]] sections <var class="replaceme">W.X and Y.Z</var>.
106-
All properties in this module apply to the <code>::first-line</code> and
106+
107+
<p class="replaceme">All properties in this module apply to the <code>::first-line</code> and
107108
<code>::first-letter</code> pseudo-elements.
109+
<!-- HANDLE, THEN REMOVE THIS COMMENT
110+
Properties that affect box layout should be excluded from ::first-line.
111+
Properties that take things out-of-flow or alter box construction should
112+
be excluded from both ::first-line and ::first-letter. (A special exception
113+
is made for float on ::first-letter, which is defined to emulate drop-caps.)
114+
Examples of ::first-line / ::first-letter statements:
115+
http://dev.w3.org/csswg/css3-background/#placement
116+
(All properties apply to ::first-letter; some apply to ::first-line)
117+
-->
108118

109119
<h3 id="values">
110120
Values</h3>

0 commit comments

Comments
 (0)