Fix some cleanall issues

[mirror_edk2.git] / Tools / Source / TianoTools / Pccts / dlg / dlg1.txt

\r
\r
\r
dlg(1)                 PCCTS Manual Pages                  dlg(1)\r
\r
\r
\r
NAME\r
     dlg - DFA Lexical Analyzer Generator\r
\r
SYNTAX\r
     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]\r
\r
DESCRIPTION\r
     dlg is a tool that produces fast deterministic finite auto-\r
     mata for recognizing regular expressions in input.\r
\r
OPTIONS\r
     -CC  Generate C++ output.  The _\bo_\bu_\bt_\bp_\bu_\bt__\bf_\bi_\bl_\be is not specified\r
          in this case.\r
\r
     -C[ level]\r
          Where level is the compression level used.  0 indica-\r
          tions no compression, 1 removes all unused characters\r
          from the transition from table, and 2 maps equivalent\r
          characters into the same character classes.  It is sug-\r
          gested that level -C2 is used, since it will signifi-\r
          cantly reduce the size of the dfa produced for lexical\r
          analyzer.\r
\r
     -m   Produces the header file for the lexical mode with a\r
          name other than the default name of "mode.h".\r
\r
     -i   An interactive, or as interactive as possible, parser\r
          is produced.  A character is only obtained when\r
          required to decide which state to go to.  Some care\r
          must be taken to obtain accept states that do not\r
          require look ahead at the next character to determine\r
          if that is the stop state.  Any regular expression with\r
          a Kleene closure at the end is guaranteed to require\r
          another character of look ahead.\r
\r
     -cl class\r
          Specify a class name for DLG to generate.  The default\r
          is DLGLexer.\r
\r
     -ci  The automaton will treat upper and lower case charac-\r
          ters identically.  This is accomplished in the automa-\r
          ton; the characters in the lexical buffer are unmodi-\r
          fied.\r
\r
     -cs  Upper and lower case characters are treated as dis-\r
          tinct.  This is the default.\r
\r
     -o dir\r
          Directory where output files should go (default=".").\r
          This is very nice for keeping the source directory\r
          clear of ANTLR and DLG spawn.\r
\r
     -Wambiguity\r
          Warns if more than one regular expression could match\r
          the same character sequence.  The warnings give the\r
          numbers of the expressions in the dlg lexical specifi-\r
          cation file.  The numbering of the expressions starts\r
          at one.  Multiple warnings may be print for the same\r
          expressions.\r
\r
     -    Used in place of file names to get input from standard\r
          in or send output to standard out.\r
\r
SPECIAL CONSIDERATIONS\r
     _\bD_\bl_\bg works...  we think.  There is no implicit guarantee of\r
     anything.  We reserve no legal rights to the software known\r
     as the Purdue Compiler Construction Tool Set (PCCTS) - PCCTS\r
     is in the public domain.  An individual or company may do\r
     whatever they wish with source code distributed with PCCTS\r
     or the code generated by PCCTS, including the incorporation\r
     of PCCTS, or its output, into commercial software.  We\r
     encourage users to develop software with PCCTS.  However, we\r
     do ask that credit is given to us for developing PCCTS.  By\r
     "credit", we mean that if you incorporate our source code\r
     into one of your programs (commercial product, research pro-\r
     ject, or otherwise) that you acknowledge this fact somewhere\r
     in the documentation, research report, etc...  If you like\r
     PCCTS and have developed a nice tool with the output, please\r
     mention that you developed it using PCCTS.  As long as these\r
     guidelines are followed, we expect to continue enhancing\r
     this system and expect to make other tools available as they\r
     are completed.\r
\r
FILES\r
     mode.h , dlgauto.h , dlgdef.h\r
\r
SEE ALSO\r
     antlr(1), pccts(1)\r
\r
BUGS\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r
\r