adjusted api doc.