I like both python's and (e)lisp's way of documenting functions on the inside, even though I don't know of any system that does that reads it this way for C, I'm still trying it out.