packnl(8) ========= :doctype: manpage :revdate: {sys:date "+%Y-%m-%d %H:%M:%S"} :COLON: : :EQUALS: = :NEWLINE: \n NAME ---- packnl - Pack newlisp scripts into an embedded binary. SYNOPSIS -------- *packnl* -w _binary_ _member-option_* *packnl* -u _binary_ _path_ *packnl* -t _binary_ DESCRIPTION ----------- *packnl* is a utility to pack a newlisp application into a binary using the embedding feature of newlisp. Such a packed binary will have the special +incore.lsp+ as embedded script, and it is then extended with the given application files in a "simple archive" format. The first application script is "main script" and it is loaded automatically. Additional application scripts and files are set up to be available as overriding filenames for the +load+, +read-file+ and +file?+ functions. E.g., where the running script has the expression "(load _file_)" then _file_ is first looked up as being an embedded member (script), and only secondarily looked up in the filesystem. OPTIONS ------- Command Options ~~~~~~~~~~~~~~~ *-w* _binary_ _members_:: The *-w* command option is used for writing an embedded newlisp binary with the nominated scripts. The subseqent arguments nominate the scripts to include, and optionally nominate +ar+ style libraries of scripts to include from, or include a library in full, as well as optionally change the input directory for resolving subsequent script names. See *Member Options* below. *-u* _binary_ _path_:: The *-u* command option is used for unpacking an embedded binary into the nominated directory. *t* _binary_:: The *-t* command option is used for enlisting then names of the included members of an embedded binary. Member Otions ~~~~~~~~~~~~~ *_member_*:: All member arguments other than the options below are undestood to nominate scripts to embed with file names as given. *-a* _library_:: The *-a* option installs the script members from a given +ar+ style library to be available for embedding. The subsequent arguments nominate members to include. *-A* _library_:: The *-A* option incorporates all the script members from the given +ar+ style library into the embedding. *-C* _path_:: The *-C* option changes the working directory for the program so that subsequent relative pathnames (file members and libraries) are found relative that working directory. SEE ALSO -------- *newlisp*, *ar* AUTHOR ------ Ralph Ronnquist