documented utils (closes issue #11)