Documentation updates and update to hook_permission().

In addition to these small changes, I think that it should be clear what role the default 'shunt' shunt is intended to play. It does nothing on its own, and is not utilized in the example module.