title: How do I avoid "SEVERE: Duplicate ID" warnings for my autodoc'd modules in Sphinx?
body: <p>I'm using rST/Sphinx to document my Python, however when building it's throwing warnings such as </p>
  
  <pre><code>...Code/doc/code.rst:3: SEVERE: Duplicate ID: "module-toast".
  </code></pre>
  
  <p>My Python source files are documented like so:</p>
  
  <pre><code>#!/usr/bin/env python
  '''
  .. module:: toast
      :synopsis: Processes the blobs produced by :mod:`bread`.
  '''
  # my inline-rST documented code...
  </code></pre>
  
  <p>And the rST files use the autodoc provided <code>automodule</code> directive to pull all the docstrings out and document all the members.</p>
  
  <pre><code>Toast
  --------------------------------
  
  .. automodule:: toast
      :members:
  </code></pre>
  
  <p>The above combo seems to work just fine, but the error seems to imply there is a proper way to do this.  If I remove the module directive from the top of my source file the error goes away, but then I can't add a synopsis option in the source that's picked up by Sphinx.</p>