1 2 3 4dlg(1) PCCTS Manual Pages dlg(1) 5 6 7 8NAME 9 dlg - DFA Lexical Analyzer Generator 10 11SYNTAX 12 dlg [_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] 13 14DESCRIPTION 15 dlg is a tool that produces fast deterministic finite auto- 16 mata for recognizing regular expressions in input. 17 18OPTIONS 19 -CC Generate C++ output. The _o_u_t_p_u_t__f_i_l_e 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 71SPECIAL CONSIDERATIONS 72 _D_l_g 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 91FILES 92 mode.h , dlgauto.h , dlgdef.h 93 94SEE ALSO 95 antlr(1), pccts(1) 96 97BUGS 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 133