]>
Commit | Line | Data |
---|---|---|
878ddf1f | 1 | .TH dlg 1 "April 1994" "DLG" "PCCTS Manual Pages"\r |
2 | .SH NAME\r | |
3 | dlg \- DFA Lexical Analyzer Generator\r | |
4 | .SH SYNTAX\r | |
5 | .LP\r | |
6 | \fBdlg\fR [\fIoptions\fR] \fIlexical_spec\fR [\fIoutput_file\fR]\r | |
7 | .SH DESCRIPTION\r | |
8 | .B dlg\r | |
9 | is a tool that produces fast deterministic finite automata for recognizing\r | |
10 | regular expressions in input.\r | |
11 | .SH OPTIONS\r | |
12 | .IP "\fB-CC\fR"\r | |
13 | Generate C++ output. The \fIoutput_file\fP is not specified in this\r | |
14 | case.\r | |
15 | .IP "\fB-C\fR[\fP level\fR]\r | |
16 | Where \fPlevel\fR is the compression level used. 0 indications no\r | |
17 | compression, 1 removes all unused characters from the transition from table,\r | |
18 | and 2 maps equivalent characters into the same character classes. It is\r | |
19 | suggested that level -C2 is used, since it will significantly reduce the size\r | |
20 | of the dfa produced for lexical analyzer.\r | |
21 | .IP "\fB-m\fP\r | |
22 | Produces the header file for the lexical mode with a name other than\r | |
23 | the default name of "mode.h".\r | |
24 | .IP \fB-i\fP\r | |
25 | An interactive, or as interactive as possible, parser is produced. A character\r | |
26 | is only obtained when required to decide which state to go to. Some care\r | |
27 | must be taken to obtain accept states that do not require look ahead at the\r | |
28 | next character to determine if that is the stop state. Any regular expression\r | |
29 | with a Kleene closure at the end is guaranteed to require another character\r | |
30 | of look ahead.\r | |
31 | .IP "\fB-cl\fP class\r | |
32 | Specify a class name for DLG to generate. The default is DLGLexer.\r | |
33 | 'class' will be a subclass of DLGLexerBase; only used for -CC.\r | |
34 | .IP \fB-ci\fP\r | |
35 | The automaton will treat upper and lower case characters identically.\r | |
36 | This is accomplished in the automaton; the characters in the lexical\r | |
37 | buffer are unmodified.\r | |
38 | .IP \fB-cs\fP\r | |
39 | Upper and lower case characters are treated as distinct. This is the\r | |
40 | default.\r | |
41 | .IP "\fB-o\fP dir\r | |
42 | Directory where output files should go (default="."). This is very\r | |
43 | nice for keeping the source directory clear of ANTLR and DLG spawn.\r | |
44 | .IP \fB-Wambiguity\fP\r | |
45 | Warns if more than one regular expression could match the same character\r | |
46 | sequence. The warnings give the numbers of the expressions in the dlg\r | |
47 | lexical specification file. The numbering of the expressions starts at one.\r | |
48 | Multiple warnings may be print for the same expressions.\r | |
49 | .IP \-\r | |
50 | Used in place of file names to get input from standard in or send output\r | |
51 | to standard out.\r | |
52 | .SH "SPECIAL CONSIDERATIONS"\r | |
53 | .PP\r | |
54 | \fIDlg\fP works... we think. There is no implicit guarantee of\r | |
55 | anything. We reserve no \fBlegal\fP rights to the software known as\r | |
56 | the Purdue Compiler Construction Tool Set (PCCTS) \(em PCCTS is in the\r | |
57 | public domain. An individual or company may do whatever they wish\r | |
58 | with source code distributed with PCCTS or the code generated by\r | |
59 | PCCTS, including the incorporation of PCCTS, or its output, into\r | |
60 | commercial software. We encourage users to develop software with\r | |
61 | PCCTS. However, we do ask that credit is given to us for developing\r | |
62 | PCCTS. By "credit", we mean that if you incorporate our source code\r | |
63 | into one of your programs (commercial product, research project, or\r | |
64 | otherwise) that you acknowledge this fact somewhere in the\r | |
65 | documentation, research report, etc... If you like PCCTS and have\r | |
66 | developed a nice tool with the output, please mention that you\r | |
67 | developed it using PCCTS. As long as these guidelines are followed, we\r | |
68 | expect to continue enhancing this system and expect to make other\r | |
69 | tools available as they are completed.\r | |
70 | .SH FILES\r | |
71 | .B mode.h\r | |
72 | ,\r | |
73 | .B dlgauto.h\r | |
74 | ,\r | |
75 | .B dlgdef.h\r | |
76 | .SH SEE ALSO\r | |
77 | .BR antlr (1),\r | |
78 | .BR pccts (1)\r | |
79 | .SH BUGS\r |