Requires Optional LISP SoftBench Software

NAME

lispbench − LISP SoftBench interface tool

SYNOPSIS

lispbench

DESCRIPTION

lispbench is a window-based set of tools for programming in Common LISP that is based on HP SoftBench and HP Encapsulator.  For more information refer to the HP LISP-SoftBench Interface User’s Guide.

USAGE

The main screen presents pull-down menu bars and a LISP buffer (listener).  Additionally, lispbench contains tools that have their own pull-down menu bars and buffers. 

The pull-down menu bars can be used to access all of lispbench’s features.  Commands that are available from the pull-down menu bar are detailed in the Commands section below.  All of these commands are also accessible through user-defined key bindings. 

The LISP buffer area is an I/O buffer which can be used interactively to read, eval, or print forms through the LISP listener (a traditional LISP listener). 

The Build tool and the Common LISP Help tool contain two buffers each.  The lower buffers in both of these tools are windows to the LISP listener.  The top buffer in the Build tool, Build Edit Buffer, is used for editing different build constructs, and the one in the Common LISP Help tool, Common LISP List Buffer furnishes a list of available commands in Common LISP. 

lispbench should be invoked by using the SoftBench Tool Manager. 

Starting From The Tool Manager

Select the Tool:Start function from the pull-down menu in the SoftBench Tool Manager.  A window pops up showing a list of tools available from the SoftBench Tool Manager.  A single click on LISP from the list selects lispbench.  Press the Start button, or double-click on LISP to start lispbench. 

COMMANDS

Main lispbench Interface Screen:

The main screen has several pull down menus.  These are labeled File, Actions, Utilities, and Help.  Commands can be issued from buttons in the pull-down Menu, or by using a key binding.  These key bindings can be used from any of the tool windows as well. 

File Pull-Down Menu:

Edit...  Opens a new Edit window for editing Common LISP source files.  The default editor and the currently supported one is Gnu Emacs .  Default keyboard accelerator: Meta-E. 

Set Context...  Changes the context in which lispbench runs.  The context consists of the name of the host system and the base directory where the user’s files reside.  Default keyboard accelerator: Meta-C. 

Load File...  Loads a Common LISP file into lispbench.  Default keyboard accelerator: Ctrl-Meta-L. 

Compile File...  Compiles a Common LISP file and creates a binary file containing native machine code.  Default keyboard accelerator: Ctrl-Meta-C. 

Write Buffer...  Writes the entire contents of one or more of lispbench’s I/O buffers to a file.  Default keyboard accelerator: Meta-W. 

Quit LISPBench Quits lispbench.  Default keyboard accelerator: Meta-Q. 

Actions Pull-Down Menu:

Evaluate...  Evaluates a Common LISP form.  Default keyboard accelerator: Ctrl-Meta-X or use the Enter buttons. 

MacroExpand...  Expands a Common LISP macro before evaluating it.  Default keyboard accelerator: Ctrl-Meta-M. 

PrettyPrint...  Displays a formatted version of a Common LISP form.  Default keyboard accelerator: Ctrl-Meta-P. 

Describe...  Displays information about a Common LISP object.  Default keyboard accelerator: Ctrl-Meta-D. 

SourceCode...  Displays the source code of an interpreted function in HP Common LISP.  Default keyboard accelerator: Ctrl-Meta-S. 

ArgList...  Displays the arguments to a function in HP Common LISP.  Default keyboard accelerator: Ctrl-Meta-A. 

Disassemble...  Disassembles a compiled function and displays the assembly code for that function in HP Common LISP.  Default keyboard accelerator: Ctrl-Meta-I. 

Show Debugger Commands
Displays the window based Debugger Commands List. Default keyboard accelerator: Ctrl-Meta-E. 

Hide Debugger Commands
Hides the window based Debugger Commands List. Default keyboard accelerator: Ctrl-Meta-H. 

Utilities Pull-Down Menu:

Trace...  Displays the tracer options and invoke the trace tool.  Default keyboard accelerator: Ctrl-Shft-R. 

Step...  Displays the stepper options and invoke the step tool.  Default keyboard accelerator: Ctrl-Shft-S. 

Inspect...  Display the inspector options and invoke the inspect tool.  Default keyboard accelerator: Ctrl-Shft-E. 

Static Analyzer... 
Displays the Static Analyzer Tool. Default keyboard accelerator: Ctrl-Shft-X. 

Storage Management... 
Displays HP Common LISP’s storage management options.  Default keyboard accelerator: Ctrl-Shft-M. 

Build...  Displays the Build tool.  Default keyboard accelerator: Ctrl-Shft-B. 

Common LISP Help Provides information about Common LISP functionality.  Default keyboard accelerator: Ctrl-Shft-L. 

Help Pull-Down Menu:

Item Help Provides help information for any item on the screen.  The cursor changes to a question mark.  Clicking on an item will retrieve help for that item.  Default keyboard accelerator: Ctrl-Shft-H. 

Application Help Provides general help information for the lispbench tool.  Once Help is activated, information can be obtained for any SoftBench tool.  Default keyboard accelerator: Ctrl-Shft-A. 

Build Tool screen:

The Build tool has two pull-down menus.  These are labeled Tool and Help.  There are also 6 command buttons for editing, defining, and building a system.  After a command button is pressed and the necessary input is provided, the OK button should be pressed to execute the command.  To disregard the command, use the Cancel button. 

Tool Pull-Down Menu:

Quit Hide the Build Window.  Default keyboard accelerator: Meta-S. 

Help Pull-Down Menu:

Item Help Provides help information for any item on the screen.  The cursor changes to a question mark.  Clicking on an item retrieves help for that item.  Default keyboard accelerator: Ctrl-Shft-H. 

Application Help Provides general help information for the lispbench tool.  Once Help is activated, information can be obtained for any SoftBench tool.  Default keyboard accelerator: Ctrl-Shft-A. 

Pushbutton Area

Edit System Creates or modifies a system. 

Delete System Deletes an existing system. 

Edit Module Creates or modifies a module for an existing system. 

Delete Module Deletes an existing module. 

Define System Defines a new system. 

Build Builds new or existing systems. 

Common LISP Help Tool Screen:

The Common LISP Help tool has 3 pull-down menus.  These are labeled Tool, Actions, and Help. 

Tool Pull-Down Menu:

Quit Hide the Common LISP Help Window.  Default keyboard accelerator: Meta-S. 

Actions Pull-Down Menu:

View...  Display information about a selected command in the Common LISP Help buffer.  Default keyboard accelerator: Ctrl-Shft-V. 

Go To Command... 
Prompts the user for a command name and displays information about that command. Default keyboard accelerator: Ctrl-Shft-G. 

Write Help Text... 
Copy the information about a particular command to a file. Default keyboard accelerator: Ctrl-Shft-W. 

Help Pull-Down Menu:

Item Help Provides help information for any item on the screen.  The cursor changes to a question mark.  Clicking on an item retrieves help for that item.  Default keyboard accelerator: Ctrl-Shft-H. 

Application Help Provides general help information for the lispbench tool.  Once Help is activated, information can be obtained for any SoftBench tool.  Default keyboard accelerator: Ctrl-Shft-A. 

Debug Tools Tool Screen:

The Debug Tools tool has two pull-down menus.  These are labeled Tool and Help.  There are also three command buttons which provide access to the tracer, stepper, or the inspector. 

Tool Pull-Down Menu:

Quit Hide the Debug Tools Window.  Default keyboard accelerator: Meta-S. 

Help Pull-Down Menu:

Item Help Provides help information for any item on the screen.  The cursor changes to a question mark.  Clicking on an item retrieves help for that item.  Default keyboard accelerator: Ctrl-Shft-H. 

Application Help Provides general help information for the lispbench tool.  Once Help is activated, information can be obtained for any SoftBench tool.  Default keyboard accelerator: Ctrl-Shft-A. 

Pushbuttons Area

Trace...  Displays the tracer options and invoke the trace tool. 

Step...  Displays the stepper options and invoke the step tool. 

Inspect...  Displays the inspector options and invoke the inspect tool. 

Static Analyzer Tool screen:

The Static Analyzer tool has two pull-down menus.  These are labeled Tool and Help.  There are also six toggle buttons which provide different classes of functionality in the static analyzer. 

Tool Pull-Down Menu:

Quit Hide the Static Analyzer Window.  Default keyboard accelerator: Meta-S. 

Help Pull-Down Menu:

Item Help Provides help information for any item on the screen.  The cursor changes to a question mark.  Clicking on an item retrieves help for that item.  Default keyboard accelerator: Ctrl-Shft-H. 

Application Help Provides general help information for the lispbench tool.  Once Help is activated, information can be obtained for any SoftBench tool.  Default keyboard accelerator: Ctrl-Shft-A. 

Toggle Buttons Area

Analysis Provides functions to control what is analyzed. 

Macro Settings Provides functions to change how analysis is done with respect to macros. 

Database Queries Displays a variety of information about a Common LISP program. 

Display Displays information about Common LISP objects and files. 

Structure Queries
Provides information about the structures defined in a Common LISP program. 

Variable Usage Queries
Provides information about the binding, referencing, and setting of variables.

Storage Management Tool Screen:

The Storage Management tool has two pull-down menus.  These are labeled Tool and Help.  There are also five toggle buttons which provide different classes of functionality in the storage manager. 

Tool Pull-Down Menu:

Quit Hide the Storage Manager Window.  Default keyboard accelerator: Meta-S. 

Help Pull-Down Menu:

Item Help Provides help information for any item on the screen.  The cursor changes to a question mark.  Clicking on an item retrieves help for that item.  Default keyboard accelerator: Ctrl-Shft-H. 

Application Help Provides general help information for the lispbench tool.  Once in Help, information may be obtained for any SoftBench tool.  Default keyboard accelerator: Ctrl-Shft-A. 

The Toggle Buttons Area

Report Provides information on the current storage management settings. 

Memory Mgmt Settings
Provide functions to configure the current memory allocations.

Dynamic Gc Provides Dynamic garbage collection functions. 

Egc Provides Ephemeral garbage collection functions. 

Consing Space Provides functions to control where new objects are created. 

MESSAGES

lispbench supports the following message (tool class LISP) for use with Emacs.  This message sends an evaluation request to Emacs to read in the contents of a file (the first data field of the message) and evaluate the entire file.  Using this message, lispbench can easily be expanded to support more requests from Emacs. 

Request EDIT EVAL-EXP

FILES

/usr/softbench/bin/lispbench shell script to start LISP SoftBench Interface

/usr/lib/X11/app-defaults/Lisp
X11 application resource file

NOTES

Set the environment variable CL to the desired version of Common LISP you want to use and use CLEXT to indicate the type of LISP file extensions your Common LISP uses. 

AUTHOR

lispbench was developed by HP. 

SEE ALSO

encapsulate(1), softbench(1), softbench(5). 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994