Boost logo

Boost :

From: Rob Stewart (stewart_at_[hidden])
Date: 2005-02-28 11:15:34

From: "Andreas Huber" <ahd6974-spamgroupstrap_at_[hidden]>
> Jeff Garland wrote:
> >
> > I addressed what I meant by complexity in my response to Darryl. The
> > thing is since we don't have an example of bad code that can be
> > simplified by an fsm to compare agaisnt in the docs and we can all
> > think of easier ways to write the StopWatch I worry that people will
> > be put off.
> The tutorial is primarily addressed to people who already have had
> exposure to FSMs (and also had to implement them one way or another).
> You are right, a beginner with only theoretical or even no prior
> knowledge about FSMs would probably shake his head before even following
> through the StopWatch example. I've spent quite some time thinking how I
> could also address newbies but have come to the conclusion that this
> would require a separate document at least as large as the tutorial.

A tutorial is typically assumed to be addressed at newbies. If
you are aiming at a different, more advanced audience, just say
so. That should eliminate the confusion.

To avoid misconceptions, a disclaimer stating that the StopWatch
example is too simple to benefit much from Boost.FSM, but serves
to show how to use the library, would probably be a good idea.

Rob Stewart                           stewart_at_[hidden]
Software Engineer           
Susquehanna International Group, LLP  using std::disclaimer;

Boost list run by bdawes at, gregod at, cpdaniel at, john at