Cleaning up candidate IDL and providing descriptions.
Fixing example.
Merge pull request #20 from martinthomson/candidates

Cleaning up candidate IDL and providing descriptions.