Colm.Net Suite of Programs
                     ==========================

This package contains the Colm Programming Language, Ragel State Machine
Compiler 7.0+, and supporting libraries.

DEPENDENCIES
============

This package has no external dependencies, other than usual autotools and C/C++
compiler programs.

For the program:

    make libtool gcc g++ autoconf automake

For the docucumentation:

 * asciidoc
 * fig2dev


BUILDING
========

Colm is built in the usual autotool way:

$ ./autogen
$ ./configure
$ make
$ make install

RUN-TIME DEPENDENCIES
=====================

The colm program depends on GCC at runtime. It produces a C program as output,
then compiles and links it with a runtime library. The compiled program depends
on the colm library.

Notes on RUNNING
================

To find the includes and the runtime library to pass to GCC, colm looks at
argv[0] to decide if it is running out of the source tree. If it is, then the
compile and link flags are derived from argv[0]. Otherwise, it uses the install
location (prefix) to construct the flags.

SYNTAX HIGHLIGHTING
===================

There are vim syntax definition files colm.vim and ragel.vim