added documentation for the terminal_* family of api calls