[css2] Removed commented text

ianbjacobs · ianbjacobs · commit 8f71da32d274 · 1998-05-06T02:29:17.000Z
--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%401660
diff --git a/css2/colors.src b/css2/colors.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html lang="en">
-<!-- $Id: colors.src,v 2.15 1998-04-17 21:04:42 ijacobs Exp $ -->
+<!-- $Id: colors.src,v 2.16 1998-05-06 02:17:23 ijacobs Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Colors and backgrounds</TITLE>
@@ -85,15 +85,6 @@ HTML document will have a "marble" background:
 </div>
 
 
-<!--
-<div class="note"><P>
-<em><strong>Note.</strong> The document language may not define an
-element that gives direct access to the canvas. 
-</em>
-</div>
-
-What if it does? How will CSS know? [BB]-->
-
 <H3><a name="background-properties">Background properties</a>: <span
 class="propinst-background-color">'background-color'</span>, <span
 class="propinst-background-image">'background-image'</span>, <span
@@ -131,17 +122,6 @@ title="&lt;uri&gt;"><span
 class="value-inst-uri">&lt;uri&gt;</span></span>, to specify the
 image, or 'none', when no image is used.
 
-<!--
-<P>Values have the following meanings:</p>
-
-<dl>
-<dt><span class="index-inst" title="&lt;uri&gt;"><span class="value-inst-uri"><strong>&lt;uri&gt;</strong></span></span>
-<dd>Specifies the location of the image.
-<dt><strong>none</strong>
-<dd>No background image is used.
-</dl>
--->
-
 <div class="example"><P>
 <PRE>
 BODY { background-image: url(marble.gif) }
@@ -197,15 +177,6 @@ document ('scroll').
 the background or padding area of the element. Thus, unless the image
 is tiled ('background-repeat: repeat'), it may be invisible.
 
-<!--
-<dl>
-<dt><strong>fixed</strong>
-<dd>The image is fixed with respect to the viewport.
-<dt><strong>scroll</strong>
-<dd>The image is scrolled along with the document.
-</dl>
--->
-
 <div class="example"><P>This example creates an infinite vertical band
 that remains "glued" to the viewport when the element is scrolled.
 <PRE>
diff --git a/css2/grammar.src b/css2/grammar.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html lang="en">
-<!-- $Id: grammar.src,v 2.15 1998-05-04 15:09:50 bbos Exp $ -->
+<!-- $Id: grammar.src,v 2.16 1998-05-06 02:21:21 ijacobs Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Appendix D: The grammar of CSS2</TITLE>
@@ -22,10 +22,6 @@ imposes restrictions on the possible values of the "class" attribute.
 <!-- IJ: There used to be a link to "unit notation", but I couldn't
 find anything in the spec that corresponded. -->
 
-<!-- The words "forward-compatible" no longer appear in syndata.src.
-They appear here and in fonts.src. Should be label them in
-syndata.src? -IJ -->
-
 <h2>Grammar</h2>
 
 <P> The grammar below is <span class="index-inst"
diff --git a/css2/media.src b/css2/media.src
@@ -1,13 +1,12 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html lang="en">
-<!-- $Id: media.src,v 2.18 1998-04-28 22:28:55 ijacobs Exp $ -->
+<!-- $Id: media.src,v 2.19 1998-05-06 02:22:55 ijacobs Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Media types</TITLE>
 </HEAD>
 <BODY>
 <H1 align="center">Media types</H1>
-<!-- Are values case-sensitive? -->
 
 <H2>Introduction to media types</H2>
 
@@ -139,9 +138,7 @@ Please consult the section on <a href="page.html">paged media</a> for
 information about formatting issues that are specific to paged media.
 
 <dt><strong>screen</strong> 
-<dd>Intended primarily for color computer screens. <!-- See the section on
-<a href="#continuous-media-group">rendering to continuous
-media</a> for more information. -->
+<dd>Intended primarily for color computer screens. 
 
 <dt><strong>tty</strong>
 <dd>Intended for media using a fixed-pitch character grid, such as
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.50 1998-05-03 01:08:49 ijacobs Exp $ -->
+<!-- $Id: selector.src,v 2.51 1998-05-06 02:25:10 ijacobs Exp $ -->
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <title>Selectors</title>
@@ -338,8 +338,7 @@ matching|&#124;="><code>[att|=val]</code></span>
 <dd>Match when the element's "att" attribute value is a 
 hyphen-separated list of "words", beginning with "val". The match
 always starts at the beginning of the attribute value.
-<!--If this selector is used, the words in the value must not contain
-hyphens (since they are separated by hyphens).--> This is primarily
+This is primarily
 intended to allow <span class="index-inst" title="language
 code">language subcode</span> matches (e.g., the "lang"
 attribute in HTML) as described in RFC 1766 ([[-RFC1766]]).
@@ -502,9 +501,6 @@ text, while the second would:</p>
 </pre>
 </div>
 
-<!--<p>The normal inheritance rules apply to classed elements; they
-inherit values from their parent in the document structure.</p>-->
-
 <p>To match a subset of "class" values, each value must be preceded
 by a ".", in any order.</P>
 
@@ -657,18 +653,6 @@ pseudo-elements may only appear after the <a
 href="#subject">subject</a> of the selector.
 </p>
 
-<!--
-<p>Although pseudo-elements and pseudo-classes do not exist in the
-document tree, their behavior is defined as if they did. Each
-pseudo-element and pseudo-class may be modeled by a <span
-class="index-def" title="fictional tag sequence"><em>fictional tag
-sequence,</em></span> a fragment of document source that includes
-imaginary elements from the document language. The fictional tag
-sequence is only a model used to describe the rendering effects of
-pseudo-elements and pseudo-classes and does not indicate how these
-should be implemented.
-
-[Too strong. BB]-->
 
 <p>Pseudo-elements and pseudo-class names are case-insensitive.</p>
 
@@ -677,16 +661,6 @@ applied simultaneously to the same element. In case of conflicting
 rules, the normal <a href="cascade.html#cascading-order">cascading
 order</A> determines the outcome.
 
-
-<!--
-<P> Some common typographical effects are associated not with
-structural elements but rather with typographical items as rendered. 
-In CSS2, two such typographical items can be addressed
-through <span class="index-inst"
-title="pseudo-elements">pseudo-elements</span>: the first line of an
-element, and the first letter.
--->
-
 <p><a href="conform.html#conformance">Conforming HTML user agents</a>
 may <span class="index-inst" title="ignore"><a
 href="syndata.html#ignore">ignore</a></span> all rules with :first-line or
@@ -798,9 +772,6 @@ A:link { color: red }
 :link  { color: red }
 </pre>
 
-<!-- What about LINK? Why only A elements (WG still out on 
-this)? What about XML? -IJ -->
-
 <div class="example"><p>
 If the following link:</p>
 
@@ -817,24 +788,6 @@ A.external:visited { color: blue }
 will cause it to be blue.
 </div>
 
-<!--
-<div class="example"><P>
-Here's another example. The following rule:</p>
-
-<pre>
-  P.note:first-letter { color: red }
-</pre>
-
-<P>would make the first letter of all P elements with
-<samp>class="note"</samp> such as the following, the color 'red',
-as in:</p>
-
-<pre class="html-example">
-  &lt;P class="note"&gt;Note: Only valid until December 31.&lt;/P&gt;
-</pre>
-</div>
--->
-
 <h3><a name="dynamic-pseudo-classes">The dynamic pseudo-classes:</a>
 <span class="index-def" title="pseudo-classes:::hover|:hover|hover
 (pseudo-class)">:hover</span>, <span class="index-def"
@@ -961,13 +914,6 @@ HTML:lang(de) { quotes: '
 :lang(de) > Q { quotes: '�' '�' '\2039' '\203A' }
 </pre>
 
-<!-- old example, HWL
-HTML:lang(fr) { quotes: "�" "�"  "\2039"  "\203A"  "\201C" "\201D" }
-HTML:lang(de) { quotes: "�" "�"  "\203A" "\2039"  "\201E" "\201D" }
-[LANG|=fr] > * { quotes: "�" "�"  "\2039"  "\203A"  "\201C" "\201D" }
-[LANG|=de] > * { quotes: "�" "�"  "\203A" "\2039"  "\201E" "\201D" }
--->
-
 <p>The second pair of rules actually set the <span
 class="propinst-quotes">'quotes'</span> property on Q elements
 according to the language of its parent. This is done because the
@@ -1088,7 +1034,7 @@ class="index-inst" title="initial caps">"initial caps"</span> and
 are common typographical effects. This type of initial letter is
 similar to an inline-level element if its <span
 class="propinst-float">'float'</span> property is 'none', otherwise it
-is similar to a floating element.</p>
+is similar to a floated element.</p>
 
 <p>These are the properties that apply to :first-letter
 pseudo-elements: <a href="fonts.html#font-properties">font
@@ -1158,11 +1104,7 @@ which it is attached.</p>
 may approximate font sizes, for example to align baselines. Also, the
 glyph outline may be taken into account when formatting.
 
-<p><!--
-The user agent defines what characters are inside the :first-letter
-element. Removed. 27/2/98 -->
-
-Punctuation (i.e, characters defined in Unicode [[UNICODE]] in the
+<P>Punctuation (i.e, characters defined in Unicode [[UNICODE]] in the
 "open" (Ps), "close" (Pe), and "other" (Po) punctuation classes), that
 precedes the first letter should be included, as in:</p>
 
@@ -1247,26 +1189,6 @@ P.special:first-letter {color: #ffd800}
 <p>This will render the "S" of "Special!" in gold.
 </div>
 
-<!--
-<div class="example"><p>
-The following example illustrates this with the
-<span class="index-inst" title=":first-letter">:first-letter</span>
-pseudo-element.</p>
-
-<pre>
-BODY P:first-letter { color: purple }
-</pre>
-</div>
-
-<div class="example"><p>
-The following example sets the border color to blue of all images that
-descend from A elements that have not yet been visited:</p>
-<pre>
-A:link IMG { border: solid blue }
-</pre>
-</div>
--->
-
 </body>
 </html>
 <!-- Keep this comment at the end of the file
diff --git a/css2/text.src b/css2/text.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html lang="en">
-<!-- $Id: text.src,v 2.19 1998-05-05 20:10:42 bbos Exp $ -->
+<!-- $Id: text.src,v 2.20 1998-05-06 02:27:41 ijacobs Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Text</TITLE>
@@ -390,15 +390,6 @@ H1 { text-transform: uppercase }
 </PRE>
 </div>
 
-<!--
-<H3>Special first letter/first line</H3>
-
-<P>Please consult the sections on <a
-href="./selector.html#first-line">first line</a> and <a
-href="./selector.html#first-letter">first letter</a> for information
-on specially formatting the first letter or line of a paragraph.
--->
-
 <H2><a name="white-space-prop">Whitespace</a>: the <span
 class="propinst-white-space">'white-space'</span> property</H2>
 
@@ -444,24 +435,6 @@ class="propinst-white-space">'white-space'</span> property in author
 and user style sheets but must specify a value for it in the default
 style sheet.
 
-<!--
-<H3>Line breaks</H3>
-
-<p>To force a line break with CSS2, authors may specify one with the
-<a href= "generate.html#before-after-content">':before' or
-':after'</a> pseudo-elements. Thus, the BR element in HTML 
-may be described as follows:</p>
-
-<pre class="example">
-  BR:before { content: "\A"}
-</pre>
-
-<p>See <a href="generate.html">"Generated content and automatic
-numbering"</a> for explanations of the <span class=
-"propinst-content">'content'</span> property and the use of the
-"\A" escape sequence.
--->
-
 </BODY>
 </HTML>
 <!-- Keep this comment at the end of the file
diff --git a/css2/visufx.src b/css2/visufx.src
@@ -7,11 +7,6 @@
 <body>
 <h1 align="center">Visual effects</h1>
 
-<!--
-<P><em>The visual effects discussed in these sections do not alter layout,
-only presentation.</em>
--->
-
 <H2><a name="overflow-clipping">Overflow and clipping</a></H2>
 
 <P>Generally, the content of a block box is confined to the
@@ -127,11 +122,6 @@ BLOCKQUOTE   { width : 125px; height : 100px;
 DIV.attributed-to { text-align : right; }
 </PRE>
 
-<!-- I replaced top and left with margin-top and margin-left, and
-removed position:absolute. Another way to fix the example is to add
-position:relative to DIV, but that would make the example, longer,
-while this made it shorter. BB -->
-
 <P>The initial value of <span
 class="propinst-overflow">'overflow'</span> is 'visible', so
 the BLOCKQUOTE would be formatted without clipping, something like this:</P>
@@ -209,9 +199,6 @@ taken that no pixels remain visible when &lt;left&gt; + &lt;right&gt;
 is equal to the element's width (or &lt;top&gt; + &lt;bottom&gt;
 equals the element's height), and conversely that no pixels remain
 hidden when these values are 0.
-<!-- When converted to pixel coordinates, the bottom-right corner is
-excluded from the clipping rectangle. This rule is necessary to permit
-the definition of zero-width or zero-height rectangles. -->
 </dl>
 
 <P>The element's ancestors may also have clipping regions (in case
