Add full documentation. Implement deferred ChildDef to HTMLModule. Add missing attributes for table, switched some to Number. Add necessary includes to module files. Add pre exclusions. Printer now ksorts arrays before output. Exclude ins/del from descendants_are_inline flagging.

git-svn-id: http://htmlpurifier.org/svnroot/htmlpurifier/trunk@717 48356398-32a2-884e-a903-53898d9a118a

library/HTMLPurifier/HTMLModule/List.php

@@ -10,11 +10,14 @@ class HTMLPurifier_HTMLModule_List extends HTMLPurifier_HTMLModule
     
     var $elements = array('dl', 'dt', 'dd', 'ol', 'ul', 'li');
     var $info = array();
-    // technically speaking, the List content set is a fully formed
+    // According to the abstract schema, the List content set is a fully formed
     // one or more expr, but it invariably occurs in an optional declaration
     // so we're not going to do that subtlety. It might cause trouble
     // if a user defines "List" and expects that multiple lists are
     // allowed to be specified, but then again, that's not very intuitive.
+    // Furthermore, the actual XML Schema may disagree. Regardless,
+    // we don't have support for such nested expressions without using
+    // the incredibly inefficient and draconic Custom ChildDef.
     var $content_sets = array('List' => 'dl | ol | ul', 'Flow' => 'List');
     
     function HTMLPurifier_HTMLModule_List() {
@@ -33,6 +36,7 @@ class HTMLPurifier_HTMLModule_List extends HTMLPurifier_HTMLModule
         $this->info['dt']->content_model_type = 'optional';
         $this->info['dl']->content_model = 'dt | dd';
         $this->info['dl']->content_model_type = 'required';
+        // this could be a LOT more robust
         $this->info['li']->auto_close = array('li' => true);
     }