[review] FSM Library review result

This is a summary of the comments received during the
review of Andrey Semashev's Finite State Machines (FSM)
library. Apologies for the delay in getting these out.

DOCUMENTATION

* Relocate ToC to make it stand out.
* Several people used the Wikipedia article
  http://en.wikipedia.org/wiki/Finite_state_machine as
  a reference for FSM terminology and operation, and
  found discrepancies between Boost.FSM and that description.
  Perhaps Boost.FSM should explicitly describe its FSM
  metamodel, or refer to an existing metamodel (Wikipedia
  FSM or Harel or UML Statechart, for example). The latter
  was mentioned several times as being preferred since it
  is a standard.
* If possible, use standard terminology. For example,
  "transition map" vs. "state transition table". Or
  define the non-standard terms.
* Include a comprehensive rationale mapping the design
  choices to the design objectives.
* Compare/contrast Boost.FSM with the FSM implementation
  as described in "C++ Template Metaprogramming".
* Add an example of event deferral using boost::function.
* Clarify support for multithreading vs. asynchronous FSM,
  as some were confused by existing text.
* Clarify lifetime of objects.
* Add implementation of example using transition map/STT.
* Add more complex example(s).