document rest of command-line api