[ff-cvs] fenfire/docs/pegboard/functional_futureproof_ap...

[Tuomas J. Lukka]

CVSROOT:        /cvsroot/fenfire
Module name:    fenfire
Branch:         
Changes by:     Tuomas J. Lukka <address@hidden>        03/09/05 05:43:46

Modified files:
        docs/pegboard/functional_futureproof_api--tjl: peg.rst 

Log message:
        morefunctional

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/fenfire/fenfire/docs/pegboard/functional_futureproof_api--tjl/peg.rst.diff?tr1=1.2&tr2=1.3&r1=text&r2=text

Patches:
Index: fenfire/docs/pegboard/functional_futureproof_api--tjl/peg.rst
diff -u fenfire/docs/pegboard/functional_futureproof_api--tjl/peg.rst:1.2 
fenfire/docs/pegboard/functional_futureproof_api--tjl/peg.rst:1.3
--- fenfire/docs/pegboard/functional_futureproof_api--tjl/peg.rst:1.2   Fri Sep 
 5 05:31:01 2003
+++ fenfire/docs/pegboard/functional_futureproof_api--tjl/peg.rst       Fri Sep 
 5 05:43:46 2003
@@ -3,8 +3,8 @@
 =============================================================
 
 :Author:   Tuomas J. Lukka
-:Last-Modified: $Date: 2003/09/05 09:31:01 $
-:Revision: $Revision: 1.2 $
+:Last-Modified: $Date: 2003/09/05 09:43:46 $
+:Revision: $Revision: 1.3 $
 :Status:   Incomplete
 
 Functions and caching are here to stay with us. 
@@ -87,6 +87,14 @@
   objects that obey the special restrictions associated with that,
   if any are needed.
 
+- How should we specify placeholder objects for super-lazy caches?
+  Placeholders can be on two levels, either the function level or instance 
level.
+
+  RESOLUTION: For now, only function level. Hints object will have a 
setPlaceholder
+  call.
+
+
+
 Changes
 =======
 
@@ -147,10 +155,24 @@
             * of the given group if it's not run directly.
             * This is useful for using Libvob OpenGL, since 
             * OpenGL objects should only be handled in one thread.
+            * Default: null.
             */
            void setBackgroundGroup(Object id);
-           /**
+
+           /** Whether this function usually consumes considerable time
+            * to generate its output, given all its inputs.
+            * Evaluations of functions given as parameters to this function
+            * are not counted.
+            * Default: not slow.
+            */
            void setSlow(boolean isSlow);
+
+           /** Set the placeholder object to be returned if the function value
+            * is not ready yet.
+            * Default: null.
+            */
+           void setPlaceholder(Object o);
+
            /** Create the Hints object.
             */
            Hints make();