Updated documentation, internal version number and comments

This should be near-final cleaned up version. Still to try to rewrite face.erase! section of code before final release.