BUILDAPP(1)

NAME
buildapp - application to create common lisp images

SYNOPSIS
buildapp --output OUTPUT-FILE [--flag1 value1 ...]

DESCRIPTION

  Required flags:

--output OUTPUT-FILE
    Use OUTPUT-FILE as the name of the executable to create

  Entry-point flags:

--entry 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.

--dispatched-entry 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.

  Action flags:

--load FILE
    Load FILE. CL:*PACKAGE* is bound to the CL-USER package before loading

--load-system NAME
    Load an ASDF system identified by NAME

--require NAME
    Use CL:REQUIRE to load NAME

--eval CODE
    Use CL:EVAL to evaulate CODE. The code is read with CL:READ-FROM-STRING in the CL-USER package

There may be any number of load/load-system/require/eval flags. Each is executed in command-line order before creating an executable.

  Load path flags:

--load-path DIRECTORY
    When handling a --load, search DIRECTORY for files to load

--asdf-path DIRECTORY
    When handling a --load-system, search DIRECTORY for ASDF system files to load

--asdf-tree DIRECTORY
    When handling a --load-system, search DIRECTORY and all its subdirectories for ASDF system files to load

There may be any number of load-path/asdf-path/asdf-tree flags. asdf-path arguments take precedence over asdf-tree arguments.

  Other flags:

--help
    Show this usage message

--logfile FILE
    Log compilation and load output to FILE

--sbcl PATH-TO-SBCL
    Use PATH-TO-SBCL instead of the sbcl program found in your PATH environment variable

For the latest documentation, see http://www.xach.com/lisp/buildapp/