summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authordgp <dgp@users.sourceforge.net>2017-11-03 18:56:33 (GMT)
committerdgp <dgp@users.sourceforge.net>2017-11-03 18:56:33 (GMT)
commit88451d16ba54b6db1e2a6c35e1487a6c06e36639 (patch)
tree4e9c19cc0d39b2ec69489443f4d28c96757328f6 /doc
parent3691ae66b666ee599cb71bf5f0076c613514b96f (diff)
parentb0a9f6c55b529b1b7ad08fabce66218512634149 (diff)
downloadtcl-88451d16ba54b6db1e2a6c35e1487a6c06e36639.zip
tcl-88451d16ba54b6db1e2a6c35e1487a6c06e36639.tar.gz
tcl-88451d16ba54b6db1e2a6c35e1487a6c06e36639.tar.bz2
TIPs 330 & 336 changes to Tcl 9 Implementation
Diffstat (limited to 'doc')
-rw-r--r--doc/Interp.313
-rw-r--r--doc/SaveResult.34
-rw-r--r--doc/SetResult.313
3 files changed, 2 insertions, 28 deletions
diff --git a/doc/Interp.3 b/doc/Interp.3
index 731007b..daf76fb 100644
--- a/doc/Interp.3
+++ b/doc/Interp.3
@@ -33,19 +33,6 @@ the pointer as described below is no longer supported. The supported
public routines \fBTcl_SetResult\fR, \fBTcl_GetResult\fR,
\fBTcl_SetErrorLine\fR, \fBTcl_GetErrorLine\fR must be used instead.
.PP
-For legacy programs and extensions no longer being maintained, compiles
-against the Tcl 8.6 header files are only possible with the compiler
-directives
-.CS
-#define USE_INTERP_RESULT
-.CE
-and/or
-.CS
-#define USE_INTERP_ERRORLINE
-.CE
-depending on which fields of the \fBTcl_Interp\fR struct are accessed.
-These directives may be embedded in code or supplied via compiler options.
-.PP
The \fIresult\fR and \fIfreeProc\fR fields are used to return
results or error messages from commands.
This information is returned by command procedures back to \fBTcl_Eval\fR,
diff --git a/doc/SaveResult.3 b/doc/SaveResult.3
index b2270a2..6dd6cb6 100644
--- a/doc/SaveResult.3
+++ b/doc/SaveResult.3
@@ -54,9 +54,9 @@ is called, Tcl will take care of memory management.
.PP
The second triplet stores the snapshot of only the interpreter
result (not its complete state) in memory allocated by the caller.
-These routines are passed a pointer to a \fBTcl_SavedResult\fR structure
+These routines are passed a pointer to \fBTcl_SavedResult\fR
that is used to store enough information to restore the interpreter result.
-This structure can be allocated on the stack of the calling
+\fBTcl_SavedResult\fR can be allocated on the stack of the calling
procedure. These routines do not save the state of any error
information in the interpreter (e.g. the \fB\-errorcode\fR or
\fB\-errorinfo\fR return options, when an error is in progress).
diff --git a/doc/SetResult.3 b/doc/SetResult.3
index e5b81d7..545787c 100644
--- a/doc/SetResult.3
+++ b/doc/SetResult.3
@@ -197,19 +197,6 @@ It also sets \fIinterp->freeProc\fR to zero, but does not
change \fIinterp->result\fR or clear error state.
\fBTcl_FreeResult\fR is most commonly used when a procedure
is about to replace one result value with another.
-.SS "DIRECT ACCESS TO INTERP->RESULT"
-.PP
-It used to be legal for programs to
-directly read and write \fIinterp->result\fR
-to manipulate the interpreter result. The Tcl headers no longer
-permit this access by default, and C code still doing this must
-be updated to use supported routines \fBTcl_GetObjResult\fR,
-\fBTcl_GetStringResult\fR, \fBTcl_SetObjResult\fR, and \fBTcl_SetResult\fR.
-As a migration aid, access can be restored with the compiler directive
-.CS
-#define USE_INTERP_RESULT
-.CE
-but this is meant only to offer life support to otherwise dead code.
.SH "THE TCL_FREEPROC ARGUMENT TO TCL_SETRESULT"
.PP
\fBTcl_SetResult\fR's \fIfreeProc\fR argument specifies how