| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: name &rest args
This function allows the execution of top-level commands from programs. It hides the method of dispatch for top-level commands, and should be the sole means of accessing top-level commands outside typing them to the top-level read-eval-print loop.
name must be a string or symbol naming a top-level command. An error is signaled if it is not. args are the arguments that are passed to the command.
For example, the form
(tpl:do-command "history" :reverse t)
will print the command history in reverse order, just like
:history :reverse t
When Lisp is starting up, information necessary or environment necessary to process many top-level commands is not available while initialization files (such as .clinit.cl, clinit.cl, and sys:siteinit.cl) are being read. Therefore, using this function to call those top-level commands from within initialization files may cause an error (perhaps an unrecoverable error). Among the commands that are known to fail are :zoom and its relatives. We recommend that you do not call any top-level commands in initialization files.
This operator is not available in Lisp images built with a minimal
top level, that is built with the
include-tpl argument to build-lisp-image specified nil
. See
Minimal top levels in
building-images.htm for information on minimal top
levels.
See top-level.htm for more information on the top level.
Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |