tweak command line function documentation
cleaned up comments