change and document the way verbosity works