`__. The
following instructions assume that you have the commercial version of
LispWorks. If you don't, skip this section.
- Run the LispWorks installation program and install LispWorks into the
c:\\bin\\lispworks-4.2 directory.
- Create a file called console.lisp in the c:\\home\\lisp\\ directory.
This file will be used to create the non-gui console version of the
LispWorks executable. The file should have the following lines in it:
.. raw:: html
(load-all-patches)
(save-image "lw42-console" :console t :environment nil)
(quit)
- Go to a dos command line and enter the following commands to create
the non-gui console version of the LispWorks executable:
.. raw:: html
cd c:\bin\lispworks-4.2
lispworks-4200 -init c:\home\lisp\console.lisp
This will result in the lw42-console.exe file being created in the
c:\\bin\\lispworks-4.2 directory.
7. Installing Corman CL
-----------------------
- Download the precompiled binaries for `Corman
Lisp `__ for Windows from:
http://www.cormanlisp.com/cgi/rgcorman/ccl_download_form.cgi
- Run the downloaded installation program and install Corman CL into
the c:\\bin\\corman-2.5 directory.
- Open the file "c:\\bin\\corman-2.5\\init.lisp", then remove or
comment out the following line (line #3):
.. raw:: html
(setf (current-directory) *cormanlisp-directory*)
8. Configuration steps
----------------------
- Setup environmental variables either in the autoexec.bat file (e.g. -
Windows/98) or the Control Panel/System (e.g. - Windows/NT/2000/XP):
- HOME: Should be set to c:/home (Note: use "/" rather than "". Note
also that you should make certain that you don't have both a User
and a System HOME variable set up when setting up the HOME
environmental variable under Windows/NT/2000/XP. If you do, the
User variable will override the System one. Delete one of the two
(better to leave the system one if you want multiple login users
to use your same emacs configuration) and make certain that it is
set to the c:\\home directory.).
- EMACSDIR: Should be set to c:\\bin\\emacs-21.3
- PATH: The c:\\bin\\emacs-21.3\\bin directory path should be
prepended to the existing PATH to ensure that the Emacs executable
can be found (e.g. -- set path=c:\\bin\\emacs-21.3\\bin;%path%).
- If the specified directory locations were used, no changes to the
.emacs file should be necessary. If file locations were changed, the
directory locations that are specified in the first section of the
.emacs file (the "Site-Specific Variables" section) should be
modified with the correct directory locations (Note: when specifying
directory locations in the .emacs file, use "/" rather than "" as the
directory separator character).
- If not all the Lisp implementations were downloaded, the .emacs file
will still work "as is". If you did download multiple installations,
you will probably want to change the lisp-used variable (default
value is the first lisp implementation in the list of lisp
implementations that you installed) to default to the main lisp
implementation that you will be using (you don't have to change it,
you can still toggle to the other lisp implementations using
"C-M-F5").
- Reboot the PC after making the above changes and configuration
settings.
- Start Emacs (either by using the Start menu's Gnu Emacs shortcut or
by using Run on the Windows Start menu with the command
"c:\\emacs\\bin\\runemacs.exe") and do the following:
- If you installed the cua.el utility:
- Double-click on the "site" directory to drill down into that
directory.
- Compile the cua.el file by pressing "B" when the cursor is on
the file name in the dired window (answer "y" to the
"Byte-Compile (y or n)" prompt).
- If you installed the cua-emul.el utility:
- Double-click on the "site" directory to drill down into that
directory.
- Compile the cua-emul.el file by pressing "B" when the cursor is
on the file name in the dired window (answer "y" to the
"Byte-Compile (y or n)" prompt).
- If you installed the color-theme.el utility:
- Double-click on the "site" directory to drill down into that
directory.
- Compile the color-theme.el file by pressing "B" when the cursor
is on the file name in the dired window (answer "y" to the
"Byte-Compile (y or n)" prompt).
- If you installed CLISP and ILISP, do the following:
- Press "C-M-F5" until the minibuffer window at the bottom says
"lisp-used: :clisp-ilisp" indicating that you have toggled to
CLISP mode.
- Start CLISP by pressing "F5".
- After starting ILISP/CLISP in Emacs, use "M-x
ilisp-compile-inits" to compile the CLISP Lisp initialization
files. When finished, press "F4" to close the *clisp-hs*
window.
- If you installed Lispworks and ILISP, do the following:
- Press "C-M-F5" until the minibuffer window at the bottom says
"lisp-used: :lw-ilisp" indicating that you have toggled to
LispWorks mode.
- Start LispWorks by pressing "F5".
- After starting ILISP/CLISP in Emacs, use "M-x
ilisp-compile-inits" to compile the LispWorks Lisp
initialization files. When finished, press "F4" to close the
window.
- All configuration steps should now be complete - exit Emacs by
pressing "C-x C-c" and pressing "y" when you get the "Do you really
want to exit Emacs ? (y or n)" prompt in the minibuffer.
9. Testing the environments
---------------------------
- Start Emacs (either by using the Start menu's Gnu Emacs shortcut or
by using Run on the Windows Start menu with the command
"c:\\emacs\\bin\\runemacs.exe") and do the following:
- If you installed CLISP, do the following:
- Click in the dired window and press "C-M-F5" until the
minibuffer window at the bottom says "lisp-used: :clisp-ilisp"
indicating that you have toggled to CLISP mode).
- Test that CLISP runs by pressing "F5" (CLISP should open in the
bottom window and the ILISP menu should appear in the Emacs
menu bar).
- Click in the *clisp-hs* window and press "C-h b" (this will
show you the keybindings that are in effect for
ILISP/CLISP).
- Click in the *Help* window and scroll through the keybinding
list. When finished, press "F4" to close that window.
- Click in the *clisp-hs* window and press "F4" to close that
window.
- If you installed ACL, do the following:
- Click in the dired window and press "C-M-F5" until the
minibuffer window at the bottom says "lisp-used: :acl-eli"
indicating that you have toggled to ACL mode).
- Test that ACL runs by pressing "F5". The ACL icon will appear
in the Windows system tray.
- A Listener for ACL should also appear in an Emacs
*common-lisp* buffer and the ACL menus should appear in the
Emacs menu bar.
- Click in the *common-lisp* window and press "C-h b" (this
will show you the keybindings that are in effect for
ELI/ACL).
- Click in the *Help* window and scroll through the keybinding
list. When finished, press "F4" to close that window.
- Click in the *common-lisp* window and select the
ACLFile/Exit Allegro CL menu option (this will close down
the ACL connection and the ACL application will end).
- If you installed LispWorks, do the following:
- Click in the dired window and press "C-M-F5" until the
minibuffer window at the bottom says "lisp-used: :lw-ilisp"
indicating that you have toggled to LispWorks mode).
- Test that LispWorks runs by pressing "F5" (LispWorks should
open in the bottom window and the ILISP menu should appear in
the Emacs menu bar).
- Click in the *lispworks* window and press "C-h b" (this will
show you the keybindings that are in effect for
ILISP/LispWorks).
- Click in the *Help* window and scroll through the keybinding
list. When finished, press "F4" to close that window.
- Click in the *lispworks* window and press "F4" to close that
window.
- If you installed Corman, do the following:
- Click in the dired window and press "M-C-F5" until the
minibuffer window at the bottom says "lisp-used: :corman-inf"
indicating that you have toggled to Corman mode).
- Test that Corman runs by pressing "F5".
- Click in the *inferior-lisp* window and press "C-h b" (this
will show you the keybindings that are in effect for Corman
in Inferior Lisp Mode).
- Click in the *Help* window and scroll through the keybinding
list. When finished, press "F4" to close that window.
- Click in the *inferior-lisp* window and press "F4" to close
that window.
- If you installed the documentation, you can test that the online
documentation works by pressing "F1" (for the HyperSpect) or
"M-F1" (for CLtL2) when the cursor is on a Lisp keyword (e.g. --
"defun" or "setq"). This should bring up a browser with the
documentation for that keyword. See the function key definitions
below for accessing other documentation.
- Exit Emacs by pressing "C-x C-c" and pressing "y" when you get the
"Do you really want to exit Emacs ? (y or n)" prompt in the
minibuffer.
You should now have a working Windows/Emacs setup that supports a number
of different Lisp implementations.
A. Sample .emacs file
---------------------
- Following is a brief explanation of each of the sections of the
sample `.emacs <.emacs>`__ file:
- **Site-Specific Variables:** Contains directory locations for the
different Lisp implementations, Lisp documentation and
Emacs-specific files. It also sets the default Lisp implementation
(Note: if you want to specify a different default Lisp
implementation, change the lisp-used variable to one of
:clisp-ilisp, :clisp-inf, :acl-eli, :lw-ilisp, :corman-inf).
- **Initial Code Load:** Loads Emacs files that are needed later on.
- **System Customizations:** Some standard customizations that make
Emacs easier to use.
- **Programming - Common Lisp:** CL-specific setup.
- **Programming - Elisp:** Emacs Lisp-specific setup.
- **Lisp Key Overrides:** ILISP & ELI have their own key mappings -
here are some extra ones:
- F1 - Brings up the CL Hyperspec (if it was installed)
documentation page for the Lisp symbol under the cursor using
the default browser.
- S-F1 - Brings up the CL Hyperspec (if it was installed)
documentation page for the Lisp symbol under the cursor using
w3 (if it was installed).
- C-u F1 - Brings up the CL Hyperspec (if it was installed)
documentation page for the format character under the cursor
using the default browser.
- C-u S-F1 - Brings up the CL Hyperspec (if it was installed)
documentation page for the format character under the cursor
using w3 (if it was installed).
- C-F1 - Brings up the Franz CL (if it was installed)
documentation page for the Lisp symbol under the cursor using
the default browser.
- C-S-F1 - Brings up the Franz CL (if it was installed)
documentation page for the Lisp symbol under the cursor using
w3 (if it was installed).
- M-F1 - Brings up the CLtL2 (if it was installed) documentation
page for the Lisp symbol under the cursor using the default
browser.
- M-S-F1 - Brings up the CLtL2 (if it was installed)
documentation page for the Lisp symbol under the cursor using
w3 (if it was installed).
- C-M-F1 - Brings up the info (if it was installed) documentation
page for the Lisp symbol under the cursor.
- F5 - Starts the appropriate Lisp mode for the Lisp
implementation that was selected (use C-M-F5 to select the Lisp
implementation before pressing F5 to start it).
- C-M-F5 - Toggles between the different installed Lisp
implementations.
- M-p - For ACL only, in a Lisp listener, retrieves the previous
historical entry (this is already the binding in ILISP).
- M-n - For ACL only, in a Lisp listener, retrieves the next
historical entry (this is already the binding in ILISP).
- C-c d - For ACL only, does a "Do What I Mean" eval/compile (see
function documentation for eli-lisp-eval-or-compile-dwim).
- C-c x - For ACL or the ILISP Lisps, does a "Do What I Mean"
eval/compile (see function documentation for
copy-eval-dwim-lisp).
- C-c e - Prompts for a Lisp form to evaluate.
- C-c ; - Comments out the sexp that the cursor is on (repeated
presses comment outward sexp's). (see function documentation
for insert-balanced-comments).
- C-c : - Uncomments comments that were insered with
insert-balanced-comments (see function documentation for
remove-balanced-comments).
- **Standard Key Overrides:** Some convenience key setups. The
following key bindings have been added:
- mouse-2 - Brings up a menu of Lisp symbols when in a Lisp
source file.
- F6 - Switches focus to another window (when multiple windows
are in an Emacs frame).
- F7 - Closes all windows except for the window that currently
has focus.
- C-F7 - If ECB was loaded, toggles between multiple ECB windows
and just a single source window.
- M-F7 - If ECB was loaded, toggles between different ECB window
layouts.
- F12 - Emacs shell
- C-F12 - Default shell
- M-F12 - Bash shell (if present on computer)
- C-c f - Finds the Emacs Lisp function at the cursor location.
- C-c F - Finds the file whose name is at the cursor location.
- C-c s - Search forward using the symbol that is currently under
the cursor.
- C-c r - Search backward using the symbol that is currently
under the cursor.
- C-c / - Do a word completion (using hippie-expand).
- C-c ] - Goto the matching parenthesis of the parenthesis under
the cursor.
- C-c g - Goto a line (prompts for line#).
- C-c a - Select the entire buffer contents.
- **MS Windows Customizations:** These settings make Emacs feel more
like a Windows application. For Windows machines, they add the
following bindings:
- In dired mode, when you press the "w" key when the cursor is on
a file name, the file will be opened with the default
application for that file type.
- When cua.el is installed:
- C-c - Standard Windows copy.
- C-x - Standard Windows cut.
- C-v - Standard Windows paste.
- C-z - Standard Windows undo.
- When cua-emul.el is installed:
- M-F4 - Close frame (closes Emacs if only one Emacs frame is
open).
- C-F4 - Close the current buffer.
- C-TAB - Switch to next buffer.
- C-S-TAB - Switch to previous buffer.
- **Mac OS X Customizations:** Mac OS X specific customizations:
- Keypad DEL - Deletes character under cursor.
- C-kp-HOME - Goes to beginning of buffer.
- C-kp-END - Goes to end of buffer.
- **Start Directory:** After Emacs starts up, the start directory
will be the HOME directory.
B. Mac OS X Setup Instructions
------------------------------
- At this stage, support for Mac OS X on this page is very limited and
(since I do not use Mac OS X on a regular basis) I would welcome
someone else providing a separate page of instructions. This section
lists the things that are different from the above Windows
instructions.
- There are multiple different versions of Emacs (some Aqua-ized, some
not) for the Mac and there will eventually be an official FSF Emacs
that supports the Aqua GUI. I used `David Caldwell's Carbon
build `__ since the Mac I tested on
had OS X version 10.2. Other Emacs builds on other versions of Mac OS
X may or may not have problems using my .\ `emacs <.emacs>`__ file.
- All of the places in the above Windows instructions where "c:/home"
is mentioned, you should substitute the path to your own home
directory (referenced as "~/" in the remainder of these
instructions). The .\ `emacs <.emacs>`__ file is setup in such a way
that it is not necessary to set any environmental variables manually.
- After downloading ILISP, you will need to modify the makefile & run
make as per the instructions in ILISP.
- The optional cua.el and cua-emul.el utilities caused some issues
under Mac OS X; therefore, the .\ `emacs <.emacs>`__ file ignores
them if you're not on Windows. I have not tested the optional ECB
utility on Mac OS X but it should work with the settings that are in
the .\ `emacs <.emacs>`__ file so long as all the components are
installed in the directories that were specified under the Windows
instructions. The optional color-theme.el utility works fine.
- The .\ `emacs <.emacs>`__ file that is supplied will work unchanged
with either a Windows installation or a Mac OS X installation. For a
Mac install, the assumed directory locations are listed below.
- The following Lisp installations are supported by the
.\ `emacs <.emacs>`__ file. I am not providing full build
instructions for them as was provided for the Windows installation.
The things that you need to know to use these installations with the
.\ `emacs <.emacs>`__ file are:
- CLISP version 2.29: Installed and built with
`Fink `__.
(Note: in order to build CLISP with Fink, you will need the `Apple
December 2002 Development
Tools `__). The
resulting clisp executable should be installed in the /sw/bin/
directory. This is the only source code based install, all the
other Lisp installs are binary; therefore, the CLISP installation
takes the longest and is the most complicated to do.
- ACL version 6.2: Installed from `Franz's download
page `__. After
installation, you need to run (sys:update-allegro) in the ACL Lisp
listener to download some needed fixes for it to run properly on
OS X. ACL should be installed in the ~/bin/acl-6.2/ directory.
- OpenMCL version 0.13: The `binary
distribution `__ was
downloaded and installed in the ~/bin/ directory. The OpenMCL
executable should be at ~/bin/ccl/scripts/openmcl.
- SBCL version 0.8.2.8: The `binary
distribution `__
was downloaded and unpacked. The files src/runtime/sbcl and
output/sbcl.core were moved to the ~/bin/ directory.
- LispWorks 4.3: I was not able to get a trial version of LispWorks
to try out on Mac OS X; however, I have made the changes to the
.emacs file that I think will be necessary to support it. The
LispWorks executable should be at
~/bin/lispworks-4.3/lw43-console.