Eric Deveaud wrote:
> [EMAIL PROTECTED] wrote:
> >  Like in C we comment like
> >  /*
> >  Bunch of lines of code
> >  */
> >
> >  Should we use docstring """ """
>
> I would say NO.
> docstring are displayed by pydoc, thus a pydoc on your code will display some
> inconsistent information ;-)
>

docstrings are a bit of a magical construct.  Not all strings in a
function are docstrings.

>>> def foo():
...     "real docstring"
...     """
...     x=1
...     """
...     print x
...
>>> help(foo)
Help on function foo in module __main__:

foo()
    real docstring

>>>

-- 
http://mail.python.org/mailman/listinfo/python-list

Reply via email to