adding documentation for cmdline module, and updating the API to
return results rather than throw errors