BUILDAPP(1)							   User Commands						       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  APPLICA-
	      TION-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/

buildapp 1.1							     July 2010							       BUILDAPP(1)