api doc updated, closes #45