[Python-Dev] query: docstring formatting in python distutils code

Fred Drake fdrake at acm.org
Fri Jul 9 00:01:20 CEST 2010


On Thu, Jul 8, 2010 at 5:42 PM, Alexander Belopolsky
<alexander.belopolsky at gmail.com> wrote:
> I am against mark-up in doc-strings, but this problem can be easily
> solved by placing a magic character at __doc__[0] to indicate that the
> rest is  (mini)reST.

Or __docformat__ can be set appropriately.  See:

    http://www.python.org/dev/peps/pep-0258/#id42


  -Fred

-- 
Fred L. Drake, Jr.    <fdrake at gmail.com>
"A storm broke loose in my mind."  --Albert Einstein


More information about the Python-Dev mailing list