On Mon, 01 Mar 2010 11:42:16 -0600 Robert Kern <robert.k...@gmail.com> wrote:
> On 2010-03-01 11:22 , Andreas Waldenburger wrote: > > > Back in the software world: Those guys write code that works. It > > does what it's supposed to do. Why should we care where they put > > their comments? > > Software usually needs to be maintained and extended over the course > of its lifetime. The original team that wrote it may not be available > in the future. > > Furthermore, docstrings are not comments. They become part of the > function object and can be introspected at runtime. This is a very > important tool when working with code at the interactive prompt and > for the collection of API documentation. Comments are less useful > than docstrings; the OP's complaint was that his programmers were > putting the function documentation in other places than docstrings, > rendering them less useful than they could have been. > No, the OP complained about those guys being idiots. I should know, because I posted it. /W -- INVALID? DE! -- http://mail.python.org/mailman/listinfo/python-list