(1) integrate idl makefile into main makefile;

(2) correct handling of extended attrs on typedefs;
(3) add build info to readme;
(4) remove old, unused python files;
(5) fix redundant status statement in status section;

--HG--
rename : cssom/idl/cssom.js => cssom/cssom-generate-json.js
rename : cssom/idl/cssom.idl => cssom/cssom.idl

Author: skynavga

cssom/Makefile

@@ -1,15 +1,37 @@
 
-ANOLIS = anolis
-PYTHON = python
-NODE = node
-
-XREFS  = data/xrefs/css/cssom.json
-EDFILE = Overview.html
-TRFILE = TR/Overview.html
+ANOLIS		= anolis
+NODE		= node
+
+IDLDRIVER	= cssom.idl
+IDLFRAGS	= idl/CSSFontFaceRule.idl \
+		  idl/CSSImportRule.idl \
+		  idl/CSSMediaRule.idl \
+		  idl/CSSNamespaceRule.idl \
+		  idl/CSSPageRule.idl \
+		  idl/CSSRule.idl \
+		  idl/CSSRuleList.idl \
+		  idl/CSSStyleDeclaration.idl \
+		  idl/CSSStyleRule.idl \
+		  idl/CSSStyleSheet.idl \
+		  idl/Document.idl \
+		  idl/ElementCSSInlineStyle.idl \
+		  idl/LinkStyle.idl \
+		  idl/MediaList.idl \
+		  idl/ProcessingInstruction.idl \
+		  idl/StyleSheet.idl \
+		  idl/StyleSheetList.idl \
+		  idl/Window.idl
+JSONFILE	= cssom.json
+XREFS		= data/xrefs/css/cssom.json
+EDFILE		= Overview.html
+TRFILE		= TR/Overview.html
 
 all: $(EDFILE)
 
-Overview.src.html: cssom-generate.js idl/cssom.json cssom-source
+$(JSONFILE): cssom-generate-json.js $(IDLDRIVER) $(IDLFRAGS)
+	gcc -E -x c -P -Iidl -C $(IDLDRIVER) | node cssom-generate-json.js > $@
+
+Overview.src.html: cssom-generate.js $(JSONFILE) cssom-source
 	$(NODE) cssom-generate.js > $@
 
 $(XREFS): Overview.src.html Makefile
@@ -32,6 +54,7 @@ publish: $(TRFILE)
 clean::
 	$(RM) $(EDFILE)
 	$(RM) Overview.src.html
+	$(RM) $(JSONFILE)
 	echo '{ "definitions": {}, "url": "http://dvcs.w3.org/hg/csswg/raw-file/tip/cssom/Overview.html#" }' > $(XREFS)
 
 

cssom/Overview.html

@@ -17,18 +17,42 @@ and syntax usage) are expected before concluding the above transition.
 
 NOTES FOR EDITORS
 
-1. At the current time, the pre-processor tool requires a modified version of
-WebIDL.js in order to support (1) string valued extended attributes and (2)
-extended attributes on typedefs and other extended attributes, e.g.,
-Constructor.
+1. The primary editor is using MacOSX 10.7.X (Lion) and tools provided via
+MacOSX, e.g., gcc, and MacPorts, e.g., py27-{lxml,html5lib} (used by anolis),
+so if you aren't using this platform or something close to it, you will have
+to account for any differences.
 
-2. At the current time, due to use of the C pre-processor to aggregate IDL
+2. At the current time, the pre-processor tool requires a customized version
+of WebIDL.js in order to support (1) string valued extended attributes and
+(2) extended attributes on typedefs and other extended attributes, e.g.,
+Constructor. See http://github.com/skynavga/webidl.js to obtain this
+customized version.
+
+3. At the current time, due to use of the C pre-processor to aggregate IDL
 file definitions, the value of 'Documentation' extended attributes must not
 contain an unescaped NEWLINE, meaning that values composed of multiple lines
 must use C pre-processor style continuation lines, i.e., end in a backslash
 character. This requirement is temporary and expected to go away in the
 near future.
 
+BUILDING
+
+1. Satisfy all build dependencies (see next section below).
+2. Run make (no arguments).
+3. Open the resulting output file Overview.html.
+
+BUILD DEPENDENCIES
+
+In order to build the CSSOM related specification, you must install and
+configure the following:
+
+* node.js (http://nodejs.org)
+* webidl.js [customized] (http://github.com/skynavga/webidl.js)
+  - must be loadable from node via require()
+* html5.js (http://github.com/aredridel/html5)
+  - must be loadable from node via require()
+* anolis (http://wiki.whatwg.org/wiki/Anolis)
+
 TO DO 
 
 1. IDL Pre-Processor Related
@@ -47,10 +71,3 @@ TO DO
 *  Reorganize content sections, reordering aggregating/dividing as needed.
 *  Fill in implicit TBDs.
 *  Address outstanding bugs.
-
-3. Miscellaneous
-
-*  Push WebIDL.js patch to DAP; push editor's working version to github.
-*  Ensure any necessary changes to HTML5 parser or ANOLIS are posted.
-*  Document custom build tools/process.
-*  Integrate child (IDL) and parent (Overview.html) makefiles.

cssom/Overview.src.html

@@ -83,13 +83,12 @@
   can be found in the
   <a href="http://www.w3.org/TR/">W3C technical reports index at http://www.w3.org/TR/.</a></em>
 
-  <p>This is the [DATE: 3 August 2002] [LONGSTATUS] of CSSOM. Please send
-  comments to
+  <p class="dontpublish">This is the [DATE: 3 August 2002] [LONGSTATUS] of CSSOM. Please send comments to
   <a href="mailto:www-style@w3.org?subject=%5Bcssom%5D%20">www-style@w3.org</a>
   (<a href="http://lists.w3.org/Archives/Public/www-style/">archived</a>)
   with <samp>[cssom]</samp> at the start of the subject line.
 
-  <p>This is the [DATE] First Public Working Draft of CSSOM, produced by the
+  <p class="publish">This is the [DATE] First Public Working Draft of CSSOM, produced by the
   <a href="http://www.w3.org/Style/CSS/members">CSS Working Group</a> (part
   of the <a href="http://www.w3.org/Style/">Style Activity</a>).
   <!--XXX remove "First Public" after initial publication -->

cssom/README

@@ -1,4 +1,5 @@
+typedef
 [Documentation=
  "<p>The {@name} sequence represents an ordered collection of CSS style rules.</p>"
 ]
-typedef sequence<CSSRule> CSSRuleList;
+sequence<CSSRule> CSSRuleList;