mirror of
https://github.com/ashinn/chibi-scheme.git
synced 2025-05-21 22:59:16 +02:00
Official chibi-scheme repository
a18deb68cc
Chibi uses a lot of #if conditioned code so that configuration
management can be done entirely with the C preprocessor.
Originally this also involved conditional includes of .c files
from other source files. The alterative, which this change
switches to, is to compile and link all files, and for uneeded
files conditionally eliminate their entire bodies so they compile
to empty object files.
Pros for conditionally including all code into one large file:
* Don't need to declare most functions (keeps .h files small).
* Can keep most functions static/inlined (keeps objects small).
* Don't need to even distribute uneeded files with the default
Makefile (e.g. can prune opt/* from dist for minimal builds).
Pros for linking multiple possibly empty files:
* Extensions and third-party libs probably want the exported
declarations anyway.
* Static analysis tools work better (e.g. flymake on what previously
was an included file).
* Can build each file in parallel (i.e. make -j for faster builds).
* Can build and link in just the changed files, instead of
having to recompile the whole thing.
For Chibi these are all minor points - it will be small
regardless, and will build fast regardless - but the arguments
for splitting seem stronger. Note the new shared lib is about
1k larger, but that can be trimmed down later.
|
||
|---|---|---|
| benchmarks/shootout | ||
| build-lib/chibi/char-set | ||
| contrib | ||
| data | ||
| doc | ||
| examples | ||
| include/chibi | ||
| lib | ||
| opt | ||
| tests | ||
| tools | ||
| .hgignore | ||
| AUTHORS | ||
| chibi-scheme.vcproj | ||
| COPYING | ||
| eval.c | ||
| fedora.spec | ||
| gc.c | ||
| main.c | ||
| Makefile | ||
| Makefile.detect | ||
| Makefile.libs | ||
| mkfile | ||
| opcodes.c | ||
| README | ||
| README.libs | ||
| RELEASE | ||
| sexp.c | ||
| TODO | ||
| VERSION | ||
| vm.c | ||
Chibi-Scheme
--------------
Minimal Scheme Implementation for use as an Extension Language
http://synthcode.com/wiki/chibi-scheme/
Chibi-Scheme is a very small library intended for use as an extension
and scripting language in C programs. In addition to support for
lightweight VM-based threads, each VM itself runs in an isolated heap
allowing multiple VMs to run simultaneously in different OS threads.
The default language is an extended subset of the current draft R7RS
Scheme, with support for all libraries. Support for additional
languages such as JavaScript, Go, Lua and Bash are planned for future
releases. Scheme is chosen as a substrate because its first class
continuations and guaranteed tail-call optimization makes implementing
other languages easy.
To build on most platforms just run "make && make test". This will
provide a shared library "libchibi-scheme", as well as a sample
"chibi-scheme" command-line repl. You can then run
sudo make PREFIX=/usr/local install
to install the binaries, leaving out the PREFIX for the default
/usr/local or specifying an alternate install location. If you want
to try out chibi-scheme without installing, be sure to set
LD_LIBRARY_PATH so it can find the shared libraries.
For more detailed documentation, run "make doc" and see the generated
"doc/chibi.html".