Tools/CodeTools/Source/Pccts/dlg/dlg1.txt

   1
   2
   3
   4 dlg(1)                 PCCTS Manual Pages                  dlg(1)
   5
   6
   7
   8 NAME
   9      dlg - DFA Lexical Analyzer Generator
  10
  11 SYNTAX
  12      dlg [_\bo_\bp_\bt_\bi_\bo_\bn_\bs] _\bl_\be_\bx_\bi_\bc_\ba_\bl__\bs_\bp_\be_\bc [_\bo_\bu_\bt_\bp_\bu_\bt__\bf_\bi_\bl_\be]
  13
  14 DESCRIPTION
  15      dlg is a tool that produces fast deterministic finite auto-
  16      mata for recognizing regular expressions in input.
  17
  18 OPTIONS
  19      -CC  Generate C++ output.  The _\bo_\bu_\bt_\bp_\bu_\bt__\bf_\bi_\bl_\be is not specified
  20           in this case.
  21
  22      -C[ level]
  23           Where level is the compression level used.  0 indica-
  24           tions no compression, 1 removes all unused characters
  25           from the transition from table, and 2 maps equivalent
  26           characters into the same character classes.  It is sug-
  27           gested that level -C2 is used, since it will signifi-
  28           cantly reduce the size of the dfa produced for lexical
  29           analyzer.
  30
  31      -m   Produces the header file for the lexical mode with a
  32           name other than the default name of "mode.h".
  33
  34      -i   An interactive, or as interactive as possible, parser
  35           is produced.  A character is only obtained when
  36           required to decide which state to go to.  Some care
  37           must be taken to obtain accept states that do not
  38           require look ahead at the next character to determine
  39           if that is the stop state.  Any regular expression with
  40           a Kleene closure at the end is guaranteed to require
  41           another character of look ahead.
  42
  43      -cl class
  44           Specify a class name for DLG to generate.  The default
  45           is DLGLexer.
  46
  47      -ci  The automaton will treat upper and lower case charac-
  48           ters identically.  This is accomplished in the automa-
  49           ton; the characters in the lexical buffer are unmodi-
  50           fied.
  51
  52      -cs  Upper and lower case characters are treated as dis-
  53           tinct.  This is the default.
  54
  55      -o dir
  56           Directory where output files should go (default=".").
  57           This is very nice for keeping the source directory
  58           clear of ANTLR and DLG spawn.
  59
  60      -Wambiguity
  61           Warns if more than one regular expression could match
  62           the same character sequence.  The warnings give the
  63           numbers of the expressions in the dlg lexical specifi-
  64           cation file.  The numbering of the expressions starts
  65           at one.  Multiple warnings may be print for the same
  66           expressions.
  67
  68      -    Used in place of file names to get input from standard
  69           in or send output to standard out.
  70
  71 SPECIAL CONSIDERATIONS
  72      _\bD_\bl_\bg works...  we think.  There is no implicit guarantee of
  73      anything.  We reserve no legal rights to the software known
  74      as the Purdue Compiler Construction Tool Set (PCCTS) - PCCTS
  75      is in the public domain.  An individual or company may do
  76      whatever they wish with source code distributed with PCCTS
  77      or the code generated by PCCTS, including the incorporation
  78      of PCCTS, or its output, into commercial software.  We
  79      encourage users to develop software with PCCTS.  However, we
  80      do ask that credit is given to us for developing PCCTS.  By
  81      "credit", we mean that if you incorporate our source code
  82      into one of your programs (commercial product, research pro-
  83      ject, or otherwise) that you acknowledge this fact somewhere
  84      in the documentation, research report, etc...  If you like
  85      PCCTS and have developed a nice tool with the output, please
  86      mention that you developed it using PCCTS.  As long as these
  87      guidelines are followed, we expect to continue enhancing
  88      this system and expect to make other tools available as they
  89      are completed.
  90
  91 FILES
  92      mode.h , dlgauto.h , dlgdef.h
  93
  94 SEE ALSO
  95      antlr(1), pccts(1)
  96
  97 BUGS
  98
  99
 100
 101
 102
 103
 104
 105
 106
 107
 108
 109
 110
 111
 112
 113
 114
 115
 116
 117
 118
 119
 120
 121
 122
 123
 124
 125
 126
 127
 128
 129
 130
 131
 132