title: Python Sphinx autodoc and decorated members
body: <p>I am attempting to use Sphinx to document my Python class. I do so using autodoc:</p>
  
  <pre><code>.. autoclass:: Bus
     :members:
  </code></pre>
  
  <p>While it correctly fetches the docstrings for my methods, those that are decorated:</p>
  
  <pre><code>    @checkStale
      def open(self):
          """
          Some docs.
          """
          # Code
  </code></pre>
  
  <p>with <code>@checkStale</code> being</p>
  
  <pre><code>def checkStale(f):
      @wraps(f)
      def newf(self, *args, **kwargs):
          if self._stale:
              raise Exception
          return f(self, *args, **kwargs)
      return newf
  </code></pre>
  
  <p>have an incorrect prototype, such as <code>open(*args, **kwargs)</code>.</p>
  
  <p>How can I fix this? I was under the impression that using <code>@wraps</code> would fix up this kind of thing.</p>