Extended documentation and fixed a bug where AttributeErrors were being
swallowed by over-eager exception handling