fleshing out the API
0.9.1