+*incore.lsp* is a newlisp module for application embedding into
+self-contained script collections including both an in-core archive
+and optionally external archives in _ar_ or _tar_ formats.
+
+The first use case illustrates loading the module in a running script.
+When the module is loaded it installs an _archives_ hashtable and an
+_archive_ context for handling an in-core archive, and then it wraps
+newlisp's _load_, _read-file_ and _file?_ functions to first use the
+_archives_ hashtable before looking at the external filesystem.
+
+The second use case shows an example of a _Makefile_ fragment that
+makes an embedding with *incore.lsp* extended with an in-core archive
+following the divide line of 40 "x" characters. The resulting _binary_
+will contain all the mentioned newlisp scripts ( _main.lsp_ and all
+_other.lsp_) as an in-core archive appended to the embedding of
+*incore.lsp*. As a result when the binary is executed the _main.lsp_
+script will be loaded and thus executed as the application script
+while all _other.lsp_ scripts are availble to it for _load_ and
+_read-file_.
+
+The third use case presents how the _packnl_ utility is used to achive
+the same embedding as the second use case, though with the addition of
+referring to scripts within _ar_ aor _tar_ archive files.
+
+=== incore.lsp API
+
+*core:core*::
+
+This is a data reference functor that gets set up by reading
+"/proc/self/exe". This is only useful for an embedded binary where it
+will contain application's inc-core archive. Any other use case will
+need to redefine *core:core* for its in-core archive, if any.