| .TH dlg 1 "April 1994" "DLG" "PCCTS Manual Pages" | |
| .SH NAME | |
| dlg \- DFA Lexical Analyzer Generator | |
| .SH SYNTAX | |
| .LP | |
| \fBdlg\fR [\fIoptions\fR] \fIlexical_spec\fR [\fIoutput_file\fR] | |
| .SH DESCRIPTION | |
| .B dlg | |
| is a tool that produces fast deterministic finite automata for recognizing | |
| regular expressions in input. | |
| .SH OPTIONS | |
| .IP "\fB-CC\fR" | |
| Generate C++ output. The \fIoutput_file\fP is not specified in this | |
| case. | |
| .IP "\fB-C\fR[\fP level\fR] | |
| Where \fPlevel\fR is the compression level used. 0 indications no | |
| compression, 1 removes all unused characters from the transition from table, | |
| and 2 maps equivalent characters into the same character classes. It is | |
| suggested that level -C2 is used, since it will significantly reduce the size | |
| of the dfa produced for lexical analyzer. | |
| .IP "\fB-m\fP | |
| Produces the header file for the lexical mode with a name other than | |
| the default name of "mode.h". | |
| .IP \fB-i\fP | |
| An interactive, or as interactive as possible, parser is produced. A character | |
| is only obtained when required to decide which state to go to. Some care | |
| must be taken to obtain accept states that do not require look ahead at the | |
| next character to determine if that is the stop state. Any regular expression | |
| with a Kleene closure at the end is guaranteed to require another character | |
| of look ahead. | |
| .IP "\fB-cl\fP class | |
| Specify a class name for DLG to generate. The default is DLGLexer. | |
| 'class' will be a subclass of DLGLexerBase; only used for -CC. | |
| .IP \fB-ci\fP | |
| The automaton will treat upper and lower case characters identically. | |
| This is accomplished in the automaton; the characters in the lexical | |
| buffer are unmodified. | |
| .IP \fB-cs\fP | |
| Upper and lower case characters are treated as distinct. This is the | |
| default. | |
| .IP "\fB-o\fP dir | |
| Directory where output files should go (default="."). This is very | |
| nice for keeping the source directory clear of ANTLR and DLG spawn. | |
| .IP \fB-Wambiguity\fP | |
| Warns if more than one regular expression could match the same character | |
| sequence. The warnings give the numbers of the expressions in the dlg | |
| lexical specification file. The numbering of the expressions starts at one. | |
| Multiple warnings may be print for the same expressions. | |
| .IP \- | |
| Used in place of file names to get input from standard in or send output | |
| to standard out. | |
| .SH "SPECIAL CONSIDERATIONS" | |
| .PP | |
| \fIDlg\fP works... we think. There is no implicit guarantee of | |
| anything. We reserve no \fBlegal\fP rights to the software known as | |
| the Purdue Compiler Construction Tool Set (PCCTS) \(em PCCTS is in the | |
| public domain. An individual or company may do whatever they wish | |
| with source code distributed with PCCTS or the code generated by | |
| PCCTS, including the incorporation of PCCTS, or its output, into | |
| commercial software. We encourage users to develop software with | |
| PCCTS. However, we do ask that credit is given to us for developing | |
| PCCTS. By "credit", we mean that if you incorporate our source code | |
| into one of your programs (commercial product, research project, or | |
| otherwise) that you acknowledge this fact somewhere in the | |
| documentation, research report, etc... If you like PCCTS and have | |
| developed a nice tool with the output, please mention that you | |
| developed it using PCCTS. As long as these guidelines are followed, we | |
| expect to continue enhancing this system and expect to make other | |
| tools available as they are completed. | |
| .SH FILES | |
| .B mode.h | |
| , | |
| .B dlgauto.h | |
| , | |
| .B dlgdef.h | |
| .SH SEE ALSO | |
| .BR antlr (1), | |
| .BR pccts (1) | |
| .SH BUGS |