Commits

Anonymous committed 47183b8

Improved the comments on the various *page-* variabes, to indicate correctly their current usage

  • Participants
  • Parent commits 754d8ee

Comments (0)

Files changed (1)

 
 (defvar *page-scripts*
       ()
-  "A list of tag type names (symbols) for tags that wish to include shared scripts on the page"
+  "A list of strings, each representing a script added to the page"
       )
 
 (defvar *page-ready-scripts*
       ()
-  "A list of tag type names (symbols) for tags that wish to include shared ready scripts on the page"
+  "A list of strings, each representing script to be run when the document is ready (after load)"
       )
 
 (defvar *page-styles*
   ()
-  "A list of tag type names (symbols) for tags that wish to include shared styles on the page"
+  "A list of strings, each representing CSS added to the page"
   )
 
 (defvar *page-style-sheets*
       ()
-  "A list of tag type names (symbols) for tags that wish to include shared stylesheets on the page"
+  "A list of strings, each pointing to a styleseheet that the page referneces"
       )
 (defvar *page-script-libraries*
       ()
-  "A list of tag type names (symbols) for tags that wish to include shared script libraries on the page"
+  "A list of strings, each pointing to a script library that the page referneces"
       )
 
 ;;;------------------------------------------------------------------------------------
 (defgeneric render-tag-ready-scripts (*current-tag*)
   (:documentation
     "Return a string representing script to run when a page
-     first loads
+     first loads.  During rendering, scripts are accumulated by visiting each tag
+     in the page (depth, then breadth), and adding each unique script
+     (based on string comparison) to the end of a list.  Consequently,
+     outer tags have their ready script run before inner tags.
     "
     )
   )