Root Zanli
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
usr
/
share
/
doc
/
re2c
/
Filename :
manpage.rst.in
back
Copy
++++ re2c ++++ ================================================ generate fast lexical analyzers for C/C++ and Go ================================================ :Manual section: 1 SYNOPSIS ======== ``re2c [OPTIONS] INPUT [-o OUTPUT]`` ``re2go [OPTIONS] INPUT [-o OUTPUT]`` RE2C_DISCLAIMER Introduction ============ .. include:: @top_srcdir@/doc/manual/syntax/syntax.rst_ .. include:: @top_srcdir@/doc/manual/syntax/api1.rst_ .. include:: @top_srcdir@/doc/manual/syntax/api2_RE2C_LANG.rst_ .. include:: @top_srcdir@/doc/manual/syntax/api3.rst_ Example ======= Here is a simple re2c program: .. include:: @top_srcdir@/examples/RE2C_LANG/01_basic.re :literal: :code: RE2C_LANG The generated code looks like this: .. include:: @top_srcdir@/examples/RE2C_LANG/01_basic.RE2C_LANG :literal: :code: RE2C_LANG Command-line options ==================== Command-line interface consists of options and warnings. Some of the options have corresponding `configurations`_, others are global and cannot be changed after re2c starts reading the input file. Debug options generally require building re2c in debug configuration. Internal options are useful for experimenting with the algorithms used in re2c. Warnings can be invividually enabled, disabled and turned into an error. .. include:: @top_srcdir@/doc/manual/options/options.rst_ .. include:: @top_srcdir@/doc/manual/options/debug.rst_ .. include:: @top_srcdir@/doc/manual/options/internal.rst_ .. include:: @top_srcdir@/doc/manual/warnings/warnings_general.rst_ .. include:: @top_srcdir@/doc/manual/warnings/warnings_list.rst_ Blocks and directives ===================== .. include:: @top_srcdir@/doc/manual/directives/directives.rst_ Interface primitives ==================== .. include:: @top_srcdir@/doc/manual/api/interface.rst_ Configurations ============== .. include:: @top_srcdir@/doc/manual/configurations/configurations.rst_ Regular expressions =================== .. include:: @top_srcdir@/doc/manual/regexps/regular_expressions.rst_ Handling the end of input ========================= .. include:: @top_srcdir@/doc/manual/eof/eof.rst_ .. include:: @top_srcdir@/doc/manual/eof/01_sentinel.rst_ .. include:: @top_srcdir@/examples/RE2C_LANG/eof/01_sentinel.re :literal: :code: RE2C_LANG .. include:: @top_srcdir@/doc/manual/eof/03_eof_rule.rst_ .. include:: @top_srcdir@/examples/RE2C_LANG/eof/03_eof_rule.re :literal: :code: RE2C_LANG .. include:: @top_srcdir@/doc/manual/eof/02_bounds_checking.rst_ .. include:: @top_srcdir@/examples/RE2C_LANG/eof/02_bounds_checking.re :literal: :code: RE2C_LANG .. include:: @top_srcdir@/doc/manual/eof/04_generic_api.rst_ .. include:: @top_srcdir@/examples/RE2C_LANG/eof/05_generic_api_eof_rule.re :literal: :code: RE2C_LANG Buffer refilling ================ .. include:: @top_srcdir@/doc/manual/fill/fill.rst_ .. include:: @top_srcdir@/doc/manual/fill/01_fill.rst_ .. include:: @top_srcdir@/examples/RE2C_LANG/fill/01_fill.re :literal: :code: RE2C_LANG .. include:: @top_srcdir@/doc/manual/fill/02_fill.rst_ .. include:: @top_srcdir@/examples/RE2C_LANG/fill/02_fill.re :literal: :code: RE2C_LANG Include files ============= .. include:: @top_srcdir@/doc/manual/includes/includes.rst_ Include file 1 (definitions.RE2C_HEADER_EXT) ------------------------------------------ .. include:: @top_srcdir@/examples/RE2C_LANG/includes/definitions.RE2C_HEADER_EXT :literal: :code: RE2C_LANG Include file 2 (extra_rules.re.inc) ----------------------------------- .. include:: @top_srcdir@/examples/RE2C_LANG/includes/extra_rules.re.inc :literal: :code: RE2C_LANG Input file ---------- .. include:: @top_srcdir@/examples/RE2C_LANG/includes/include.re :literal: :code: RE2C_LANG Header files ============ .. include:: @top_srcdir@/doc/manual/headers/headers.rst_ Input file ---------- .. include:: @top_srcdir@/examples/RE2C_LANG/headers/header.re :literal: :code: RE2C_LANG Header file ----------- .. include:: @top_srcdir@/examples/RE2C_LANG/headers/src/lexer/lexer.RE2C_HEADER_EXT :literal: :code: RE2C_LANG Submatch extraction =================== .. include:: @top_srcdir@/doc/manual/submatch/submatch.rst_ .. include:: @top_srcdir@/doc/manual/submatch/submatch_example_stags.rst_ .. include:: @top_srcdir@/examples/RE2C_LANG/submatch/01_stags.re :literal: :code: RE2C_LANG .. include:: @top_srcdir@/doc/manual/submatch/submatch_example_stags_fill.rst_ .. include:: @top_srcdir@/examples/RE2C_LANG/submatch/01_stags_fill.re :literal: :code: RE2C_LANG .. include:: @top_srcdir@/doc/manual/submatch/submatch_example_posix.rst_ .. include:: @top_srcdir@/examples/RE2C_LANG/submatch/03_posix.re :literal: :code: RE2C_LANG .. include:: @top_srcdir@/doc/manual/submatch/submatch_example_mtags.rst_ .. include:: @top_srcdir@/examples/RE2C_LANG/submatch/02_mtags.re :literal: :code: RE2C_LANG Storable state ============== .. include:: @top_srcdir@/doc/manual/state/state.rst_ Example ------- .. include:: @top_srcdir@/examples/RE2C_LANG/state/push.re :literal: :code: RE2C_LANG Reusable blocks =============== .. include:: @top_srcdir@/doc/manual/reuse/reuse.rst_ Example of a ``!use`` directive ------------------------------- .. include:: @top_srcdir@/examples/RE2C_LANG/reuse/usedir.re :literal: :code: RE2C_LANG Example of a ``/*!use:re2c ... */`` block ----------------------------------------- .. include:: @top_srcdir@/examples/RE2C_LANG/reuse/reuse.re :literal: :code: RE2C_LANG Encoding support ================ .. include:: @top_srcdir@/doc/manual/encodings/encodings.rst_ Example ------- .. include:: @top_srcdir@/examples/RE2C_LANG/encodings/unicode_identifier.re :literal: :code: RE2C_LANG Start conditions ================ .. include:: @top_srcdir@/doc/manual/conditions/conditions.rst_ Example ------- .. include:: @top_srcdir@/examples/RE2C_LANG/conditions/parse_u32_conditions.re :literal: :code: RE2C_LANG Skeleton programs ================= .. include:: @top_srcdir@/doc/manual/skeleton/skeleton.rst_ Visualization and debug ======================= .. include:: @top_srcdir@/doc/manual/dot/dot.rst_ SEE ALSO ======== You can find more information about re2c at the official website: http://re2c.org. Similar programs are flex(1), lex(1), quex(http://quex.sourceforge.net). AUTHORS ======= Re2c was originaly written by Peter Bumbulis in 1993. Since then it has been developed and maintained by multiple volunteers; mots notably, Brain Young, Marcus Boerger, Dan Nuffer and Ulya Trofimovich.