Blame doc/flex.1

Packit f00812
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.1.
Packit f00812
.TH FLEX "1" "March 2016" "flex 2.6.1" "User Commands"
Packit f00812
.SH NAME
Packit f00812
flex \- the fast lexical analyser generator
Packit f00812
.SH SYNOPSIS
Packit f00812
.B flex
Packit f00812
[\fI\,OPTIONS\/\fR] [\fI\,FILE\/\fR]...
Packit f00812
.SH DESCRIPTION
Packit f00812
Generates programs that perform pattern\-matching on text.
Packit f00812
.SS "Table Compression:"
Packit f00812
.TP
Packit f00812
\fB\-Ca\fR, \fB\-\-align\fR
Packit f00812
trade off larger tables for better memory alignment
Packit f00812
.TP
Packit f00812
\fB\-Ce\fR, \fB\-\-ecs\fR
Packit f00812
construct equivalence classes
Packit f00812
.TP
Packit f00812
\fB\-Cf\fR
Packit f00812
do not compress tables; use \fB\-f\fR representation
Packit f00812
.TP
Packit f00812
\fB\-CF\fR
Packit f00812
do not compress tables; use \fB\-F\fR representation
Packit f00812
.TP
Packit f00812
\fB\-Cm\fR, \fB\-\-meta\-ecs\fR
Packit f00812
construct meta\-equivalence classes
Packit f00812
.TP
Packit f00812
\fB\-Cr\fR, \fB\-\-read\fR
Packit f00812
use read() instead of stdio for scanner input
Packit f00812
.TP
Packit f00812
\fB\-f\fR, \fB\-\-full\fR
Packit f00812
generate fast, large scanner. Same as \fB\-Cfr\fR
Packit f00812
.TP
Packit f00812
\fB\-F\fR, \fB\-\-fast\fR
Packit f00812
use alternate table representation. Same as \fB\-CFr\fR
Packit f00812
.TP
Packit f00812
\fB\-Cem\fR
Packit f00812
default compression (same as \fB\-\-ecs\fR \fB\-\-meta\-ecs\fR)
Packit f00812
.SS "Debugging:"
Packit f00812
.TP
Packit f00812
\fB\-d\fR, \fB\-\-debug\fR
Packit f00812
enable debug mode in scanner
Packit f00812
.TP
Packit f00812
\fB\-b\fR, \fB\-\-backup\fR
Packit f00812
write backing\-up information to lex.backup
Packit f00812
.TP
Packit f00812
\fB\-p\fR, \fB\-\-perf\-report\fR
Packit f00812
write performance report to stderr
Packit f00812
.TP
Packit f00812
\fB\-s\fR, \fB\-\-nodefault\fR
Packit f00812
suppress default rule to ECHO unmatched text
Packit f00812
.TP
Packit f00812
\fB\-T\fR, \fB\-\-trace\fR
Packit f00812
flex should run in trace mode
Packit f00812
.TP
Packit f00812
\fB\-w\fR, \fB\-\-nowarn\fR
Packit f00812
do not generate warnings
Packit f00812
.TP
Packit f00812
\fB\-v\fR, \fB\-\-verbose\fR
Packit f00812
write summary of scanner statistics to stdout
Packit f00812
.TP
Packit f00812
\fB\-\-hex\fR
Packit f00812
use hexadecimal numbers instead of octal in debug outputs
Packit f00812
.SH FILES
Packit f00812
.TP
Packit f00812
\fB\-o\fR, \fB\-\-outfile\fR=\fI\,FILE\/\fR
Packit f00812
specify output filename
Packit f00812
.TP
Packit f00812
\fB\-S\fR, \fB\-\-skel\fR=\fI\,FILE\/\fR
Packit f00812
specify skeleton file
Packit f00812
.TP
Packit f00812
\fB\-t\fR, \fB\-\-stdout\fR
Packit f00812
write scanner on stdout instead of lex.yy.c
Packit f00812
.TP
Packit f00812
\fB\-\-yyclass\fR=\fI\,NAME\/\fR
Packit f00812
name of C++ class
Packit f00812
.TP
Packit f00812
\fB\-\-header\-file\fR=\fI\,FILE\/\fR
Packit f00812
create a C header file in addition to the scanner
Packit f00812
.HP
Packit f00812
\fB\-\-tables\-file\fR[=\fI\,FILE\/\fR] write tables to FILE
Packit f00812
.SS "Scanner behavior:"
Packit f00812
.TP
Packit f00812
\fB\-7\fR, \fB\-\-7bit\fR
Packit f00812
generate 7\-bit scanner
Packit f00812
.TP
Packit f00812
\fB\-8\fR, \fB\-\-8bit\fR
Packit f00812
generate 8\-bit scanner
Packit f00812
.TP
Packit f00812
\fB\-B\fR, \fB\-\-batch\fR
Packit f00812
generate batch scanner (opposite of \fB\-I\fR)
Packit f00812
.TP
Packit f00812
\fB\-i\fR, \fB\-\-case\-insensitive\fR
Packit f00812
ignore case in patterns
Packit f00812
.TP
Packit f00812
\fB\-l\fR, \fB\-\-lex\-compat\fR
Packit f00812
maximal compatibility with original lex
Packit f00812
.TP
Packit f00812
\fB\-X\fR, \fB\-\-posix\-compat\fR
Packit f00812
maximal compatibility with POSIX lex
Packit f00812
.TP
Packit f00812
\fB\-I\fR, \fB\-\-interactive\fR
Packit f00812
generate interactive scanner (opposite of \fB\-B\fR)
Packit f00812
.TP
Packit f00812
\fB\-\-yylineno\fR
Packit f00812
track line count in yylineno
Packit f00812
.SS "Generated code:"
Packit f00812
.TP
Packit f00812
\-+,  \fB\-\-c\fR++
Packit f00812
generate C++ scanner class
Packit f00812
.TP
Packit f00812
\fB\-Dmacro\fR[=\fI\,defn\/\fR]
Packit f00812
#define macro defn  (default defn is '1')
Packit f00812
.TP
Packit f00812
\fB\-L\fR,  \fB\-\-noline\fR
Packit f00812
suppress #line directives in scanner
Packit f00812
.TP
Packit f00812
\fB\-P\fR,  \fB\-\-prefix\fR=\fI\,STRING\/\fR
Packit f00812
use STRING as prefix instead of "yy"
Packit f00812
.TP
Packit f00812
\fB\-R\fR,  \fB\-\-reentrant\fR
Packit f00812
generate a reentrant C scanner
Packit f00812
.TP
Packit f00812
\fB\-\-bison\-bridge\fR
Packit f00812
scanner for bison pure parser.
Packit f00812
.TP
Packit f00812
\fB\-\-bison\-locations\fR
Packit f00812
include yylloc support.
Packit f00812
.TP
Packit f00812
\fB\-\-stdinit\fR
Packit f00812
initialize yyin/yyout to stdin/stdout
Packit f00812
.HP
Packit f00812
\fB\-\-noansi\-definitions\fR old\-style function definitions
Packit f00812
.TP
Packit f00812
\fB\-\-noansi\-prototypes\fR
Packit f00812
empty parameter list in prototypes
Packit f00812
.TP
Packit f00812
\fB\-\-nounistd\fR
Packit f00812
do not include <unistd.h>
Packit f00812
.TP
Packit f00812
\fB\-\-noFUNCTION\fR
Packit f00812
do not generate a particular FUNCTION
Packit f00812
.SS "Miscellaneous:"
Packit f00812
.TP
Packit f00812
\fB\-c\fR
Packit f00812
do\-nothing POSIX option
Packit f00812
.TP
Packit f00812
\fB\-n\fR
Packit f00812
do\-nothing POSIX option
Packit f00812
.HP
Packit f00812
\-?
Packit f00812
.TP
Packit f00812
\fB\-h\fR, \fB\-\-help\fR
Packit f00812
produce this help message
Packit f00812
.TP
Packit f00812
\fB\-V\fR, \fB\-\-version\fR
Packit f00812
report flex version
Packit f00812
.SH "SEE ALSO"
Packit f00812
The full documentation for
Packit f00812
.B flex
Packit f00812
is maintained as a Texinfo manual.  If the
Packit f00812
.B info
Packit f00812
and
Packit f00812
.B flex
Packit f00812
programs are properly installed at your site, the command
Packit f00812
.IP
Packit f00812
.B info flex
Packit f00812
.PP
Packit f00812
should give you access to the complete manual.