Author: Philip Jenvey <[email protected]>
Branch: py3k
Changeset: r58978:5db5bc8596ea
Date: 2012-11-17 14:48 -0800
http://bitbucket.org/pypy/pypy/changeset/5db5bc8596ea/

Log:    add some docstrings, some required by test_descr

diff --git a/pypy/module/_io/interp_fileio.py b/pypy/module/_io/interp_fileio.py
--- a/pypy/module/_io/interp_fileio.py
+++ b/pypy/module/_io/interp_fileio.py
@@ -437,7 +437,10 @@
     fileno = interp2app(W_FileIO.fileno_w),
     isatty = interp2app(W_FileIO.isatty_w),
     name = interp_member_w('w_name', cls=W_FileIO),
-    closefd = interp_attrproperty('closefd', cls=W_FileIO),
-    mode = GetSetProperty(W_FileIO.descr_get_mode),
+    closefd = interp_attrproperty(
+        'closefd', cls=W_FileIO,
+        doc="True if the file descriptor will be closed"),
+    mode = GetSetProperty(W_FileIO.descr_get_mode,
+                          doc="String giving the file mode"),
     )
 
diff --git a/pypy/module/_io/interp_iobase.py b/pypy/module/_io/interp_iobase.py
--- a/pypy/module/_io/interp_iobase.py
+++ b/pypy/module/_io/interp_iobase.py
@@ -274,7 +274,8 @@
     _checkReadable = interp2app(check_readable_w),
     _checkWritable = interp2app(check_writable_w),
     _checkSeekable = interp2app(check_seekable_w),
-    closed = GetSetProperty(W_IOBase.closed_get_w),
+    closed = GetSetProperty(W_IOBase.closed_get_w,
+                            doc="True if the file is closed"),
     _checkClosed = interp2app(W_IOBase.check_closed_w),
     __dict__ = GetSetProperty(descr_get_dict, descr_set_dict, cls=W_IOBase),
     __weakref__ = make_weakref_descr(W_IOBase),
diff --git a/pypy/objspace/std/complextype.py b/pypy/objspace/std/complextype.py
--- a/pypy/objspace/std/complextype.py
+++ b/pypy/objspace/std/complextype.py
@@ -221,14 +221,14 @@
     return (space.float_w(space.float(w_complex)), 0.0)
 
 
-def complexwprop(name):
+def complexwprop(name, doc):
     def fget(space, w_obj):
         from pypy.objspace.std.complexobject import W_ComplexObject
         if not isinstance(w_obj, W_ComplexObject):
             raise OperationError(space.w_TypeError,
                                  space.wrap("descriptor is for 'complex'"))
         return space.newfloat(getattr(w_obj, name))
-    return GetSetProperty(fget)
+    return GetSetProperty(fget, doc=doc)
 
 def descr___getnewargs__(space,  w_self):
     from pypy.objspace.std.complexobject import W_ComplexObject
@@ -243,8 +243,9 @@
 This is equivalent to (real + imag*1j) where imag defaults to 0.""",
     __new__ = interp2app(descr__new__),
     __getnewargs__ = interp2app(descr___getnewargs__),
-    real = complexwprop('realval'),
-    imag = complexwprop('imagval'),
+    real = complexwprop('realval', doc="the real part of a complex number"),
+    imag = complexwprop('imagval',
+                        doc="the imaginary part of a complex number"),
     )
 
 complex_typedef.registermethods(globals())
_______________________________________________
pypy-commit mailing list
[email protected]
http://mail.python.org/mailman/listinfo/pypy-commit

Reply via email to