void usage ()
{
- fprintf (stderr,
+ fprintf (stdout,
"usage: re2c [-bcdDefFghirsuvVwx18] [-o of] [-t th] file\n"
- "\n"
- "-? -h --help Display this info.\n"
- "\n"
- "-b --bit-vectors Implies -s. Use bit vectors as well in the attempt to\n"
- " coax better code out of the compiler. Most useful for\n"
- " specifications with more than a few keywords (e.g. for\n"
- " most programming languages).\n"
- "\n"
- "-c --conditions Require start conditions.\n"
- "\n"
- "-d --debug-output Creates a parser that dumps information during\n"
- " about the current position and in which state the\n"
- " parser is.\n"
- "\n"
- "-D --emit-dot Emit a Graphviz dot view of the DFA graph\n"
- "\n"
- "-e --ecb Generate a parser that supports EBCDIC. The generated code\n"
- " can deal with any character up to 0xFF. In this mode re2c\n"
- " assumes that input character size is 1 byte. This switch is\n"
- " incompatible with -w, -u, -x and -8\n"
- "\n"
- "-f --storable-state Generate a scanner that supports storable states.\n"
- "\n"
- "-F --flex-syntax Partial support for flex syntax.\n"
- "\n"
- "-g --computed-gotos Implies -b. Generate computed goto code (only useable\n"
- " with gcc).\n"
- "\n"
- "-i --no-debug-info Do not generate '#line' info (useful for versioning).\n"
- "\n"
- "-o of --output=of Specify the output file (of) instead of stdout\n"
- "\n"
- "-r --reusable Allow reuse of scanner definitions.\n"
- "\n"
- "-s --nested-ifs Generate nested ifs for some switches. Many compilers\n"
- " need this assist to generate better code.\n"
- "\n"
- "-t th --type-header=th Generate a type header file (th) with type definitions.\n"
- "\n"
- "-u --unicode Generate a parser that supports UTF-32. The generated code\n"
- " can deal with any valid Unicode character up to 0x10FFFF.\n"
- " In this mode re2c assumes that input character size is 4 bytes.\n"
- " This switch is incompatible with -e, -w, -x and -8. It implies -s.\n"
- "\n"
- "-v --version Show version information.\n"
- "\n"
- "-V --vernum Show version as one number.\n"
- "\n"
- "-w --wide-chars Generate a parser that supports UCS-2. The generated code can\n"
- " deal with any valid Unicode character up to 0xFFFF. In this mode\n"
- " re2c assumes that input character size is 2 bytes. This switch is\n"
- " incompatible with -e, -x, -u and -8. It implies -s."
- "\n"
- "-x --utf-16 Generate a parser that supports UTF-16. The generated code can\n"
- " deal with any valid Unicode character up to 0x10FFFF. In this mode\n"
- " re2c assumes that input character size is 2 bytes. This switch is\n"
- " incompatible with -e, -w, -u and -8. It implies -s."
- "\n"
- "-8 --utf-8 Generate a parser that supports UTF-8. The generated code can\n"
- " deal with any valid Unicode character up to 0x10FFFF. In this mode\n"
- " re2c assumes that input character size is 1 byte. This switch is\n"
- " incompatible with -e, -w, -x and -u."
- "\n"
- "--no-generation-date Suppress date output in the generated file.\n"
- "\n"
- "--no-version Suppress version output in the generated file.\n"
- "\n"
- "--case-insensitive All strings are case insensitive, so all \"-expressions\n"
- " are treated in the same way '-expressions are.\n"
- "\n"
- "--case-inverted Invert the meaning of single and double quoted strings.\n"
- " With this switch single quotes are case sensitive and\n"
- " double quotes are case insensitive.\n"
- "\n"
- "--encoding-policy ep Specify what re2c should do when given bad code unit.\n"
- " ep can be one of the following: fail, substitute, ignore.\n"
- "\n"
- "--input i Specify re2c input API.\n"
- " i can be one of the following: default, custom.\n"
- "\n"
- "--skeleton Instead of embedding re2c-generated code into C/C++ source,\n"
- " generate a self-contained program for the same DFA.\n"
- " Most useful for correctness and performance testing.\n"
- "\n"
- "--empty-class policy What to do if user inputs empty character class. policy can be\n"
- " one of the following: 'match-empty' (match empty input, default),\n"
- " 'match-none' (fail to match on any input), 'error' (compilation\n"
- " error). Note that there are various ways to construct empty class,\n"
- " e.g: [], [^\\x00-\\xFF], [\\x00-\\xFF]\\[\\x00-\\xFF].\n"
- "\n"
- "--dfa-minimization <table | moore>\n"
- " Internal algorithm used by re2c to minimize DFA (defaults to\n"
- " 'moore'). Both table filling and Moore's algorithms should\n"
- " produce identical DFA (up to states relabelling). Table filling\n"
- " algorithm is much simpler and slower; it serves as a reference\n"
- " implementation.\n"
- "\n"
- "-1 --single-pass Deprecated and does nothing (single pass is by default now).\n"
- "\n"
- "-W Turn on all warnings.\n"
- "\n"
- "-Werror Turn warnings into errors. Note that this option along doesn't\n"
- " turn on any warnings, it only affects those warnings that have\n"
- " been turned on so far or will be turned on later.\n"
- "\n"
- "-W<warning> Turn on individual warning.\n"
- "\n"
- "-Wno-<warning> Turn off individual warning.\n"
- "\n"
- "-Werror-<warning> Turn on individual warning and treat it as error (this implies\n"
- " '-W<warning>').\n"
- "\n"
- "-Wno-error-<warning> Don't treat this particular warning as error. This doesn't turn\n"
- " off the warning itself.\n"
- "\n"
- "Warnings:\n"
- "\n"
- "-Wcondition-order Warn if the generated program makes implicit assumptions about\n"
- " condition numbering. One should use either '-t, --type-header'\n"
- " option or '/*!types:re2c*/' directive to generate mapping of\n"
- " condition names to numbers and use autogenerated condition names.\n"
- "\n"
- "-Wempty-character-class Warn if regular expression contains empty character class. From\n"
- " the rational point of view trying to match empty character class\n"
- " makes no sense: it should always fail. However, for backwards\n"
- " compatibility reasons re2c allows empty character class and treats\n"
- " it as empty string. Use '--empty-class' option to change default\n"
- " behaviour.\n"
- "\n"
- "-Wmatch-empty-string Warn if regular expression in a rule is nullable (matches empty\n"
- " string). If DFA runs in a loop and empty match is unintentional\n"
- " (input position in not advanced manually), lexer may get stuck\n"
- " in eternal loop.\n"
- "\n"
- "-Wswapped-range Warn if range lower bound is greater that upper bound. Default\n"
- " re2c behaviour is to silently swap range bounds.\n"
- "\n"
- "-Wundefined-control-flow\n"
- " Warn if some input strings cause undefined control flow in lexer\n"
- " (the faulty patterns are reported). This is the most dangerous\n"
- " and common mistake. It can be easily fixed by adding default rule\n"
- " '*' (this rule has the lowest priority, matches any code unit\n"
- " and consumes exactly one code unit).\n"
- "\n"
- "-Wuseless-escape Warn if a symbol is escaped when it shouldn't be. By default re2c\n"
- " silently ignores escape, but this may as well indicate a typo\n"
- " or an error in escape sequence.\n"
- "\n"
+ /* MANWIDTH=88 PAGER=cat man re2c | sed -n '/^OPTIONS/,/^INTERFACE/ p' |tail -n+2|head -n-1|sed 's/ //' |
+ c_doublequote */
+"\n"
+"-? -h --help\n"
+" Display this info\n"
+"\n"
+"-b --bit-vectors\n"
+" Implies -s. Use bit vectors as well to try to coax better code out of\n"
+" the compiler. Most useful for specifications with more than a few key\xe2\x80\x90\n"
+" words (e.g., for most programming languages).\n"
+"\n"
+"-c --conditions\n"
+" Used for (f)lex-like condition support.\n"
+"\n"
+"-d --debug-output\n"
+" Creates a parser that dumps information about the current position and\n"
+" the state the parser is in. This is useful for debugging parser issues\n"
+" and states. If you use this switch, you need to define a YYDEBUG macro,\n"
+" which will be called like a function with two parameters: void YYDEBUG\n"
+" (int state, char current). The first parameter receives the state or\n"
+" -1 and the second parameter receives the input at the current cursor.\n"
+"\n"
+"-D --emit-dot\n"
+" Emit Graphviz dot data, which can then be processed with e.g., dot\n"
+" -Tpng input.dot > output.png. Please note that scanners with many\n"
+" states may crash dot.\n"
+"\n"
+"-e --ecb\n"
+" Generate a parser that supports EBCDIC. The generated code can deal\n"
+" with any character up to 0xFF. In this mode, re2c assumes an input\n"
+" character size of 1 byte. This switch is incompatible with -w, -x, -u,\n"
+" and -8.\n"
+"\n"
+"-f --storable-state\n"
+" Generate a scanner with support for storable state.\n"
+"\n"
+"-F --flex-syntax\n"
+" Partial support for flex syntax. When this flag is active, named defi\xe2\x80\x90\n"
+" nitions must be surrounded by curly braces and can be defined without\n"
+" an equal sign and the terminating semicolon. Instead, names are\n"
+" treated as direct double quoted strings.\n"
+"\n"
+"-g --computed-gotos\n"
+" Generate a scanner that utilizes GCC's computed-goto feature. That is,\n"
+" re2c generates jump tables whenever a decision is of certain complexity\n"
+" (e.g., a lot of if conditions would be otherwise necessary). This is\n"
+" only usable with compilers that support this feature. Note that this\n"
+" implies -b and that the complexity threshold can be configured using\n"
+" the cgoto:threshold inplace configuration.\n"
+"\n"
+"-i --no-debug-info\n"
+" Do not output #line information. This is useful when you want use a CMS\n"
+" tool with re2c's output. You might want to do this if you do not want\n"
+" to impose re2c as a build requirement for your source.\n"
+"\n"
+"-o OUTPUT --output=OUTPUT\n"
+" Specify the OUTPUT file.\n"
+"\n"
+"-r --reusable\n"
+" Allows reuse of scanner definitions with /*!use:re2c */ after\n"
+" /*!rules:re2c */. In this mode, no /*!re2c */ block and exactly one\n"
+" /*!rules:re2c */ must be present. The rules are saved and used by\n"
+" every /*!use:re2c */ block that follows. These blocks can contain\n"
+" inplace configurations, especially re2c:flags:e, re2c:flags:w,\n"
+" re2c:flags:x, re2c:flags:u, and re2c:flags:8. That way it is possible\n"
+" to create the same scanner multiple times for different character\n"
+" types, different input mechanisms, or different output mechanisms. The\n"
+" /*!use:re2c */ blocks can also contain additional rules that will be\n"
+" appended to the set of rules in /*!rules:re2c */.\n"
+"\n"
+"-s --nested-ifs\n"
+" Generate nested ifs for some switches. Many compilers need this assist\n"
+" to generate better code.\n"
+"\n"
+"-t HEADER --type-header=HEADER\n"
+" Create a HEADER file that contains types for the (f)lex-like condition\n"
+" support. This can only be activated when -c is in use.\n"
+"\n"
+"-u --unicode\n"
+" Generate a parser that supports UTF-32. The generated code can deal\n"
+" with any valid Unicode character up to 0x10FFFF. In this mode, re2c\n"
+" assumes an input character size of 4 bytes. This switch is incompatible\n"
+" with -e, -w, -x, and -8. This implies -s.\n"
+"\n"
+"-v --version\n"
+" Show version information.\n"
+"\n"
+"-V --vernum\n"
+" Show the version as a number in the MMmmpp (Majorm, minor, patch) for\xe2\x80\x90\n"
+" mat.\n"
+"\n"
+"-w --wide-chars\n"
+" Generate a parser that supports UCS-2. The generated code can deal with\n"
+" any valid Unicode character up to 0xFFFF. In this mode, re2c assumes\n"
+" an input character size of 2 bytes. This switch is incompatible with\n"
+" -e, -x, -u, and -8. This implies -s.\n"
+"\n"
+"-x --utf-16\n"
+" Generate a parser that supports UTF-16. The generated code can deal\n"
+" with any valid Unicode character up to 0x10FFFF. In this mode, re2c\n"
+" assumes an input character size of 2 bytes. This switch is incompatible\n"
+" with -e, -w, -u, and -8. This implies -s.\n"
+"\n"
+"-8 --utf-8\n"
+" Generate a parser that supports UTF-8. The generated code can deal with\n"
+" any valid Unicode character up to 0x10FFFF. In this mode, re2c assumes\n"
+" an input character size of 1 byte. This switch is incompatible with -e,\n"
+" -w, -x, and -u.\n"
+"\n"
+"--case-insensitive\n"
+" Makes all strings case insensitive. This makes \"-quoted expressions\n"
+" behave as '-quoted expressions.\n"
+"\n"
+"--case-inverted\n"
+" Invert the meaning of single and double quoted strings. With this\n"
+" switch, single quotes are case sensitive and double quotes are case\n"
+" insensitive.\n"
+"\n"
+"--no-generation-date\n"
+" Suppress date output in the generated file.\n"
+"\n"
+"--no-version\n"
+" Suppress version output in the generated file.\n"
+"\n"
+"--no-generation-date\n"
+" Suppress version output in the generated file.\n"
+"\n"
+"--encoding-policy POLICY\n"
+" Specify how re2c must treat Unicode surrogates. POLICY can be one of\n"
+" the following: fail (abort with an error when a surrogate is encoun\xe2\x80\x90\n"
+" tered), substitute (silently replace surrogates with the error code\n"
+" point 0xFFFD), ignore (treat surrogates as normal code points). By\n"
+" default, re2c ignores surrogates (for backward compatibility). The Uni\xe2\x80\x90\n"
+" code standard says that standalone surrogates are invalid code points,\n"
+" but different libraries and programs treat them differently.\n"
+"\n"
+"--input INPUT\n"
+" Specify re2c's input API. INPUT can be either default or custom.\n"
+"\n"
+"-S --skeleton\n"
+" Instead of embedding re2c-generated code into C/C++ source, generate a\n"
+" self-contained program for the same DFA. Most useful for correctness\n"
+" and performance testing.\n"
+"\n"
+"--empty-class POLICY\n"
+" What to do if the user uses an empty character class. POLICY can be one\n"
+" of the following: match-empty (match empty input: pretty illogical, but\n"
+" this is the default for backwards compatibility reasons), match-none\n"
+" (fail to match on any input), error (compilation error). Note that\n"
+" there are various ways to construct an empty class, e.g., [],\n"
+" [^\\x00-\\xFF], [\\x00-\\xFF][\\x00-\\xFF].\n"
+"\n"
+"--dfa-minimization <table | moore>\n"
+" The internal algorithm used by re2c to minimize the DFA (defaults to\n"
+" moore). Both the table filling algorithm and the Moore algorithm\n"
+" should produce the same DFA (up to states relabeling). The table fill\xe2\x80\x90\n"
+" ing algorithm is much simpler and slower; it serves as a reference\n"
+" implementation.\n"
+"\n"
+"-1 --single-pass\n"
+" Deprecated. Does nothing (single pass is the default now).\n"
+"\n"
+"-W Turn on all warnings.\n"
+"\n"
+"-Werror\n"
+" Turn warnings into errors. Note that this option alone doesn't turn on\n"
+" any warnings at all; it only affects those warnings that have been\n"
+" turned on so far or those that will be turned on later.\n"
+"\n"
+"-W<warning>\n"
+" Turn on a warning.\n"
+"\n"
+"-Wno-<warning>\n"
+" Turn off a warning.\n"
+"\n"
+"-Werror-<warning>\n"
+" Turn on a warning and treat it as an error (this implies -W<warning>).\n"
+"\n"
+"-Wno-error-<warning>\n"
+" Don't treat this particular warning as an error. This doesn't turn off\n"
+" the warning itself.\n"
+"\n"
+"-Wcondition-order\n"
+" Warn if the generated program makes implicit assumptions about condi\xe2\x80\x90\n"
+" tion numbering. You should use either the -t, --type-header option or\n"
+" the /*!types:re2c*/ directive to generate a mapping of condition names\n"
+" to numbers and then use the autogenerated condition names.\n"
+"\n"
+"-Wempty-character-class\n"
+" Warn if a regular expression contains an empty character class. Ratio\xe2\x80\x90\n"
+" nally, trying to match an empty character class makes no sense: it\n"
+" should always fail. However, for backwards compatibility reasons, re2c\n"
+" allows empty character classes and treats them as empty strings. Use\n"
+" the --empty-class option to change the default behavior.\n"
+"\n"
+"-Wmatch-empty-string\n"
+" Warn if a regular expression in a rule is nullable (matches an empty\n"
+" string). If the DFA runs in a loop and an empty match is unintentional\n"
+" (the input position in not advanced manually), the lexer may get stuck\n"
+" in an infinite loop.\n"
+"\n"
+"-Wswapped-range\n"
+" Warn if the lower bound of a range is greater than its upper bound. The\n"
+" default behavior is to silently swap the range bounds.\n"
+"\n"
+"-Wundefined-control-flow\n"
+" Warn if some input strings cause undefined control flow in the lexer\n"
+" (the faulty patterns are reported). This is the most dangerous and most\n"
+" common mistake. It can be easily fixed by adding the default rule (*)\n"
+" (this rule has the lowest priority, matches any code unit, and consumes\n"
+" exactly one code unit).\n"
+"\n"
+"-Wunreachable-rules\n"
+" Warn about rules that are shadowed by other rules and will never match.\n"
+"\n"
+"-Wuseless-escape\n"
+" Warn if a symbol is escaped when it shouldn't be. By default, re2c\n"
+" silently ignores such escapes, but this may as well indicate a typo or\n"
+" error in the escape sequence.\n"
+"\n"
+""
);
}
projects / re2c / commitdiff