[css2] Corrected spelling, anchors, mark-up, etc.

--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%401890

Author: bert-github

css2/Makefile

@@ -1,6 +1,6 @@
 # Makefile to generate the CSS2 document based on its "source files"
 # Arnaud Le Hors - lehors@w3.org
-# $Id: Makefile,v 2.54 2002-07-05 22:19:35 bbos Exp $
+# $Id: Makefile,v 2.55 2002-07-08 14:57:49 bbos Exp $
 
 # what needs to be set for every new release:
 # Note use of full year (1998) in identifier.
@@ -104,14 +104,10 @@ ALLOBJS= $(SPECOBJS) $(INDEXES) $(IMAGES) $(LONGDESCS) $(STYLESHEETS)
 
 PROPSRC= properties/properties.db
 PROPSAMPLE= properties/sample.db
-DESCSRC= properties/descriptors.db
 PROPBLKSDIR= build/properties
-DESCBLKSDIR= build/descriptors
 
 # dbase for property name anchors
 PROPERTYDB= build/property.db
-# dbase for descriptor name anchors
-DESCRIPTORDB= build/descriptor.db
 # dbase for value types
 VALUEDB= build/value.db
 # dbase for headings
@@ -123,6 +119,7 @@ SED = sed
 #PERL= perl5 -Ibin
 PERL= perl
 NSGMLS=nsgmls
+HTMLDECL = sgml/HTML4.decl
 LINKLINT=$(PERL) bin/linklint
 SPELL = ispell -l -p
 DIFF = diff
@@ -136,7 +133,7 @@ HIPP= $(PERL) ./bin/hipp
 HMKDEPEND= $(PERL) ./bin/hmkdep
 # make value anchor database
 MKANCHDB= $(PERL) ./bin/mkanchdb
-# make property and descriptor anchor database
+# make property anchor database
 MKPANCHDB= $(PERL) ./bin/mkpanchdb
 # add heading anchors
 ADDHANCH= $(PERL) ./bin/addhanch
@@ -148,8 +145,6 @@ ADDNAVBAR= $(PERL) ./bin/addnavbar
 MKIDX= $(PERL) ./bin/mkidx
 # make property index
 MKPROPIDX= $(PERL) ./bin/mkpropidx
-# make descriptor index
-MKDESCIDX= $(PERL) ./bin/mkdescidx
 # make table of contents and heading database
 MKTOC= $(PERL) ./bin/mktoc
 # HTML concate utility
@@ -164,8 +159,6 @@ INSAFTER= $(PERL) ./bin/insafter
 ADDLINKS= $(PERL) ./bin/addlinks
 # extract properties from db.
 PEXTR= $(PERL) ./bin/pextr
-# extract descriptors from db.
-DEXTR= $(PERL) ./bin/dextr
 # extract issues from issues db.
 ISSUES= bin/issues
 # extract issues from errata-issues db.
@@ -178,7 +171,7 @@ CHKSAMPLE= $(PERL) ./bin/chksample
 MKREFDB = $(PERL) ./bin/mkrefdb
 # check references.
 CHKREFS= $(PERL) ./bin/chkrefs
-# check property/descriptor defs and instances
+# check property defs and instances
 CHKPROPS= $(PERL) ./bin/chkprops
 # add reference normative/informative class info.
 CHKSPACES= $(PERL) ./bin/chkspaces
@@ -237,7 +230,7 @@ LN= ln
 #%.html: %.subtoc Project.cfg
 %.html: %.subtoc $(MAINSRCS:.src=.srd) $(APPSRCS:.src=.srd) Project.cfg #$(SPECSRCS:.src=.srd)
 	@echo "=========== making" $@
-	$(ADDLINKS) $(VALUEDB) $*.srd propinst-/propdef- descinst-/descdef- value-inst-/value-def- |\
+	$(ADDLINKS) $(VALUEDB) $*.srd propinst-/propdef- value-inst-/value-def- |\
 	$(ADDIDXANCH) -r $@ $(INDEXDB) - |\
 	$(ADDMARKUP) - |\
 	$(ADDLONGDESC) - |\
@@ -252,8 +245,6 @@ LN= ln
 	$(ADDHANCH) -r $*.html $(HEADINGDB) - $@
 	$(MKANCHDB) -r $*.html value-def- $(VALUEDB) $@
 	$(MKANCHDB) -r $*.html propdef- $(VALUEDB) $@
-	$(MKANCHDB) -r $*.html descdef- $(VALUEDB) $@
-	$(MKANCHDB) -r $*.html descdef- $(VALUEDB) $@
 
 .idraw.gif:
 	$(RM) $@
@@ -348,9 +339,9 @@ css2.zip: $(ALLOBJS)
 	$(ZIP) $@ $(ALLOBJS) images/*.png
 #	$(ZIP) $@ $(ALLOBJS) `$(LS) -d images/*.png | $(GREP) -v "\."` 
 
-#### Section generate property/descriptor tables from property database.
+#### Section generate property tables from property database.
 
-build/blocks.ok: $(PROPBLKSDIR)/blocks.ok $(DESCBLKSDIR)/blocks.ok
+build/blocks.ok: $(PROPBLKSDIR)/blocks.ok
 	touch $@
 
 $(PROPBLKSDIR)/blocks.ok: $(PROPSRC)
@@ -359,21 +350,6 @@ $(PROPBLKSDIR)/blocks.ok: $(PROPSRC)
 	$(PEXTR) -n $(PROPSAMPLE) $(PROPBLKSDIR)
 	touch $@
 
-$(DESCBLKSDIR)/blocks.ok: $(DESCSRC)
-	@if [ ! -d $(DESCBLKSDIR) ]; then mkdir -p $(DESCBLKSDIR);fi
-	$(DEXTR) $(DESCSRC) $(DESCBLKSDIR)
-	touch $@
-
-
-#build/value.db.ok: $(MAINSRCS) $(APPSRCS)
-#	@echo "=========== making" $@
-#	$(MKANCHDB) value-def- $(VALUEDB) $(MAINSRCS) $(APPSRCS:.src=.srd)
-#	# $(SPECSRCS:.src=.srd)
-#	$(MKANCHDB) propdef- $(VALUEDB) $(MAINSRCS:.src=.srd) $(APPSRCS:.src=.srd)
-#	# $(SPECSRCS:.src=.srd)
-#	$(MKANCHDB) descdef- $(VALUEDB) $(MAINSRCS:.src=.srd) $(APPSRCS:.src=.srd)
-#	# $(SPECSRCS:.src=.srd)
-#	touch $@
 
 cover.srd: cover.src build/contents.srb build/minicontents.srb
 	@echo "=========== making" $@
@@ -425,27 +401,6 @@ propidx.srd:: build/propidx.srb #propidx.src
 #	@echo "=========== making" $@
 #	$(HIPP) $(INCLUDES) $< $@
 
-#propidx.html: propidx.srd Project.cfg
-#	@echo "=========== making" $@
-#	$(ADDHANCH) -r $*.html $(HEADINGDB) $*.srd |\
-#	$(ADDLINKS) -x $(VALUEDB) - propinst-/propdef- descinst-/descdef- value-inst-/value-def- |\
-#	$(ADDNAVBAR) -r $@ |\
-#	$(MKCHAIN) -r $@ - $@
-
-build/descidx.srb: $(MAINSRCS) $(APPSRCS)
-	@echo "=========== making" $@
-	$(MKDESCIDX) -r $@ $@ $(DESCSRC)
-
-descidx.srd:: build/descidx.srb #descidx.src
-#	$(HIPP) $(INCLUDES) $< $@
-
-#descidx.html: descidx.srd Project.cfg
-#	@echo "=========== making" $@
-#	$(ADDHANCH) -r $*.html $(HEADINGDB) $*.srd |\
-#	$(ADDLINKS) -x $(VALUEDB) - propinst-/propdef- descinst-/descdef- value-inst-/value-def- |\
-#	$(ADDNAVBAR) -r $@ |\
-#	$(MKCHAIN) -r $@ - $@
-
 # Issues and todo lists.
 issues.html: issues.src build/issues.srb
 	@echo "=========== making" $@
@@ -482,7 +437,7 @@ checkdoc: all
 	-@echo "# Begin checking sgml."
 	@for i in $(FILES) $(LONGDESCS); \
 	do echo checking $$i...; \
-           $(NSGMLS) -s -c sgml/HTML4.cat $$i; done;
+           $(NSGMLS) -s -c sgml/HTML4.cat $(HTMLDECL) $$i; done;
 	-@echo "# End checking sgml."
 
 ### check on the validity references in the document
@@ -524,13 +479,10 @@ checklnx: all
 
 ### check property instances
 
-checkprops: $(SPECSRCS) $(PROPSRC) $(DESCSRC)
+checkprops: $(SPECSRCS) $(PROPSRC)
 	-@echo "# Begin checking properties."
 	-@$(CHKPROPS) $(PROPSRC) propinst $(SPECSRCS)
 	-@echo "# End checking properties."
-	-@echo "# Begin checking descriptors."
-	-@$(CHKPROPS) $(DESCSRC) descinst $(SPECSRCS)
-	-@echo "# End checking descriptors."
 
 # Check spaces
 
@@ -551,7 +503,7 @@ build/checkx.out: build/xamples.ok
 	-@echo Begin checking HTML examples.
 	-@for i in build/?*xampl*.html ; \
 	do echo checking $$i...; \
-	   $(NSGMLS) -s -c sgml/HTML4.cat sgml/HTML4.decl $$i >> build/checkx.out 2>&1; \
+	   $(NSGMLS) -s -c sgml/HTML4.cat $(HTMLDECL) $$i >> build/checkx.out 2>&1; \
 	done;
 	-@echo Begin checking CSS examples.
 	$(CHKCSS) build/?*xampl*.css >> build/checkx.out 2>&1
@@ -575,7 +527,7 @@ clean:
 	$(RM) $(SPECOBJS) $(INDEXES) $(PROPBLKSDIR)/* \
 	$(SPECOBJS:.html=.srd) $(SPECOBJS:.html=.subtoc) \
         $(INDEXES:.html=.srd) \
-        $(DESCBLKSDIR)/* build/* css2.* linklint images/links.ok images/pngs.ok
+        build/* css2.* linklint images/links.ok images/pngs.ok
 
 realclean: clean
 

css2/Project.cfg

@@ -10,7 +10,7 @@
 # value contains spaces.
 #
 # Bert Bos <bert@w3.org>
-# $Id: Project.cfg,v 2.8 2002-07-05 19:58:04 bbos Exp $
+# $Id: Project.cfg,v 2.9 2002-07-08 14:57:50 bbos Exp $
 
 @source-extension .src
 
@@ -54,9 +54,9 @@
 
 @format "\Append\ix A." "A.1" "A.1.1" "" "" "" 
 @chapter aural.html
-@chapter sample.html
-@chapter changes.html
 @chapter refs.html
+@chapter changes.html
+@chapter sample.html
 @chapter propidx.html 
 @chapter indexlist.html
 @chapter grammar.html

css2/about.src

@@ -2,13 +2,53 @@
   'http://www.w3.org/TR/html4/strict.dtd'>
 
 <html lang="en">
-<!-- $Id: about.src,v 2.36 2002-07-05 19:58:04 bbos Exp $ -->
+<!-- $Id: about.src,v 2.37 2002-07-08 14:57:50 bbos Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>About the CSS2.1 Specification</TITLE>
 </HEAD>
 <BODY>
-<H1 align="center">About the CSS2.1 Specification</H1>
+<H1>About the CSS2.1 Specification</H1>
+
+<h2>CSS&nbsp;2.1 vs CSS&nbsp;2</h2>
+
+<p>The CSS community has gained significant experience with the CSS2
+specification since it became a recommendation in 1998. Errors in the
+CSS2 specification have subsequently been corrected via the
+publication of various errata, but there has not yet been an
+opportunity for the specification to be changed based on experience
+gained.
+
+<p>While many of these issues will be addressed by the upcoming CSS3
+specifications, the current state of affairs hinders the
+implementation and interoperability of CSS2. The CSS2.1 specification
+attempts to address this situation by:
+
+<ul>
+<li>Maintaining compatibility with those portions of CSS2 that are
+widely accepted and implemented.
+   
+<li>Incorporating all published CSS2 errata.
+
+<li>Where implementations overwhelmingly differ from the CSS2
+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. Thus, compliant
+implementations of CSS2.1 need not be burdened with these constraints.
+  
+<li>Removing CSS2 features that will be obsoleted by CSS3, thus
+encouraging adoption of the proposed CSS3 features in their place.
+</ul>
+
+<p>Thus, while it is not the case that a CSS2 stylesheet is
+necessarily forwards-compatible with CSS2.1, it is the case that a
+stylesheet restricting itself to CSS2.1 features is more likely to
+find a compliant user agent today and to preserve forwards
+compatibility in the future. While breaking forward compatibility is
+not desirable, we believe the advantages to the revisions in CSS2.1
+are worthwhile.
 
 <h2>Reading the specification</h2>
 
@@ -64,13 +104,11 @@ href="conform.html#conformance">conformance</a>.
 
 <dd>Appendixes contain information about <a href="sample.html">a
 sample style sheet for HTML 4.0</a>, <a href="changes.html">changes
-from CSS1 </a>, <a href="notes.html">implementation and
-performance notes</a>, 
+from CSS1 </a>,
 <a href="grammar.html">the grammar of CSS2</a>, 
 a list of normative and informative <a href="refs.html">references</a>,
-and three indexes: one for
-<a href="propidx.html">properties</a>, one for
-<a href="descidx.html">descriptors</a>, and one
+and two indexes: one for
+<a href="propidx.html">properties</a> and one
 <a href="indexlist.html">general index</a>.
 </dl>
 
@@ -176,7 +214,7 @@ the following modifiers:</p>
 
 <P>The following examples illustrate different value types:
 
-<BLOCKQUOTE>
+<BLOCKQUOTE><P>
     <EM>Value:</EM> N | NW | NE<BR>
     <EM>Value:</EM> [ &lt;length&gt; | thick | thin ]{1,4}<BR>
     <EM>Value:</EM> [&lt;family-name&gt; , ]* &lt;family-name&gt;<BR>
@@ -356,7 +394,9 @@ thereof.</p>
 
 <p>No right to create modifications or derivatives of W3C documents is
 granted pursuant to this license. However, if additional requirements
-(documented in the <a href="IPR-FAQ.html">Copyright FAQ</a>) are satisfied,
+(documented in the <a
+href="http://www.w3.org/Consortium/Legal/IPR-FAQ.html">Copyright
+FAQ</a>) are satisfied,
 the right to create modifications or derivatives is�sometimes granted by the
 W3C to individuals complying with those requirements.</p>
 

css2/aural.src

@@ -2,7 +2,7 @@
   'http://www.w3.org/TR/html4/strict.dtd'>
 
 <html lang="en">
-<!-- $Id: aural.src,v 2.34 2002-07-05 22:19:35 bbos Exp $ -->
+<!-- $Id: aural.src,v 2.35 2002-07-08 14:57:50 bbos Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Aural style sheets</TITLE>
@@ -883,10 +883,10 @@ a:visited     { voice-family: betty, female }
 a:active      { voice-family: betty, female; pitch-range: 80; pitch: x-high }
 </pre>
 
-<h2><a name="emacsspeak">Emacsspeak</a></h2>
+<h2><a name="emacspeak">Emacspeak</a></h2>
 
 <p>For information, here is the list of properties implemented by
-Emacsspeak, a speech subsystem for the Emacs editor.
+Emacspeak, a speech subsystem for the Emacs editor.
 
 <ul>
 <li>voice-family