updated docs with musings on command line arguments