Clarify certain aspects of the protocol as implemented in the example code. Clean up double and inconsistent specification files.

Author: gandrewstone