minor documentation/error message corrections

added trivial + simple tests