Additional information available:

AboutGlossaryMenus and ObjectsOverviewUsing Scrolls

=TITLE About
=TITLE About VAX LISP
=INCLUDE Overview
 © Digital Equipment Corporation. 1989, 1990. All rights
 reserved.

 For more information about the VAX LISP DECwindows
 Development Environment, double click MB1 on the
 Additional Topic below.

Additional information available:

more about

=TITLE more_about
=TITLE Additional Trademark and Product Information
 Software Version: VAX LISP V3.1

 The information in these texts is subject to change
 without notice and should not be construed as a
 commitment by Digital Equipment Corporation. Digital
 Equipment Corporation assumes no responsibility for any
 errors that may appear in these texts.

 The software described in these texts is furnished
 under a license and may be used or copied only under
 the terms of such license.

 No responsibility is assumed for the use or reliability
 of software or equipment that is not supplied by
 Digital Equipment Corporation or its affiliated
 companies.

 Restricted Rights: Use, duplication, or disclosure
 by the U.S. Government is subject to restrictions as
 set forth in subparagraph (c)(1)(ii) of the Rights in
 Technical Data and Computer Software Clause at DFARS
 252.227-7013.

 The following are trademarks of Digital Equipment
 Corporation:

 DEC                   VAX

 DECnet                VAXstation

 DECwindows            VAX LISP

 DIGITAL               XUI


 The following are third-party trademarks:

 Helvetica is a registered trademark of Allied
 Corporation.

 PostScript is a registered trademark of Adobe Systems,
 Inc.

 X Window System, Version 11 and its derivations (X,
 X11, X Version 11, X Window System) are trademarks of
 the Massachusetts Institute of Technology.

=TITLE Glossary
=TITLE Glossary
 There is no glossary for VAX LISP V3.1.

=TITLE Menus_and_Objects
=TITLE Menus and Other Screen Objects
 When you position the mouse pointer directly on a menu
 name, item, or other screen object, press and hold the
 Help key and click either MB1, MB2, or MB3, you get
 context-sensitive help that specifically describes the
 object you have selected.

 See the additional topics the DECwindows menus and
 other screen objects available in the Lisp development
 Environment.

Additional information available:

Menu bar menusPop up menusDialog boxesDisplay stream

=TITLE Menu_bar_menus
=TITLE Menu Bar Pulldown Menus
 The names of menus available in an application appear
 on the menu bar. When you press MB1 on a menu name, the
 menu's contents are displayed or pulled down.

 See the additional topics for more information on the
 menus availiable on menus bars in the Lisp programming
 environment.

Additional information available:

File Menuedit menuoperations menuhelp menudebugger commands menu
trace commands menued file menued edit menued search menued commands menu
ed help menuih commands menuih edit menui commands menui edit menu

=TITLE File_Menu
=TITLE File Menu
 The Listener and Debug I/O windows have File menus. The
 items in these menus generally deal with operations on
 files. They both contain the following menu items:

 -  Load...

 -  Compile file...

 -  Ed...

 -  Suspend

 -  Suspend As...

 -  Dribble.../Stop Dribble

 -  Save

 -  Save as...

 -  Exit

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item.

Additional information available:

LoadEd fileCompile filesuspendsuspend asdribbleSave
save asexit

=TITLE Load
=TITLE Load...
 The Load .. . item in the File menu loads a file into
 the LISP environment through either the Listener
 or Debugger evaluation loops. When you choose the
 Load .. . item and a dialog box appears, select or type
 the name of a LISP source or compiled file to load into
 the LISP environment.

 A LISP form of the form (LOAD "filename") is inserted
 and evaluated in the window. If the READ-EVAL-PRINT
 loop is still computing the previously read form,
 the Load form is put in the type-ahead buffer for the
 window and will appear when the evaluation loop reads
 from the stream again.

=TITLE Ed_file
=TITLE Ed...
 The Ed .. . item in the File menu invokes the VAX
 LISP Editor on a specified file. When you choose the
 Ed .. . file item and a dialog box appears, select or
 type the name of a file to edit.

 A LISP form of the form (ED "filename") is inserted and
 evaluated in the window. If the READ-EVAL-PRINT loop is
 still computing the previously read form, the Ed form
 is put in the type-ahead buffer for the window and will
 appear when the evaluation loop reads from the stream
 again.

=TITLE Compile_file
=TITLE Compile file...
 The Compile file .. . item in the File menu compiles
 a LISP source file through either the Listener or
 Debugger evaluation loops. When you choose the Compile
 file .. . item and a dialog box appears, select or type
 the name of a file to compile.

 A LISP form of the form (COMPILE-FILE "filename")
 is inserted and evaluated in the window. If the
 READ-EVAL-PRINT loop is still computing the previously
 read form, the Compile file form is put in the
 type-ahead buffer for the window and will appear when
 the evaluation loop reads from the stream again.

=TITLE suspend
=TITLE Suspend
=INCLUDE menus_and_objects menu_bar_menus file_menu suspend_as
 The Suspend item in the File menu causes LISP to write
 out a suspended image file to the file most recently
 specified with the Suspend As .. . item in the same
 menu. (For more details about suspended files see the
 VAX LISP Program Development Guide.) When you choose
 the Suspend item, a LISP form of the form (SUSPEND
 "filename") is inserted and evaluated in the window.
 If the READ-EVAL-PRINT loop is still computing the
 previously read form, the Suspend form is put in the
 type-ahead buffer for the window and will appear when
 the evaluation loop reads from the stream again.

=TITLE suspend_as
=TITLE Suspend As...
=INCLUDE menus_and_objects menu_bar_menus file_menu suspend
 The Suspend As .. . item in the File menu causes LISP
 to write out a suspended image file to a specified
 file. (For more details about suspended files see the
 VAX LISP Program Development Guide.) When you choose
 the Suspend As .. . item and a dialog box appears,
 select or type the name of the file to which you want
 the output to be written.

 A LISP form of the form (SUSPEND "filename") is
 inserted and evaluated in the window. If the
 READ-EVAL-PRINT loop is still computing the previously
 read form, the Suspend form is put in the type-ahead
 buffer for the window and will appear when the
 evaluation loop reads from the stream again.

 If at a later time in the same LISP you want to Suspend
 into the same file, you can select the Suspend item
 from the same menu to avoid having to respond to the
 file selection box.

=TITLE dribble
=TITLE Dribble...
 The Dribble .. . item in the File menu turns on and
 off the simultaneous writing of information written
 to the Common LISP stream *STANDARD-OUTPUT* to a file.
 When you choose the Dribble .. . item and a dialog box
 appears, select or type the name of the file to which
 you want the output to be written.

 A LISP form of the form (DRIBBLE "filename") is
 inserted and evaluated in the window. If the
 READ-EVAL-PRINT loop is still computing the previously
 read form, the Dribble form is put in the type-ahead
 buffer for the window and will appear when the
 evaluation loop reads from the stream again.

 When you turn on Dribbling the name of this menu item
 changes to Stop Dribbling. You choose this item to
 insert the form (DRIBBLE), which ends writing to and
 closes the output file.

=TITLE Save
=TITLE Save
=INCLUDE menus_and_objects menu_bar_menus file_menu save_As
 The Save item in the File menu of a given window causes
 LISP to write out the transcript of that window to the
 file most recently specified with the Save As .. . item
 in the same menu. The file transcript is written out
 immediately, without any effect on the READ-EVAL-PRINT
 loop.

=TITLE save_as
=TITLE Save as...
=INCLUDE menus_and_objects menu_bar_menus file_menu save
 The Save As .. . item in the File menu of a given
 windows causes LISP to write out the transcript of
 that window to a specified file. When you choose the
 Save As .. . item and a dialog box appears, select or
 type the name of the file to which you want the output
 to be written. The file transcript is written out
 immediately, without any effect on the READ-EVAL-PRINT
 loop.

 If at a later time in the same LISP you want to write
 out a transcript into the same file, you select the
 Save item from the same menu to avoid having to respond
 to the file selection box.

=TITLE exit
=TITLE Exit
=INCLUDE overview utilities listener listener_custom Prompt_on_exit
 The Exit item in the Listener's File menus causes LISP
 to call the EXIT function. When you choose this item
 you may be prompted before LISP exits, to confirm your
 desire to Exit. The appearance of the prompt depends
 on the state of the :PROMPT-ON-EXIT attribute for
 the Listener. See the additional topic below for more
 information on this customization attribute.

=TITLE edit_menu
=TITLE Edit Menu
=INCLUDE overview selection
 You find an Edit menu in most windows in the
 development environment. You use the items in the Edit
 menu to move information to and from the Clipboard and
 to perform specialized selections. They all contain
 some subset of the following items:

 -  Undo

 -  Cut

 -  Copy

 -  Paste

 -  Clear

 -  Select All

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item. Many of these items operate on a selection. See
 the additional topic on Selecting Text and Objects for
 more information on making a selection.

Additional information available:

clipboardundo itemcut itemcopy itemclear itempaste itemselect all item

=TITLE clipboard
=TITLE The LISP Clipboard
=INCLUDE overview selection
 The Clipboard available to you through the Edit
 menus of the Development Environment is a special
 LISP-sensitive Clipboard. You can use the LISP
 Clipboard to store real LISP objects for retrieval
 later in the LISP session, or for moving text between
 any XUI Style Guide compliant windows.

 Note that since the Lisp Clipboard is the global
 DECwindows Clipboard (available from other DECwindows
 applications), only text may be transferred between
 other DECwindows applications and your Lisp process
 and pasting onto the clipboard from another DECwindows
 application resets the contents of the LISP Clibboard.

=TITLE undo_item
=TITLE Undo/Redo
 The Undo item reverses the work done by an immediately
 preceding Edit menu operation. For example, if you use
 the Cut item to delete some text and move it to the
 Clipboard, you can use the Undo item to put the deleted
 text back and restore the previous information on the
 Clipboard. When the Undo operation is complete, the
 item label changes from Undo to Redo. If you select
 Redo, the previously undone operation is redone.
 Continuing the example, if you choose Redo, the Cut
 is performed again, moving the text to the Clipboard.

=TITLE cut_item
=TITLE Cut
 The Cut item removes selected text or objects from
 an editable region (such as the input region of the
 Listener) and puts them on the LISP Clipboard.

 Note that the region must be editable, since you cannot
 delete information from a read-only text region.

=TITLE copy_item
=TITLE Copy
 The Copy item puts selected text or objects on the LISP
 Clipboard without deleting them from the region.

=TITLE clear_item
=TITLE Clear
 The Clear item removes the stored text or objects from
 the LISP Clipboard.

=TITLE paste_item
=TITLE Paste
 The Paste item inserts text or objects stored on the
 LISP clipboard at the input point in the window with
 input focus. If the input point is a selection, the
 paste replaces the selected information.

 For example, if you select an object's component in an
 Inspect window and choose the Paste item in the Inspect
 window's Edit menu, the selected component is replaced
 with the object on the LISP Clipboard, modifying the
 inspected object. Note that, in this case, if the
 information on the Clipboard is text, it is treated
 as a LISP string for the component's new value.

=TITLE select_all_item
=TITLE Select All
 The Select All item selects all of the text in the
 transcript of the Listener or Debugger I/O windows.
 This is particularly useful for copying all of the
 information to another window or application.

=TITLE operations_menu
=TITLE Operations Menu
=INCLUDE overview selection
 The items in this menu execute certain LISP functions
 useful for program development and control. Each of
 the items corresponds to the LISP function or macro
 of the same name except for CLEAR. CLEAR corresponds
 to DECW-STREAM:CLEAR-DISPLAY-STREAM. The items in this
 menu are:

 -  INSPECT

 -  ED

 -  EVAL

 -  COMPILE

 -  UNCOMPILE

 -  DISASSEMBLE

 -  TRACE

 -  TRACE...

 -  UNTRACE

 -  STEP

 -  CLEAR

 -  ABORT

 -  BREAK

 -  CONTINUE

 -  DEBUG

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item. The descriptions pertain mainly to the syntax of
 the item. Use the LISP DESCRIBE function on each of the
 symbols of the same names as the menu items for more
 information about the operation of these functions and
 macros.

 Also, many of these items operate on a selection. See
 the additional topic on Selecting Text and Objects for
 more information on making a selection.

Additional information available:

inspect itemed itemeval itemcompile itemuncompile itemdisassemble item
trace itemtrace dots itemuntrace itemStep itemclear itemabort item
break itemcontinue itemdebug item

=TITLE inspect_item
=TITLE INSPECT
=INCLUDE overview utilities inspector
 The INSPECT item invokes the Inspector on a selected
 object. If you select text it is inspected as a LISP
 string.

 See the additional topic on the Inspector for more
 information.

=TITLE ed_item
=TITLE ED
=INCLUDE overview utilities editor
 The ED item invokes the Editor on a selected object.
 If you select text this item is only available if LISP
 can find a function or macro named by a symbol with the
 same name. If you select a LISP string, the Editor is
 invoked on it. Choosing the ED item with no selection
 brings up an empty Editor.

 See the additional topic on the Editor for more
 information.

=TITLE eval_item
=TITLE EVAL
 The EVAL item evaluates a selected object or region
 of text. When you choose the EVAL item, a LISP form of
 the form (EVAL 'form) is inserted and evaluated in the
 window. If the READ-EVAL-PRINT loop is still computing
 the previously read form, the EVAL form is put in the
 type-ahead buffer for the window and will appear when
 the evaluation loop reads from the stream again.

=TITLE compile_item
=TITLE COMPILE
 The COMPILE item compiles the function associated with
 a symbol that names an interpreted function. When you
 select such a symbol and choose the COMPILE item, a
 LISP form of the form (COMPILE 'symbol) is inserted and
 evaluated in the window. If the READ-EVAL-PRINT loop is
 still computing the previously read form, the COMPILE
 form is put in the type-ahead buffer for the window
 and will appear when the evaluation loop reads from the
 stream again.

=TITLE uncompile_item
=TITLE UNCOMPILE
 The UNCOMPILE item uncompiles the function associated
 with a symbol that names a previously compiled
 function. When you select such a symbol and choose
 the UNCOMPILE item, a LISP form of the form (UNCOMPILE
 'symbol) is inserted and evaluated in the window.
 If the READ-EVAL-PRINT loop is still computing the
 previously read form, the UNCOMPILE form is put in the
 type-ahead buffer for the window and will appear when
 the evaluation loop reads from the stream again.

=TITLE disassemble_item
=TITLE DISASSEMBLE
 The DISASSEMBLE item disassembles the function
 associated with a symbol that names a previously
 compiled function, a function object or a lambda
 expression. When you select such an object and
 choose the DISASSEMBLE item, a LISP form of the form
 (DISASSEMBLE 'object) is inserted and evaluated in the
 window. If the READ-EVAL-PRINT loop is still computing
 the previously read form, the DISASSEMBLE form is put
 in the type-ahead buffer for the window and will appear
 when the evaluation loop reads from the stream again.

=TITLE trace_item
=TITLE TRACE
=INCLUDE overview utilities trace
 The TRACE item invokes the Trace facility on a selected
 symbol. If you select text this item is only available
 if LISP can find a function or macro named by a symbol
 with the same name.

 See the additional topic on the Trace facility for more
 information.

=TITLE trace_dots_item
=TITLE TRACE...
=INCLUDE overview utilities trace
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 The TRACE .. . item invokes the Trace facility on a
 selected symbol, and allows you to supply options for
 the Trace. See the additional topic below about Trace
 Options for more information about the dialog box that
 is brought up for you to supply Trace options. If you
 have selected text this item is only available if LISP
 can find a function or macro named by a symbol with the
 same name.

 See the additional topic on the Trace facility for more
 information.

=TITLE untrace_item
=TITLE UNTRACE
=INCLUDE overview utilities trace
=INCLUDE overview utilities trace trace_custom prompt_on_untrace
 The UNTRACE item removes a selected item from the Trace
 List in the Trace window. You select a symbol that
 names the function or macro you want removed. If you
 select text this item is only available if LISP can
 find a function or macro named by a symbol with the
 same name.

 If you choose this item without a selection it is
 equivalent to calling the UNTRACE macro without
 arguments, except that you are prompted by a caution
 box asking whether you really want to untrace all
 remaining items. See the additional topic on Prompt
 on Untrace All for more information on controlling the
 display of this prompt.

 See the additional topic on the Trace facility for more
 information.

=TITLE Step_item
=TITLE STEP
=INCLUDE overview utilities stepper
 The STEP item invokes the Stepper on a selected form.
 When you choose the STEP item, a LISP form of the
 form (STEP 'form) is inserted and evaluated in the
 window. If the READ-EVAL-PRINT loop is still computing
 the previously read form, the STEP form is put in the
 type-ahead buffer for the window and will appear when
 the evaluation loop reads from the stream again.

 See the additional topic on the Stepper for more
 information.

=TITLE clear_item
=TITLE CLEAR
 The CLEAR item deletes and resets the stream data
 structures to an empty state in either the Listener
 or Debug I/O windows. It then interrupts the code that
 is running in that window. The CLEAR item corresponds
 to DECW-STREAM:CLEAR-DISPLAY-STREAM.

=TITLE abort_item
=TITLE ABORT
 The ABORT item interrupts code that is running in the
 Listener or Debug I/O windows. It calls the VAX LISP
 ABORT function on the code's stack, so if there are any
 CATCH-ABORT frames on the stack they catch this call
 to ABORT. Otherwise, the top-level CATCH-ABORT catches
 this ABORT and you are returned to top-level in the
 window.

 See the VAX LISP Object Reference Manual for more
 information about the ABORT and CATCH-ABORT routines.

=TITLE break_item
=TITLE BREAK
=INCLUDE menus_and_objects menu_bar_menus operations_menu continue_item
 The BREAK item interrupts code that is running in the
 Listener or Debug I/O windows and brings up a Break
 loop in the Listener window. The CONTINUE function or
 the CONTINUE item in the Operations menu exit the Break
 loop and continue the code's evaluation from the point
 where LISP encountered the BREAK function.

 See the VAX LISP Program Development Guide for more
 information about the Break loop.

=TITLE continue_item
=TITLE CONTINUE
=INCLUDE menus_and_objects menu_bar_menus operations_menu break_item
 The CONTINUE item exits a Break loop that you invoked
 with the BREAK function or the BREAK item on the
 Operations menu. The evaluation of your code continues
 from the point where LISP encountered the BREAK
 function.

 See the VAX LISP Program Development Guide for more
 information about the Break loop.

=TITLE debug_item
=TITLE DEBUG
=INCLUDE overview utilities debugger
 The DEBUG item interrupts code that is running in
 the Listener or Debug I/O windows and brings up the
 Debugger at the current point of execution. If you
 Continue from the Debugger, your program continues. If
 you Quit from the Debugger, your program is aborted.

 See the additional topic on the Debugger for more
 information.

=TITLE help_menu
=TITLE Help Menu
 Items in the Help menu give you help on LISP and the
 development environment. Help menus are in all the
 main windows in the development environment, and in the
 Inspect windows. (Note that the Editor window's Help
 menu has additional topics that are specific to the
 Editor.)

 The items in this menu are:

 -  Overview

 -  About

 -  Apropos

 -  Describe

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item.

Additional information available:

overview itemabout itemapropos itemdescribe item

=TITLE overview_item
=TITLE Overview
=INCLUDE overview
 The Overview item brings up the Overview topic in
 the Help window. (The window where you are reading
 this text.) The Overview topic leads you to all the
 remaining help items in the on-line help system.

 Double click on the Overview additional topic below for
 further information.

=TITLE about_item
=TITLE About
=INCLUDE about
 The About item brings up the About topic in the
 Help window. (The window where you are reading this
 text.) The About topic gives you version and copyright
 information about VAX LISP.

 Double click on the About additional topic below for
 further information.

=TITLE apropos_item
=TITLE Apropos
=INCLUDE overview selection
 The Apropos item invokes the Common LISP APROPOS
 function on a selection and displays the output in
 a separate window. The APROPOS function displays a
 message that shows the string that is being searched
 for and the name of the package that is being searched.
 When the function finds a symbol whose print name
 contains the string, the function displays the symbol's
 name.

 The selection can be some text, a string, or a symbol,
 and would have the following syntax:

     (APROPOS [selection-value] *PACKAGE*)

 See the additional topics below for more information on
 making a selection and customizing the Apropos windows.

Additional information available:

apropos describe windows custom

=TITLE apropos_describe_windows_custom
=TITLE Customizing the Apropos and Describe Windows
=INCLUDE overview Customization cust_routine attr_key change_font
=INCLUDE overview Customization cust_routine attr_key change_color
=INCLUDE overview Customization cust_routine attr_key change_geometry
=INCLUDE overview Customization cust_routine attr_key change_init_state
=INCLUDE overview utilities inspector insp_custom win_count
=INCLUDE overview utilities inspector insp_custom win_geom
=INCLUDE overview Customization cust_routine
 You can customize aspects of the Apropos and Describe
 windows with the DECW-UTILS:CUSTOMIZATION routine (see
 the additional topic below) using :DESCRIBE-WINDOWS or
 :APROPOS-WINDOWS as the object-keyword and one of the
 following attribute-keywords:

 -  :FONT

 -  :FOREGROUND-COLOR

 -  :BACKGROUND-COLOR

 -  :BORDER-COLOR

 -  :HIGHLIGHT-COLOR

 -  :MONOCHROME-REVERSE

 -  :INITIAL-STATE

=TITLE describe_item
=TITLE Describe
=INCLUDE overview selection
=INCLUDE menus_and-objects menu_bar_menus help_menu apropos_item apropos_describe_windows_custom
 This item invokes the Common LISP DESCRIBE function
 on a selection and displays the output in a separate
 window. The DESCRIBE function prints information about
 the object supplied.

 See the additional topic below for more information
 on making a selection and customizing the Describe
 windows.

=TITLE debugger_commands_menu
=TITLE Debugger Commands Menu
 The items in this menu bring up the Debugger or
 Stepper's auxiliary windows or leave the Debugger or
 Stepper.

 The items in this menu are:

 -  Commands...

 -  Calling Stack... [Debugger only]

 -  Variable Bindings... [Debugger only]

 -  Continue

 -  Quit Debugger/Stepper

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item.

Additional information available:

d commands buttond calling stack buttond variable bindings buttond m continue button
d m quit debugger

=TITLE d_commands_button
=TITLE Commands...
=INCLUDE overview utilities debugger d_commands_box
=INCLUDE overview utilities debugger s_commands_box
 The Commands .. . item brings up or to the front the
 Debugger or Stepper Commands box (depending on which
 utility you are using). See the additional topics for
 more information.

=TITLE d_calling_stack_button
=TITLE Calling Stack...
=INCLUDE overview utilities debugger debug_call_stack_window
 The Calling Stack .. . item brings up or to the front
 the Debugger Calling Stack window. See the additional
 topic for more information about this window.

=TITLE d_variable_bindings_button
=TITLE Variable Bindings...
=INCLUDE overview utilities debugger debug_var_bind_window
 The Variable Bindings .. . item brings up or to the
 front the Variable Bindings window. See the additional
 topic for more information about this window.

=TITLE d_m_continue_button
=TITLE Continue
 The Continue item continues execution by returning from
 the continuable error that invoked the Debugger. You
 can use this item to continue from the Debugger when
 the Debugger was invoked by a continuable error or by a
 direct call to the DEBUG function. The Continue button
 in the Debugger Commands box or typing CONTINUE at the
 prompt in the Debug I/O window do the same thing.

=TITLE d_m_quit_debugger
=TITLE Quit Debugger/Stepper
=INCLUDE overview utilities listener listener_custom Prompt_on_exit
 The Quit Debugger/Stepper item causes LISP to quit
 from the Debugger or Stepper. The Quit button in the
 Commands box or typing QUIT at the prompt does the same
 thing.

 When you choose this item you may be prompted before
 the Debugger is exited, to confirming your desire to
 quit. The appearance of the prompt depends on the state
 of the :PROMPT-ON-EXIT attribute for the Debugger.
 See the additional topic below for more information on
 customizable attributes.

=TITLE trace_commands_menu
=TITLE Tracer Commands Menu
 The items in the Trace Commands menu control the
 tracing of functions and affect the Trace window.

 The items in this menu are:

 -  Clear

 -  Trace

 -  Trace...

 -  Untrace

 -  Close

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item.

Additional information available:

t clear buttont trace buttont trace dots buttont untrace button
t close button

=TITLE t_clear_button
=TITLE Clear
 The Clear item clears the Trace Output region. In
 addition to clearing the text, it frees the pointers
 being held to objects printed in this region.

=TITLE t_trace_button
=TITLE Trace
 The Trace item invokes the Trace facility on a selected
 symbol. If you select text this item is only available
 if LISP can find a function or macro named by a symbol
 with the same name.

=TITLE t_trace_dots_button
=TITLE Trace...
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 The Trace .. . item invokes the Trace facility on a
 selected symbol and displays the Trace Options dialog
 box in which you set or modify options for the trace.
 See the additional topic below about Trace Options
 for more information about the dialog box. If you have
 selected text this item will only be available if LISP
 can find a function or macro named by a symbol with the
 same name.

=TITLE t_untrace_button
=TITLE Untrace
=INCLUDE overview utilities trace trace_custom prompt_on_untrace
 The Untrace item removes an item from the Trace List
 in the Trace window. You select a symbol that names the
 function or macro you want removed. If you select text,
 this item is only available if LISP can find a function
 or macro named by a symbol with the same name.

 If you choose this item without a selection it is
 equivalent to calling the UNTRACE macro without
 arguments, except that you are prompted by a caution
 box asking whether you really want to untrace all
 remaining items. See the additional topic on Prompt
 on Untrace All for more information on controlling the
 display of this prompt.

=TITLE t_close_button
=TITLE Close
 The Close item closes the Trace window. The Trace
 window automatically returns the next time text is
 written to it. You can bring the Trace window back by
 choosing the Trace item in the Listener or Debugger
 Operations menus without a selection.

=TITLE ed_file_menu
=TITLE Editor File Menu
 The items in the Editor's File menu invoke Editor
 commands on files. The items in this menu are:

 -  Open...

 -  View...

 -  Include...

 -  Save

 -  Save As...

 -  Exit

 See the additional topics below for more information on
 each of these items.

Additional information available:

ed file menu opened file menu viewed file menu includeed file menu save
ed file menu save ased file menu exit

=TITLE ed_file_menu_open
=TITLE Open .. .
 The Open .. . item opens a buffer to a file for
 editing. You are prompted for a file name at the bottom
 of the Editor window.

=TITLE ed_file_menu_view
=TITLE View...
 The View .. . item opens a buffer to a file for
 viewing. This differs from the Open item in that the
 buffer for the file is read-only. You are prompted for
 a file name at the bottom of the editor window.

=TITLE ed_file_menu_include
=TITLE Include...
 The Include .. . item inserts the contents of a file at
 the current text insertion point in the Editor. You are
 prompted for a file name at the bottom of the Editor
 window.

=TITLE ed_file_menu_save
=TITLE Save
 The Save item saves the current buffer's contents into
 the file previously associated with it.

=TITLE ed_file_menu_save_as
=TITLE Save As...
 The Save As .. . item saves the current buffer's
 contents into a file that you specify. You are prompted
 for a file name at the bottom of the Editor window.

=TITLE ed_file_menu_exit
=TITLE Exit
 The Exit item exits the Editor. You are prompted for
 confirmation at the bottom of the Editor window.

=TITLE ed_edit_menu
=TITLE Editor Edit Menu
 The items in this menu move text to and from the LISP
 clipboard and perform special types of selection in the
 current buffer. The items in this menu are:

 -  Cut

 -  Copy

 -  Paste

 -  Clear

 -  Select Enclosing Form

 -  Select Outermost Form

 -  Select All

 See the additional topics below for more information on
 each of these items.

Additional information available:

ed edit menu cuted edit menu copyed edit menu pasteed edit menu clear
ed edit menu select enced edit menu select outed edit menu select all

=TITLE ed_edit_menu_cut
=TITLE Cut
 The Cut item removes selected text from the current
 buffer and puts it on the LISP Clipboard.

=TITLE ed_edit_menu_copy
=TITLE Copy
 The Copy item puts selected text from the current
 buffer on the LISP Clipboard without removing it from
 the current buffer.

=TITLE ed_edit_menu_paste
=TITLE Paste
 The Paste item takes text stored on the LISP Clipboard
 and inserts it at the input point in the current
 buffer.

=TITLE ed_edit_menu_clear
=TITLE Clear
 The Clear item removes a stored item from the LISP
 Clipboard.

=TITLE ed_edit_menu_select_enc
=TITLE Select Enclosing Form
 The Select Enclosing Form item selects the LISP form
 immediately enclosing the insertion point or select
 region in the current buffer.

=TITLE ed_edit_menu_select_out
=TITLE Select Outermost Form
 The Select Outermost Form item selects the LISP form
 enclosing the insertion point or select region in the
 current buffer that begins in the left-most column of
 the buffer.

=TITLE ed_edit_menu_select_all
=TITLE Select All
 The Select All item selects all the text (including
 that which you do not see) of the current buffer.

=TITLE ed_search_menu
=TITLE Editor Search Menu
 The items in this menu give access the Editor's forward
 and reverse string searching functions. The menu items
 are:

 -  Find...

 -  Find Next

 -  Find Previous

 -  Replace...

 See the additional topics below for more information on
 each of these items.

Additional information available:

ed search menu finded search menu find nexted search menu find previous
ed search menu replace

=TITLE ed_search_menu_find
=TITLE Find...
 The Find .. . item searches for a string that you
 specify. The search is in the current buffer and in
 the current Editor direction. You are prompted for the
 string at the bottom of the Editor window.

=TITLE ed_search_menu_find_next
=TITLE Find Next
 The Find Next item searches forward from the cursor
 position in the current buffer for the string specified
 in the most recent search operation.

=TITLE ed_search_menu_find_previous
=TITLE Find Previous
 The Find Previous item searches backward from the
 cursor position in the current buffer for the string
 specified in the most recent search operation.

=TITLE ed_search_menu_replace
=TITLE Replace...
 The Replace .. . item invokes the Editor's
 Query/Replace function. At the bottom of the Editor
 window you are prompted, sequentially, for a search
 string and a replacement string. You are then prompted
 to supply command characters for each search string
 found. At this prompt you can press the ? (question
 mark) key for more information on the individual
 commands.

=TITLE ed_commands_menu
=TITLE Editor Commands Menu
 The items in this menu invoke a number of common Editor
 commands that operate on Editor buffers, windows and
 LISP regions.

 -  List Buffers

 -  Select Buffer

 -  Insert Buffer

 -  Delete Current Buffer

 -  Delete Named Buffer

 -  Write Modified Buffers

 -  Write Current Buffer

 -  Split Window

 -  Remove Current Window

 -  Remove Other Windows

 -  Next Window

 -  Evaluate LISP Region

 -  Indent LISP Region

 See the additional topics below for more information on
 each of these items.

Additional information available:

ed commands menu list bufed commands menu select bufed commands menu insert buf
ed commands menu del cur bufed commands menu del nam bufed commands menu wri mod buf
ed commands menu wri cur bufed commands menu split wined commands menu rem-cur win
ed commands menu rem oth wined commands menu next wined commands menu evl lsp reg
ed commands menu ind lsp reg

=TITLE ed_commands_menu_list_buf
=TITLE List Buffers
 The List Buffers item displays the Help buffer with a
 list of available Editor buffers, their names, sizes
 and status information.

=TITLE ed_commands_menu_select_buf
=TITLE Select Buffer
 The Select Buffer item selects an existing buffer or
 creates a new buffer. You are prompted for a buffer
 name at the bottom of the Editor window.

=TITLE ed_commands_menu_insert_buf
=TITLE Insert Buffer
 The Insert Buffer item inserts the contents of an
 existing buffer at the insertion point in the current
 buffer. You are prompted for a buffer name at the
 bottom of the Editor window.

=TITLE ed_commands_menu_del_cur_buf
=TITLE Delete Current Buffer
 The Delete Current Buffer item deletes the current
 buffer from memory. If you modified the buffer since
 you last wrote it, you are prompted for whether to
 write out the buffer before it is deleted. Note that
 you cannot delete permanent Editor buffers. If you try
 to do this a message is written to the information area
 at the bottom of the Editor window.

 If you simply want to remove the buffer from view
 instead of deleting the buffer, use the Remove Current
 Window item from this menu.

=TITLE ed_commands_menu_del_nam_buf
=TITLE Delete Named Buffer
 The Delete Named Buffer item deletes a buffer from
 memory. You are prompted for a buffer name at the
 bottom of the Editor window. If you modified the
 specified buffer since you last wrote it you are
 prompted for whether to write out the buffer before
 it is deleted.

=TITLE ed_commands_menu_wri_mod_buf
=TITLE Write Modified Buffers
 The Write Modified Buffers item writes out all modified
 buffers to their associated files.

=TITLE ed_commands_menu_wri_cur_buf
=TITLE Write Current Buffer
 The Write Current Buffer item writes out the current
 buffer to its associated file.

=TITLE ed_commands_menu_split_win
=TITLE Split Window
 The Split Window item splits the current Editor window.

=TITLE ed_commands_menu_rem-cur_win
=TITLE Remove Current Window
 The Remove Current Window item removes the current
 Editor window from view.

 If you want to delete the buffer and its contents from
 memory rather than removing the current Editor window
 from view, use the Delete Current Buffer item from this
 menu.

=TITLE ed_commands_menu_rem_oth_win
=TITLE Remove Other Windows
 The Remove Other Windows item removes the other Editor
 windows, leaving the current buffer in the only visible
 Editor window.

=TITLE ed_commands_menu_next_win
=TITLE Next Window
 The Next Window item switches input focus from the
 current Editor window to the next one.

=TITLE ed_commands_menu_evl_lsp_reg
=TITLE Evaluate LISP Region
 The Evaluate LISP Region item evaluates selected text
 in Editor buffers that have "VAX LISP" as their minor
 style. (*.LSP files, by default.) The code is evaluated
 in the environment current in your READ-EVAL-PRINT
 loop.

 For example, if you are in the Debugger, the code
 evaluated here is evaluated in the same environment
 as that visible in the current frame in the Debugger.

 The result of the evaluation is printed to the
 information area at the bottom of the Editor window.

=TITLE ed_commands_menu_ind_lsp_reg
=TITLE Indent LISP Region
 The Indent LISP Region item indents selected text as
 LISP code in Editor buffers that have "VAX LISP" as
 their minor style.

=TITLE ed_help_menu
=TITLE Editor Help Menu
=INCLUDE menus_and_objects menu_bar_menus help_menu overview
=INCLUDE menus_and_objects menu_bar_menus help_menu about
 The items in this menu invoke both the VAX LISP-general
 and Editor-specific help systems. The items in the menu
 are:

 -  Overview

 -  About

 -  Apropos Editor Object

 -  Apropos Word

 -  Describe Editor Object

 -  Describe Word

 -  Alternatives

 -  Last Error

 See the additional topics below for more information on
 each of these items.

Additional information available:

ed help menu apropos objected help menu apropos worded help menu describe object
ed help menu describe worded help menu alternativesed help menu last error

=TITLE ed_help_menu_apropos_object
=TITLE Apropos Editor Object
 The Apropos Editor Object item invokes the Editor's
 apropos mechanism for Editor objects and commands. You
 are prompted for a string at the bottom of the Editor
 window.

=TITLE ed_help_menu_apropos_word
=TITLE Apropos Word
 The Apropos Word item invokes the LISP APROPOS function
 on the word nearest to the cursor in the current Editor
 buffer. The output is displayed in the Editor Help
 buffer.

=TITLE ed_help_menu_describe_object
=TITLE Describe Editor Object
 The Describe Editor Object item invokes the Editor's
 description mechanism for Editor objects and commands.
 You are prompted for a string at the bottom of the
 Editor window.

=TITLE ed_help_menu_describe_word
=TITLE Describe Word
 The Describe Word item invokes the LISP DESCRIBE
 function on the word nearest to the cursor in the
 current Editor buffer. The output is displayed in the
 Editor Help buffer.

=TITLE ed_help_menu_alternatives
=TITLE Alternatives
 The Alternatives item displays a list of completion
 alternatives for when you are being prompted at the
 bottom of the Editor window. The alternatives are
 displayed in the Editor Help buffer.

=TITLE ed_help_menu_last_error
=TITLE Last Error
 The Last Error item displays the message from the last
 encountered Editor error. The message is displayed in
 the Editor Help buffer.

=TITLE ih_commands_menu
=TITLE Inspector History Commands Menu
 The items in this menu inspect objects, affect Inspect
 windows and exit from the Inspector.

 The menu items are:

 -  Inspect

 -  Return

 -  Close

 -  Remove

 -  Lock

 -  Exit Inspector

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item.

Additional information available:

ih inspect buttonih return buttonih close buttonih remove button
ih lock toggleih exit button

=TITLE ih_inspect_button
=TITLE Inspect
 The Inspect item invokes the Inspector on an object
 you selected. If you selected text it is inspected as a
 LISP string.

=TITLE ih_return_button
=TITLE Return
 The Return item causes the Inspector ( your call to the
 INSPECT function) to return an object you selected. If
 you selected text it is returned as a LISP string.

 This item is only available when you have called the
 INSPECT function with :PARALLEL NIL and you have a
 selection in a LISP window.

=TITLE ih_close_button
=TITLE Close
 The Close item closes the Inspect window for an object
 you select in the Inspector History window. The window
 associated with the selected object is removed from the
 screen.

 This item is only available when you have an object
 selected in the Inspector History window that has an
 Inspect window open to it.

=TITLE ih_remove_button
=TITLE Remove
 The Remove item removes an object from the Inspector
 History window. If there is an open Inspect window
 associated with this object, the window is closed.

 This item is only available when you select an object
 in the the Inspector History window that has been
 inspected previously.

=TITLE ih_lock_toggle
=TITLE Lock (toggle)
 The Lock item locks and unlocks the Inspect window
 associated with an object that you select in the
 Inspector History window. When you lock the Inspect
 window, it cannot be overwritten as you inspect more
 objects. You can later unlock the window with another
 use of the Lock item.

 This item is only available when you select an object
 in the Inspector History window that has an Inspect
 window open to it.

=TITLE ih_exit_button
=TITLE Exit
 The Exit item exits the Inspector. If you invoked
 the Inspector by calling the INSPECT function with
 :PARALLEL NIL, the object originally inspected is
 returned.

=TITLE ih_edit_menu
=TITLE Inspector History Edit Menu
 The item in this menu moves information from the
 Inspector History to the LISP Clipboard. The only item
 in this menu is:

 -  Copy

Additional information available:

ih copy button

=TITLE ih_copy_button
=TITLE Copy
 The Copy item copies selected text or objects and puts
 them on the LISP Clipboard.

=TITLE i_commands_menu
=TITLE Inspector Commands Menu
 You can use the items in this menu to inspect further
 objects, modify the object in this Inspect window or
 modify the state of the window. The items in this menu
 are:

 -  Inspect

 -  Update

 -  Modify

 -  Return

 -  Lock (toggle)

 -  Close

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item.

Additional information available:

i inspect buttoni update buttoni modify buttoni return button
i lock togglei close button

=TITLE i_inspect_button
=TITLE Inspect
 The Inspect item invokes the Inspector on an object you
 have selected. If you select text it is inspected as a
 LISP string.

=TITLE i_update_button
=TITLE Update
 The Update item reinspects the object inspected in
 this Inspect window. This might be necessary if you
 modify some component of an object through a different
 Inspect window or through the READ-EVAL-PRINT loop.
 (The Inspect window is not updated automatically - you
 must use this item to assure the displayed values are
 correct.)

 Note that this item does NOT require a selection.

=TITLE i_modify_button
=TITLE Modify
=INCLUDE menus_and_objects dialog_boxes i_modify_dialog
 The Modify item modifies the selected component of an
 inspected object. The Modify dialog box is brought up
 to prompt you for a new value for the component.

 This item is only available when you have an object
 selected in the Inspect window that corresponds to a
 component of the inspected object displayed in this
 window.

 See the additional topic below for more information
 about the Modify dialog box.

=TITLE i_return_button
=TITLE Return
 The Return item causes the Inspector (your call to
 the INSPECT function) to return an object you have
 selected. If you selected text it is returned as a LISP
 string.

 This item is only available when you called the INSPECT
 function with :PARALLEL NIL and you have a selection in
 a LISP window.

=TITLE i_lock_toggle
=TITLE Lock (toggle)
 The Lock item is a toggle that locks and unlocks the
 Inspect window. Once you lock a window, it is no longer
 overwritten as you inspect more objects. You can later
 unlock the window with another use of this item.

=TITLE i_close_button
=TITLE Close
 The Close item closes the Inspect window. The window
 you close is removed from the screen.

=TITLE i_edit_menu
=TITLE Inspector Edit Menu
 The items in this menu move information to and from the
 Clipboard. Additionally, you can use the Paste item as
 a way to modify components of an inspected object. The
 items in this menu are:

 -  Undo

 -  Copy

 -  Paste

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item.

Additional information available:

i undo buttoni copy buttoni paste button

=TITLE i_undo_button
=TITLE Undo
 The Undo item undoes the previous clipboard operation
 performed through this menu.

 For example, if you modified an inspected object's
 component with Paste, Undo restores the previous
 component value.

=TITLE i_copy_button
=TITLE Copy
 The Copy item copies selected text or objects and puts
 them on the LISP Clipboard.

=TITLE i_paste_button
=TITLE Paste
 The Paste item replaces an inspected object's selected
 component with the information on the LISP clipboard.

=TITLE Pop_up_menus
=TITLE Pop-Up Menus
 Pop-Up menus duplicate commands and functions available
 on pull-down menus. Pop-up menus are activated by
 pressing and holding MB2 in windows in which pop-up
 menus have been defined.

 See the additional topics for more information on
 the pop-p menus availiable in the Lisp programming
 environment.

Additional information available:

i Pop up menuih Pop up menu

=TITLE i_Pop_up_menu
=TITLE Inspector Pop-Up Menu
 The items in this popup menu correspond to the items in
 both the Edit and the Commands pull-down menus on the
 Inspect windows menu bar. The items in this menu are:

 -  Undo

 -  Copy

 -  Paste

 -  Inspect

 -  Update

 -  Modify

 -  Return

 -  Lock (toggle)

 -  Close

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item.

Additional information available:

i popup undoi popup copyi popup pastei popup inspecti popup update
i popup modifyi popup returni popup lock togglei popup close

=TITLE i_popup_undo
=TITLE Undo
 The pop-up menu appears when you press MB2. The Undo
 item on the pop-up menu undoes the previous clipboard
 operation performed through the Edit menu or the Copy
 or Paste items on this pop-up menu.

 For example, if you modified an inspected object's
 component with Paste, Undo restores the object's
 previous component value.

=TITLE i_popup_copy
=TITLE Copy
 The pop-up menu appears when you press MB2. The Copy
 item on the pop-up menu copies objects to the LISP
 Clipboard. The LISP object that is copied is the one
 your mouse pointer is over when you press MB2 to bring
 up this pop-up menu.

=TITLE i_popup_paste
=TITLE Paste
 The pop-up menu appears when you press MB2. The Paste
 item on the pop-up menu replaces an inspected object's
 component with the information on the LISP clipboard.
 The component that is replaced is the one your mouse
 pointer is over when you press MB2 to bring up the
 pop-up menu.

=TITLE i_popup_inspect
=TITLE Inspect
 The pop-up menu appears when you press MB2. The Inspect
 item on the pop-up menu invokes the Inspector on the
 LISP object under your pointer when when you bring up
 the menu with MB2.

=TITLE i_popup_update
=TITLE Update
 The pop-up menu appears when you press MB2. The Update
 item on the pop-up menu updates the Inspect window in
 which you brought up the pop-up menu. The Update item
 from the pop-up menu in the Inspector History window
 updates the Inspect window associated with the LISP
 object that is under the mouse pointer when you bring
 up the pop-up menu.

=TITLE i_popup_modify
=TITLE Modify
=INCLUDE menus_and_objects dialog_boxes i_modify_dialog
 The pop-up menu appears when you press MB2. The Modify
 item on the pop-up menu modifies the component of the
 inspected object that is under your mouse pointer when
 you bring up the menu. The modify dialog box is brought
 up to prompt you for a new value for the component.

 See the additional topic below for more information
 about the modify dialog box.

=TITLE i_popup_return
=TITLE Return
 The pop-up menu appears when you press MB2. The Return
 item on the pop-up menu causes the Inspector (your
 call to the INSPECT function) to return an object. The
 object that is returned is the one that is under your
 mouse pointer when you press MB2 to bring up the menu.

 This item is only available when you call the INSPECT
 function with :PARALLEL NIL.

=TITLE i_popup_lock_toggle
=TITLE Lock
 The pop-up menu appears when you press MB2. The Lock
 item on the pop-up menu locks or unlocks the Inspect
 window in which you bring up the pop-up menu. The Lock
 item in the pop-up menu in the Inspector History window
 locks or unlocks the Inspect window associated with the
 LISP object that is under your mouse pointer when you
 bring up the pop-up menu.

=TITLE i_popup_close
=TITLE Close
 The pop-up menu appears when you press MB2. The Close
 item in the pop-menu closes the Inspect window in which
 you brought up the menu. The Close item in the pop-up
 menu in the Inspector History window closes the window
 associated with the LISP object under the mouse pointer
 when you press MB2 to bring up the menu.

=TITLE ih_Pop_up_menu
=TITLE Inspector History Pop-Up Menu
=INCLUDE menus_and_objects pop_up_menus i_pop_up_menu i_popup_copy
=INCLUDE menus_and_objects pop_up_menus i_pop_up_menu i_popup_inspect
=INCLUDE menus_and_objects pop_up_menus i_pop_up_menu i_popup_return
=INCLUDE menus_and_objects pop_up_menus i_pop_up_menu i_popup_close
=INCLUDE menus_and_objects pop_up_menus i_pop_up_menu i_popup_lock_toggle
 The items in this popup menu correspond to the items in
 both the Edit and the Commands pull-down menus on the
 Inspector History windows menu bar. The items in this
 menu are:

 -  Copy

 -  Inspect

 -  Return

 -  Close

 -  Remove

 -  Lock (toggle)

 -  Exit Inspector

 Double click on any of these items in the list of
 Additional Topics below for text describing that menu
 item.

Additional information available:

i popup removei popup exit

=TITLE i_popup_remove
=TITLE Remove
 The pop-up menu appears when you press MB2. The Remove
 item in the pop-up menu removes an object from the
 Inspector History. The object that is removed is the
 one under the mouse pointer when you press MB2 to
 bring up the menu. If there is an open Inspect window
 associated with the object, it is closed.

=TITLE i_popup_exit
=TITLE Exit Inspector
 The pop-up menu appears when you press MB2. The Exit
 item on the pop-up menu exits the Inspector. If you
 invoked the Inspector by calling the INSPECT function
 with :PARALLEL NIL, the object origianlly inspected is
 returned.

=TITLE Dialog_boxes
=TITLE Dialog Boxes
 Dialog boxes are displayed when ever additional
 information is needed to carry out some task.

 See the additional topics for more information on
 the dialog boxes which may be availiable in the Lisp
 programming environment.

Additional information available:

trace options boxi modify dialoggeneric message boxgeneric caution box
generic wip boxload file selection boxcompile file selection boxed file selection box
suspend file selection boxsave file selection boxdebug call stack windowdebug var bind window
d commands boxs commands box

=TITLE trace_options_box
=TITLE Trace Options
 This dialog box lets you set various options on the
 tracing of a given function. The box is composed of a
 series of labeled text fields. If you enter appropriate
 values in each of the text fields and click on the OK
 button in this box the trace options for that function
 are modified. The options are:

 -  Invoke the debugger

 -  Invoke the stepper

 -  Suppress trace output

 -  Print a value

 -  Only note calls inside certain other functions

 See the additional topics below for more information on
 these options. (Alternatively, hold down the Help key
 and click MB1 on the text field in the Trace Options
 dialog box for which you wish to see more information.)

Additional information available:

t options ok buttont options cancel buttont o before debug textt o after debug text
t o around debug textt o before step textt o before supp textt o before print text
t o after print textt o around print textt options during text

=TITLE t_options_ok_button
=TITLE OK
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 You push the OK button to indicate that you are done
 setting the trace options for this function. The Trace
 Options dialog box is removed and the function's name
 is added to the Trace List.

=TITLE t_options_cancel_button
=TITLE Cancel
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 You push the Cancel button to indicate that you want to
 ignore all the options you entered in the dialog box.
 The dialog box is removed and the function's previous
 trace state remains unchanged.

=TITLE t_o_before_debug_text
=TITLE Enter Debugger Before Call
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 The text field, Before Call, appears under the heading,
 Invoke the Debugger if result is non-NIL. In this text
 field you specify a form to be computed just before
 each call to the traced function. If the form returns a
 non-NIL value, the debugger is invoked on the call to
 the traced function.

=TITLE t_o_after_debug_text
=TITLE Enter Debugger After Call
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 The text field, After Call, appears under the heading,
 Invoke the Debugger if result is non-NIL. In this text
 field you specify a form to be computed just after
 each call to the traced function. If the form returns
 a non-NIL value, the Debuger is invoked on the call
 immediately following the call to the traced function.

=TITLE t_o_around_debug_text
=TITLE Enter Debugger Around Call
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 The text field, Around Call appears under the heading,
 Invoke the Debugger if result is non-NIL. In this text
 field you specify a form to be computed just before
 and just after each call to the traced function. If
 the form returns a non-NIL value, the Debugger is
 invoked on the call to the traced function and again
 immediately following the call to the traced function.

=TITLE t_o_before_step_text
=TITLE Enter Stepper Before Call
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 The text field, Before Call, appears under the heading,
 Invoke the Stepper if result in non-NIL. In this text
 field you specify a form to be computed just before
 each call to the traced function. If the form returns
 a non-NIL value, the stepper is invoked on the call to
 the traced function.

=TITLE t_o_before_supp_text
=TITLE Suppress Output Before Call
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 The text field, Before Call, appears under the heading,
 Suppress trace output if result is non-NIL. In this
 text field you specify a form to be computed just
 before each call to the traced function. If the form
 returns a non-NIL value, this call to the traced
 function is not printed to the Trace Output region.

=TITLE t_o_before_print_text
=TITLE Print Before Call
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 The text field, Before Call, appears under the heading,
 Print result. In this text field you enter a symbol
 name or list of symbol names (unquoted, in both
 cases!). Immediately before the call to the traced
 function the values of these symbols are printed to the
 Trace Output region.

=TITLE t_o_after_print_text
=TITLE Print After Call
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 The text field, After Call, appears under the heading,
 Print result. In this text field you enter a symbol
 name or list of symbol names (unquoted, in both
 cases!). Immediately after the call to the traced
 function the values of these symbols are printed to
 the Trace Output region.

=TITLE t_o_around_print_text
=TITLE Print Around Call
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 The text field, Around Call, appears under the heading,
 Print result. In this text field you enter a symbol
 name or list of symbol names (unquoted, in both
 cases!). Immediately before and after the call to the
 traced function the values of these symbols are printed
 to the Trace Output region.

=TITLE t_options_during_text
=TITLE Only Trace During Calls In
=INCLUDE menus_and_objects dialog_boxes trace_options_box
 In the Only trace during calls in text field, you
 enter a symbol name or list of symbol names (unquoted,
 in both cases!). The functions and macros for which
 the trace is enabled are traced only when they are
 called (directly or indirectly) from within one of the
 functions or macros named by these symbols.

=TITLE i_modify_dialog
=TITLE Inspector Modify Dialog
 You use this dialog box to supply a new value for a
 component of an inspected object. The box displays
 the inspected object, the component you are about to
 modify, a text field for the new value and buttons to
 activate or cancel the modification.

 Double click on one of the additional topics below for
 more information.

Additional information available:

i modify objecti modify componenti modify new value texti modify ok button
i modify cancel button

=TITLE i_modify_object
=TITLE Object
 This label displays the object whose component you are
 about to modify.

=TITLE i_modify_component
=TITLE Component
 This label displays the current value of the component
 you are about to modify.

=TITLE i_modify_new_value_text
=TITLE New Value
 You use this text field to supply a new value for the
 component.

 Note that the text you supply will be READ, so supply
 quotes as necessary.

=TITLE i_modify_ok_button
=TITLE OK
 You use this button to complete the modification when
 you are satisfied with the value you have entered in
 the New Value field. Clicking MB1 on the OK button
 modifies the component and removes the Modify dialog
 box.

=TITLE i_modify_cancel_button
=TITLE Cancel
 You use this button to cancel the modification at any
 time. Clicking MB1 on the Cancel button leaves the
 component unchanged and removes the Modify dialog box.

=TITLE generic_message_box
=TITLE Message Box
 The system uses this dialog box to deliver a message,
 usually where a system error has occurred. You should
 read the message to determine what has happened and
 take the actions the message suggests. Once you have
 read the message you can click on the Acknowledged
 button to remove the box and, hopefully, continue.

=TITLE generic_caution_box
=TITLE Caution Box
 The system uses this dialog box to allow you to
 choose between alternatives. In general the buttons
 are labeled Yes and No. Click on the button that
 appropriately answers the question posed in the dialog
 box. The dialog box is removed and the action described
 in the question is or is not performed, depending on
 your choice.

 The other notable use of this caution box is when your
 code signals a fatal or continuable error. The buttons
 are labeled Debug and Abort or Debug and Continue,
 respectively. The error message is displayed in the
 box. Debug takes you into the LISP Debugger, Abort
 returns you to the READ-EVAL-PRINT loop and Continue
 attempts to continue from the continuable error.

=TITLE generic_wip_box
=TITLE Work-in-Progress Box
 The system uses this box to let you know that is is
 busy working on something. The work being done is
 described in the box. When the work is done the box
 is removed.

=TITLE load_file_selection_box
=TITLE Load File Selection Box
 You use this file selection box to supply a filename to
 be used as an argument to the LOAD function.

 Double click MB1 on the additional topic below for more
 information on using a file selection box.

Additional information available:

file selection box controls

=TITLE file_selection_box_controls
=TITLE File Selection Controls
 In a file selection box you see the following controls:

 -  Filter text field
    You supply a wildcard file specification in the
    Filter text field, such as *.lsp, that restricts the
    files displayed in the filename list box.

 -  Filter button
    You push the Filter button to change the contents
    of the Filename list box based on the new value you
    supplied in the Filter text field.

 -  Filename list box
    You click on the name of one of the files in
    the Filename list box to change the value of the
    Selection text field.

 -  OK button
    You push this button when you are satisfied with
    the value in the Selection field. The dialog box is
    removed.

 -  Cancel button
    You push this button at any time to cancel the
    current file operation. The dialog box is removed.

 -  Selection text field
    You click on the OK button to perform the current
    file operation on the value of the Selection
    text field. You can edit the value in this field
    directly.

=TITLE compile_file_selection_box
=TITLE Compile File Selection Box
=INCLUDE menus_and_objects dialog_boxes load_file_selection_box file_selection_box_controls
 You use this file selection box to supply a filename to
 be used as an argument to the COMPILE-FILE function.

 Double click MB1 on the additional topic below for more
 information on using a file selection box.

=TITLE ed_file_selection_box
=TITLE Ed File Selection Box
=INCLUDE menus_and_objects dialog_boxes load_file_selection_box file_selection_box_controls
 You use this file selection box to supply a filename to
 be used as an argument to the ED function.

 Double click MB1 on the additional topic below for more
 information on using a file selection box.

=TITLE suspend_file_selection_box
=TITLE Suspend File Selection Box
=INCLUDE menus_and_objects dialog_boxes load_file_selection_box file_selection_box_controls
 You use this file selection box to supply a filename to
 be used as an argument to the SUSPEND function.

 Double click MB1 on the additional topic below for more
 information on using a file selection box.

=TITLE save_file_selection_box
=TITLE Save File Selection Box
=INCLUDE menus_and_objects dialog_boxes load_file_selection_box file_selection_box_controls
 You use this file selection box to supply a filename
 for the file into which you want the Listener or
 Debugger transcript text to be written.

 Double click MB1 on the additional topic below for more
 information on using a file selection box.

=TITLE debug_call_stack_window
=TITLE Calling Stack Window
=INCLUDE menus_and_objects menu_bar_menus debugger_commands_menu
=INCLUDE overview utilities debugger debug_custom cust_debug_aux_win
 This window show you a representation of the LISP stack
 from the top-level-call (the bottom of the stack) to
 the point where the Debugger was invoked (the top of
 the stack). The information is similar to what you
 see in the Debug I/O window if you issue the Debugger
 BACKTRACE command.

 You can change the current Debugger frame by selecting
 a frame with MB1 (it is underlined when the pointer
 passes over it) and clicking on the button labeled
 Goto Frame. As a shortcut you can double click MB1
 on the frame you select. Either of these inserts the
 appropriate command into the Debug I/O window (for
 example, GOTO 14, where 14 is the number of the frame
 you clicked on).

 You can also select any object or text in this window
 for use with menu items in the Debug I/O window's Edit,
 Operations or Help menus, as well as for QuickCopy
 operations.

 You remove this window by clicking MB1 on the button
 labeled Cancel. If you wish to restore it you can bring
 it back with the Calling Stack... item in the Debugger
 I/O window's Commands menu.

Additional information available:

d cs goto buttond cs cancel buttond call stack text widget

=TITLE d_cs_goto_button
=TITLE Goto Frame button
=INCLUDE menus_and_objects dialog_boxes debug_call_stack_window d_call_stack_text_widget
=INCLUDE menus_and_objects dialog_boxes debug_call_stack_window
 You use this button to change the current frame in
 the Debugger. If you select a frame in the Backtrace
 display of the Calling Stack window and click on this
 button the selected frame becomes the current frame.
 Double click MB1 on one of the additional topics below
 for more information.

=TITLE d_cs_cancel_button
=TITLE Cancel button
=INCLUDE overview utilities debugger debug_call_stack_window
 This button removes the Calling Stack window. Clicking
 on the Calling Stack... item in the Debug I/O window's
 Commands menu brings back the Calling Stack window.

=TITLE d_call_stack_text_widget
=TITLE Backtrace Display
=INCLUDE menus_and_objects dialog_boxes debug_call_stack_window d_cs_goto_button
=INCLUDE menus_and_objects dialog_boxes debug_call_stack_window
 The backtrace display shows a quick backtrace of the
 stack. It suppresses frame numbers and insignificant
 frames. Each of the frames is represented by an object,
 so you can select a frame with MB1. This is useful in
 conjunction with the Goto Frame button. Double click
 MB1 on one of the additional topics below for more
 information.

=TITLE debug_var_bind_window
=TITLE Variable Bindings Stack Window
=INCLUDE menus_and_objects menu_bar_menus debugger_commands_menu
=INCLUDE overview utilities debugger debug_custom cust_debug_aux_win
 This window shows you the variables bound in the
 current frame and their values.

 You can select any object or text in this window for
 use with menu items in the Debug I/O window's Edit,
 Operations or Help menus, as well as for QuickCopy
 operations.

 You remove this window by clicking MB1 on the button
 labeled Cancel. If you wish to restore it you can bring
 it back with the Variable Bindings... item in the Debug
 I/O window's Commands menu.

Additional information available:

d vb cancel buttonvar bindings text widget

=TITLE d_vb_cancel_button
=TITLE Cancel button
=INCLUDE overview utilities debugger debug_var_bind_window
 This button removes the Variable Bindings window.
 Clicking MB1 on the Variable Bindings... item in
 the Debug I/O window's Commands menu brings back the
 Variable Bindings window.

=TITLE var_bindings_text_widget
=TITLE Variable Bindings display
=INCLUDE overview utilities debugger debug_var_bind_window
 This area displays the output of the Debugger SHOW
 ARGUMENTS command for the current frame. It is
 automatically updated when you move around the stack
 or modify an argument in the current frame.

=TITLE d_commands_box
=TITLE Debugger Commands Box
=INCLUDE menus_and_objects menu_bar_menus debugger_commands_menu
=INCLUDE overview utilities debugger debug_custom cust_debug_aux_win
 This window provides buttons that you can use to
 control the Debugger. You can click MB1 on any of the
 buttons to insert a command into the Debug I/O window's
 input region. The additional topics below describe the
 commands.

 If the button's label contains "..." it means that
 this command requires arguments. When you click on one
 of these commands, it brings up a small dialog box in
 which you set the argument. The layout of the dialog
 box depends on the command, its arguments and their
 potential values.

 Note that the commands that these buttons insert are in
 exactly the same form that you would type. The commands
 box can help you gain familiarity with the command line
 syntax, which, with practice, may be faster for you to
 use.

 You remove this window by clicking MB1 on the button
 labeled Cancel. If you wish to restore it you can bring
 it back with the Commands... item in the Debug I/O
 window's Commands menu.

Additional information available:

d quit buttond continue buttond cancel buttond backtrace button
d bottom buttond down buttond error buttond evaluate dots button
d goto dots buttond redo buttond return dots buttond search dots button
d set dots buttond show dots buttond step buttond top buttond up button
d where button

=TITLE d_quit_button
=TITLE Quit
=INCLUDE overview utilities listener listener_custom Prompt_on_exit
 You can click on this button to quit the Debugger. When
 you click on this button, you may be prompted before
 exiting the Debugger to confirm that you want to quit.
 The appearance of the prompt depends on the state of
 the :PROMPT-ON-EXIT attribute for the Debugger. See
 the additional topic below for more information on the
 customizable attribute.

=TITLE d_continue_button
=TITLE Continue
 You use this button to continue from the Debugger when
 you entered it through a continuable error or a direct
 call to the DEBUG function. Choosing the Continue item
 in the Debug I/O window's Commands menu or typing
 CONTINUE at the prompt in the Debug window does the
 same thing.

=TITLE d_cancel_button
=TITLE Cancel
 Clicking MB1 on this button removes the Debugger
 Commands box from the screen. You can bring it back
 by using the Commands... item in the Debug I/O window's
 Commands menu.

=TITLE d_backtrace_button
=TITLE Backtrace, Backtrace...
 Clicking MB1 on either of these buttons prints a
 backtrace of the stack to the Debug I/O window.

 Backtrace prints a quick backtrace of significant
 frames.

 Backtrace... brings up a small dialog box in which
 you set the amount of detail and the range for the
 backtrace.

=TITLE d_bottom_button
=TITLE Bottom, Bottom All
 Clicking MB1 on either of these buttons makes the
 current frame the bottom frame on the stack.

 Bottom takes you to the bottommost significant frame.

 Bottom All takes you to the bottommost frame,
 regardless of its significance.

=TITLE d_down_button
=TITLE Down, Down...
 Clicking MB1 on either of these buttons moves you down
 the stack.

 Down moves you down one significant frame.

 Down... brings up a small dialog box in which you set
 both the number of frames to move down and whether to
 include insignificant frames.

=TITLE d_error_button
=TITLE Error
 Clicking MB1 on this button recalls the error message
 in the Debug I/O window.

=TITLE d_evaluate_dots_button
=TITLE Evaluate...
 Clicking MB1 on this button brings up a small dialog
 box in which you enter an expression to be evaluated in
 the context of the active frame in the Debugger.

=TITLE d_goto_dots_button
=TITLE Goto...
 Clicking MB1 on this button brings up a small dialog
 box in which you specify a frame number. The active
 frame becomes the frame with the number you have
 specified.

=TITLE d_redo_button
=TITLE Redo
 Clicking MB1 on this button reexecutes your original
 form. You use Redo after having made changes to the
 stack in the debugging environment. If there are still
 errors, the evaluation is not completed.

=TITLE d_return_dots_button
=TITLE Return...
 Clicking MB1 on this button brings up a small dialog
 box in which you enter an expression. When you click
 on the OK button in this dialog box, this expression is
 computed and used as the return value of the form that
 originally put you in the Debugger.

=TITLE d_search_dots_button
=TITLE Search...
 Clicking MB1 on this button brings up a small dialog
 box in which you specify a search direction, a function
 name to search for and a count of how many occurrences
 to search past.

=TITLE d_set_dots_button
=TITLE Set...
 Clicking MB1 on this button brings up a small dialog
 box in which you set either a function or argument
 value to an arbitrary new value.

=TITLE d_show_dots_button
=TITLE Show...
 Clicking MB1 on this button brings up a small dialog
 box in which you select what you would like shown:
 arguments, call, function or the current frame.

=TITLE d_step_button
=TITLE Step
=INCLUDE overview utilities stepper
 Clicking MB1 on this button invokes the Stepper on the
 form in the current frame. See the additional topic
 below for more information on the Stepper.

=TITLE d_top_button
=TITLE Top, Top All
 Clicking MB1 on either of these buttons sets the active
 frame to the top of the stack.

 Top takes you to the topmost significant frame.

 Top All takes you to the topmost frame, regardless of
 its significance.

=TITLE d_up_button
=TITLE Up, Up...
 Clicking MB1 on either of these buttons moves you up
 the stack.

 Up moves you up one significant frame.

 Up... brings up a small dialog box in which you set
 both the number of frames to move up and whether to
 include insignificant frames.

=TITLE d_where_button
=TITLE Where
 Clicking MB1 on this button redisplays the current
 frame in the Debug I/O window.

=TITLE s_commands_box
=TITLE Stepper Commands Box
=INCLUDE menus_and_objects menu_bar_menus debugger_commands_menu
=INCLUDE overview utilities debugger debug_custom cust_debug_aux_win
 This window provides buttons that control the
 Stepper. Clicking MB1 on any of the buttons inserts
 a command into the Debug I/O window's input region.
 The additional topics below describe the individual
 commands.

 If the button's label contains "..." it means that this
 command requires arguments. When you click on one of
 them it brings up a small dialog box in which you set
 the argument. The layout of the dialog box depends on
 the command, its arguments and their potential values.

 Note that the commands that these buttons insert have
 the same form that you would type in yourself. The
 commands box can help you gain familiarity with the
 command line syntax, which, with practice, may be
 faster for you to use.

 Clicking MB1 on the Cancel button removes this window.
 If you want to restore it, you bring it back with the
 Commands... item in the Debug I/O window's Commands
 menu.

Additional information available:

s quit buttons cancel buttons backtrace buttons evaluate dots button
s finish buttons over buttons return dots buttons show button
s step buttons up button

=TITLE s_quit_button
=TITLE Quit
=INCLUDE overview utilities listener listener_custom Prompt_on_exit
 Clicking MB1 on this button quits the Stepper. When you
 click on this button, you may be prompted before the
 Stepper is exited to confirm your desire to quit.The
 appearance of the prompt depends on the state of the
 :PROMPT-ON-EXIT attribute for the Debugger. See the
 additional topic below for more information on the
 customizable attribute.

=TITLE s_cancel_button
=TITLE Cancel
 Clicking MB1 on this button removes the Stepper
 Commands Box from the screen. You bring it back by
 choosing the Commands... item in the Debug I/O window's
 Commands menu.

=TITLE s_backtrace_button
=TITLE Backtrace, Backtrace...
 Clicking MB1 on either of these buttons prints a
 backtrace of the stack to the Debug I/O window's
 transcript region.

 The Backtrace... button brings up a small dialog box in
 which you set options for the backtrace.

=TITLE s_evaluate_dots_button
=TITLE Evaluate...
 Clicking MB1 on this button brings up a small dialog
 box in which you enter an expression to be evaluated in
 the context of the current Step form and environment.

=TITLE s_finish_button
=TITLE Finish, Finish T
 Clicking MB1 on either of these buttons finishes the
 computation of the current step form without stepping.
 Finish T prints the intermediate return values.

=TITLE s_over_button
=TITLE Over
 Clicking MB1 on this button evaluates the current form
 without stepping through it.

=TITLE s_return_dots_button
=TITLE Return...
 Clicking MB1 on this button brings up a small dialog
 box in which you enter an expression. When you click on
 OK in this dialog box, this expression is computed and
 used as the return value of the original step form.

=TITLE s_show_button
=TITLE Show
 Clicking MB1 on this button redisplays the current step
 form.

=TITLE s_step_button
=TITLE Step
 Clicking MB1 on this button single steps the current
 form.

=TITLE s_up_button
=TITLE Up, Up...
 Clicking MB1 on either of these buttons suspends single
 stepping until control returns to the form immediately
 containing the current form. Additionally, Up... brings
 up a small dialog box in which you set the number of
 levels to move up.

=TITLE Display_stream
=TITLE Display Stream
=INCLUDE overview selection
=INCLUDE overview quick_copy
=INCLUDE overview utilities listener listener_custom object_recording
 Display streams are special window streams that allow
 you to select text or objects for use with menu items
 or QuickCopy operations.

 During printing a display stream records where the
 objects print representation started and ended. These
 records are used to select objects. During reading,
 a display stream replaces inserted objects (the text
 that represents them) with the exact object which was
 inserted. Since there is considerable overhead required
 to perform this feature, it can be turned off in the
 public display streams below. (See the additional
 topics below for more information.)

 In the development environment some utilities have
 display streams whch are bound to public streams in the
 following manner:

 o  Listener
    The initial value of *STANDARD-INPUT*,
    *STANDARD-OUTPUT* and *ERROR-OUTPUT* is bound to
    the Listener display stream.

 o  Debugger
    The initial value of *DEBUG-IO* is bound to the
    display stream in the Debugger Window.

 o  Trace Utility
    The initial value of *TRACE-OUTPUT* (output only)
    is bound to the display stream in the Trace Utility
    Window.

=TITLE Overview
=TITLE Overview of VAX LISP Development Environment
=INCLUDE menus_and_objects
=INCLUDE Using_Scrolls
 The VAX LISP Development Environment is the DECwindows-
 based interface to the VAX LISP system. It integrates
 the many functions involved in creating, running,
 debugging, and revising VAX LISP programs.

 For more information about using the VAX LISP
 Development Environment, move the pointer to any item
 in the list of Additional Topics below and double click
 MB1 (mouse button 1). For information about using Help,
 move the pointer to the Help menu in the Help on VAX
 LISP window's menu bar. Press and hold MB1. The Help
 menu appears. Drag the pointer to the Help item and
 release MB1. Help text is displayed.

 Note that the on-line documentation provided through
 this Help window is only intended to provide
 information on the structure and syntax of the VAX
 LISP Development Environment. It does not attempt to
 reproduce information that can be found through any of
 the following:

 -  The LISP APROPOS and DESCRIBE functions.

 -  The Editor Help commands.

 -  The Debugger command-line Help command.

 General information about VAX LISP, including
 installation, basic LISP interaction, step-by-
 step descriptions of program development and object
 reference pages, can be found in the hard copy
 documentation or on-line in the Bookreader.

 The on-line documentation provided through the Help
 window occasionally refers you to these other sources
 of information.

Additional information available:

DECBasicsTypes of HelputilitiesSelectionquick copyCustomization
Release Notes

=TITLE DECBasics
=TITLE DECwindows Basics
=INCLUDE Overview
 Basic information about using DECwindows, such as how
 to manage windows, and how to use dialog boxes and
 scroll bars, is available from Session Manager help.
 Also, many DECwindows terms are explained in Session
 Manager help.

 To get Session Manager help, display the Session
 Manager window on your screen. To do this, move the
 pointer to the icon box and click mouse button 1 (MB1)
 on the session manager icon. The session manager icon
 is the icon that contains your user name and the name
 of your system. The Session Manager window is then
 displayed on your screen.

 Move the pointer to the Help menu in the Session
 Manager window. Press and hold MB1 to pull down the
 Help menu. Drag the pointer to the Overview menu item
 and release MB1. "Overview" provides details about
 using DECwindows.

=TITLE Types_of_Help
=TITLE Types of Help
 There is help text available for most screen objects.
 That is, while holding down the Help key, you can point
 directly to a word or object displayed on the screen
 and click MB1 to see help text describing that object.
 This is known as context-sensitive help.

 Help is also available through a tree-structured
 organization of topics. The "Overview of VAX LISP
 Development Environment" topic is at the top of this
 organizational tree. The "Overview" topic is displayed
 when you click on the Overview item from the Help menu
 in the upper right corner of any main window in the
 LISP environment.

 At the bottom of the "Overview" screen and most other
 screens is a list of Additional Topics. By double
 clicking on the Additional Topics in each screen,
 you can move through the entire help database for the
 development environment. To move back to a previous
 screen, and eventually, all the way back to the
 top-level "Overview" screen from any point in this
 hierarchy, press the Go Back button. Each time you
 press it, you back up one screen.

 Many context-sensitive objects also have corresponding
 help topics defined under the "Overview" hierarchy. For
 example, there is context-sensitive help text for the
 Load... item in the File menu of the Listener window
 and there is also a topic several levels down from
 "Overview" called "Loading a File".

 While generally the context-sensitive help describes
 an object and the hierarchical help explains how to
 perform the task indicated by the object, they can
 sometimes overlap.

 Note: Sometimes there is more than one screen of
 information on a particular topic. To view the entire
 topic, you need to scroll the additional information.
 Therefore, you should check the scroll bars at the side
 of each screen to see whether or not you have viewed
 all Additional Topics and all help text.

=TITLE utilities
=TITLE Utilities
 The development environment is composed of a number of
 windows, grouped by the following utilities:

 -  Listener

 -  Debugger/Stepper

 -  Trace

 -  Editor

 -  Inspector

 -  Describe windows

 -  Apropos windows

 Double click on the Additional Topics listed below for
 more details on each utility.

Additional information available:

ListenerdebuggerstepperTraceEditorInspectorapropos describe windows

=TITLE Listener
=TITLE Listener
=INCLUDE menus_and_objects menu_bar_menus File_menu
=INCLUDE menus_and_objects menu_bar_menus Edit_menu
=INCLUDE menus_and_objects menu_bar_menus Operations_menu
=INCLUDE menus_and_objects menu_bar_menus Help_menu
=INCLUDE Menus_and_Objects Display_stream
 The Listener is the main utility for interaction
 with the LISP evaluator. In the Listener window is a
 text widget that is part of special type of stream
 called a display stream. Default initialization of the
 DECwindows programming environment binds the Common
 LISP standard streams *STANDARD-INPUT* and *STANDARD-
 OUTPUT* to this stream. Since the default top-level
 READ-EVAL-PRINT loop reads and writes to these streams
 you will find it running in the Listener window. In
 addition, by using LISP-sensitive input editing you
 can retrieve both text and object information from
 these and other display streams in other utilities. See
 the topic on display streams in the additional topics
 below.

 Listener menu items also perform a variety of LISP and
 DECwindows operations. These menus are described in the
 additional topics below.

Additional information available:

evaluating lisplistener custom

=TITLE evaluating_lisp
=TITLE Evaluating LISP
=INCLUDE Menus_and_Objects Display_stream
=INCLUDE overview utilities listener listener_custom eval_hist_limit
 You can evaluate LISP code in the Listener at the Lisp>
 prompt, in the Debugger at the Debugx> prompt or in the
 Stepper at the Step> prompt.

=TITLE listener_custom
=TITLE Customizing the Listener
=INCLUDE overview Customization cust_routine attr_key change_font
=INCLUDE overview Customization cust_routine attr_key change_color
=INCLUDE overview Customization cust_routine attr_key change_geometry
=INCLUDE overview Customization cust_routine attr_key change_init_state
=INCLUDE overview Customization cust_routine
 You can customize aspects of the Listener with the
 DECW-UTILS:CUSTOMIZATION routine (see the additional
 topic below) using :LISTENER as the object-keyword and
 one of the following attribute-keywords:

 -  :EVALUATION-HISTORY-LIMIT

 -  :PROMPT-ON-EXIT

 -  :OBJECT-RECORDING

 -  :FONT

 -  :FOREGROUND-COLOR

 -  :BACKGROUND-COLOR

 -  :BORDER-COLOR

 -  :HIGHLIGHT-COLOR

 -  :MONOCHROME-REVERSE

 -  :GEOMETRY

 -  :INITIAL-STATE

Additional information available:

eval hist limitprompt on exitobject recording

=TITLE eval_hist_limit
=TITLE Evaluation History Limit
=INCLUDE Menus_and_Objects Display_stream
 Setting the customization attribute :EVALUATION-
 HISTORY-LIMIT to a number limits the number of
 evaluations saved in either the Listener or Debugger
 display stream transcript regions to one less than the
 number set (the current input buffer is counted as an
 evaluation).

 The :EVALUATION-HISTORY-LIMIT attribute keyword is
 defined for use only with the :LISTENER and :DEBUGGER
 object keywords

 Setting the customization attribute :EVALUATION-
 HISTORY-LIMIT to be :DEFAULT sets the attribute to the
 default value stored in the LISP$DECWINDOWS.UID file
 (40).

 Once you have performed one less than the set number
 of evaluations, subsequent evaluation causes the oldest
 evaluation's text and object records to be removed from
 the transcript.

 Note that when you decrease this limit your transcript
 is immediately reduced to the new limit.

 Syntax example:

     Lisp> (decw-utils:customization
             :listener :evaluation-history-limit)
     40
     Lisp> (setf (decw-utils:customization
                   :listener :evaluation-history-limit)
                 20)
     20

=TITLE prompt_on_exit
=TITLE Prompt on Exit
 Setting the :PROMPT-ON-EXIT customization attribute
 controls whether you will be prompted for confirmation
 when exiting the listener, debugger, or inspector.

 The :PROMPT-ON-EXIT attribute keyword is defined
 for use with only the :LISTENER, :DEBUGGER, and the
 :INSPECTOR object keywords.

 Setting the customization attribute :PROMPT-ON-EXIT
 to be :DEFAULT sets the attribute to the default value
 stored in the LISP$DECWINDOWS.UID file (T).

 If this attribute is true, LISP brings up a caution box
 asking if you really want to exit the utility. If you
 do not wish to exit you can cancel the operation.

 If this attribute is not true, then the utility exits
 immediately.

 Syntax example:

     Lisp> (decw-utils:customization
             :listener :prompt-on-exit)
     T
     Lisp> (setf (decw-utils:customization
                   :debugger :prompt-on-exit)
                 NIL)
     NIL

=TITLE object_recording
=TITLE Object Recording
=INCLUDE Menus_and_Objects Display_stream
 Setting the :OBJECT-RECORDING customization attribute
 controls whether a given utility records objects
 as they are printed. If this attribute is true then
 objects printed to that utility's transcript region are
 sensitive to the pointer and can be retrieved directly.
 If this attribute is false, no object information is
 kept in the utility's transcript region.

 Setting the customization attribute :OBJECT-RECORDING
 to be :DEFAULT sets the attribute to the default value
 stored in the LISP$DECWINDOWS.UID file (T).

 The :OBJECT-RECORDING attribute keyword is defined for
 use with only the :LISTENER, :DEBUGGER, and the :TRACE
 object keywords.

 If you change this attribute from true to false,
 subsequent object recording data is not made. Previous
 object records are still available. In a similar
 manner, changing the attribute back to true affects
 only subsequently printed objects.

 Syntax example:

     Lisp> (decw-utils:customization
             :trace :object-recording)
     T
     Lisp> (setf (decw-utils:customization
                   :listener :object-recording)
                 NIL)
     NIL

=TITLE debugger
=TITLE Debugger
=INCLUDE menus_and_objects dialog_boxes debug_call_stack_window
=INCLUDE menus_and_objects dialog_boxes debug_var_bind_window
=INCLUDE menus_and_objects dialog_boxes d_commands_box
=INCLUDE menus_and_objects menu_bar_menus File_menu
=INCLUDE menus_and_objects menu_bar_menus Edit_menu
=INCLUDE menus_and_objects menu_bar_menus debugger_commands_menu
=INCLUDE menus_and_objects menu_bar_menus Operations_menu
=INCLUDE menus_and_objects menu_bar_menus Help_menu
=INCLUDE Menus_and_Objects Display_stream
=INCLUDE overview utilities listener Evaluating_lisp
=INCLUDE overview utilities stepper
 The Debugger is the utility you use for examining
 and modifying your code on the stack. It consists of
 four windows: the Debug I/O window, the Calling Stack
 window, the Variable Bindings window and the Debugger
 Commands box. The Debug I/O window is described
 here. You will find descriptions of the others under
 additional topics below.

 The Debug I/O window (the title bar reads LISP
 Debugger) is the main debugger window. It contains
 a display stream to which *DEBUG-IO* is bound. A
 special-purpose command loop for the Debugger runs in
 this window, reading and writing to this stream. If you
 are familiar with the Debugger's command-line interface
 from earlier versions of VAX LISP you will find this
 interface preserved in this window. You can type HELP
 at the Debugx> prompt for more information about the
 command-line interface.

 In addition to the command-line interface, you can use
 the menus in the Debug I/O window to perform a variety
 of LISP, Debugger control and DECwindows operations.
 These menus are described in additional topics below.

 (Note that the Debug I/O window is also used when you
 run the Stepper.)

Additional information available:

debug custom

=TITLE debug_custom
=TITLE Customizing the Debugger and Stepper
=INCLUDE overview utilities listener listener_custom prompt_on_exit
=INCLUDE overview utilities listener listener_custom eval_hist_limit
=INCLUDE overview utilities listener listener_custom object_recording
=INCLUDE overview Customization cust_routine attr_key change_font
=INCLUDE overview Customization cust_routine attr_key change_color
=INCLUDE overview Customization cust_routine attr_key change_geometry
=INCLUDE overview Customization cust_routine attr_key change_init_state
=INCLUDE overview Customization cust_routine
 You can customize aspects of the Debugger and
 Stepper with the DECW-UTILS:CUSTOMIZATION routine
 (see the additional topic below) using :DEBUGGER
 as the object-keyword and one of the following
 attribute-keywords:

 -  :PROMPT-ON-ENTRY

 -  :PROMPT-ON-EXIT

 -  :EVALUATION-HISTORY-LIMIT

 -  :OBJECT-RECORDING

 -  :FONT

 -  :FOREGROUND-COLOR

 -  :BACKGROUND-COLOR

 -  :BORDER-COLOR

 -  :HIGHLIGHT-COLOR

 -  :MONOCHROME-REVERSE

 -  :GEOMETRY

 -  :INITIAL-STATE

Additional information available:

cust debug aux winprompt on entry

=TITLE cust_debug_aux_win
=TITLE Customizing the Debugger Auxiliary Windows
=INCLUDE overview Customization cust_routine attr_key change_font
=INCLUDE overview Customization cust_routine attr_key change_color
=INCLUDE overview Customization cust_routine attr_key change_geometry
=INCLUDE overview Customization cust_routine attr_key change_init_state
=INCLUDE overview Customization cust_routine
 In addition to the customizations you can make to
 the Debug I/O window, you can use the following
 combinations of object-keyword and attribute-keywords
 with the DECW-UTILS:CUSTOMIZATION routine to customize
 the auxiliary windows of the Debugger and the Stepper:

    :CALLING-STACK-WINDOW
    :VARIABLE-BINDINGS-WINDOW

    -   :FONT

    -   :FOREGROUND-COLOR

    -   :BACKGROUND-COLOR

    -   :BORDER-COLOR

    -   :HIGHLIGHT-COLOR

    -   :MONOCHROME-REVERSE

    -   :GEOMETRY

    -   :INITIAL-STATE
    :DEBUGGER-COMMANDS-WINDOW
    :STEPPER-COMMANDS-WINDOW

    -   :FOREGROUND-COLOR

    -   :BACKGROUND-COLOR

    -   :BORDER-COLOR

    -   :HIGHLIGHT-COLOR

    -   :MONOCHROME-REVERSE

    -   :POSITION

    -   :INITIAL-STATE

 Note that for the commands boxes you can only set their
 positions - their sizes are fixed.

=TITLE prompt_on_entry
=TITLE Prompt on Entry
 Setting the :PROMPT-ON-ENTRY customization attribute
 controls whether LISP confirms that you want to enter
 the Debugger when a LISP error is signaled in your
 program and handled by the default error handler.
 (See VAX LISP Implementation and Extensions to Common
 LISP for more information on defining your own error
 handler.)

 This feature exists because the management of the four
 Lisp debugging windows can be slow. Use of this feature
 allows the user to quickly abort debugger startup when
 the error is obvious. The :PROMPT-ON-ENTRY attribute
 keyword is defined for use only with the :DEBUGGER
 object keyword.

 Setting the customization attribute :PROMPT-ON-ENTRY
 to be :DEFAULT sets the attribute to the default value
 stored in the LISP$DECWINDOWS.UID file (T).

 If this attribute is true, LISP brings up a caution box
 asking if you want to enter the Debugger or abort from
 the error or continue if the error was a continuable
 error. If you want to enter the Debugger, click MB1 on
 the DEBUG button. If you want to ignore the error,
 click MB1 on the ABORT button. If the error was a
 continuable error and you want to continue, click MB1
 on the CONTINUE button.

 If this attribute is false the Debugger is
 automatically entered when an error is signaled.

=TITLE stepper
=TITLE Stepper
=INCLUDE menus_and_objects dialog_boxes d_commands_box
=INCLUDE menus_and_objects menu_bar_menus File_menu
=INCLUDE menus_and_objects menu_bar_menus Edit_menu
=INCLUDE menus_and_objects menu_bar_menus debugger_commands_menu
=INCLUDE menus_and_objects menu_bar_menus Operations_menu
=INCLUDE menus_and_objects menu_bar_menus Help_menu
=INCLUDE Menus_and_Objects Display_stream
=INCLUDE overview utilities listener Evaluating_lisp
=INCLUDE overview utilities debugger
=INCLUDE overview utilities debugger debug_custom
 The Stepper is the utility you use to step
 interactively through the evaluation of a form. It
 consists of two windows: the Debug I/O window and the
 Stepper Commands box. The Debug I/O window is described
 here. The Stepper Commands box is described in an
 additional topic below.

 The Debug I/O window (entitled LISP Debugger) is the
 main window of the Stepper. It contains a display
 stream to which *DEBUG-IO* is bound. A special-purpose
 command loop for the Stepper runs in this window,
 reading and writing to this stream. If you are
 familiar with the Stepper's command-line interface
 from earlier versions of VAX LISP you will find this
 interface preserved in this window. You can type HELP
 at the Step> prompt for more information about the
 command-line interface.

 In addition to the command-line interface, you can use
 the menus in the Debug I/O window to perform a variety
 of LISP, Stepper control and DECwindows operations.
 These menus are described in additional topics below.

 (Note that the Debug I/O window is also used when you
 run the Debugger.)

=TITLE Trace
=TITLE Trace
=INCLUDE menus_and_objects menu_bar_menus Trace_commands_menu
=INCLUDE menus_and_objects menu_bar_menus edit_menu
=INCLUDE menus_and_objects menu_bar_menus help_menu
 The Trace utility provides a separate window in which
 you view the output from tracing the execution of
 functions and macros. The utility consists of one
 window separated into two regions: the Trace List
 region and the Trace Output region. These are described
 in additional topics below.

 In addition to these regions the Trace window provides
 menus for modifying the Trace system, accessing the
 Clipboard and getting Help. These menus are described
 in additional topics below.

Additional information available:

Trace listTrace outputtrace custom

=TITLE Trace_list
=TITLE Trace List
=INCLUDE menus_and_objects menu_bar_menus operations_menu trace_dots_item
=INCLUDE menus_and_objects menu_bar_menus operations_menu untrace_item
 The Trace List region spans the top of the Trace
 window, immediately below the menu bar. In this region
 are the symbols that name the functions and macros
 being traced. If nothing is being traced the Trace List
 reads "No functions being traced."

 You can select the symbols in the Trace List with MB1
 for use with the Trace... and Untrace items in the
 Trace Window's Commands menu. See the additional topics
 below for more information on these commands.

=TITLE Trace_output
=TITLE Trace Output
=INCLUDE menus_and_objects display_stream
 The Trace Output region is the lower portion of the
 Trace window, immediately below the Trace List. It
 contains the output display stream to which the Common
 LISP stream *TRACE-OUTPUT* is bound. The output of
 the TRACE macro is displayed in this region. If you
 are familiar with earlier versions of VAX LISP you
 will notice that the trace information is output in
 the same format. You can find more information on the
 TRACE macro and its output in the Debugging Facilities
 chapter of the VAX LISP Program Development Guide.

 You can select objects and text written to this window
 with the pointer for use with items in both the Trace
 window and any other LISP utility, as well as for
 QuickCopy operations.

=TITLE trace_custom
=TITLE Customizing the Trace Window
=INCLUDE overview Customization cust_routine attr_key change_font
=INCLUDE overview Customization cust_routine attr_key change_color
=INCLUDE overview Customization cust_routine attr_key change_geometry
=INCLUDE overview Customization cust_routine attr_key change_init_state
=INCLUDE overview utilities listener listener_custom object_recording
 You can customize aspects of the Trace window with the
 DECW-UTILS:CUSTOMIZATION routine (see the additional
 topic below) using :TRACE as the object-keyword and one
 of the following attribute-keywords:

 -  :PROMPT-ON-UNTRACE-ALL

 -  :FONT

 -  :FOREGROUND-COLOR

 -  :BACKGROUND-COLOR

 -  :BORDER-COLOR

 -  :HIGHLIGHT-COLOR

 -  :MONOCHROME-REVERSE

 -  :GEOMETRY

 -  :INITIAL-STATE

 -  :OBJECT-RECORDING

 Note that the font and color affected by :TRACE are
 those of the Trace Output region of the Trace window.
 You can use :TRACE-LIST to change these attributes for
 the Trace List.

 Note also that the :OBJECT-RECORDING attribute only
 affects the Trace Output region.

Additional information available:

prompt on untrace

=TITLE prompt_on_untrace
=TITLE Prompt on Untrace
 Setting the customization attribute
 :PROMPT-ON-UNTRACE-ALL controls whether LISP asks you
 to confirm use of the Untrace item on the Listener
 and Debug I/O windows' Operations menu and the Trace
 window's Commands menu WITHOUT a selection. (Selecting
 Untrace without a selection is the same as calling the
 UNTRACE macro without any arguments, which untraces all
 functions and macros being traced.)

 The :PROMPT-ON-UNTRACE attribute keyword is defined for
 use with only the :TRACE object keyword.

 Setting the customization attribute :PROMPT-ON-UNTRACE
 to be :DEFAULT sets the attribute to the default value
 stored in the LISP$DECWINDOWS.UID file (T).

 If this attribute is true, LISP brings up a caution
 box asking if you really want to untrace all remaining
 functions and macros. If you do not wish to do so you
 can cancel the operation.

 If this attribute is not true, LISP immediately
 untraces all remaining functions and macros.

 Syntax example:

     Lisp> (decw-utils:customization
             :trace :prompt-on-untrace-all)
     T
     Lisp> (setf (decw-utils:customization
                   :trace :prompt-on-untrace-all)
                 NIL)
     NIL

=TITLE Editor
=TITLE Editor
=INCLUDE menus_and_objects menu_bar_menus ed_file_menu
=INCLUDE menus_and_objects menu_bar_menus ed_edit_menu
=INCLUDE menus_and_objects menu_bar_menus ed_search_menu
=INCLUDE menus_and_objects menu_bar_menus ed_help_menu
 The Editor is the utility you use for editing your
 LISP source code and objects, as well as any text
 files you choose. This Editor is the same one found
 in earlier versions of VAX LISP. Under DECwindows you
 can use menus for common Editor commands and DECwindows
 clipboard operations. These menus are described in
 additional topics below.

 The Editor already has extensive on-line help built
 into it. When you are in the Editor you can press the
 HELP key for more information.

Additional information available:

editor custom

=TITLE editor_custom
=TITLE Customizing the Editor
=INCLUDE overview Customization cust_routine attr_key change_font
=INCLUDE overview Customization cust_routine attr_key change_color
=INCLUDE overview Customization cust_routine attr_key change_geometry
=INCLUDE overview Customization cust_routine attr_key change_init_state
=INCLUDE overview Customization cust_routine
 You can customize aspects of the Editor with the
 DECW-UTILS:CUSTOMIZATION routine (see the additional
 topic below) using :EDITOR as the object-keyword and
 one of the following attribute-keywords:

 -  :FONT

 -  :BOLD-FONT

 -  :FOREGROUND-COLOR

 -  :BACKGROUND-COLOR

 -  :BORDER-COLOR

 -  :HIGHLIGHT-COLOR

 -  :MONOCHROME-REVERSE

 -  :POSITION

 -  :INITIAL-STATE

 Note that there is a restriction on changing the
 Editor's fonts: you must use a fixed-width font family
 (such as the Terminal or Courier fonts supplied by
 DECwindows) and the normal and bold font sizes must be
 the same. Otherwise the Editor cannot correctly display
 text.

 Also, you should use the EDITOR:SCREEN-WIDTH and
 EDITOR:SCREEN-HEIGHT routines to change the size of
 the editor window. These routines return the width
 and height of the Editor window in character cell
 coordinates. You can use both routines with SETF to
 modify the size of the window. Of course you can also
 resize the window by hand using the pointing device.
 Doing so automatically updates the values returned by
 EDITOR:SCREEN-WIDTH and EDITOR:SCREEN-HEIGHT.

=TITLE Inspector
=TITLE Inspector
=INCLUDE overview selection
 The Inspector is the utility you use to examine and
 modify LISP data structures. The Inspector displays two
 types of windows. There is one Inspector History window
 and a number of Inspect windows. These two types of
 windows are described in additional topics below.

 You invoke the Inspector by calling the LISP INSPECT
 function on a LISP object or by selecting an object and
 choosing one of the menu items (available in various
 menus) labeled Inspect. If you have not inspected
 anything previously in this LISP, the Inspector History
 window and an Inspect window are created. Subsequent
 invocations bring up new Inspect windows but not a new
 Inspector History window.

Additional information available:

insp historyinsp windowsinsp custom

=TITLE insp_history
=TITLE Inspector History
=INCLUDE menus_and_objects menu_bar_menus ih_commands_menu
=INCLUDE menus_and_objects menu_bar_menus ih_edit_menu
=INCLUDE menus_and_objects menu_bar_menus help_menu
=INCLUDE overview utilities inspector
=INCLUDE overview utilities inspector insp_windows
 The Inspector History window displays a list of all of
 the objects you have inspected, one per row. The left
 column of this window also contains either a * or L
 when you have an Open or Locked Inspect window which
 corresponds to the object displayed in that row.

 Items in the Inspector History window's pull-down
 menus affect the selected object and provide access
 to the Clipboard and Help. These menus are described in
 additional topics below.

 A subset of the items in the pull-down menus are
 available in a pop-up menu. Pressing MB2 in the
 Inspector History window brings up the pop-up menu.
 The operations in the pop-up menus apply to the
 object that the pointer is over when you press MB2
 (as opposed to the pull-down menus, which operate on
 the selected object). Items in the pop-up menu that are
 not applicable (to the object on which you bring up the
 menu) appear dimmed and are unselectable.

 An additional shortcut is double clicking MB1 on any
 object in the Inspector History window to inspect the
 object.

=TITLE insp_windows
=TITLE Inspect Windows
=INCLUDE menus_and_objects menu_bar_menus i_commands_menu
=INCLUDE menus_and_objects menu_bar_menus i_edit_menu
=INCLUDE menus_and_objects menu_bar_menus help_menu
=INCLUDE overview utilities inspector
=INCLUDE overview utilities inspector insp_history
 Each Inspect Window displays a single object and its
 components (for example, a list and its elements, a
 structure and its slots, or a symbol and its name,
 package, value, function and property).

 The items in the pull-down menus in the Inspect windows
 affect the windows themselves and the selected object,
 and provide access to the Clipboard and Help. These
 menus are described in additional topics below.

 A subset of the items in the pull-down menus are
 available in a pop-up menu. Pressing MB2 in the Inspect
 windows brings up the pop-up menu. The operations in
 the pop-up menus apply to the object that the pointer
 is over when you press MB2 (as opposed to the pull-down
 menus, which operate on the selected object). Items in
 the pop-up menu that are not applicable to the object
 on which you bring up the menu appear dimmed (they are
 inactive).

 An additional shortcut is double clicking MB1 on any
 object in an Inspect window to inspect the object.

=TITLE insp_custom
=TITLE Customizing the Inspector
=INCLUDE overview Customization cust_routine attr_key change_geometry
=INCLUDE overview Customization cust_routine attr_key change_font
=INCLUDE overview Customization cust_routine attr_key change_color
=INCLUDE overview Customization cust_routine attr_key change_init_state
=INCLUDE overview Customization cust_routine
 You can customize aspects of the Inspector with the
 DECW-UTILS:CUSTOMIZATION routine (see the additional
 topic below) using one of the following combinations of
 object-keyword and attribute-keywords:

    :INSPECTOR
    These attributes affect the Inspector History window
    and the Inspector utility in general.

    -   :SEQUENCE-LENGTH-THRESHOLD

    -   :FONT

    -   :FOREGROUND-COLOR

    -   :BACKGROUND-COLOR

    -   :BORDER-COLOR

    -   :HIGHLIGHT-COLOR

    -   :MONOCHROME-REVERSE

    -   :GEOMETRY

    -   :INITIAL-STATE
    :INSPECT-WINDOWS
    These attributes affect the Inspect windows as a
    group (all of them have the same font and colors).

    -   :COUNT

    -   :POSITION-OFFSETS

    -   :FONT

    -   :FOREGROUND-COLOR

    -   :BACKGROUND-COLOR

    -   :BORDER-COLOR

    -   :HIGHLIGHT-COLOR

    -   :MONOCHROME-REVERSE

    -   :GEOMETRY

 (See the additional topic Positioning and Sizing
 Inspect Windows for more information about the use of
 :GEOMETRY and :POSITION-OFFSETS for Inspect windows.)

Additional information available:

seq len threshwin countwin geom

=TITLE seq_len_thresh
=TITLE Sequence Length Threshold
 Setting the customization attribute
 :SEQUENCE-LENGTH-THRESHOLD limits the number of
 elements in a sequence that are computed and printed
 to an Inspect window. This allows you to "preview"
 the beginning of a large sequence without computing
 and printing the whole object. When you inspect a
 sequence, a count of the number of elements is begun.
 When this count reaches the sequence length threshold
 you are prompted with a caution box that tells you
 the threshold has been reached and asks if would you
 like to see more. If you choose to, the count is reset
 to zero and begins incrementing as more elements are
 computed and printed. This process repeats either until
 you respond negatively to the prompt or the end of the
 sequence is reached.

 The :SEQUENCE-LENGTH-THRESHOLD attribute keyword
 is defined for use only with the :INSPECTOR object
 keyword.

 Setting the customization attribute
 :SEQUENCE-LENGTH-THRESHOLD to be :DEFAULT sets
 the attribute to the default value stored in the
 LISP$DECWINDOWS.UID file (75).

 If you reinspect a sequence, this entire process is
 repeated. If you originally wanted to see just the
 first part of a sequence but now want to see more,
 reinspect the object allowing the Inspector to print
 more of the object.

 When you increase or decrease this limit, there is no
 effect on objects you have already inspected. Sequences
 that you subsequently inspect prompt you based on the
 new limit.

 Syntax example:

     Lisp> (decw-utils:customization
             :inspector :sequence-length-threshold)
     75
     Lisp> (setf (decw-utils:customization
                   :inspector :sequence-length-threshold)
                 50)
     50

=TITLE win_count
=TITLE Number of Windows
 Setting the :COUNT customization attribute controls the
 number windows the utility creates before reusing the
 oldest window for new text. Note that for the Inspector
 this attribute defines the number of unlocked Inspect
 windows.

 Setting the customization attribute :COUNT to be zero
 (0) allows an infinite number of windows to be created.

 The :COUNT attribute keyword is defined for use
 only with the :INSPECT-WINDOWS :DESCRIBE-WINDOWS or
 :APROPOS-WINDOWS object keywords.

 Setting the customization attribute :COUNT to be
 :DEFAULT sets the attribute to the default value
 stored in the LISP$DECWINDOWS.UID file. The default
 value for :INSPECT-WINDOWS is 5. The default value for
 :DESCRIBE-WINDOWS and :APROPOS-WINDOWS is 0.

 If you raise this attribute's value, the utility, on
 subsequent invocations, creates more new windows until
 the number of windows (unlocked inspect windows for the
 Inspector) matches the new value.

 If you lower this attribute's value the utility
 only creates new windows when the number of windows
 (unlocked Inspect windows for the Inspector) is below
 the new value. If the number of windows is greater
 than the new value you set, the utility continues to
 cycle through all of the windows. As you close them,
 however, new ones will not be created unless the number
 of windows drops below the value of this attribute.

 Syntax example:

     Lisp> (decw-utils:customization
             :inspect-windows :count)
     5
     Lisp> (setf (decw-utils:customization
                   :inspect-windows :count)
                 7)
     7

=TITLE win_geom
=TITLE Positioning and Sizing Multiple-window Objects
 Unlike the Inspector History window and most of the
 other utility windows, you cannot control the absolute
 position and size of Inspect, Apropos or Describe
 windows. Instead, you control the absolute position of
 the first window created, offsets from that position
 for subsequently created windows and the size for
 subsequently created windows.

 The :GEOMETRY attribute-keyword with the
 DECW-UTILS:CUSTOMIZATION routine gets or sets the
 first window's position and size and all of the
 subsequently created windows. The :POSITION-OFFSETS
 attribute-keyword gets or sets offsets in the x and y
 directions that specify the position, relative to the
 first window, of subsequently created windows.

 The :POSITION-OFFSETS attribute-keyword may only be
 used with the :INSPECT-WINDOWS, :APROPOS-WINDOWS or
 :DESCRIBE-WINDOWS object-keywords.

 Changing any of these attributes has no effect on any
 windows that have already been created, including those
 that have since been unmapped. If you do not change
 the attributes or change them before the first call
 to a function which will create them in a fresh LISP,
 then all the windows come up the same size and form
 a cascade from the first window to the last. (The
 direction and spread of this cascade depend on the
 :POSITION-OFFSETS attribute.)

 However, if you create a few windows, move and resize
 them, modify these attributes (which, as indicated
 above, does not modify the existing windows) and then
 perform another window creation function, the size and
 position of the new window will be computed from the
 values of the attributes and may bear no relation in
 size or position to any of the earlier windows.

=TITLE apropos_describe_windows
=TITLE Apropos and Describe
=INCLUDE menus_and_objects menu_bar_menus help_menu apropos_item
=INCLUDE menus_and_objects menu_bar_menus help_menu describe_item
=INCLUDE menus_and_objects menu_bar_menus help_menu
 The Common Lisp functions: APROPOS and DESCRIBE can
 be used to get information about which symbols are
 interned and what bindings symbols have. If these
 functions are typed at the listener the output is
 written in the listener. If these functions are
 selected from the Help menu output is written in
 separate Apropos or Describe windows.

=TITLE Selection
=TITLE Selecting Text and Objects
=INCLUDE overview quick_copy
=INCLUDE overview utilities listener listener_custom object_recording
 In the DECwindows-based VAX LISP Development
 Environment one of the major features is that you can
 select not only text but the actual LISP object that is
 represented by that text.

 When you move the pointer over text that represents
 an object, the text is underlined. When you move
 the pointer out of the region of the object, the
 underlining disappears. Note that if an object is
 hierarchically structured, both the object and its
 individual elements are selectable individually.

 For example, if LISP prints the representation of the
 list (A (B C) D) and you move the pointer over the list
 from left to right, you will notice that if the pointer
 is over either of the outer parentheses, the space
 after the symbol A or the space before the symbol D,
 the entire list is underlined. If the pointer is over
 either of the inner parentheses or the space between
 the symbols B and C, the text (B C) is underlined.
 Finally, if the pointer is over any of the individual
 symbols they are underlined.

 You select an object by clicking MB1 when the pointer
 is over underlined text. The text representation of the
 object becomes highlighted. You perform operations on
 this object by either choosing some menu item or using
 QuickCopy to copy the object.

 You still select text in the standard DECwindows style:
 press MB1 and drag the pointer across the text you
 want to select. The text becomes highlighted as you
 move the pointer. When you release MB1 the text remains
 highlighted. You perform operations on this text by
 either choosing some menu item or using QuickCopy to
 copy the text.

 You may find there is a certain amount of overhead
 involved in the object recording feature. If you find
 that you do not use or need it, you can disable it for
 certain windows. See the additional topic on Object
 Recording below for more information.

=TITLE quick_copy
=TITLE QuickCopying
=INCLUDE overview selection
 In the DECwindows-based VAX LISP Development
 Environment the standard operations for quickly copying
 information from one area to another are extended to
 apply to both text and objects.

 You copy text from any window to the window that
 currently has input focus by pressing MB3, dragging
 the pointer over the desired text and releasing MB3.
 Alternatively, you make a text selection in some window
 and click MB3 at the point in a window into which you
 want the text copied. In both cases the two windows can
 be the same window.

 You copy a LISP object from any LISP window to the
 window that currently has input focus by clicking MB3
 when the pointer is over the object. Alternatively,
 you make an object selection in some LISP window and
 click MB3 at the point in a window into which you want
 the object copied. Again, in both cases the two windows
 can be the same window. Note, however, that copying
 objects only applies between certain LISP windows since
 other applications do not understand LISP. If the area
 to which you copy the object does not understand LISP,
 only the text representation is copied.

 Quick Copy is defined as part of the XUI Style guide.
 All X windows do not define Quick Copy protocol. If the
 window with input focus or the window containing the
 mouse are not XUI Style Guide compliant, the Quick Copy
 Operation is undefined.

 See the additional topic on Selecting Text and
 Objects below for more information on text vs. object
 selection.

=TITLE Customization
=TITLE Customizing the Development Environment
=INCLUDE overview utilities listener listener_custom
=INCLUDE overview utilities debugger debug_custom
=INCLUDE overview utilities inspector insp_custom
=INCLUDE overview utilities trace trace_custom
=INCLUDE overview utilities editor editor_custom
=INCLUDE menus_and_objects menu_bar_menus help_menu apropos_item apropos_describe_windows_custom
 You can tailor certain aspects of the
 development environment through the LISP routine
 DECW-UTILS:CUSTOMIZATION. A description of this routine
 is listed as an additional topic or type (DESCRIBE
 'DECW-UTILS:CUSTOMIZATION) in the Listener.

 The following customizations are supported to some
 degree in various utilities:

 -  Change font.

 -  Change colors.

 -  Change window size and position.

 -  Change the initial state of the utility.

 In addition to these there are some that are specific
 to the individual utilities.

 Routines are defined for interactively saving and
 recalling customizations.

 Finally, you can also customize the DECwindows FileView
 Applications menu to invoke LISP directly.

 Double click on any of these items in the list of
 Additional Topics below for text describing how to
 perform certain types of customization. The topics on
 the individual utilities give more information on the
 specific customizations available for each utility.

Additional information available:

cust routinesave customizationload customizationCustom Vue

=TITLE cust_routine
=TITLE The DECW-UTILS:CUSTOMIZATION routine
 You retrieve the values of various attributes in the
 development environment with this routine. You use
 the same form with SETF to change the values of the
 attributes.

 Format: DECW-UTILS:CUSTOMIZATION object-keyword
 attribute-keyword

 Both arguments are keywords indicating the object
 and attribute whose values you want retrieved. See
 the additional topics below for descriptions of these
 arguments and their allowed values.

Additional information available:

object keywordattr key

=TITLE object_keyword
=TITLE Object keywords
=INCLUDE overview utilities listener listener_custom
=INCLUDE overview utilities debugger debug_custom
=INCLUDE overview utilities debugger debug_custom cust_debug_aux_win
=INCLUDE overview utilities editor editor_custom
=INCLUDE overview utilities trace trace_custom
=INCLUDE overview utilities inspector insp_custom
=INCLUDE menus_and_objects menu_bar_menus help_menu apropos_item apropos_describe_windows_custom
 You can specify any of the following as the
 object-keyword argument to the DECW-UTILS:CUSTOMIZATION
 routine:

    :LISTENER
    :DEBUGGER
    :CALLING-STACK-WINDOW
    :VARIABLE-BINDINGS-WINDOW
    :DEBUGGER-COMMANDS-BOX
    :STEPPER-COMMANDS-BOX
    :EDITOR
    :TRACE
    :TRACE-LIST
    :INSPECTOR
    :INSPECT-WINDOWS
    :APROPOS-WINDOWS
    :DESCRIBE-WINDOWS

 For more information on which attribute-keywords can be
 used with each object-keyword see the descriptions of
 customizing the individual utilities under additional
 topics below or see the Customizing DECwindows from
 VAX LISP appendix of the VAX LISP Program Development
 Guide.

=TITLE attr_key
=TITLE Attribute keywords
=INCLUDE overview utilities listener listener_custom eval_hist_limit
=INCLUDE overview utilities listener listener_custom object_recording
=INCLUDE overview utilities debugger debug_custom prompt_on_entry
=INCLUDE overview utilities listener listener_custom prompt_on_exit
=INCLUDE overview utilities trace trace_custom prompt_on_untrace
=INCLUDE overview utilities inspector insp_custom win_count
=INCLUDE overview utilities inspector insp_custom seq_len_thresh
 You specify any of the following as
 the attribute-keyword argument to the
 DECW-UTILS:CUSTOMIZATION routine:

    :FONT
    :BOLD-FONT
    :FOREGROUND-COLOR
    :BACKGROUND-COLOR
    :BORDER-COLOR
    :HIGHLIGHT-COLOR
    :MONOCHROME-REVERSE
    :GEOMETRY
    :POSITION-OFFSETS
    :POSITION
    :INITIAL-STATE
    :EVALUATION-HISTORY-LIMIT
    :OBJECT-RECORDING
    :PROMPT-ON-ENTRY
    :PROMPT-ON-EXIT
    :PROMPT-ON-UNTRACE-ALL
    :COUNT
    :SEQUENCE-LENGTH-THRESHOLD

 For more information on which attribute-keywords can be
 used with each object-keyword see the descriptions of
 customizing the individual attributes under additional
 topics below or see the Customizing DECwindows from
 VAX LISP appendix of the VAX LISP Program Development
 Guide.

Additional information available:

change fontchange colorchange geometrychange init state

=TITLE change_font
=TITLE Font
 You change the font of an object by using the
 DECW-UTILS:CUSTOMIZATION routine with SETF, the
 attribute-keyword :FONT and a new value that is either
 a CLX:FONT or a string naming a font. When you specify
 a font using a string you need only supply identifying
 characters with the character * as a wildcard for
 the server to match. (The string argument is of the
 same form you would supply to the CLX:LIST-FONT-NAMES
 function.) If the string you supply matches more than
 one font name the X server uses the first one it finds.

 When the new value is specified to be :DEFAULT the font
 is set to the font defined in the LISP$DECWINDOWS.UID
 file.

 The :FONT attribute keyword is defined for use with all
 object keywords.

 For example:

     Lisp> (setf (decw-utils:customization :listener :font) "*helvetica*12*")
     "*helvetica*12*"
     Lisp> (decw-utils:customization :listener :font)
     #<CLX font -Adobe-Helvetica-Medium-R--12-120-75-75-P-67-ISO8859-1>

 In addition, you use the DECW-UTILS:LIST-FONTS function
 with a string to return a list of all the fonts known
 to the server that match the string. If you call the
 function without arguments, a list of all fonts known
 to the server is returned.

=TITLE change_color
=TITLE Colors
 You change the colors of a given object by using
 the DECW-UTILS:CUSTOMIZATION routine with SETF,
 one of the attribute-keywords :FOREGROUND-COLOR,
 :BACKGROUND-COLOR, :BORDER-COLOR or :HIGHLIGHT-COLOR
 and a new value which is either :DEFAULT a CLX:PIXEL, a
 CLX:COLOR or a string naming a color.

 On monochrome displays, you can reverse the video of
 an object by using the DECW-UTILS:CUSTOMIZATION routine
 with SETF, the attribute-keyword :MONOCHROME-REVERSE
 and a new value of T or NIL.

 When the new value is specified to be :DEFAULT the
 color is set to the corresponding system default color.

 The :FOREGROUND-COLOR, :BACKGROUND-COLOR :BORDER-COLOR,
 :HIGHLIGHT-COLOR and :MONOCHROME-REVERSE attribute
 keywords are defined for use with all object keywords.

 For example:

     Lisp> (setf (decw-utils:customization :listener :foreground-color) "navyblue")
     "navyblue"
     Lisp> (setf (decw-utils:customization :listener :foreground-color)
                 (clx:make-color :red .8 :green .2 :blue .6))
     #<CLX Color red: .80 :green .20 :blue .60>
     ;; A CLX:PIXEL is an integer as you might get from CLX:ALLOC-COLOR
     Lisp> (setf (decw-utils:customization :listener :foreground-color) 254)
     254

=TITLE change_geometry
=TITLE Window Size and Position
=INCLUDE overview utilities inspector insp_custom win_geom
 You change the size and position of a given object by
 using the DECW-UTILS:CUSTOMIZATION routine with SETF,
 one of the attribute-keywords :GEOMETRY or :POSITION
 and a new value which a list of four integers in the
 form (x y width height), or two integers in the form (x
 y).

 When the new value is specified to be :DEFAULT the size
 and/or position are set to the parameters defined in
 the LISP$DECWINDOWS.UID file.

 Although you can change the whole geometry of most
 of the windows in the development environment you are
 restricted to only changing the position of the Editor,
 Debugger Commands and Stepper commands boxes. You can
 change the Editor size with the EDITOR:SCREEN-HEIGHT
 and EDITOR:SCREEN-WIDTH routines. The commands boxes
 are fixed in size.

 For example:

     Lisp> (setf (decw-utils:customization :listener :geometry) '(0 400 500 300))
     (0 400 500 300)
     Lisp> (setf (decw-utils:customization :editor :position) '(200 200))
     (200 200)

=TITLE change_init_state
=TITLE Initial State
=INCLUDE overview customization save_customization
=INCLUDE overview customization load_customization
 You change the initial state of an object by using
 the DECW-UTILS:CUSTOMIZATION routine with SETF, the
 attribute-keyword :INITIAL-STATE and a value of :OPEN,
 :CLOSED or :DEFAULT.

 When the new value is specified to be :DEFAULT the
 initial state is set to the parameters defined in the
 LISP$DECWINDOWS.UID file. The default value for all
 utilities in that file is :OPEN.

 Note that setting the initial state for a utility
 does not change the current state of the utility. To
 operate the initial state attributes, the value must
 be set and then saved. Upon subsequent use of the saved
 customizations, the object's initial state will be
 affected only at DECwindows initialization time.

 The applicable objects are affected by initial state
 values in the following manner:

 Object      :OPEN value           :CLOSED value

 :LISTENER   The listener runs     The listener runs in
             in a separate         the terminal window.
             DECwindows window.

 :DEBUGGER   The debugger runs     The debugger runs in
             in a separate         the same window as
             DECwindows windows.   the listener.

 :INSPECTOR  The decwindows        The decwindows
             inspector is          inspector is not
             initialized.          defined in the Lisp
                                   session.

 :EDITOR     The decwindows        The decwindows editor
             editor is             runs synchronously in
             initialized.          the terminal window.

 :TRACE      Trace output goes     Trace output goes to
             to a separate         the same window as
             Decwindows window.    the listener output.

 :APROPOS-   DECwindows apropos    All apropos output
 WINDOWS     output goes to        the same window as
             separate DECwindows   the listener output.
             windows.

 :DESCRIBE-  DECwindows describe   All describe output
 WINDOWS     output goes to        the same window as
             separate DECwindows   the listener output.
             windows.

 For example: execution of the following code would
 cause the listener to run in the terminal window the
 next time Lisp was run by this user.

     Lisp> (setf (decw-utils:customization
                  :listener :initial-state) :closed)
     :CLOSED
     Lisp> (decw-utils::save-customizations)

     Saving customizations to DECW$USER_DEFAULTS:LISP$DEFAULTS.DAT
     Done.
     Lisp>

 See the addition topics below for more information on
 saving and loading customizations.

=TITLE save_customization
=TITLE Saving customizations
=INCLUDE overview customization load_customization
 You write out the current settings of all of the
 customizations using the DECW-UTILS:SAVE-CUSTOMIZATIONS
 routine. You use the :FILE keyword argument to
 specify a file into which the customizations
 are saved. By default they are written into
 DECW$USER_DEFAULTS:LISP$DEFAULTS.DAT. This file is
 read in every time you start up a fresh LISP, so
 by making changes and saving into this file you can
 change the default appearance of your LISP Development
 Environment.

 It is possible to have different arrangements of
 the windows for certain types of work. You store the
 different settings into separate files which you load
 explicitly.

 See the additional topic below for information on
 explicitly recalling stored defaults.

 Note that although the customization file that is
 written out is user-readable you should not edit it
 by hand. It is meant only to be loaded by LISP.

=TITLE load_customization
=TITLE Recalling saved customizations
=INCLUDE overview customization save_customization
 You recall saved customization settings using the
 DECW-UTILS:LOAD-CUSTOMIZATIONS routine. You use the
 :FILE keyword argument to specify a file from which the
 customizations are read. By default they are read from
 DECW$USER_DEFAULTS:LISP$DEFAULTS.DAT. This file is read
 in every time you start a fresh LISP, so you do not
 need to load this file explicitly unless you have made
 customization changes in this LISP and want to revert
 to the startup settings.

 You revert to the default system settings by specifying
 :SYSTEM-DEFAULTS as the :FILE argument in your call to
 DECW-UTILS:LOAD-CUSTOMIZATIONS.

 See the additional topic below for information on
 storing the defaults.

=TITLE Custom_Vue
=TITLE Customizing the FileView Applications Menu
 You can add the LISP verb to the DECwindows FileView
 Applications menu. This allows you to invoke LISP
 by clicking on the menu item in the FileView window
 rather than by issuing a DCL command in a terminal
 emulator window. To add the LISP Environment verb to
 the FileView Applications menu:

 -  Pull down the Create menu in the DECwindows Session
    Manager window, and choose FileView. The FileView
    window opens.

 -  Pull down the Customize menu in the FileView window,
    and choose Verbs and Menus. A dialog box appears.

 -  Type LISP in the text entry field under Verb Names.

 -  Click MB1 on the Enter button in the Verb Names
    region.

 -  Type LISP with any memory or initialization
    qualifiers you normally use from DCL in the
    text entry field under DCL Command for Selected
    Verb. An example of qualifiers would be
    LISP/MEMORY=25000/INIT=SYS$LOGIN:MYLISPINIT.

 -  Click MB1 on the Enter button in the DCL Command for
    Selected Verb region.

 -  Select a menu from the list box under Menu Names
    (Applications is the default and may be where you
    want it, in which case do nothing).

 -  Click MB1 on the Add button under Verbs in Menu

 -  Click on OK.

 The new verb, LISP, appears the next time you open the
 FileView window and pull down the menu you specified
 (Applications by default).

Additional information available:

custom vue comfile

=TITLE custom_vue_comfile
=TITLE Using a DCL command file
 Another way to customize the FileView to invoke LISP
 is to specify the execution of a DCL command file
 in place of specifying LISP/qualifiers in the text
 entry filed under DCL Command for Selected Verb.
 For example, you could specify the following in
 SYS$LOGIN:RUNBIGLISP.COM:

       $ SET PROCESS/NAME="Big LISP"
       $ LISP/MEM=100000

 and put @SYS$LOGIN:RUNBIGLISP in the text field in
 FileView. This way you can add other DCL commands that
 you would like to have alter the environment (such as
 the process name, in this example) in which the LISP
 image is invoked.

=TITLE Release_Notes
=TITLE Release Notes
 On-line release notes are available for VAX LISP. Type
 or print them from the following file:

     SYS$HELP:LISP030.RELEASE_NOTES

=TITLE Using_Scrolls
=TITLE Using Scroll Bars
 You use scroll bars to display data outside the borders
 of a window. A scroll bar has stepping arrows at each
 end of the scroll region and a slider within the scroll
 region.

 For more information about using a scroll bar, double
 click MB1 on one of the additional topics.

Additional information available:

Stepping arrowsScroll regionSlider

=TITLE Stepping_arrows
=TITLE Using Stepping Arrows
 Stepping arrows are the arrows that appear at the each
 end of a scroll bar.

 To move the window one line in the direction of the
 stepping arrow, move the pointer to a stepping arrow
 and click MB1.

=TITLE Scroll_region
=TITLE Using the Scroll Region
=INCLUDE Using_Scrolls Stepping_arrows
 The scroll region is the area between the stepping
 arrows that is not under the slider.

 To move the data in the window by one window length,
 move the pointer to the scroll region and click MB1.

=TITLE Slider
=TITLE Using the Slider
 The slider is the wider rectangle that appears over
 part of the scroll bar. The length of the slider
 indicates how much of the data appear on the screen.
 For example, if the slider takes up 10% of the
 scrolling region, only 10% of the data are displayed
 in the window.

 To move quickly through the data, move the pointer to
 the slider. Press MB1, and drag the slider through the
 scrolling region. When you release MB1, the information
 from the position in the data indicated by the slider
 is displayed in the window.