From: Mauricio Fernandez <mfp@...>
Date: 2006-07-30T00:49:27+09:00
Subject: Re: doc patch: weakref.

On Sat, Jul 29, 2006 at 07:37:24PM +0900, Daniel Berger wrote:
> Yukihiro Matsumoto wrote:
> >|Something about this phrase bothers me.  How about simply, "A weak
> >|reference class that does not perform garbage collection".
> >
> >But it's not true.  WeakRef class or any other class does not perform
> >garbage collection.  Garbage collector does.  WeakRef is a class to
> >represent reference to the object that is not seen by tracing phase of
> >the garbage collector.
> >
> Then your description (slightly tweaked) is what we want. :)
> 
> "WeakRef is a class to represent a reference to an object that is not seen 
> by the tracing phase of the garbage collector."
> 
> How about that?

Some people don't know how Ruby's GC works, or even what a mark&sweep GC is.
They wouldn't understand what the above means (maybe).

"WeakRef is a class to represent a reference to an object that may be
reclaimed by the GC. The WeakRef is invalidated when this happens."

-- 
Mauricio Fernandez  -   http://eigenclass.org   -  singular Ruby