diff options
| author | dkf <donal.k.fellows@manchester.ac.uk> | 2021-04-26 07:58:16 (GMT) |
|---|---|---|
| committer | dkf <donal.k.fellows@manchester.ac.uk> | 2021-04-26 07:58:16 (GMT) |
| commit | 8d556345fd97eb9d60d2e7e1e372e1cc52939ff5 (patch) | |
| tree | 6a816b87f19ec34be25a0f50066990db21455624 /doc/TraceVar.3 | |
| parent | aa1949c4f3d10fedc5209ff5c34a9f6d2442293e (diff) | |
| parent | 42a77f7b4b1e4f3699d71cd2cf9fe6de7e9e4d71 (diff) | |
| download | tcl-8d556345fd97eb9d60d2e7e1e372e1cc52939ff5.zip tcl-8d556345fd97eb9d60d2e7e1e372e1cc52939ff5.tar.gz tcl-8d556345fd97eb9d60d2e7e1e372e1cc52939ff5.tar.bz2 | |
merge core-8-branch
Diffstat (limited to 'doc/TraceVar.3')
| -rw-r--r-- | doc/TraceVar.3 | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/TraceVar.3 b/doc/TraceVar.3 index dd72563..649565a 100644 --- a/doc/TraceVar.3 +++ b/doc/TraceVar.3 @@ -360,6 +360,14 @@ Traces on a variable are always removed whenever the variable is deleted; the only time \fBTCL_TRACE_DESTROYED\fR is not set is for a whole-array trace invoked when only a single element of an array is unset. +.SH "REFERENCE COUNT MANAGEMENT" +.PP +When a \fIproc\fR callback is invoked, and that callback was installed with +the \fBTCL_TRACE_RESULT_OBJECT\fR flag, the result of the callback is a +Tcl_Obj reference when there is an error. The result will have its reference +count decremented once when no longer needed, or may have additional +references made to it (e.g., by setting it as the interpreter result with +\fBTcl_SetObjResult\fR). .SH BUGS .PP Array traces are not yet integrated with the Tcl \fBinfo exists\fR command, |