home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / pccts.zip / pccts / dlg / dlg1.txt < prev    next >
Text File  |  1994-03-31  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. dlg(1)                  PCCTS Manual Pages                 dlg(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        dlg - DFA Lexical Analyzer Generator
  9.  
  10. SSYYNNTTAAXX
  11.        ddllgg [_o_p_t_i_o_n_s] _l_e_x_i_c_a_l___s_p_e_c [_o_u_t_p_u_t___f_i_l_e]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        ddllgg  is  a  tool  that  produces fast deterministic finite
  15.        automata for recognizing regular expressions in input.
  16.  
  17. OOPPTTIIOONNSS
  18.        --CCCC    Generate C++ output.  The _o_u_t_p_u_t___f_i_l_e is not speci-
  19.               fied in this case.
  20.  
  21.        --CC[ lleevveell]
  22.               Where level is the compression level used.  0 indi-
  23.               cations no compression, 1 removes all unused  char-
  24.               acters  from  the transition from table, and 2 maps
  25.               equivalent  characters  into  the  same   character
  26.               classes.   It  is suggested that level -C2 is used,
  27.               since it will significantly reduce the size of  the
  28.               dfa produced for lexical analyzer.
  29.  
  30.        --mm     Produces  the header file for the lexical mode with
  31.               a name other than the default name of "mode.h".
  32.  
  33.        --ii     An interactive,  or  as  interactive  as  possible,
  34.               parser  is  produced.  A character is only obtained
  35.               when required to decide which state to go to.  Some
  36.               care  must be taken to obtain accept states that do
  37.               not require look ahead at  the  next  character  to
  38.               determine  if  that is the stop state.  Any regular
  39.               expression with a Kleene  closure  at  the  end  is
  40.               guaranteed  to  require  another  character of look
  41.               ahead.
  42.  
  43.        --ccll class
  44.               Specify a class name  for  DLG  to  generate.   The
  45.               default is DLGLexer.
  46.  
  47.        --ccii    The automaton will treat upper and lower case char-
  48.               acters identically.  This is  accomplished  in  the
  49.               automaton; the characters in the lexical buffer are
  50.               unmodified.
  51.  
  52.        --ccss    Upper and lower case characters are treated as dis-
  53.               tinct.  This is the default.
  54.  
  55.        --oo dir Directory    where    output    files   should   go
  56.               (default=".").  This is very nice for  keeping  the
  57.               source directory clear of ANTLR and DLG spawn.
  58.  
  59.        --WWaammbbiigguuiittyy
  60.               Warns  if  more  than  one regular expression could
  61.  
  62.  
  63.  
  64. DLG                         April 1994                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. dlg(1)                  PCCTS Manual Pages                 dlg(1)
  71.  
  72.  
  73.               match the same character  sequence.   The  warnings
  74.               give the numbers of the expressions in the dlg lex-
  75.               ical specification  file.   The  numbering  of  the
  76.               expressions  starts  at one.  Multiple warnings may
  77.               be print for the same expressions.
  78.  
  79.        -      Used in place of file names to get input from stan-
  80.               dard in or send output to standard out.
  81.  
  82. SSPPEECCIIAALL CCOONNSSIIDDEERRAATTIIOONNSS
  83.        _D_l_g works...  we think.  There is no implicit guarantee of
  84.        anything.  We reserve no  lleeggaall  rights  to  the  software
  85.        known as the Purdue Compiler Construction Tool Set (PCCTS)
  86.        -- PCCTS is in the public domain.  An individual  or  com-
  87.        pany  may  do  whatever  they  wish  with source code dis-
  88.        tributed with  PCCTS  or  the  code  generated  by  PCCTS,
  89.        including  the incorporation of PCCTS, or its output, into
  90.        commercial software.  We encourage users to develop  soft-
  91.        ware  with PCCTS.  However, we do ask that credit is given
  92.        to us for developing PCCTS.  By "credit", we mean that  if
  93.        you  incorporate our source code into one of your programs
  94.        (commercial product, research project, or otherwise)  that
  95.        you  acknowledge this fact somewhere in the documentation,
  96.        research report, etc...  If you like PCCTS and have devel-
  97.        oped  a nice tool with the output, please mention that you
  98.        developed it using PCCTS.  As long as these guidelines are
  99.        followed,  we expect to continue enhancing this system and
  100.        expect to make other tools  available  as  they  are  com-
  101.        pleted.
  102.  
  103. FFIILLEESS
  104.        mmooddee..hh , ddllggaauuttoo..hh , ddllggddeeff..hh
  105.  
  106. SSEEEE AALLSSOO
  107.        aannttllrr(1), ppccccttss(1)
  108.  
  109. BBUUGGSS
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. DLG                         April 1994                          2
  131.  
  132.  
  133.