func docs and clean up
func docs and clean up

This commit adds docs to more funcs and cleans up a few minor
issues. The commit also cleans up the validateOptions method.

relab/gorums,relab/gorums,relab/gorums