(or an equivalent form) is made a command line argument to
Lisp. If, because command-line arguments are ignored, the Emacs-Lisp
interface does not start up (or if it does not start up for any other
reason), you can start it directly from within Lisp by calling this
function.

listener-number: a value should only be specified
when starting using a file as described under the heading Starting
the interface after Lisp is already running below. The valuie
should be an integer which is not already used for a *common-lisp*
buffer, if any exist. Typical values are 1 (the default) or 2 or 3.

port: a value should only be specified when
starting using a file as described under the heading Starting the
interface after Lisp is already running below. The value can be it
can be any valid port number on the machine that is not already in
use. Specifying the value nil (the default)
causes the system to choose an appropriate value for the port.

announce-to-file: a value should only be
specified when starting using a file as described under the heading
Starting the interface after Lisp is already running
below. This file (which should not already exists -- it will be
created by this call) is the file used by Eamcs to communicate to Lisp.

The typical form that will start the Emacs-Lisp interface is:

(excl:new-start-emacs-lisp-interface)

It is not an error to call this function when the Emacs-Lisp
interface is in fact running. Doing so will cause some printing to the
listener but have no other effect.

Starting the interface after Lisp is already running

You can start the interface after Lisp has been started, typically not
in Emacs, with this function and the emacs-lisp interface function
fi:start-interface-via-file. This is typically done
for debugging a running but apparently broken process. To do this, in
Lisp call a form like:

We have not specified a value for the
listener-number, so the default 1 is used (if a
*common-lisp* already exists and uses 1, specify a different number),
or for background-streams, so the default t is used. The value given for
port is 7666 (it can be any valid port number on
the machine that is not already in use and can be nil, which causes the system to choose an appropriate
port number), and the value for announce-to-file
is the file that will be used (it must not exist; it will be created
for this call). Then, sometime later on the emacs side, do this (the
host is "pie"):

(fi:start-interface-via-file "pie" "*common-lisp*" "~/.eli-startup")

The arguments are the host running Lisp, the buffer name, and the filename.

This function does not work with the 6.2 version of the Emacs-Lisp interface

It may be that you are running Allegro CL 7.0 but (for whatever
reason) using the version of the Emacs-Lisp interface distributed with
Allegro CL 6.2, and you want to connect Emacs to an already running
Lisp. In that unusual case, you should use the obsolete function
start-emacs-lisp-interface rather than
this function. The version of the emacs-lisp interface is stored in
the emacs variable
fi:emacs-lisp-interface-version. If the value of
that variable is "3.9" or greater, you are using the 7.0 interface.

Copyright (c) 1998-2012, Franz Inc. Oakland, CA., USA. All rights reserved.Documentation for Allegro CL version 8.2. This page was not revised from the 8.1 page.Created 2010.1.21.