Added docstrings to api.py

darcs-hash:20091112094810-58252-034d7b7f42ccd1060330bffca8899f81c2fbc2b2