some shared behavior info and a few new CLI options