[css2] Edits by Hakon and some edits by me, during ftf

bert-github · bert-github · commit 334a1a9f4e06 · 2003-11-06T23:34:43.000Z
--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%402192
diff --git a/css2/about.src b/css2/about.src
@@ -2,7 +2,7 @@
   'http://www.w3.org/TR/html4/strict.dtd'>
 
 <html lang="en">
-<!-- $Id: about.src,v 2.54 2003-10-17 17:52:46 bbos Exp $ -->
+<!-- $Id: about.src,v 2.55 2003-11-06 23:34:42 bbos Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>About the CSS&nbsp;2.1 Specification</TITLE>
@@ -34,9 +34,12 @@ widely accepted and implemented.
 specification, modifying the specification to be in accordance with
 generally accepted practice.
 
-<lI>Removing all CSS2 features which, by virtue of not having been
-implemented, have been rejected by the CSS community.
-  
+<li>Removing CSS2 features which, by virtue of not having been
+implemented, have been rejected by the CSS community. CSS2.1 aims to
+reflect what CSS features are reasonably widely implemented for HTML
+and XML languages in general (rather than <em>only</em> for a
+particular XML language, or <em>only</em> for HTML).
+
 <li>Removing CSS2 features that will be obsoleted by CSS3, thus
 encouraging adoption of the proposed CSS3 features in their place.
 
@@ -249,9 +252,8 @@ initial values.
 
 <p>This part lists the elements to which the property applies. All
 elements are considered to have all properties, but some properties
-have no rendering effect on some types of elements. For example, <span
-class="propinst-border-spacing">'border-spacing'</span> only affects
-table elements.
+have no rendering effect on some types of elements. For example, the <span
+class="propinst-clear">'clear'</span> property only affects block-level elements.
 
 <h4>Inherited</h4>
 
diff --git a/css2/box.src b/css2/box.src
@@ -2,7 +2,7 @@
   'http://www.w3.org/TR/html4/strict.dtd'>
 
 <html lang="en">
-<!-- $Id: box.src,v 1.48 2003-11-05 20:03:41 bbos Exp $ -->
+<!-- $Id: box.src,v 1.49 2003-11-06 23:34:42 bbos Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Box model</TITLE>
@@ -77,13 +77,15 @@ box is a table, etc. Box widths and heights are discussed
 in the chapter on <a href="visudet.html">visual formatting
 model details</a>.
 
+<!-- removed at ftf 6 Nov 2003
 <P>The <span class="index-def" title="box::width"><a
 name="the-box-width"><dfn>box width</dfn></a></span> is given by the
 sum of the left and right margins, border, and padding, and the
 content width. The <span class="index-def" title="box::height"><a
 name="the-box-height"><dfn>box height</dfn></a></span> is given by the sum
 of the top and bottom margins, border, and padding, and the content
 height.
+-->
 
 <P>The background style of the content, padding, and border areas of a
 box is specified by the <span
diff --git a/css2/generate.src b/css2/generate.src
@@ -772,12 +772,16 @@ principal block box. Values have the following meanings:</p>
 
 <dl>
 <dt><strong>outside</strong>
-<dd>The marker box is outside the principal block box. CSS&nbsp;2.1 does not specify the precise location
-of the marker box.
+
+<dd>The marker box is outside the principal block box. CSS&nbsp;2.1
+does not specify the precise location of the marker box.
 
 <dt><strong>inside</strong>
-<dd>The marker box is the first inline box in the
-principal block box, after which the element's content flows.
+
+<dd>The marker box is the first inline box in the principal block box,
+after which the element's content flows. CSS&nbsp;2.1 does not specify
+the precise location of the marker box.
+
 </dl>
 
 <div class="html-example"><P>
diff --git a/css2/media.src b/css2/media.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html lang="en">
-<!-- $Id: media.src,v 2.30 2002-11-17 19:29:40 bbos Exp $ -->
+<!-- $Id: media.src,v 2.31 2003-11-06 23:34:42 bbos Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Media types</TITLE>
@@ -112,10 +112,10 @@ properties that apply to that media type.
 -->
 
 <P>The names chosen for CSS media types reflect target devices for
-which the relevant properties make sense. The names of media types are
-normative. In the following list of CSS media types, the parenthetical
-descriptions are not normative. Likewise, the "Media" field in the
-description of each property is informative.
+which the relevant properties make sense. In the following list of CSS
+media types the names of media types are normative, but the
+parenthetical descriptions are informative. Likewise, the "Media"
+field in the description of each property is informative.
 
 <dl>
 <dt><strong>all</strong>
@@ -186,7 +186,7 @@ class="index-inst" title="@media">@media</span>.
 
 <div class="note"><P>
 <em><strong>Note.</strong>
-Future versions of CSS may extend this list. Authors
+Future versions of CSS may extend the list of media types. Authors
 should not rely on media type names that are not yet defined
 by a CSS specification.
 </em>
@@ -196,14 +196,12 @@ by a CSS specification.
 
 <P><em>This section is informative, not normative.</em></P>
 
-<P>Each CSS property definition specifies the media types for which
-the property must be implemented by a <a
-href="conform.html#conformance">conforming user agent</a>. Since
-properties generally apply to several media, the "Applies to media"
-section of each property definition lists <span class="index-def"
-title="media group">media groups</span> rather than individual media
-types. Each property applies to all media types in the media groups
-listed in its definition.
+<P>Each CSS property definition specifies which media types the
+property applies to. Since properties generally apply to several media
+types, the "Applies to media" section of each property definition
+lists <span class="index-def" title="media group">media groups</span>
+rather than individual media types. Each property applies to all media
+types in the media groups listed in its definition.
 
 <P>CSS&nbsp;2.1 defines the following media groups: </P>
 <ul>
diff --git a/css2/page.src b/css2/page.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html lang="en">
-<!-- $Id: page.src,v 2.39 2003-10-08 09:57:01 bbos Exp $ -->
+<!-- $Id: page.src,v 2.40 2003-11-06 23:34:42 bbos Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Paged media</TITLE>
@@ -15,26 +15,15 @@
 on computer screens, etc.) differ from <a
 href="./media.html#continuous-media-group">continuous media</a> in
 that the content of the document is split into one or more discrete
-pages. To handle page breaks, CSS2 extends the <a
-href="visuren.html">visual formatting model</a> as follows:</p>
+pages. To handle pages, CSS 2.1 describes how page margins are set
+on <a href="#page-box">page boxes</a>, and how <a href="#page-breaks">page breaks</a> are declared.
 
-<ol>
-<li>The <a href="#page-box">page
-box</a> extends the <a href="box.html#box-model">box
-model</a> to allow authors to specify page margins.
-
-<li>The <span class="index-def" title="page model"><dfn>page
-model</dfn></span> extends the <a href="visuren.html">visual formatting
-model</a> to account for <a href="#page-breaks">page breaks.</a>
-</ol>
-
-<p>The CSS&nbsp;2.1 <a name="page-model">page model</a> specifies how a
-document is formatted within the <a
-href="#page-box">page box</a>. The page box does not necessarily correspond to the real <span
-class="index-def" title="sheet"><dfn>sheet</dfn></span> where the
-document will ultimately be rendered (paper, transparency, screen,
-etc.).  The user agent is responsible for transferring the page box to the
-sheet. Transfer possibilities include:</P>
+<p>The user agent is responsible for transferring the page boxes of a
+document onto the real <span class="index-def"
+title="sheet"><dfn>sheets</dfn></span> where the document will
+ultimately be rendered (paper, transparency, screen, etc.). There is
+often a 1-to-1 relationship between a page box and a sheet, but this
+is not always the case. Transfer possibilities include:</P>
 
 <ul>
 <li>Transferring one page box to one sheet (e.g., single-sided printing).
@@ -56,21 +45,24 @@ proper sequence.
 box</dfn></span> is a rectangular region that contains two areas:</p>
 
 <ul>
+
 <li>The <span class="index-def" title="page area"><a
 name="page-area"><dfn>page area</dfn></a></span>. The page
 area includes the boxes laid out on that page.
 The edges of the page area act as the initial <a
 href="visudet.html#containing-block-details">containing block</a> 
-for layout that occurs between page breaks.
-<li>The margin area, which surrounds the page area.
+for layout that occurs between page breaks. 
+
+<li>The margin area, which surrounds the page area. 
 </ul>
 
 <P>Authors can specify the margins of a page box inside an <span
 class="index-def" title="@page">@page</span> rule. An @page rule
 consists of the keyword "@page", followed by an optional page
-selector, followed by a block of declarations. The declarations are
-said to be in the <span class="index-def" title="page-context"><a
-name="page-context"><dfn>page context</dfn></a></span>.</p>
+selector, followed by a block of declarations. The declarations in an
+@page rule are said to be in the <span class="index-def"
+title="page-context"><a name="page-context"><dfn>page
+context</dfn></a></span>.</p>
 
 <P>The <span class="index-def" title="page selector"><dfn>page
 selector</dfn></span> specifies for which pages the declarations
@@ -80,9 +72,9 @@ all left pages, or all right pages</p>
 
 <h3><a name="page-margins">Page margins</a></h3>
 
-<P>The <a href="box.html#margin-properties">margin properties</a>
-(<span class="propinst-margin-top">'margin-top'</span>, <span
-class="propinst-margin-right">'margin-right'</span>, <span
+<P>In CSS 2.1, only the <a href="box.html#margin-properties">margin
+properties</a> (<span class="propinst-margin-top">'margin-top'</span>,
+<span class="propinst-margin-right">'margin-right'</span>, <span
 class="propinst-margin-bottom">'margin-bottom'</span>, <span
 class="propinst-margin-left">'margin-left'</span>, and <span
 class="propinst-margin">'margin'</span>) apply within the <a
diff --git a/css2/selector.src b/css2/selector.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC '-//W3C//DTD HTML 4.0 Transitional//EN'>
 <html lang="en">
-<!-- $Id: selector.src,v 2.79 2003-11-05 20:03:41 bbos Exp $ -->
+<!-- $Id: selector.src,v 2.80 2003-11-06 23:34:42 bbos Exp $ -->
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <title>Selectors</title>
@@ -697,7 +697,7 @@ subset of the properties on these pseudo-elements.</P>
 
 <P>The <span class="index-def"
 title="first-child|:first-child">:first-child</span> pseudo-class
-matches an element that is the first child of some other element.
+matches an element that is the first child element of some other element.
 
 <div class="example"><P>
 In the following example, the selector matches any P element
@@ -814,10 +814,12 @@ will cause it to be blue.
 
 <p class=note>Note. It is possible for stylesheet authors to abuse the
 :link and :visited pseudo-classes to determine which sites a user has
-visited without the user's consent. UAs may therefore treat all links
-as unvisited links, or implement other measures to preserve the user's
-privacy while rendering visited and unvisited links differently. See
-[[-P3P]] for more information about handling privacy.
+visited without the user's consent.
+
+<p>UAs may therefore treat all links as unvisited links, or implement
+other measures to preserve the user's privacy while rendering visited
+and unvisited links differently. See [[-P3P]] for more information
+about handling privacy.
 
 <h3><a name="dynamic-pseudo-classes">The dynamic pseudo-classes:</a>
 <span class="index-def" title="pseudo-classes:::hover|:hover|hover
@@ -857,6 +859,9 @@ how the states are entered and left. Scripting may change whether
 elements react to user events or not, and different devices and UAs
 may have different ways of pointing to, or activating elements.
 
+<p>CSS&nbsp;2.1 doesn't define if the parent of an element that is
+':active' or ':hover is also in that state.
+
 <p>User agents are not required to reflow a currently displayed
 document due to pseudo-class transitions. For instance, a style sheet
 may specify that the <span
@@ -908,11 +913,18 @@ focus outlines</a>.
 In CSS1, the ':active' pseudo-class was mutually
 exclusive with ':link' and ':visited'. That is no longer the case. An
 element can be both ':visited' and ':active' (or ':link' and
-':active') and the normal cascading rules determine which properties
+':active') and the normal cascading rules determine which style
+declarations
 apply.
 </em>
 </div>
 
+<div class="note"><P>
+<em><strong>Note.</strong>
+Also note that in CSS1, the ':active' pseudo-class only applied to
+links.</em>
+</div>
+
 <h3><a name="lang">The language pseudo-class:</a> <span
 class="index-def" title="pseudo-classes:::lang|:lang|lang
 (pseudo-class)">:lang</span></h3>
@@ -1049,7 +1061,7 @@ will be treated as ordinary lines in the
 paragraph.&lt;/P&gt;
 </pre>
 
-<p>the user agent could generate the appropriate start and end tags for
+<p>the user agent could simulate start and end tags for
 SPAN when inserting the fictional tag sequence for :first-line.
 
 <pre>
@@ -1075,7 +1087,7 @@ line...&lt;/P>&lt/DIV></code> is the first line of the P (assuming
 that both P and DIV are block-level).
 
 <p>A UA should act as if the fictional start tag of the first-line
-pseudo-element is just inside the smallest enclosing block-level
+pseudo-element is just inside the innermost enclosing block-level
 element. (Since CSS1 and CSS2 were silent on this case, authors
 should not rely on this behavior.) Here is an example. The fictional
 tag sequence for
diff --git a/css2/syndata.src b/css2/syndata.src
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
         "http://www.w3.org/TR/1998/REC-html40-19980424/loose.dtd">
 <html lang="en">
-<!-- $Id: syndata.src,v 2.88 2003-10-17 17:52:47 bbos Exp $ -->
+<!-- $Id: syndata.src,v 2.89 2003-11-06 23:34:42 bbos Exp $ -->
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <title>Syntax and basic data types</title>
@@ -136,6 +136,9 @@ code 32), "tab" (9), "line feed" (10), "carriage return" (13), and
 such as "em-space" (8195) and "ideographic space" (12288), are never
 part of whitespace.
 </p>
+<p>The meaning of input that cannot be tokenized or parsed is
+undefined in CSS&nbsp;2.1.
+
 <h3><a name="keywords">Keywords</a></h3>
 
 <!-- provide better explanation of where keywords appear:
@@ -228,7 +231,7 @@ href="#parsing-errors">rules for handling parsing errors</a>. However, because t
     (including element names, classes, and IDs in <a
     href="selector.html">selectors</a>) can contain only the
     characters [A-Za-z0-9] and ISO 10646 characters 161 and higher,
-    plus the hyphen (-) and the underscore (_); they cannot start with a hyphen or a
+    plus the hyphen (-) and the underscore (_); they cannot start with a
     digit. They can also contain escaped characters and any ISO 10646
     character as a numeric code (see next item).
     <span class="example">For instance, the identifier "B&amp;W?" may
@@ -903,7 +906,7 @@ li { list-style: url(http://www.example.com/redball.png) disc }
 </div>
 
 <p> Parentheses, commas, whitespace characters, single quotes (') and
-double quotes (") appearing in a URI must be escaped with a
+double quotes (") appearing in an unquoted URI must be escaped with a
 backslash: '\(', '\)', '\,'.
 </p>
 <p>Depending on the type of URI, it might also be possible to write
@@ -935,7 +938,8 @@ by the URI
 <pre>http://www.example.org/style/yellow</pre>
 </div>
 
-<p>User agents may vary in how they handle URIs that designate
+<p>User agents may vary in how they handle invalid URIs or URIs that
+designate
 unavailable or inapplicable resources.
 </p>
 <h3><a name="counter">Counters</a></h3>
@@ -1187,8 +1191,13 @@ at-rule.</li>
 <li>Mechanisms of the language of the
 referencing document (e.g., in HTML, the "charset"
 attribute of the LINK element).</li>
+<li><ins cite="http://www.damowmow.com/temp/csswg/css21/issues"
+title="issue 44">UA-dependent mechanisms</ins></li>
 </ol>
 
+<p><ins cite="http://www.damowmow.com/temp/csswg/css21/issues"
+title="issue 44">[A BOM character is ignored if it conflicts, otherwise used]</ins>
+
 <p>At most one @charset rule may appear in an external
 style sheet &mdash; it must <em>not</em> appear in an embedded style sheet
 &mdash; and it must appear at the very start of the document, not preceded
diff --git a/css2/visudet.src b/css2/visudet.src
diff --git a/css2/visuren.src b/css2/visuren.src
