[css2] Made text more precise. Fixed some minor errors.

bert-github · bert-github · commit 1d892fa69300 · 1998-05-03T23:42:04.000Z
Removed "HTML" from "HTML user agent" (what is an "HTML user agent?)

--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%401626
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.17 1998-04-30 18:29:23 howcome Exp $ -->
+<!-- $Id: text.src,v 2.18 1998-05-03 23:42:04 bbos Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Text</TITLE>
@@ -53,7 +53,7 @@ class="propinst-text-align">'text-align'</span> property</H2>
 
 <!-- #include src=properties/text-align.srb -->
 
-<P>This property describes how a block of text is aligned.  Values
+<P>This property describes how inline content of a block is aligned.  Values
 have the following meanings:</P>
 
 <dl>
@@ -66,25 +66,27 @@ class="value-inst-string"><strong>&lt;string&gt;</strong></span></span>
 align (see the section on <a href="tables.html#column-alignment">
 horizontal alignment in a column</a> for details and an example).
 This value applies <em>only</em> to <a href="tables.html">table</a> 
-columns.
+cells.
 </dl>
 
 <P>A block of text is a stack of <a href="visuren.html#line-box">line
-boxes</a>.  In all cases except for 'justify', this property specifies
+boxes</a>.  In the case of 'left', 'right' and 'center', this property specifies
 how the inline boxes within each line box align with respect to the line
 box's left and right sides; alignment is not with respect to the <a
 href="visuren.html#viewport">viewport</a>.  In the case of 'justify',
 the UA may stretch the inline boxes in addition to adjusting their
-positions.
+positions. (See also <span
+class="propinst-letter-spacing">'letter-spacing'</span> and <span
+class="propinst-word-spacing">'word-spacing'</span>.)
 
 <div class="example"><P> 
 In this example, note that since <span
 class="propinst-text-align">'text-align'</span> is inherited, all
 block-level elements inside the DIV element with 'class=center' will
-be centered. 
+have their inline content centered. 
 
 <PRE>
-  DIV.center { text-align: center }
+DIV.center { text-align: center }
 </PRE>
 </div>
 
@@ -94,7 +96,8 @@ The actual justification algorithm used is user-agent and written language
 dependent.</em>
 
 <P><em><span class="index-inst" title="conformance"><a
-href="conform.html#conformance">Conforming HTML user agents</a></span> may
+href="conform.html#conformance">Conforming <!--HTML [What is an "HTML
+UA"? BB--> user agents</a></span> may
 interpret the value 'justify' as 'left' or 'right', depending on
 whether the element's default writing direction is left-to-right or
 right-to-left, respectively.</em>
@@ -149,7 +152,7 @@ In the following example for HTML, the text content of all
 A elements acting as hyperlinks will be underlined:</p>
 
 <PRE>
-  A[href] { text-decoration: underline }
+A[href] { text-decoration: underline }
 </PRE>
 </div>
 
@@ -201,15 +204,15 @@ have the same color as the element itself, and since no blur radius is
 specified, the text shadow will not be blurred:</p>
 
 <PRE>
-  H1 { text-shadow: 0.2em 0.2em }
+H1 { text-shadow: 0.2em 0.2em }
 </PRE>
 
 <P>The next example will place a shadow to the right and below
 the element's text. The shadow will have a 5px blur radius and will be
 red.
 
 <PRE>
-  H2 { text-shadow: 3px 3px 5px red }
+H2 { text-shadow: 3px 3px 5px red }
 </PRE>
 
 <P>The next example specifies a list of shadow effects. The first
@@ -223,7 +226,7 @@ class="propinst-color">'color'</span>
 property will be used:</p>
 
 <PRE>
-  H2 { text-shadow: 3px 3px red, yellow -3px 3px 2px, 3px -3px }
+H2 { text-shadow: 3px 3px red, yellow -3px 3px 2px, 3px -3px }
 </PRE>
 
 </DIV>
@@ -232,11 +235,11 @@ property will be used:</p>
 <P>Consider this example:
 
 <PRE>
-  SPAN.glow { 
+SPAN.glow { 
     background: white; 
     color: white;
     text-shadow: black 0px 0px 5px;
-  }
+}
 </PRE>
 
 <P>Here, the <span class="propinst-background">'background'</span> and
@@ -250,7 +253,8 @@ property is used to create a "solar eclipse" effect:</p>
 <div class="note"><P>
 <em><strong>Note.</strong>
 This property is not defined in CSS1. Some shadow
-effects may render text invisible in UAs that only support CSS1.
+effects (such as the one in the last example) may render text
+invisible in UAs that only support CSS1.
 </em>
 </div>
 
@@ -265,14 +269,17 @@ text characters. Values have the following meanings:</P>
 
 <dl>
 <dt><strong>normal</strong>
-<dd>This value allows the user agent to alter the space
+<dd>The spacing is the normal spacing for the current font.
+This value allows the user agent to alter the space
 between characters in order to justify text.
 <dt><span class="index-inst" title="&lt;length&gt;"><span
 class="value-inst-length"><strong>&lt;length&gt;</strong></span></span>
 <dd>This value indicates inter-character space <em>in
 addition to</em> the default space between
 characters.  Values may be negative, but there may be
 implementation-specific limits. 
+User agents may not further increase or decrease the inter-character
+space in order to justify text.
 </dl>
 
 <P>Character spacing algorithms are user agent-dependent.  Character
@@ -284,14 +291,14 @@ In this example, the space between characters in
 BLOCKQUOTE elements is increased by '0.1em'.
 
 <PRE>
-  BLOCKQUOTE { letter-spacing: 0.1em }
+BLOCKQUOTE { letter-spacing: 0.1em }
 </PRE>
 
 <P>In the following example, the user agent is not permitted
-to alter inter-character space, nor to add space:</p>
+to alter inter-character space:</p>
 
 <PRE>
-  BLOCKQUOTE { letter-spacing: 0cm }   /* Same as '0' */
+BLOCKQUOTE { letter-spacing: 0cm }   /* Same as '0' */
 </PRE>
 </div>
 
@@ -300,7 +307,7 @@ the default space, user agents should not use
 <span class="index-inst" title="ligatures">ligatures.</span>
 
 <P><span class="index-inst" title="conformance"><a
-href="conform.html#conformance">Conforming HTML user agents</a></span>
+href="conform.html#conformance">Conforming <!--HTML--> user agents</a></span>
 may consider the value of the <span
 class="propinst-letter-spacing">'letter-spacing'</span> property to be
 'normal'.
@@ -312,8 +319,8 @@ Values have the following meanings:</p>
 
 <dl>
 <dt><strong>normal</strong>
-<dd>This value allows the user agent to alter the space
-between words in order to justify text.
+<dd>The normal inter-word space, as defined by the current font and/or
+the UA.
 <dt><span class="index-inst" title="&lt;length&gt;"><span
 class="value-inst-length"><strong>&lt;length&gt;</strong></span></span>
 <dd>This value indicates inter-word space <em>in
@@ -322,21 +329,21 @@ words.  Values may be negative, but there may be
 implementation-specific limits. 
 </dl>
 
-<P>Word spacing algorithms are user agent-dependent.  Word spacing may
-also be influenced by justification (see the <span
+<P>Word spacing algorithms are user agent-dependent.  Word spacing is
+also influenced by justification (see the <span
 class="propinst-text-align">'text-align'</span> property).
 
 <div class="example"><P>
 In this example, the word-spacing between each word in H1 elements is
 increased by '1em'.
 
 <PRE>
-  H1 { word-spacing: 1em }
+H1 { word-spacing: 1em }
 </PRE>
 </div>
 
 <P><span class="index-inst" title="conformance"><a
-href="conform.html#conformance">Conforming HTML user agents</a></span> may
+href="conform.html#conformance">Conforming <!--HTML--> user agents</a></span> may
 consider the value of the <span
 class="propinst-word-spacing">'word-spacing'</span> property to be
 'normal'.
@@ -367,7 +374,7 @@ dependent. See RFC 2070 ([[RFC2070]]) for ways to find the language of
 an element.
 
 <P><span class="index-inst" title="conformance"><a
-href="conform.html#conformance">Conforming HTML user agents</a></span>
+href="conform.html#conformance">Conforming <!--HTML--> user agents</a></span>
 may consider the value of <span
 class="propinst-text-transform">'text-transform'</span> to be 'none'
 for characters that are not from the Latin-1 repertoire and for
@@ -379,7 +386,7 @@ that specified by the case-conversion tables of ISO 10646
 In this example, all text in an H1 element is transformed to uppercase
 text.
 <PRE>
-  H1 { text-transform: uppercase }
+H1 { text-transform: uppercase }
 </PRE>
 </div>
 
@@ -405,29 +412,32 @@ handled. Values have the following meanings:</P>
 <!-- See the HTML definition of whitespace -IJ -->
 <dl>
 <dt><strong>normal</strong>
-<dd>This value allows user agents to collapse sequences
-of whitespace. Line breaks may be created by characters
-or elements (e.g., the BR element in HTML).
+<dd>This value directs user agents to collapse sequences
+of whitespace, and break lines as necessary to fill line boxes.
+Additional line breaks may be created by occurrences of "\A" in
+generated content (e.g., for the BR element in HTML).
 <dt><strong>pre</strong>
 <dd>This value prevents user agents from collapsing sequences
-of whitespace.
+of whitespace. Lines are only broken at newlines in the source, or
+at occurences of "\A" in generated content.
 <dt><strong>nowrap</strong>
-<dd>This value suppresses line breaks within text
-except for those created by other elements (e.g., the
-BR element in HTML).
+<dd>This value collapses whitespace as for 'normal', but suppresses
+line breaks within text except for those created by "\A" in generated
+content (e.g., for the BR element in HTML).
 </dl>
 
 <div class="example"><P> The following examples show what <a
 href="syndata.html#whitespace">whitespace</a> behavior is expected
-from the PRE and P elements in HTML.
+from the PRE and P elements, and the "nowrap" attribute in HTML.
 <PRE>
-  PRE { white-space: pre }
-  P   { white-space: normal }
+PRE        { white-space: pre }
+P          { white-space: normal }
+TD[nowrap] { white-space: nowrap }
 </PRE>
 </div>
 
 <P><span class="index-inst" title="conformance"><a
-href="conform.html#conformance">Conforming HTML user agents</a></span> 
+href="conform.html#conformance">Conforming <!--HTML--> user agents</a></span> 
 may <span class="index-inst" title="ignore"><a
 href="syndata.html#ignore">ignore</a></span> the <span
 class="propinst-white-space">'white-space'</span> property in author
