2 files changed, 8 insertions, 1 deletions
diff --git a/ChangeLog b/ChangeLog
index f29d7930bc..3734eb3b46 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+Sun Dec  2 16:45:00 2012  Zachary Scott  <zachary@zacharyscott.net>
+
+	* gc.c (WeakMap): Add doc for internal reference, use lib/weakref.rb
+
 Sun Dec  2 07:24:23 2012  Eric Hodel  <drbrain@segment7.net>
 
 	* lib/rdoc/parser.rb:  Parse files with a -*- rdoc -*- modeline
diff --git a/gc.c b/gc.c
index 9e2da52ffc..dfbc82b7b9 100644
--- a/gc.c
+++ b/gc.c
@@ -4412,7 +4412,10 @@ rb_gcdebug_sentinel(VALUE obj, const char *name)
  *  Document-class: ObjectSpace::WeakMap
  *
  *  An ObjectSpace::WeakMap object holds references to
- *  any objects, but those objects can get disposed by GC.
+ *  any objects, but those objects can get be garbage collected.
+ *
+ *  This class is mostly used internally by WeakRef, please use
+ *  +lib/weakref.rb+ for the public interface.
  */
 
 /*  Document-class: GC::Profiler