title: How to document multiple return values using reStructuredText in Python 2?
body: <p>The <a href="https://docs.python.org/devguide/documenting.html" rel="noreferrer">Python docs</a> say that "the markup used for the Python documentation is <a href="http://docutils.sf.net/rst.html" rel="noreferrer">reStructuredText</a>". My question is: How is a block comment supposed to be written to show multiple return values?</p>
  
  <pre><code>def func_returning_one_value():
      """Return just one value.
  
      :returns: some value
      :rtype: str
      """
  
  def func_returning_three_values():
      """Return three values.
  
      How do I note in reStructuredText that three values are returned?
      """
  </code></pre>
  
  <p>I've found a <a href="http://thomas-cokelaer.info/tutorials/sphinx/docstring_python.html" rel="noreferrer">tutorial</a> on Python documentation using reStructuredText, but it doesn't have an example for documenting multiple return values. The <a href="http://www.sphinx-doc.org/en/stable/domains.html" rel="noreferrer">Sphinx docs on domains</a> talks about <code>returns</code> and <code>rtype</code> but doesn't talk about multiple return values.</p>