Transition to new IDL pre-processor.

Author: skynavga

cssom/Makefile

@@ -1,15 +1,16 @@
 
 ANOLIS = anolis
 PYTHON = python
+NODE = node
 
 XREFS  = data/xrefs/css/cssom.json
 EDFILE = Overview.html
 TRFILE = TR/Overview.html
 
 all: $(EDFILE)
 
-Overview.src.html: cssom-source cssom-generate.py
-	$(PYTHON) cssom-generate.py
+Overview.src.html: cssom-generate.js idl/cssom.json cssom-source
+	$(NODE) cssom-generate.js > $@
 
 $(XREFS): Overview.src.html Makefile
 	$(ANOLIS) --dump-xrefs=$@ $< /tmp/spec; $(RM) /tmp/spec

cssom/Overview.html

@@ -0,0 +1,57 @@
+SUMMARY
+
+The CSSOM specifications are in the process of being transitioned from a
+predominantly ANOLIS based processing tool to a combination of (1) a custom
+pre-processor tool that uses WebIDL.js and (2) ANOLIS as a post-processor.
+The goal of this change is to shift from using WebIDL embedded in HTML to HTML
+embedded in WebIDL for the purpose of defining the source IDL specification
+content. In the editors' opinion, this change permits better (automatic)
+verification of IDL correctness along with subsequent HTML correctness.
+
+More documentation on this custom tool will be provided before publishing a
+new WD of the CSSOM specifications. So please remain patient if you are
+looking for more details.
+
+Note that substantial changes to the custom tool (organization, processing,
+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.
+
+2. 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.
+
+TO DO 
+
+1. IDL Pre-Processor Related
+
+*  Enumerate constructors in a manner similar to attributes/operations.
+*  Perform keyword substitution in constructor documentation.
+*  Enumerate constant members.
+*  Generate typedef and implements definitions.
+*  Generate extended attributes, e.g., PutForwards, NoInterfaceObject, etc.
+*  Generate setters, getters (not presently used in CSSOM IDL definitions).
+*  Remove coded-in file names (e.g., cssom.json), accepting on command line.
+
+2. Content Related
+
+*  Substitute correct W3C copyright notice.
+*  Restore named properties (i.e., CSS2Properties) on CSSStyleDeclaration.
+*  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.