Fix some cleanall issues
[mirror_edk2.git] / Tools / Source / TianoTools / 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