add new method docs, and update the version

Hello @nicks, 

Please review the following commits I made in branch 'nick-version'.

e8d42dbf4c59e5ae997a30e14cc224873c8c13a5 (2014-01-07 10:13:37 -0800)
update version

ef636f0da502605a5ed068362b5cbf7c1e3e3218 (2014-01-07 10:12:54 -0800)
Document the new API methods

R=@nicks