|
|
|
dlg(1) PCCTS Manual Pages dlg(1)
|
|
|
|
NAME
|
dlg - DFA Lexical Analyzer Generator
|
|
SYNTAX
|
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]
|
|
DESCRIPTION
|
dlg is a tool that produces fast deterministic finite auto-
|
mata for recognizing regular expressions in input.
|
|
OPTIONS
|
-CC Generate C++ output. The _o_u_t_p_u_t__f_i_l_e is not specified
|
in this case.
|
|
-C[ level]
|
Where level is the compression level used. 0 indica-
|
tions no compression, 1 removes all unused characters
|
from the transition from table, and 2 maps equivalent
|
characters into the same character classes. It is sug-
|
gested that level -C2 is used, since it will signifi-
|
cantly reduce the size of the dfa produced for lexical
|
analyzer.
|
|
-m Produces the header file for the lexical mode with a
|
name other than the default name of "mode.h".
|
|
-i 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.
|
|
-cl class
|
Specify a class name for DLG to generate. The default
|
is DLGLexer.
|
|
-ci The automaton will treat upper and lower case charac-
|
ters identically. This is accomplished in the automa-
|
ton; the characters in the lexical buffer are unmodi-
|
fied.
|
|
-cs Upper and lower case characters are treated as dis-
|
tinct. This is the default.
|
|
-o dir
|
Directory where output files should go (default=".").
|
This is very nice for keeping the source directory
|
clear of ANTLR and DLG spawn.
|
|
-Wambiguity
|
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 specifi-
|
cation file. The numbering of the expressions starts
|
at one. Multiple warnings may be print for the same
|
expressions.
|
|
- Used in place of file names to get input from standard
|
in or send output to standard out.
|
|
SPECIAL CONSIDERATIONS
|
_D_l_g works... we think. There is no implicit guarantee of
|
anything. We reserve no legal rights to the software known
|
as the Purdue Compiler Construction Tool Set (PCCTS) - 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 pro-
|
ject, 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.
|
|
FILES
|
mode.h , dlgauto.h , dlgdef.h
|
|
SEE ALSO
|
antlr(1), pccts(1)
|
|
BUGS
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
