changeset 846:89afd38433e8

docs Ignore-this: 84f3a0144967d1c29399862656da66a9
author drewp@bigasterisk.com
date Tue, 26 Mar 2013 08:24:06 +0000
parents 2bf4b72cb5e8
children 431ddd043b47
files light9/rdfdb/autodepgraphapi.py
diffstat 1 files changed, 8 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/light9/rdfdb/autodepgraphapi.py	Tue Mar 26 08:17:59 2013 +0000
+++ b/light9/rdfdb/autodepgraphapi.py	Tue Mar 26 08:24:06 2013 +0000
@@ -7,8 +7,15 @@
     """
     knockoutjs-inspired API for automatically building a dependency
     tree while reading the graph. See addHandler().
+
+    This design is more aggressive than knockoutjs, since the obvious
+    query methods like value() all error if you're not in a watched
+    section of code. This is supposed to make it easier to notice
+    dependency mistakes, especially when porting old code to use
+    SyncedGraph.
     
-    mixin for SyncedGraph, separated here because these methods work together
+    This class is a mixin for SyncedGraph, separated here because
+    these methods work together
     """
 
     def __init__(self):