Right now most functions have properly formatted kerneldoc-style comments. Use them.
Stefano, I feel like I can help with this (already working on it, actually). Let me know if that's OK or if you changed your mind about this. Thanks.