added a bunch of utilities to the user guide