summaryrefslogtreecommitdiffstats
path: root/generic
diff options
context:
space:
mode:
authorvincentdarley <vincentdarley>2001-09-29 11:09:34 (GMT)
committervincentdarley <vincentdarley>2001-09-29 11:09:34 (GMT)
commitc1bf313ccab38b8a3a01c91baf5f02288f604a07 (patch)
tree7dd42cb7c0e0c6bb2d80e9f322e5382a1f342915 /generic
parent02c86dcaaba99b53c26cfa3f1094a84781071c76 (diff)
downloadtcl-c1bf313ccab38b8a3a01c91baf5f02288f604a07.zip
tcl-c1bf313ccab38b8a3a01c91baf5f02288f604a07.tar.gz
tcl-c1bf313ccab38b8a3a01c91baf5f02288f604a07.tar.bz2
fs doc improvement
Diffstat (limited to 'generic')
-rw-r--r--generic/tclIOUtil.c9
1 files changed, 8 insertions, 1 deletions
diff --git a/generic/tclIOUtil.c b/generic/tclIOUtil.c
index f2f3497..57e99b3 100644
--- a/generic/tclIOUtil.c
+++ b/generic/tclIOUtil.c
@@ -17,7 +17,7 @@
* See the file "license.terms" for information on usage and redistribution
* of this file, and for a DISCLAIMER OF ALL WARRANTIES.
*
- * RCS: @(#) $Id: tclIOUtil.c,v 1.21 2001/09/28 01:21:53 dgp Exp $
+ * RCS: @(#) $Id: tclIOUtil.c,v 1.22 2001/09/29 11:09:35 vincentdarley Exp $
*/
#include "tclInt.h"
@@ -2449,6 +2449,13 @@ Tcl_FSLink(pathPtr, toPtr)
* that have been "inserted" into the filesystem will be called in
* succession; each may return a list of volumes, all of which are
* added to the result until all mounted file systems are listed.
+ *
+ * Notice that we assume the lists returned by each filesystem
+ * (if non NULL) have been given a refCount for us already.
+ * However, we are NOT allowed to hang on to the list itself
+ * (it belongs to the filesystem we called). Therefore we
+ * quite naturally add its contents to the result we are
+ * building, and then decrement the refCount.
*
* Results:
* The list of volumes, in an object which has refCount 0.