closes #53; closes #54; closes #55; minor doco changes