Document PanStateMachine

[jamessynge]

There is minimal documentation about the state machine in state/machine.py and core.py. More is definitely needed, especially about transitions, conditions and actions, and about the overriding of the "normal" behavior provided by the transitions library.