Great Moments in Library Documentation

I present to you the entire documentation for the GObject.chain() function in the PyGTK library:


    def chain(...)

... : additional parameters
Returns : a Python object

The chain() method does something.

So, the function takes some unspecified number of parameters, “does something,” and returns something. (Since everything in Python is an object, saying the function returns an object isn’t particularly informative.)

In other words, pretty much any function you could possibly write can be described by the above documentation.