Rearrange head comments.
Rearrange comments to a more literate style.
Some docco markup.