.\" -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH STKLOS-COMPILE 1 "version @VERSION@"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
stklos-compile \- Compiles a STklos file to byte-codes

.SH DESCRIPTION
The
.B stklos-compile
compiles a STklos file to byte-codes. For now, this command is very
poor, it should be extended in the future.

.SH OPTIONS
Here are the options available in the version @VERSION@ of
.B stklos.

.IP "--case-sensitive, -c"
Symbols are case sensitive
.IP "--output=<file>, -o <file>"
Output the compiled code in the given file instead of
.I a.out.
.IP "--C-code, -C"
Produce the byte-code in a C file instead of a ".ostk" file.

.IP "--evalute=<expr>, e <expr>"
Evaluate the Sexpr <expr> before starting compilation. This is useful,
for loading files which are needed for the compilation (e.g. files
defining new syntaxes).
.IP "--line-info, -l"
Generate line informations to ease debugging (incurs a small
performance penalty).
.IP "--show-instructions, -S"
Produce the VM instructions in the generated file. Actually,
it is probably only useful if you want to hack the VM.

.IP "--prepend-load-path=<dir>, -L <dir>"
Prepend the directory <dir> to the compiler loading path.
.IP "--append-load-path=<dir>"
Append the directory <dir> to the compiler loading path.

.IP "--no-time"
Do not display the compilation time
.IP "--help | -h | -?"
Show help.

.SH "SEE ALSO"
.BR stklos (1)
.BR stklos-config (1)