Docco compatible documentation added
Tons of changes, see details.

- docco generated documentation
- demos updated for changes to click handlers
- moshpit updated to include documenation for annotation via docco
- see diff... literally a ton of changes.