30fdf1140b
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8964 6f19259b-4bc3-4df7-8a09-765794883524
80 lines
3.4 KiB
Groff
80 lines
3.4 KiB
Groff
.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
|