.\" Process this file with
.\" groff -man -Tascii cli.1
.\"
.TH CLI 1 "October 2009" "CLI 1.0.0"
.SH NAME
cli \- command line interface compiler for C++
.\"
.\"
.\"
.\"--------------------------------------------------------------------
.SH SYNOPSIS
.\"--------------------------------------------------------------------
.B cli
.B [
.I options
.B ]
.I file
.\"
.\"
.\"
.\"--------------------------------------------------------------------
.SH DESCRIPTION
.\"--------------------------------------------------------------------
.B cli
generates C++ implementation and documentation in various formats for a
command line interface defined in the CLI language. For an input file in
the form
.B name.cli
the following is generated. By default or if the
.B --generate-cxx
option is specified, the following C++ files are generated:
.B name.hxx
(header file),
.B name.ixx
(inline file, generated unless the
.B --suppress-inline
option is specified), and
.B name.cxx (source file).
If the
.B --generate-html
option is specified, then the
.B name.html
HTML documentation file is generated. If the
.B --generate-man
option is specified, then the
.B name.1
man page file is generated. When
.B --generate-html
or
.B --generate-man
is specified, the
.B --stdout
option can be used to redirect the output to STDOUT instead of a file.
.\"
.\"
.\"
.\"--------------------------------------------------------------------
.SH OPTIONS
.\"--------------------------------------------------------------------
.\"
.\" The following documentation was generated by CLI, a command
.\" line interface compiler for C++.
.\"
.IP "\fB--help\fP"
Print usage information and exit\.

.IP "\fB--version\fP"
Print version and exit\.

.IP "\fB--output-dir\fP|\fB-o\fP \fIdir\fP"
Write the generated files to \fIdir\fP instead of the current directory\.

.IP "\fB--generate-modifier\fP"
Generate option value modifiers in addition to accessors\.

.IP "\fB--generate-file-scanner\fP"
Generate the argv_file_scanner implementation\. This scanner is capable of
reading command line arguments from the argv array as well as files
specified with command line options\.

.IP "\fB--suppress-inline\fP"
Generate all functions non-inline\. By default simple functions are made
inline\. This option suppresses creation of the inline file\.

.IP "\fB--suppress-usage\fP"
Suppress the generation of the usage printing code\.

.IP "\fB--long-usage\fP"
If no short documentation string is provided, use the complete long
documentation string in usage\. By default, in this situation only the first
sentence from the long string is used\.

.IP "\fB--option-length\fP \fIlen\fP"
Indent option descriptions \fIlen\fP characters when printing usage\. This
is useful when you have multiple options classes, potentially in separate
files, and would like their usage to have the same indentation level\.

.IP "\fB--generate-cxx\fP"
Generate C++ code\. If neither \fB--generate-man\fP nor
\fB--generate-html\fP is specified, this mode is assumed by default\.

.IP "\fB--generate-man\fP"
Generate documentation in the man page format\.

.IP "\fB--generate-html\fP"
Generate documentation in the HTML format\.

.IP "\fB--man-prologue\fP \fIfile\fP"
Insert the content of \fIfile\fP at the beginning of the man page file\.

.IP "\fB--man-epilogue\fP \fIfile\fP"
Insert the content of \fIfile\fP at the end of the man page file\.

.IP "\fB--html-prologue\fP \fIfile\fP"
Insert the content of \fIfile\fP at the beginning of the HTML file\.

.IP "\fB--html-epilogue\fP \fIfile\fP"
Insert the content of \fIfile\fP at the end of the HTML file\.

.IP "\fB--class\fP \fIfq-name\fP"
Generate the man page or HTML documentation only for the \fIfq-name\fP
options class\. The \fIfq-name\fP name should be a fully-qualified options
class name, for example, \fBapp::options\fP\. This functionality is useful
if you need to insert custom documentation between options belonging to
different classes\.

.IP "\fB--stdout\fP"
Write output to STDOUT instead of a file\. This option is not valid when
generating C++ code and is normally used to combine generated documentation
for several option classes in a single file\.

.IP "\fB--hxx-suffix\fP \fIsuffix\fP"
Use \fIsuffix\fP instead of the default \fB\.hxx\fP to construct the name of
the generated header file\.

.IP "\fB--ixx-suffix\fP \fIsuffix\fP"
Use \fIsuffix\fP instead of the default \fB\.ixx\fP to construct the name of
the generated inline file\.

.IP "\fB--cxx-suffix\fP \fIsuffix\fP"
Use \fIsuffix\fP instead of the default \fB\.cxx\fP to construct the name of
the generated source file\.

.IP "\fB--man-suffix\fP \fIsuffix\fP"
Use \fIsuffix\fP instead of the default \fB\.1\fP to construct the name of
the generated man page file\.

.IP "\fB--html-suffix\fP \fIsuffix\fP"
Use \fIsuffix\fP instead of the default \fB\.html\fP to construct the name
of the generated HTML file\.

.IP "\fB--option-prefix\fP \fIprefix\fP"
Use \fIprefix\fP instead of the default \fB-\fP 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\.

.IP "\fB--option-separator\fP \fIsep\fP"
Use \fIsep\fP instead of the default \fB--\fP as an optional separator
between options and arguments\. All the 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\.

.IP "\fB--include-with-brackets\fP"
Use angle brackets (<>) instead of quotes ("") in the generated
\fB#include\fP directives\.

.IP "\fB--include-prefix\fP \fIprefix\fP"
Add \fIprefix\fP to the generated \fB#include\fP directive paths\.

.IP "\fB--guard-prefix\fP \fIprefix\fP"
Add \fIprefix\fP to the 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\.

.IP "\fB--reserved-name\fP \fIname\fP=\fIrep\fP"
Add \fIname\fP with an optional \fIrep\fP replacement to the list of names
that should not be used as identifiers\. If provided, the replacement name
is used instead\. All C++ keywords are already in this list\.

.IP "\fB--options-file\fP \fIfile\fP"
Read additional options from \fIfile\fP with each option appearing on a
separate line optionally followed by space and an option value\. Empty lines
and lines starting with \fB#\fP are ignored\. The semantics of providing
options in a file is equivalent to providing the same set of options in the
same order on the command line at the point where the \fB--options-file\fP
option is specified except that shell escaping and quoting is not required\.
Repeat this option to specify more than one options files\.

.\"
.\" DIAGNOSTICS
.\"
.SH DIAGNOSTICS
If the input file is not a valid CLI definition,
.B cli
will issue diagnostic messages to STDERR and exit with non-zero exit code.
.\"
.\" BUGS
.\"
.SH BUGS
Send bug reports to the cli-users@codesynthesis.com mailing list.
.\"
.\" COPYRIGHT
.\"
.SH COPYRIGHT
Copyright (c) 2009 Code Synthesis Tools CC.

Permission is granted to copy, distribute and/or modify this document under
the terms of the MIT License. Copy of this license can be obtained from
http://www.codesynthesis.com/licenses/mit.txt