Docstrings considered too complicated

BlueBird phil at
Wed Mar 3 10:40:24 CET 2010

On Feb 24, 9:23 pm, Andreas Waldenburger <use... at geekmail.INVALID>
> Hi all,
> a company that works with my company writes a lot of of their code in
> Python (lucky jerks). I've seen their code and it basically looks like
> this:
> """Function that does stuff"""
> def doStuff():
>     while not wise(up):
>         yield scorn
> Now my question is this: How do I kill these people without the
> authorities thinking they didn't deserve it?

If they are generating their doc with doxygen, I think it's the right
choice. See:

Oops, after a second look, doxygen needs comments before the function,
not doc strings.


More information about the Python-list mailing list