More soon; for starters, please re-read the XP-COM document.
We're going to generate lots of stuff from XPIDL, including XPCOM headers, scriptable glue and documentation.