diff options
author | Adrian Thurston <thurston@complang.org> | 2008-11-03 17:20:10 +0000 |
---|---|---|
committer | Adrian Thurston <thurston@complang.org> | 2008-11-03 17:20:10 +0000 |
commit | 1f85b3e2bfad623a76022cc2dad22085d125d6c8 (patch) | |
tree | bbaf9361ac52c0314b8f584ad484e6cc2858a679 /README | |
parent | a781b54819c0e128790f8a40ecc80830fa268421 (diff) | |
download | colm-1f85b3e2bfad623a76022cc2dad22085d125d6c8.tar.gz |
Added a README with info on building, syntax highlighting and running.
Diffstat (limited to 'README')
-rw-r--r-- | README | 43 |
1 files changed, 43 insertions, 0 deletions
@@ -0,0 +1,43 @@ +BUILDING +======== + +Colm is currently supported only on Unix-like systems. It depends on the mmap +function and it must be able to find g++ on the path. + +Building Colm from the source repository requires that you have ragel and kelbt +installed. Building these two packages is straightforward. The usual +./configure && make should be all that's needed. Alternatively, you may find +packages for your system. + +http://www.complang.org/ragel/ +http://www.complang.org/kelbt/ + +SYNTAX HIGHLIGHTING +=================== + +There is a vim syntax definition file colm.vim + +RUNNING +======= + +The colm executable takes a Colm program and generates a .cpp file from it. It +then compiles this program using g++. The g++ compile phase depends on include +directories in the colm distribution, as well as a runtime library. Colm finds +these using argv[0]: + + -I dirname(argv[0])"../aapl" + -I dirname(argv[0])"../colm" + dirname(argv[0])"../colm/runtime.a" + +Therefore it is easiest to just run colm from the place it was built. This is +temporary. In the future a proper install scheme will be provided. + +$ ./colm prog.lm + +Will produce: + prog.cpp + prog.bin + +The prog.bin program can then be run on some input: + +$ ./prog.bin < inputfile |