NAME

cli - command line interface compiler for C++

SYNOPSIS

cli [options] file

DESCRIPTION

cli generates C++ implementation for command line interface defined in the CLI language. For an input file in the form name.cli the following C++ files are generated: name.hxx (header file), name.ixx (inline file, generated unless the --suppress-inline option is specified), and name.cxx (source file).

OPTIONS

--help

Print usage information and exit.

--version

Print version and exit.

--output-dir | -o dir

Write generated files to dir instead of the current directory.

--suppress-inline

Generate all functions non-inline. By default simple functions are made inline. This option suppresses creation of the inline file.

--hxx-suffix suffix

Use the provided suffix instead of the default .hxx to construct the name of the generated header file.

--ixx-suffix suffix

Use the provided suffix instead of the default .ixx to construct the name of the generated inline file.

--cxx-suffix suffix

Use the provided suffix instead of the default .cxx to construct the name of the generated source file.

--option-prefix prefix

Use the provided prefix instead of the default - as an option prefix. Unknown command line arguments that start with this prefix are treated as unknown options. If you set the option prefix to the empty value, then all the unknown command line arguments will be treated as program arguments.

--option-separator separator

Use the provided separator instead of the default -- as an optional separator between options and arguments. All command line arguments that are parsed after this separator are treated as program arguments. Set the option separator to the empty value if you don't want this functionality.

--include-with-brackets

Use angle brackets (<>) instead of quotes ("") in generated #include directives.

--include-prefix prefix

Add prefix to generated #include directive paths.

--guard-prefix prefix

Add prefix to generated header inclusion guards. The prefix is transformed to upper case and characters that are illegal in a preprocessor macro name are replaced with underscores.

--reserved-name name[=rep]

Add name to the list of names that should not be used as identifiers. The name can optionally be followed by = and the replacement name that should be used instead. All C++ keywords are already in this list.

DIAGNOSTICS

If the input file is not a valid CLI definition, cli will issue diagnostic messages to STDERR and exit with non-zero exit code.

BUGS

Send bug reports to the cli-users@codesynthesis.com mailing list.