Added documentation note to remind authors of object type implementations to

keep their objects with valid interpretations...

2 files changed, 7 insertions, 1 deletions

diff --git a/ChangeLog b/ChangeLog
index 0daadde..993b139 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2002-08-16  Donal K. Fellows  <fellowsd@cs.man.ac.uk>
 
+	* doc/ObjectType.3: Added note on the root cause of this problem
+	to the documentation, since it is possible for user code to
+	trigger this sort of behaviour too.
+
 	* generic/tclIOUtil.c (SetFsPathFromAny): Objects should only have
 	their old representation deleted when we know that we are about to
 	install a new one.  This stops a weird TclX bug under Linux with
diff --git a/doc/ObjectType.3 b/doc/ObjectType.3
index 17ce609..2f1285b 100644
--- a/doc/ObjectType.3
+++ b/doc/ObjectType.3
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: ObjectType.3,v 1.6 2002/02/26 02:22:20 hobbs Exp $
+'\" RCS: @(#) $Id: ObjectType.3,v 1.7 2002/08/16 13:45:36 dkf Exp $
 '\" 
 .so man.macros
 .TH Tcl_ObjType 3 8.0 Tcl "Tcl Library Procedures"
@@ -134,6 +134,8 @@ if this succeeds,
 stores the integer in \fIobjPtr\fR's internal representation
 and sets \fIobjPtr\fR's \fItypePtr\fR member to point to the integer type's
 Tcl_ObjType structure.
+Do not release \fIobjPtr\fR's old internal representation unless you
+replace it with a new one or reset the \fItypePtr\fR member to NULL.
 .PP
 The \fIupdateStringProc\fR member contains the address of a function
 called to create a valid string representation