Minor update on documentation

Added a few paragraphs to the documentation concerning the machine
state mechanism I am using for my pawn management.