Change note.

CHANGES.rst

@@ -16,6 +16,9 @@ Changes
 - ``property.CachedProperty`` is usable as a decorator, with or
   without dependent attribute names.
 
+- ``method.cachedIn`` preserves the documentation string of the
+  underlying function, and everything else that ``functools.wraps`` preserves.
+
 4.1.0 (2014-12-26)
 ------------------
 

src/zope/cachedescriptors/method.py

@@ -14,6 +14,7 @@
 
 from functools import wraps
 
+
 class cachedIn(object):
     """Cached method with given cache attribute."""
 

src/zope/cachedescriptors/method.txt

@@ -17,7 +17,7 @@ computed value:
     ...
     ...     @method.cachedIn('_cache')
     ...     def distance(self, x, y):
-    ...         "Compute the distance"
+    ...         """Compute the distance"""
     ...         print('computing distance')
     ...         return math.hypot(self.x - x, self.y - y)
     ...

src/zope/cachedescriptors/property.py

@@ -56,6 +56,7 @@ def __get__(self, inst, class_):
 
         return value
 
+
 def CachedProperty(*args):
     """
     CachedProperties.