add some verbosity messages and comments