Documenting extension modules?

[Francois De Serres]

Hiho,

I can't seem to find a proper way to document my extension module. 
Following the C API doc:

static PyMethodDef ioMethods[] = {
    {"o_count",  o_count, METH_VARARGS, "Return the count of available 
MIDI outputs."},
....
}

lacks:
a) module level documentation
b) function parameters

Also, I'd like to know if there's a typical format for the help string 
(but in C), compatible with docstring's
"""short desription

long description"""

Any pointers please?

TIA,
Francois