usage: ragel [options] file
general:
-h, -H, -?, --help Print this usage and exit
-v, --version Print version information and exit
-o <file> Write output to <file>
-s Print some statistics and compilation info to stderr
-d Do not remove duplicates from action lists
-I <dir> Add <dir> to the list of directories to search
for included an imported files
--rlhc Show the rlhc command used to compile
--save-temps Do not delete intermediate file during compilation
--no-intermediate Disable call to rlhc, leave behind intermediate
error reporting format:
--error-format=gnu file:line:column: message (default)
--error-format=msvc file(line,column): message
fsm minimization:
-n Do not perform minimization
-m Minimize at the end of the compilation
-l Minimize after most operations (default)
-e Minimize after every operation
visualization:
-V Generate a dot file for Graphviz
-p Display printable characters on labels
-S <spec> FSM specification to output (for graphviz output)
-M <machine> Machine definition/instantiation to output (for
graphviz output)
host language binaries:
ragel, ragel-c C, C++, Obj-C or Obj-C++
All code styles supported.
ragel-asm GNU AS, x86_64, System V ABI.
Generated in a code style equivalent to -G2
ragel-d D All code styles supported
ragel-go Go All code styles supported
ragel-csharp C# -T0 -T1 -F0 -F1 -G0 -G1
ragel-java Java -T0 -T1 -F0 -F1
ragel-ruby Ruby -T0 -T1 -F0 -F1
ragel-ocaml OCaml -T0 -T1 -F0 -F1
ragel-rust Rust -T0 -T1 -F0 -F1
ragel-julia Julia -T0 -T1 -F0 -F1
ragel-crack Crack -T0 -T1 -F0 -F1
ragel-js JavaScript -T0 -T1 -F0 -F1
line directives:
-L Inhibit writing of #line directives
code style:
-T0 Binary search (default)
-T1 Binary search with expanded actions
-F0 Flat table
-F1 Flat table with expanded actions
-G0 Switch-driven
-G1 Switch-driven with expanded actions
-G2 Goto-driven with expanded actions
large machines:
--integral-tables Use integers for table data (default)
--string-tables Encode table data into strings for faster host lang
compilation
analysis:
--prior-interaction Search for condition-based general repetitions
that will not function properly due to state mod
overlap and must be NFA reps.
--conds-depth=D Search for high-cost conditions inside a prefix
of the machine (depth D from start state).
--state-limit=L Report fail if number of states exceeds this
during compilation.
--breadth-check=E1,E2,.. Report breadth cost of named entry points and
the start state.
--input-histogram=FN Input char histogram for breadth check. If
unspecified a flat histogram is used.
testing:
--kelbt-frontend Compile using original ragel + kelbt frontend
Requires ragel be built with ragel + kelbt support
--colm-frontend Compile using a colm-based recursive descent
frontend
--reduce-frontend Compile using a colm-based reducer (default)
--var-backend Use the variable-based backend even if the host lang
supports goto-based
--supported-host-langs Show supported host languages by command line arg
--supported-frontends Show supported frontends
--supported-backends Show supported backends
--force-libragel Cause mainline to behave like libragel
Options (41)
| Option | Description | Source |
|---|---|---|
-h, -H, -?, --help | Print this usage and exit | help |
-v, --version | Print version information and exit | help |
-o file | Write output to <file> | help |
-s | Print some statistics and compilation info to stderr | help |
-d | Do not remove duplicates from action lists | help |
-I dir | Add <dir> to the list of directories to search for included an imported files | help |
--rlhc | Show the rlhc command used to compile | help |
--save-temps | Do not delete intermediate file during compilation | help |
--no-intermediate | Disable call to rlhc, leave behind intermediate | help |
--error-format gnu | file:line:column: message (default) | help |
-n | Do not perform minimization | help |
-m | Minimize at the end of the compilation | help |
-l | Minimize after most operations (default) | help |
-e | Minimize after every operation | help |
-V | Generate a dot file for Graphviz | help |
-p | Display printable characters on labels | help |
-S spec | FSM specification to output (for graphviz output) | help |
-M machine | Machine definition/instantiation to output (for graphviz output) | help |
-L | Inhibit writing of #line directives | help |
-T0 | Binary search (default) | help |
-T1 | Binary search with expanded actions | help |
-F0 | Flat table | help |
-F1 | Flat table with expanded actions | help |
-G0 | Switch-driven | help |
-G1 | Switch-driven with expanded actions | help |
-G2 | Goto-driven with expanded actions | help |
--integral-tables | Use integers for table data (default) | help |
--string-tables | Encode table data into strings for faster host lang compilation | help |
--prior-interaction | Search for condition-based general repetitions that will not function properly due to state mod overlap and must be NFA reps. | help |
--conds-depth D | Search for high-cost conditions inside a prefix of the machine (depth D from start state). | help |
--state-limit L | Report fail if number of states exceeds this during compilation. | help |
--breadth-check E1 | Report breadth cost of named entry points and the start state. | help |
--input-histogram FN | Input char histogram for breadth check. | help |
--kelbt-frontend | Compile using original ragel + kelbt frontend Requires ragel be built with ragel + kelbt support | help |
--colm-frontend | Compile using a colm-based recursive descent frontend | help |
--reduce-frontend | Compile using a colm-based reducer (default) | help |
--var-backend | Use the variable-based backend even if the host lang supports goto-based | help |
--supported-host-langs | Show supported host languages by command line arg | help |
--supported-frontends | Show supported frontends | help |
--supported-backends | Show supported backends | help |
--force-libragel | Cause mainline to behave like libragel | help |