How to document multiple return values using reStructuredText in Python 2?
<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>