Index: /trunk/FACT++/src/StateMachineImp.cc
===================================================================
--- /trunk/FACT++/src/StateMachineImp.cc	(revision 10689)
+++ /trunk/FACT++/src/StateMachineImp.cc	(revision 10690)
@@ -512,5 +512,5 @@
 // --------------------------------------------------------------------------
 //
-//! Calling this function a new allowed transition is added to the state
+//! Calling this function, a new (named) event is added to the state
 //! machine. Via a call to CreateEvent a new event is created with the
 //! given targetstate, name and format. 
@@ -520,8 +520,8 @@
 //!
 //! @param targetstate
-//!    Defines the target state of the new transition. If \b must be
+//!    Defines the target state (or name) of the new event. If \b must be
 //!    greater or equal zero. A negative target state is used to flag
 //!    commands which do not initiate a state transition. If this is
-//!    desired use AddEvent instead.
+//!    desired use the unnamed version of AddEvent instead.
 //!
 //! @param name
@@ -556,13 +556,13 @@
 // --------------------------------------------------------------------------
 //
-//! Calling this function a new allowed transition is added to the state
+//! Calling this function, a new (named) event is added to the state
 //! machine. Therefore an instance of type DimEvent is created and added
 //! to the list of available commands fListOfEvents.
 //!
 //! @param targetstate
-//!    Defines the target state of the new transition. If \b must be
+//!    Defines the target state (or name) of the new event. If \b must be
 //!    greater or equal zero. A negative target state is used to flag
 //!    commands which do not initiate a state transition. If this is
-//!    desired use AddEvent instead.
+//!    desired use the unnamed version of AddEvent instead.
 //!
 //! @param name
@@ -584,13 +584,13 @@
 // --------------------------------------------------------------------------
 //
-//! Calling this function a new allowed transition is added to the state
+//! Calling this function, a new (named) event is added to the state
 //! machine. Therefore an instance of type DimEvent is created and added
 //! to the list of available commands fListOfEvents.
 //!
 //! @param targetstate
-//!    Defines the target state of the new transition. If \b must be
+//!    Defines the target state (or name) of the new event. If \b must be
 //!    greater or equal zero. A negative target state is used to flag
 //!    commands which do not initiate a state transition. If this is
-//!    desired use AddEvent instead.
+//!    desired use the unnamed version of AddEvent instead.
 //!
 //! @param name
@@ -618,8 +618,8 @@
 // --------------------------------------------------------------------------
 //
-//! This function calls AddEvent with a target-state of -1 which means
-//! that the command will not change the state at all. This shell be used
-//! for configuration commands. As well as in AddEvent the states in
-//! which such a configuration command is accepted can be given.
+//! This function calls AddEvent with a target-state of -1 (unnamed
+//! event). This shell be used for configuration commands. As well as
+//! in AddEvent the states in which such a configuration command is
+//! accepted can be given.
 //!
 //! @param name
@@ -645,8 +645,8 @@
 // --------------------------------------------------------------------------
 //
-//! This function calls AddEvent with a target-state of -1 which means
-//! that the command will not change the state at all. This shell be used
-//! for configuration commands. As well as in AddEvent the states in
-//! which such a configuration command is accepted can be given.
+//! This function calls AddEvent with a target-state of -1 (unnamed
+//! event). This shell be used for configuration commands. As well as
+//! in AddEvent the states in which such a configuration command is
+//! accepted can be given.
 //!
 //! @param name
@@ -666,8 +666,8 @@
 // --------------------------------------------------------------------------
 //
-//! This function calls AddEvent with a target-state of -1 which means
-//! that the command will not change the state at all. This shell be used
-//! for configuration commands. As well as in AddEvent the states in
-//! which such a configuration command is accepted can be given.
+//! This function calls AddEvent with a target-state of -1 (unnamed
+//! event). This shell be used for configuration commands. As well as
+//! in AddEvent the states in which such a configuration command is
+//! accepted can be given.
 //!
 //! @param name
@@ -883,5 +883,5 @@
 //
 //! This is the event handler. Depending on the type of event it calles
-//! the function associated with the evenet, the Transition() or
+//! the function associated with the event, the Transition() or
 //! Configure() function.
 //!
@@ -893,11 +893,11 @@
 //! called with its return value. 
 //!
-//! If the event's target state is negative the Configure() function is
-//! called with the event as argument and HandleNewState with its
-//! returned new state.
-//!
-//! If the event's target state is 0 or positive the Transition() function is
-//! called with the event as argument and HandleNewState with its
-//! returned new state.
+//! If the event's target state is negative (unnamed Event) the Configure()
+//! function is called with the event as argument and HandleNewState with
+//! its returned new state.
+//!
+//! If the event's target state is 0 or positive (named Event) the
+//! Transition() function is called with the event as argument and
+//! HandleNewState with its returned new state.
 //!
 //! In all three cases the return value of HandleNewState is returned.