Added Javadoc Comments to classes in the machinery package

Also added general descrption to the MachineExample class