Fcalva/chibi-scheme
1
0
Fork 0
mirror of https://github.com/ashinn/chibi-scheme.git synced 2025-07-14 08:27:34 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

documentation tweaks

Browse source
This commit is contained in:
Alex Shinn 2011-05-23 04:36:35 -07:00
parent 7d6de13485
commit 498ab5da3e
1 changed files with 29 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

36
doc/chibi.scrbl
View file

@ -28,8 +28,8 @@ standard modules. You can choose whichever layer suits your needs
best and customize the rest. Adding your own primitives or wrappers best and customize the rest. Adding your own primitives or wrappers
around existing C libraries is easy with the C FFI. around existing C libraries is easy with the C FFI.
Chibi is known to build and run on 32 and 64-bit Linux, OS X, Windows Chibi is known to build and run on 32 and 64-bit Linux, OS X,
(under cygwin) and Plan9. iPhone OS, Windows (under cygwin) and Plan9.
@section{Installation} @section{Installation}
@ -72,10 +72,31 @@ or edited manually. Be sure to run this with a non-static
chibi-scheme. Then you can make the static executable with: chibi-scheme. Then you can make the static executable with:
@command{ @command{
make cleaner make -B chibi-scheme-static SEXP_USE_DL=0 CPPFLAGS=-DSEXP_USE_STATIC_LIBS
make chibi-scheme-static SEXP_USE_DL=0 CPPFLAGS=-DSEXP_USE_STATIC_LIBS
} }
@subsection{Compile-Time Options}
The include file @ccode{"chibi/features.h"} describes a number of
C preprocessor values which can be enabled or disabled by setting to
1 or 0 respectively. For example, the above commands used the
features @ccode{SEXP_USE_BOEHM}, @ccode{SEXP_USE_DL} and
@ccode{SEXP_USE_STATIC_LIBS}. Many features are still experimental
and may be removed from future releases, but the important features
are listed below.
@itemlist[
@item{@ccode{SEXP_USE_BOEHM} - link with the Boehm GC instead of the native Chibi GC}
@item{@ccode{SEXP_USE_DL} - allow dynamic linking (enabled by default)}
@item{@ccode{SEXP_USE_STATIC_LIBS} - compile the standard C libs statically}
@item{@ccode{SEXP_USE_MODULES} - use the module system}
@item{@ccode{SEXP_USE_GREEN_THREADS} - use lightweight threads (enabled by default)}
@item{@ccode{SEXP_USE_SIMPLIFY} - use a simplification optimizer pass (enabled by default)}
@item{@ccode{SEXP_USE_BIGNUMS} - use bignums (enabled by default)}
@item{@ccode{SEXP_USE_FLONUMS} - use flonums (enabled by default)}
@item{@ccode{SEXP_USE_NO_FEATURES} - disable almost all features}
]
@section{Default Language} @section{Default Language}
@subsection{Scheme Standard} @subsection{Scheme Standard}
@ -123,7 +144,8 @@ environment:
@subsection{Module System} @subsection{Module System}
A configurable module system, in the style of the Scheme48 module A configurable module system, in the style of the
@hyperlink["http://s48.org/"]{Scheme48} module
system, is provided if you choose to use it. system, is provided if you choose to use it.
Modules names are hierarchical lists of symbols or numbers. The definition of Modules names are hierarchical lists of symbols or numbers. The definition of
@ -177,11 +199,11 @@ In addition, low-level hygienic macros are provided with a
syntactic-closures interface, including @scheme{sc-macro-transformer}, syntactic-closures interface, including @scheme{sc-macro-transformer},
@scheme{rsc-macro-transformer}, and @scheme{er-macro-transformer}. A good @scheme{rsc-macro-transformer}, and @scheme{er-macro-transformer}. A good
introduction to syntactic-closures can be found at introduction to syntactic-closures can be found at
@url{http://community.schemewiki.org/?syntactic-closures} @url{http://community.schemewiki.org/?syntactic-closures}.
@scheme{identifier?}, @scheme{identifier->symbol}, @scheme{identifier=?}, and @scheme{identifier?}, @scheme{identifier->symbol}, @scheme{identifier=?}, and
@scheme{make-syntactic-closure} and @scheme{strip-syntactic-closures} are @scheme{make-syntactic-closure} and @scheme{strip-syntactic-closures} are
available. also available.
@subsection{Types} @subsection{Types}