Issue 41: proposal with examples

Attached.

This is based on the proposal that was sent by Danny (which updated the 
proposal sent by MichaelR). I have added examples (that were also sent 
by Danny in a different email).

Comments?

-Anish
--