Context manager fixes

[krcb197]

Fix an issue with exceptions in context manager resulting in the register classes being left in a bad state which has been resolved.

Also includes the following minor fixes:

• protection against mixing context manager operations
• documentation improvement
• deprecation warning for future removal of skip_write (see #135 )