From 2344ae619b86cca1784cfdfa24a5ed640779d9e0 Mon Sep 17 00:00:00 2001 From: Ralph Ronnquist Date: Sun, 23 Apr 2023 15:31:03 +1000 Subject: [PATCH] editorial cleanup --- packnl.8.adoc | 33 ++++++++++++++------------------- 1 file changed, 14 insertions(+), 19 deletions(-) diff --git a/packnl.8.adoc b/packnl.8.adoc index 16f62ff..c3574f8 100644 --- a/packnl.8.adoc +++ b/packnl.8.adoc @@ -17,21 +17,19 @@ packnl - Pack newlisp scripts into an embedded binary. == DESCRIPTION -*packnl* is a utility to package up 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. - +*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 then contain the given +application files in a "simple archive" format after an easily +recognizable divider line of 40 "x" characters. + +The first application file is used as "main script" the gets loaded +when running the binary. Any additional application files are set up +as an in-core archive to be available as overriding filenames in the ++load+, +read-file+ and +file?+ functions. I.e. where the running +script has the expression "(load _file_)" then _file_ pathname is +first looked up in the in-core archive and only secondarily looked up +in the filesystem. == OPTIONS @@ -41,10 +39,7 @@ only secondarily looked up in the filesystem. 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. +scripts to include in order. See *Member Options* below. *-u* _binary_ _path_:: -- 2.39.2