115 lines
3.7 KiB
Markdown
115 lines
3.7 KiB
Markdown
<pre>
|
||
compile-scheme(1) General Commands Manual compile-scheme(1)
|
||
|
||
NAME
|
||
compile-scheme - Compiling Scheme programs to executables
|
||
|
||
SYNOPSIS
|
||
compile-scheme [-A path] [-I path] [-o path] input-file.sps
|
||
|
||
compile-scheme [-A path] [-I path] [-o path] input-file.scm
|
||
|
||
compile-scheme long-option
|
||
|
||
DESCRIPTION
|
||
compile-scheme is a tool to compile R6RS and R7RS Scheme programs. It
|
||
supports most of SRFI-138 but also adds more features.
|
||
|
||
The program input-file is compiled into an executable file. The result‐
|
||
ing executable file is written to file specified by the -o path (if
|
||
present) or to the file named same as input-file but without the .scm or
|
||
.sps suffix. On Windows either .bat or .exe is appended to the output
|
||
name.
|
||
|
||
SUPPORTED IMPLEMENTATIONS
|
||
Some implementations support both compiling and interpreting, in that
|
||
case only the compiler functionality is used and the implementation is
|
||
marked as compiler.
|
||
|
||
R6RS Compilers
|
||
loko
|
||
|
||
R6RS Interpreters
|
||
chezscheme guile ikarus ironscheme mosh racket sagittarius ypsilon
|
||
|
||
R7RS Compilers
|
||
chicken cyclone loko
|
||
|
||
R7RS Interpreters
|
||
chibi foment gauche guile kawa larceny meevax mit-scheme mosh racket
|
||
sagittarius skint stklos tr7 ypsilon
|
||
|
||
OPTIONS
|
||
-A path Append path to the list of directories that are searched in or‐
|
||
der to locate imported libraries.
|
||
|
||
-I path Prepend directory to the list of directories that are searched
|
||
in order to locate imported libraries.
|
||
|
||
-o output-file Use the output-file file, instead of the default deducted
|
||
from input-file, for the executable file produced.
|
||
|
||
Multiple instances of the -A, and -I options can be specified.
|
||
|
||
--list-r6rs List supported R6RS implementations.
|
||
|
||
--list-r7rs List supported R7RS implementations.
|
||
|
||
--list-all List all supported implementations.
|
||
|
||
--version Show the software version.
|
||
|
||
--help Shows you command to read this manual page. :)
|
||
|
||
ENVIRONMENT
|
||
COMPILE_R7RS
|
||
|
||
COMPILE_SCHEME
|
||
|
||
Either of these environment variables must be set. Set either to
|
||
the name of the implementation as specified in the support list.
|
||
This differs from SRFI-138 as the SRFI excepts a path.
|
||
|
||
STANDARDS
|
||
SRFI 138: Compiling Scheme programs to executables.
|
||
https://srfi.schemers.org/srfi-138/srfi-138.html
|
||
|
||
CAVEATS
|
||
Differences from SRFI-138
|
||
|
||
No support for -D flag.
|
||
|
||
Not all implementations support adding to beginning or end of
|
||
load path so -I and -A might work the same
|
||
|
||
Only supports one input-file.
|
||
|
||
EXAMPLES
|
||
Compile R6RS file with all dependencies in the same directory.
|
||
|
||
COMPILE_SCHEME=<SCHEME> compile-scheme main.sps
|
||
|
||
Compile R7RS file with all dependencies in the same directory.
|
||
|
||
COMPILE_SCHEME=<SCHEME> compile-scheme main.scm
|
||
|
||
Compile R6RS file with dependencies in libs directory.
|
||
|
||
COMPILE_SCHEME=<SCHEME> compile-scheme -I ./libs main.sps
|
||
|
||
Compile R7RS file with dependencies in libs directory.
|
||
|
||
COMPILE_SCHEME=<SCHEME> compile-scheme -I ./libs main.scm
|
||
|
||
Compile R6RS file with dependencies in libs directory, to output named
|
||
foo.
|
||
|
||
COMPILE_SCHEME=<SCHEME> compile-scheme -I ./libs -o foo main.sps
|
||
|
||
Compile R7RS file with dependencies in libs directory, to output named
|
||
foo.
|
||
|
||
COMPILE_SCHEME=<SCHEME> compile-scheme -I ./libs -o foo main.scm
|
||
|
||
compile-scheme(1)
|
||
</pre> |