better documentation and info; refs #45