title: Which class attributes does Pydoc document?
body: <p>I know pydoc can generate documentation for public (not prefixed) methods of a python class. But how can I generate documentation for attributes?</p>
  <p>For example, you can see that pydoc creates documentation for 3 methods and 2 attributes:</p>
  <ul>
  <li><code>__dict__</code></li>
  <li><code>__weakref__</code></li>
  </ul>
  <p>So, my two questions</p>
  <ol>
  <li>Why does __dict__  have no real information? Wouldn't it have information about class attributes?</li>
  <li>If all attributes of a python class are in __dict__, then how can I get at documentation for these public attributes?</li>
  </ol>
  <blockquote>
  <pre><code>class ImageReader(builtins.object)
   |  Helper class that provides TensorFlow image coding utilities.
   |  
   |  Methods defined here:
   |  
   |  __init__(self)
   |      Create a Reader for reading image information.
   |  
   |  decode_image(self, sess, image_data)
   |      Decode jpeg image.
   |  
   |  read_image_dims(self, sess, image_data)
   |      Read dimension of image.
   |  
   |  ----------------------------------------------------------------------
   |  Data descriptors defined here:
   |  
   |  __dict__
   |      dictionary for instance variables (if defined)
   |  
   |  __weakref__
   |      list of weak references to the object (if defined)
  </code></pre>
  </blockquote>