[gs-cvs] rev 8463 - trunk/gs/src

[giles at ghostscript.com]

Author: giles
Date: 2007-12-22 11:13:20 -0800 (Sat, 22 Dec 2007)
New Revision: 8463

Modified:
   trunk/gs/src/gsrefct.h
Log:
Correction to the refcount documentation.

Our allocator can't double free, but attempting to trace a freed pointer
can confuse things, possibly resulting in a segfault or other
misbehaviour.


Modified: trunk/gs/src/gsrefct.h
===================================================================
--- trunk/gs/src/gsrefct.h	2007-12-22 02:05:40 UTC (rev 8462)
+++ trunk/gs/src/gsrefct.h	2007-12-22 19:13:20 UTC (rev 8463)
@@ -41,8 +41,9 @@
  * was the last reference. The difference is that rc_decrement() 
  * also assigns zero to its argument, while rc_decrement_only() 
  * does not. The first must be used if the argument could be traceable 
- * by the allocator to prevent double frees when a garbage collector
- * is running. The second must be used if the pointer is read-only.
+ * by the allocator to avoid examining stale memory when a garbage 
+ * collector runs. The second must be used if the pointer argument
+ * is read-only.
  */
 typedef struct rc_header_s rc_header;
 struct rc_header_s {