fixed up default error messages
added some quick docblocks
updated comment
more docblocks (more still needed)