Fix ref(), proxy() docstrings, based on comments from David Abrahams.

diff --git a/Modules/_weakref.c b/Modules/_weakref.c
index f797fbf00e7d8499530c420d37e42a8eceb32b1e..68e0d68d2113ac020cf947bda3706d4a2e8edd22 100644 (file)
--- a/Modules/_weakref.c
+++ b/Modules/_weakref.c
@@ -58,9 +58,10 @@ weakref_getweakrefs(PyObject *self, PyObject *object)
 
 
 static char weakref_ref__doc__[] =
-"new(object[, callback]) -- create a weak reference to 'object';\n"
+"ref(object[, callback]) -- create a weak reference to 'object';\n"
 "when 'object' is finalized, 'callback' will be called and passed\n"
-"a reference to 'object'.";
+"a reference to the weak reference object when 'object' is about\n"
+"to be finalized.";
 
 static PyObject *
 weakref_ref(PyObject *self, PyObject *args)
@@ -79,7 +80,7 @@ weakref_ref(PyObject *self, PyObject *args)
 static char weakref_proxy__doc__[] =
 "proxy(object[, callback]) -- create a proxy object that weakly\n"
 "references 'object'.  'callback', if given, is called with a\n"
-"reference to the proxy when it is about to be finalized.";
+"reference to the proxy when 'object' is about to be finalized.";
 
 static PyObject *
 weakref_proxy(PyObject *self, PyObject *args)