NAME

       dlg - DFA Lexical Analyzer Generator

SYNTAX

       dlg [options] lexical_spec [output_file]

DESCRIPTION

       dlg  is  a  tool  that produces fast deterministic finite automata for recognizing regular expressions in
       input.

OPTIONS

       -CC    Generate C++ output.  The output_file is not specified in this case.

       -C[ level]
              Where level is the compression level used.  0 indications no compression,  1  removes  all  unused
              characters  from  the  transition  from  table,  and  2  maps  equivalent characters into the same
              character classes.  It is suggested that level -C2 is used, since it will significantly reduce the
              size of the dfa produced for lexical analyzer.

       -m     Produces the header file for the lexical mode with a name other than the default name of "mode.h".

       -i     An  interactive,  or as interactive as possible, parser is produced.  A character is only obtained
              when required to decide which state to go to.  Some care must be taken  to  obtain  accept  states
              that  do not require look ahead at the next character to determine if that is the stop state.  Any
              regular expression with a Kleene closure at the end is guaranteed to require another character  of
              look ahead.

       -cl class
              Specify a class name for DLG to generate.  The default is DLGLexer.  "class" will be a subclass of
              DLGLexerBase; only used for -CC.

       -ci    The automaton will treat upper and lower case characters identically.  This is accomplished in the
              automaton; the characters in the lexical buffer are unmodified.

       -cs    Upper and lower case characters are treated as distinct.  This is the default.

       -o dir Directory  where  output  files should go (default=".").  This is very nice for keeping the source
              directory clear of ANTLR and DLG spawn.

       -Wambiguity
              Warns if more than one regular expression could match the same character sequence.   The  warnings
              give  the  numbers of the expressions in the dlg lexical specification file.  The numbering of the
              expressions starts at one.  Multiple warnings may be print for the same expressions.

       -      Used in place of file names to get input from standard in or send output to standard out.

SPECIAL CONSIDERATIONS

       Dlg works...  we think.  There is no implicit guarantee of anything.  We reserve no legal rights  to  the
       software  known as the Purdue Compiler Construction Tool Set (PCCTS) — PCCTS is in the public domain.  An
       individual or company may do whatever they wish with source code  distributed  with  PCCTS  or  the  code
       generated  by  PCCTS,  including the incorporation of PCCTS, or its output, into commercial software.  We
       encourage users to develop software with PCCTS.  However, we do ask  that  credit  is  given  to  us  for
       developing PCCTS.  By "credit", we mean that if you incorporate our source code into one of your programs
       (commercial product, research project, or otherwise) that you acknowledge  this  fact  somewhere  in  the
       documentation, research report, etc...  If you like PCCTS and have developed a nice tool with the output,
       please mention that you developed it using PCCTS.  As long as these guidelines are followed, we expect to
       continue enhancing this system and expect to make other tools available as they are completed.

FILES

       mode.h , dlgauto.h , dlgdef.h

SEE ALSO

       antlr(1), pccts(1)

BUGS