Fix for issue #148

Update comments and docstrings following testing (self-tested with low-level updater.py, @nekt tested with interposition and C-bridge).
Complete refactored changes.