
                    Ragel State Machine Compiler -- Examples
                    ========================================

clang      -- A scanner for a simple C like language. It breaks input up into
              words, numbers, strings and symbols and strips out whitespace and
              comments. It is a suitable template for writing a parser that
              finds a sequence of tokens.

mailbox    -- Parses unix mailbox files. It breaks files into messages,
              and messages into headers and body. It demonstrates Ragel's
              ability to make parsers for structured file formats.

awkemu     -- Perfoms the basic parsing that the awk program perfoms on input.
              The awk equivalent to awkemu is in awkemu/awkequiv.awk

atoi       -- Converts a string to an integer.

concurrent -- Demonstrates the ability of ragel to produce parsers that perform
              independent tasks concurrently.

statechart -- Demonstrates the use of labels, the epsilon operator, and the join
              operator for creating machines using the named state and
			  transition list paradigm, implements the same machine as the atoi
			  example.
