more convenience methods, debug statement cleanup, and fixed an unhandled err return