Post-specific revisions changes cleanup

* More inline documentation
* Actually purges when requested
* Better error handling

Closes #1