[py-svn] r36990 - py/dist/py/apigen

[hpk at codespeak.net]

Author: hpk
Date: Fri Jan 19 14:27:37 2007
New Revision: 36990

Modified:
   py/dist/py/apigen/todo-apigen.txt
Log:
made two notes about conceptually improving the
dependency/test situation


Modified: py/dist/py/apigen/todo-apigen.txt
==============================================================================
--- py/dist/py/apigen/todo-apigen.txt	(original)
+++ py/dist/py/apigen/todo-apigen.txt	Fri Jan 19 14:27:37 2007
@@ -33,5 +33,36 @@
 * look out for and streamline all apigen/source-viewer
   documentation into one document 
 
-* XXX list more here 
 
+
+* consider automating dependencies: 
+
+  e.g. something like: queue_render(page, fspath, linker, ...) 
+  would defer the rendering until later. 
+  then a loop does:
+
+  maxlength = len(queue)
+  while queue: 
+       page, fspath, linker, ... = queue.get()
+       # fill outputpath/link here or even earlier
+       if all_links_resolve(page, linker): 
+           render it and write to filesystem
+           maxlength = len(queue) 
+       else:
+           queue.append(...)
+           maxlength -= 1
+           if maxlength <= 0:  
+               print "ERROR: seems i can't make progress"
+               print "unresolved links follow: "
+               ... 
+               print "unresolved pages/fspaths:"
+               ... 
+               XXX maybe: print "filling linker with dummy hrefs, and rendering anyway"
+               ... 
+               raise ... 
+
+* also we might have a support function for tests that
+  fills the linker with "dummy hrefs" for certain types
+  like source links
+       
+* XXX list more here