This archive contains pre-configured CLI source code with all its 
dependencies. On UNIX-like operating systems it allows you to built
CLI in non-interactive mode (that is, without answering any questions).

Send questions, bug reports, or any other feedback to 
cli-users@codesynthesis.com.


UNIX
----

Building on UNIX-like operating systems requires GNU make 3.81 or later.
Most recent GNU/Linux distributions should already have this version
installed. To check the GNU make version run make (or gmake) with the
--version option.

The build system supports the following standard variables:

CXX        (defaults to g++ if not set)
CPPFLAGS
CXXFLAGS
LDFALGS
LIBS
AR         (defaults to ar if not set)
RANLIB     (defaults to ranlib if not set)

For example:

$ make CXX=g++-4.2 CXXFLAGS=-O3

After the build, the CLI compiler can be found in the cli/cli/ directory.

If you would like to see the full compiler/linker/etc., command lines,
you can add verbose=1 to the make command line, for example:

$ make verbose=1

To build and run automated test suites for the CLI compiler as well as 
all the dependencies, run:

$ make test

To clean the object files, libraries, executable, etc., run:

$ make clean

To install the CLI compiler, examples, and documentation use the install
target, for example:

$ make install_prefix=/usr install

You can fine-tune the installation locations with the following make
variables:

install_prefix       default is /usr/local
install_data_prefix  default is install_prefix
install_exec_prefix  default is install_prefix

install_bin_dir      default is install_exec_prefix/bin
install_sbin_dir     default is install_exec_prefix/sbin
install_lib_dir      default is install_exec_prefix/lib

install_data_dir     default is install_data_prefix/share
install_inc_dir      default is install_data_prefix/include

install_doc_dir      default is install_data_dir/doc
install_man_dir      default is install_data_dir/man
install_info_dir     default is install_data_dir/info

You can also run make from various sub-directories in this package. For
example, to build and run the automated test suite only for the CLI 
compiler, you can do the following:

$ cd cli/tests
$ make test


Windows
-------

Project and solution files are provided for Visual C++ 8.0 (2005) and 
9.0 (2008). To build the CLI compiler, open and build the corresponding
solution in the root directory of the package. After the build is complete,
the compiler executable can be found in the cli\cli\ directory. You can 
also build examples by opening and building one of the solution files in
the cli\examples\ directory.