update-bundle-files

Arguments: &key include-new-efs files bundle tdir bundle-prog bli-tf

This page was significantly revised in the Allegro CL 6.1 documentation update # 1. In Allegro CL 6.1, bundle files are updated automatically when update.sh or update.bat are run (that was not the case in Allegro CL 6.0). As originally released, this page did not talk about automatic updating. The revised page does. See the Documentation updates note in introduction.htm for information on significant and other types of revisions.

Although this function can be called at any time, it is generally only needed if a patch is downloaded from Franz Inc., which when built into the Lisp, displays a message at startup time advising the user to call this function.

If a user defines a new external-format which s/he wants to be autoloadable in a runtime application, the definition should be made in a file named code/ef-[name].fasl (where code/ is a subdirectory of the Allegro CL directory). When this function is called, a copy of the external-format definition file will be put into the bundle and runtime bundle. Note that only files named code/ef-*.fasl are placed into the bundle by this function.

This function updates the bundle file (returned by bundle-pathname) and also the runtime bundle file runtime.bu (if there is one). After the update, all module fasl files downloaded to the code/ subdirectory of the Allegro Directory will be included in the bundle. External format definitions not in the bundle will also be included.

Note that updating the bundle can take an appreciable amount of time.

The arguments are all keyword arguments. It is recommended that update-bundle-files be run without arguments (that is, the defaults be accepts in all cases). The arguments are:

• include-new-efs:include external-format definitions found in #p"sys;code;" which aren't already in the bundle.
• files: list of pairs of pathnames. These correspond to the original names and target names of files to be updated.
• bundle: the primary file to be updated.
• tdir: pathname of temporary directory to be used. This directory should not exist. Furthermore, the directory is removed before the function returns.
• bundle-prog: name of bundle manipulation program.
• bli-tf: the temporary script file name used to hold the forms passed to build-lisp-image, a function called by update-bundle-files.

Copyright (c) 1998-2001, Franz Inc. Berkeley, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.1 update # 1. This page has had significant revisions.
Created 2001.12.15.