completed the initial api reference documentation

Ignore-this: f95daa4e1b0e2bc2927739d384af343f

darcs-hash:20141126060209-c21fe-1754ae8e5d597368a147958a78ec8de7ecc54cde