document utility routines