Index: xotcl/doc/langRef.xotcl =================================================================== diff -u -rad8a63234e44a8788efede276e811051ab891fbe -r78e82b3563a644f2df47320eacc693f1b788b03c --- xotcl/doc/langRef.xotcl (.../langRef.xotcl) (revision ad8a63234e44a8788efede276e811051ab891fbe) +++ xotcl/doc/langRef.xotcl (.../langRef.xotcl) (revision 78e82b3563a644f2df47320eacc693f1b788b03c) @@ -1,6 +1,6 @@ -# $Id: langRef.xotcl,v 1.9 2005/09/09 21:09:01 neumann Exp $ -package provide XOTcl-langRef 1.3.6 -package require Tcl +# $Id: langRef.xotcl,v 1.10 2006/02/18 22:17:33 neumann Exp $ +package provide XOTcl-langRef 1.4.0 +package require XOTcl @ @File { description { @@ -67,9 +67,35 @@ is called without arguments. If other arguments are specified for next, these will be used for the call. <@/p> + <@/p><@p> + <@tt>::xotcl::configure filter ?on|off?<@/tt> allows to + turn on or off filters globally for the current interpreter. + By default, the filter state is turned off. + This function returns the old filter state. + This function is needed for the serializer that is intended + to serialize the objects classes independent of filter settings. + <@/p> + <@p> + <@tt>::xotcl::configure softrecreate ?on|off?<@/tt> allows to control + what should happen, when an object / a class is recreated. Per + default it is set off, which means that the object/class is destroyed + and all relations (e.g. subclass/superclass) to other + objects/classes are destroyed as well. If <@tt>softrecreate is + set, the object is resetted, but not destroyed, the relations + are kept. This is important, when e.g. reloading a file + with class definitions (e.g. when used in OpenACS with file watching and + reloading). With <@tt>softrecreate set, + it is not necessary to recreate dependent subclasses etc. +
+ Example: e.g. there is a class hierarchy A <- B <- C + Without <@tt>softrecreate set, a reload of B means + first a destroy of B, leading to A <- C, and instances + of B are reclassed to ::xotcl::Object. When <@tt>softrecreate is + set, the structure remeans unchanged. + <@/p> } - date { $Date: 2005/09/09 21:09:01 $ } + date { $Date: 2006/02/18 22:17:33 $ } } ##