editorial cleanup
authorRalph Ronnquist <ralph.ronnquist@gmail.com>
Sun, 23 Apr 2023 05:31:03 +0000 (15:31 +1000)
committerRalph Ronnquist <ralph.ronnquist@gmail.com>
Sun, 23 Apr 2023 05:31:03 +0000 (15:31 +1000)
packnl.8.adoc

index 16f62ffbca3489ebd0c45c2b44853259cd4245d8..c3574f813e7fe48564b3df9cd8f3e94503886b69 100644 (file)
@@ -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_::