From: Andreas Huber <ahd6974-spamgroupstrap@yahoo.com>
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.
I think I am saying so: http://tinyurl.com/3kkog (Audience)
I don't think that quite does it. The difference is that there you say that you assume familiarity with the subject matter and terminology, but nothing about experience. It is the latter that would permit the reader to recognize the StopWatch example as a toy and to map the code in the example to FSMs previously implemented other ways.
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.
It seems that you haven't read the whole post. I've already agreed with Jeff that I will write something in this direction.
Actually, I did read it, but I was trying to suggest the flavor of what you might add to the document. -- Rob Stewart stewart@sig.com Software Engineer http://www.sig.com Susquehanna International Group, LLP using std::disclaimer;