TIP #661 implementation: Disable the Tcl 8 compatibility macros in Tcl 9 by default. Revert TIP #664

1 files changed, 6 insertions, 5 deletions

diff --git a/doc/FileSystem.3 b/doc/FileSystem.3
index 86a46c7..b8766e7 100644
--- a/doc/FileSystem.3
+++ b/doc/FileSystem.3
@@ -270,11 +270,12 @@ allowed for the \fImode\fR argument to the Tcl \fBopen\fR command.
 POSIX-style permission flags such as 0644. If a new file is created, these
 permissions will be set on the created file.
 .AP "Tcl_Size \&| int" *lenPtr out
-Filled with the number of elements in the split path. May be (Tcl_Size *)NULL when not used. If it points to a variable which
-type is not \fBTcl_Size\fR, a compiler warning will be generated, in
-order to indicate that when number of elements is larger than INT_MAX
-this function will return NULL (which should trigger proper error-handling).
-Apart from that, it will function as expected.
+Filled with the number of elements in the split path.
+May be (Tcl_Size *)NULL when not used. If it points to a variable which
+type is not \fBTcl_Size\fR, a compiler warning will be generated.
+If your extensions is compiled with -DTCL_8_API, this function will return
+NULL if the number of elements is larger than INT_MAX (which should
+trigger proper error-handling), otherwise expect it to crash.
 .AP Tcl_Obj *basePtr in
 The base path on to which to join the given elements. May be NULL.
 .AP Tcl_Size objc in