.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.38.2.
.TH BUILDAPP "1" "July 2010" "buildapp 1.1" "User Commands"
.SH NAME
buildapp \- application to create common lisp images
.SH SYNOPSIS
.B buildapp
\fI--output OUTPUT-FILE \fR[\fI--flag1 value1 \fR...]
.SH DESCRIPTION
.SS "Required flags:"
.TP
\fB\-\-output\fR OUTPUT\-FILE
Use OUTPUT\-FILE as the name of the executable
to create
.SS "Entry-point flags:"
.TP
\fB\-\-entry\fR NAME
Use the function identified by NAME as the
executable's toplevel function. Called
with SB\-EXT:*POSIX\-ARGV* as its only
argument. If NAME has a colon, it is
treated as a package separator,
otherwise CL\-USER is the implied
package.
.TP
\fB\-\-dispatched\-entry\fR DNAME
Specify one possible entry function, depending
on the name of the file that is used to
start the application. The syntax of
DNAME is APPLICATION\-NAME/ENTRY\-NAME. If the
name used to start the executable matches
APPLICATION\-NAME, use ENTRY\-NAME as the
entry point. This can be used to choose
one of many possible entry points by
e.g. symlinking names to the application
executable. If APPLICATION\-NAME is empty, the
specified ENTRY\-NAME is used as a default
if no other application names match. There
may be any number of dispatched entry points,
but only one default.
.SS "Action flags:"
.TP
\fB\-\-load\fR FILE
Load FILE. CL:*PACKAGE* is bound to the CL\-USER
package before loading
.TP
\fB\-\-load\-system\fR NAME
Load an ASDF system identified by NAME
.TP
\fB\-\-require\fR NAME
Use CL:REQUIRE to load NAME
.TP
\fB\-\-eval\fR CODE
Use CL:EVAL to evaulate CODE. The code is read
with CL:READ\-FROM\-STRING in the CL\-USER package
.PP
There may be any number of load/load\-system/require/eval flags. Each
is executed in command\-line order before creating an executable.
.SS "Load path flags:"
.TP
\fB\-\-load\-path\fR DIRECTORY
When handling a \fB\-\-load\fR, search DIRECTORY for
files to load
.TP
\fB\-\-asdf\-path\fR DIRECTORY
When handling a \fB\-\-load\-system\fR, search DIRECTORY
for ASDF system files to load
.TP
\fB\-\-asdf\-tree\fR DIRECTORY
When handling a \fB\-\-load\-system\fR, search DIRECTORY
and all its subdirectories for ASDF system
files to load
.PP
There may be any number of load\-path/asdf\-path/asdf\-tree
flags. asdf\-path arguments take precedence over asdf\-tree arguments.
.SS "Other flags:"
.TP
\fB\-\-help\fR
Show this usage message
.TP
\fB\-\-logfile\fR FILE
Log compilation and load output to FILE
.TP
\fB\-\-sbcl\fR PATH\-TO\-SBCL
Use PATH\-TO\-SBCL instead of the sbcl program
found in your PATH environment variable
.PP
For the latest documentation, see http://www.xach.com/lisp/buildapp/