Additional information available:

AboutGlossaryMenus and ObjectsOverviewUsing Scrolls

=TITLE About
=TITLE About VAX LISP
=INCLUDE Overview
 Copyright © Digital Equipment Corporation. 1989. 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.0

 The information in these texts is subject to change
 without notice and should not be construed as a
 commitment by Digital Equipment Corporation.

 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.

 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.0.

=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.

Additional information available:

File Menuedit menuoperations menuhelp menuDisplay stream
debugger commands menutrace commands menutrace options boxed file menu
ed edit menued search menued commands menued help menuih commands menu
ih edit menui commands menui edit menui popup undoi popup copyi popup paste
i popup lock togglei popup inspecti popup updatei popup modify
i popup returni popup closei popup removei popup exiti modify dialog
OK buttonApply buttongeneric message boxgeneric caution boxgeneric wip box
file selection box controlsload file selection boxcompile file selection boxed file selection box
suspend file selection boxsave file selection boxd cs goto buttond cs cancel button
d call stack text widgetd vb cancel buttonvar bindings text widget

=TITLE File_Menu
=TITLE File Menu
 You will find a File menu in both the Listener and
 Debugger I/O windows. 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 through either the Listener or Debugger evaluation
 loops. When you choose the Load item and a dialog box
 appears, select the name of a LISP source or compiled
 file to load into the Development Environment.

 A LISP form of the form (LOAD "filename") will be
 inserted and evaluated in the window. If the READ-EVAL-
 PRINT loop is still computing the previously read form,
 the Load form will be 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 the name of
 a file to edit.

 A LISP form of the form (ED "filename") will be
 inserted and evaluated in the window. If the READ-
 EVAL-PRINT loop is still computing the previously read
 form, the Ed form will be 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 the name of a file to
 compile.

 A LISP form of the form (COMPILE-FILE "filename") will
 be inserted and evaluated in the window. If the READ-
 EVAL-PRINT loop is still computing the previously read
 form, the Compile file form will be 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 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") will be inserted and evaluated in the
 window. If the READ-EVAL-PRINT loop is still computing
 the previously read form, the Suspend form will be 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 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 a file to which you would the output
 to be written.

 A LISP form of the form (SUSPEND "filename") will be
 inserted and evaluated in the window. If the READ-EVAL-
 PRINT loop is still computing the previously read form,
 the Suspend form will be 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 would like to
 Suspend again 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 a file to which you would
 the output to be written.

 A LISP form of the form (DRIBBLE "filename") will be
 inserted and evaluated in the window. If the READ-EVAL-
 PRINT loop is still computing the previously read form,
 the Dribble form will be 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 can 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 save_As
 The Save item in the File menu of a given 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 is written out immediately, without
 any effect on the READ-EVAL-PRINT loop.

=TITLE save_as
=TITLE Save as...
=INCLUDE menus_and_objects save
 The Save As item in the File menu of a given 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 a file
 to which you would the output to be written. The file
 is written out immediately, without any effect on the
 READ-EVAL-PRINT loop.

 If at a later time in the same LISP you would like to
 write out the transcript again into the same file you
 can 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, confirming your
 desire to Exit, depending 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 will find an Edit menu in most windows in the
 Development environment. You can use the items in them
 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. 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:

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 that is local to LISP. That is,
 it is not the global DECwindows Clipboard available
 from other DECwindows applications. No information is
 shared between these Clipboards. However, you can use
 this Clipboard to store real LISP objects for retrieval
 later in the LISP session and for moving information
 between windows in the Development Environment.

=TITLE undo_item
=TITLE Undo/Redo
 You can use this item to reverse 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. Immediately after the
 Undo this item's label changes to Redo. If you select
 Redo the previously undone operation will be redone.
 Continuing the example, if you choose Redo the Cut will
 be performed again, removing the text to the Clipboard.

=TITLE cut_item
=TITLE Cut
 You can use this item to remove selected text or
 objects from an editable region (such as the input
 region of the Listener) and put 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
 You can use this item to copy selected text or objects
 and put them on the LISP Clipboard.

=TITLE clear_item
=TITLE Clear
 You can use this item to clear any stored items from
 the LISP Clipboard.

=TITLE paste_item
=TITLE Paste
 You can use this item to insert 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 will replace 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
 will be 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
 will be treated as a LISP string for the component's
 new value.

=TITLE select_all_item
=TITLE Select All
 You can use this item to select 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
 You can use the items in this menu to 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. The items in this
 menu are:

 -  INSPECT

 -  ED

 -  EVAL

 -  COMPILE

 -  UNCOMPILE

 -  DISASSEMBLE

 -  TRACE

 -  TRACE...

 -  UNTRACE

 -  STEP

 -  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 itemabort itembreak item
continue itemdebug item

=TITLE inspect_item
=TITLE INSPECT
=INCLUDE overview utilities inspector
 You can use this item to invoke the Inspector on an
 object you have selected. If you have selected text it
 will be inspected as a LISP string.

 See the additional topic on the Inspector for more
 information.

=TITLE ed_item
=TITLE ED
=INCLUDE overview utilities editor
 You can use this item to invoke the Editor on an object
 you have selected. 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.

 See the additional topic on the Editor for more
 information.

=TITLE eval_item
=TITLE EVAL
 You can use this item to evaluate an object or region
 of text you have selected. When you choose the EVAL
 item a LISP form of the form (EVAL 'form) will be
 inserted and evaluated in the window. If the READ-EVAL-
 PRINT loop is still computing the previously read form,
 the EVAL form will be 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
 You can use this item to compile 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)
 will be inserted and evaluated in the window. If the
 READ-EVAL-PRINT loop is still computing the previously
 read form, the Compile form will be 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
 You can use this item to uncompile 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) will be inserted and evaluated
 in the window. If the READ-EVAL-PRINT loop is still
 computing the previously read form, the Uncompile form
 will be 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
 You can use this item to disassemble either 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
 choose the DISASSEMBLE item a LISP form of the form
 (DISASSEMBLE 'object) will be inserted and evaluated
 in the window. If the READ-EVAL-PRINT loop is still
 computing the previously read form, the Disassemble
 form will be 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
 You can use this item to invoke the Trace facility on
 a selected symbol. 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.

 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 trace_options_box
 You can use this item to invoke the Trace facility on
 a selected symbol, allowing you also 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 options. 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.

 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
 You can use this item to remove an item from the Trace
 List in the Trace window by selecting a symbol that
 names that function or macro. 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.

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

 Also see the additional topic on the Trace facility for
 more information.

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

 Also see the additional topic on the Stepper for more
 information.

=TITLE abort_item
=TITLE ABORT
 You can use this item to interrupt your code that is
 running in the Listener or Debugger windows. It will
 call the VAX LISP ABORT function on your code's stack,
 so if you have any CATCH-ABORT frames on your stack
 they will catch this call to ABORT. Otherwise, the top-
 level CATCH-ABORT will catch this ABORT and you will be
 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 operations_menu continue_item
 You can use this item to interrupt your code that is
 running in the Listener or Debugger windows and bring
 up a Break loop in the Listener window. When you are in
 a Break loop you can either use the CONTINUE function
 or the CONTINUE item in the Operations menu to continue
 from the Break loop.

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

=TITLE continue_item
=TITLE CONTINUE
=INCLUDE menus_and_objects operations_menu break_item
 You can use this item to continue from a Break loop
 that you have invoked either with the BREAK function or
 the the BREAK item on the operations menu.

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

=TITLE debug_item
=TITLE DEBUG
=INCLUDE overview utilities debugger
 You can use this item to interrupt your code that is
 running in the Listener or Debugger windows and bring
 up the Debugger at the current point of execution.
 If you Continue from the Debugger your program will
 continue. If you Quit from the Debugger your program
 will be aborted.

 See the additional topic on the Debugger for more
 information.

=TITLE help_menu
=TITLE Help Menu
 You can use items in this menu to get help about LISP
 and the development environment. You will find a Help
 menu in all of the main windows in the Development
 Environment, as well as 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
 You can use this item to bring up the Overview topic in
 the Help window. (The one in which you are reading this
 text.) The Overview topic will lead you to all of the
 remaining help items in the on-line help system.

 The Overview topic is included as an additional topic.
 You can double-click on it to go there now.

=TITLE about_item
=TITLE About
=INCLUDE about
 You can use this item to bring up the About topic in
 the Help window. (The one in which you are reading this
 text.) The About topic gives you version and copyright
 information about VAX LISP.

 The About topic is included as an additional topic. You
 can double-click on it to go there now.

=TITLE apropos_item
=TITLE Apropos
=INCLUDE overview selection
 You can use this item with a selection to get output
 from the COMMON LISP APROPOS function to be displayed
 in a separate window. The APROPOS function lists all of
 the symbols interned in the current package whose names
 contain the string supplied as a substring.

 If you select either some text, a string or a symbol
 and then choose this menu item, the output of the call

     (APROPOS [selection-value] *PACKAGE*)

 will be displayed in a separate window.

 See the additional topic below for more information on
 making a selection.

=TITLE describe_item
=TITLE Describe
=INCLUDE overview selection
 You can use this item with a selection to get output
 from the COMMON LISP DESCRIBE function to be displayed
 in a separate window. The DESCRIBE function prints
 information about the object supplied.

 If you select an object or text and then choose this
 menu item, the output of the call

     (DESCRIBE [selection-value])

 will be displayed in a separate window.

 See the additional topic below for more information on
 making a selection.

=TITLE Display_stream
=TITLE Display Stream
=INCLUDE overview selection
=INCLUDE overview quick_copy
 You will find display streams in various windows in
 the Development Environment. These are special window
 streams that allow you to select text or objects either
 for use with menu items or with QuickCopy operations.
 (See the additional topics below for more information.)

 In the Development Environment you will find display
 streams in the following windows:

 o  Listener Window
    The initial value of *STANDARD-INPUT*, *STANDARD-
    OUTPUT* and *ERROR-OUTPUT*.

 o  Debugger Window
    The initial value of *DEBUG-IO*.

 o  Trace Window
    The initial value of *TRACE-OUTPUT* (output only).

=TITLE debugger_commands_menu
=TITLE Commands Menu
 You can use the items in this menu to bring up the
 Debugger or Stepper's auxiliary windows and leave the
 Debugger or Stepper.

 The items in this menu are:

 -  Commands...

 -  Calling Stack... [only in the Debugger]

 -  Variable Bindings... [only in the Debugger]

 -  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
 This item either brings up or to the front the Debugger
 or Stepper Commands Box (depending on which utility
 you are in). See one of the additional topics for more
 information.

=TITLE d_calling_stack_button
=TITLE Calling Stack...
=INCLUDE overview utilities debugger debug_call_stack_window
 This button either 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
 This item either 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
 You can use this item to continue from the Debugger
 when you entered it through a continuable error or a
 direct call to the DEBUG function. It works same the as
 the Continue button in the Debugger Commands Box or as
 typing CONTINUE at the prompt in the Debugger window.

=TITLE d_m_quit_debugger
=TITLE Quit Debugger/Stepper
=INCLUDE overview utilities listener listener_custom Prompt_on_exit
 The Quit Debugger/Stepper item in the Debugger window's
 Commands menu causes LISP to quit from the Debugger or
 Stepper. It works the same as the Quit button in the
 Commands Box or as typing QUIT at the prompt in the
 Debugger window.

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

=TITLE trace_commands_menu
=TITLE Commands Menu
 You can use the items in this menu to 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
 You can use this item to clear the Trace Output region.
 In addition to clearing the text it will free the
 pointers being held to objects printed in this region.

=TITLE t_trace_button
=TITLE Trace
 You can use this item to invoke the Trace facility on
 a selected symbol. 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_trace_dots_button
=TITLE Trace...
=INCLUDE menus_and_objects trace_options_box
 You can use this item to invoke the Trace facility on
 a selected symbol, allowing you also 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 options. 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
 You can use this item to remove an item from the Trace
 List in the Trace window by selecting a symbol that
 names that function or macro. 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.

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

=TITLE t_close_button
=TITLE Close
 You can use this item to close the Trace window. It
 will automatically return when text is next written to
 it. Additionally, you can bring it back by using the
 Trace item in the Listener or Debugger Operations menu
 without a selection.

=TITLE trace_options_box
=TITLE Trace Options
 You can use this dialog box to set various options on
 the tracing of a given function. This 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:

 -  Enter the debugger

 -  Enter the stepper

 -  Suppressing 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 trace_options_box
 You can push this button to indicate that you are done
 setting the trace options for this function. The box
 will be removed and the function's name will be added
 to the Trace List.

=TITLE t_options_cancel_button
=TITLE Cancel
=INCLUDE menus_and_objects trace_options_box
 You can push this button to indicate that you wish to
 ignore all of the information you've entered in the
 dialog box. The box will be removed and the previous
 trace state of the function will remain unchanged.

=TITLE t_o_before_debug_text
=TITLE Enter Debugger Before Call
=INCLUDE menus_and_objects trace_options_box
 In this text field you can specify a form to be
 computed just before each call to the traced function.
 If the form returns a non-NIL value the debugger will
 be invoked on the call to the traced function.

=TITLE t_o_after_debug_text
=TITLE Enter Debugger After Call
=INCLUDE menus_and_objects trace_options_box
 In this text field you can specify a form to be
 computed just after each call to the traced function.
 If the form returns a non-NIL value the debugger will
 be 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 trace_options_box
 In this text field you can 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 will be 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 trace_options_box
 In this text field you can specify a form to be
 computed just before each call to the traced function.
 If the form returns a non-NIL value the stepper will be
 invoked on the call to the traced function.

=TITLE t_o_before_supp_text
=TITLE Suppress Output Before Call
=INCLUDE menus_and_objects trace_options_box
 In this text field you can 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 will not be printed to the Trace Output
 region.

=TITLE t_o_before_print_text
=TITLE Print Before Call
=INCLUDE menus_and_objects trace_options_box
 In this text field you can 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 will be printed to the Trace Output
 region.

=TITLE t_o_after_print_text
=TITLE Print After Call
=INCLUDE menus_and_objects trace_options_box
 In this text field you can 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 will be printed to the Trace Output
 region.

=TITLE t_o_around_print_text
=TITLE Print Around Call
=INCLUDE menus_and_objects trace_options_box
 In this text field you can 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 will be printed to the Trace
 Output region.

=TITLE t_options_during_text
=TITLE Only Trace During Calls In
=INCLUDE menus_and_objects trace_options_box
 In this text field you can enter a symbol name or list
 of symbol names (unquoted, in both cases!). Calls to
 the traced function will only be noticed for calls
 to it from within one of the functions named by these
 symbols.

=TITLE ed_file_menu
=TITLE File Menu
 You can use the items in this menu to invoke various
 Editor commands dealing with 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
 You can use this item to open a buffer to a file for
 editing. You will be prompted for a file name at the
 bottom of the editor window.

=TITLE ed_file_menu_view
=TITLE View
 You can use this item to open a buffer to a file for
 viewing. You will be prompted for a file name at the
 bottom of the editor window. This differs from the Open
 item in that the buffer for the file will be read-only.

=TITLE ed_file_menu_include
=TITLE Include
 You can use this item to insert the contents of a file
 at the current text insertion point in the editor. You
 will be prompted for a file name at the bottom of the
 editor window.

=TITLE ed_file_menu_save
=TITLE Save
 You can use this item to save the current buffer's
 contents into the file previously associated with it.

=TITLE ed_file_menu_save_as
=TITLE Save As
 You can use this item to save the current buffer's
 contents into a specified file. You will be prompted
 for a file name at the bottom of the editor window.

=TITLE ed_file_menu_exit
=TITLE Exit
 You can use this item to exit the Editor. You will be
 prompted for confirmation at the bottom of the editor
 window.

=TITLE ed_edit_menu
=TITLE Edit Menu
 You can use the items in this menu to move text to and
 from the LISP clipboard as well as to 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
 You can use this item to remove selected text in the
 current buffer and put it on the LISP Clipboard.

=TITLE ed_edit_menu_copy
=TITLE Copy
 You can use this item to copy selected text in the
 current buffer and put it on the LISP Clipboard.

=TITLE ed_edit_menu_paste
=TITLE Paste
 You can use this item to insert text stored on the LISP
 Clipboard at the input point in the current buffer.

=TITLE ed_edit_menu_clear
=TITLE Clear
 You can use this item to clear any stored items from
 the LISP Clipboard.

=TITLE ed_edit_menu_select_enc
=TITLE Select Enclosing Form
 You can use this item to select 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
 You can use this item to select 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
 You can use this item to select the entire text
 (including that which you can't see) of the current
 buffer.

=TITLE ed_search_menu
=TITLE Search Menu
 You can use the items in this menu to access the
 Editor's forward and reverse string searching
 functions. The items in this menu 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
 You can use this item to specify a search string and
 search for it in the current buffer in the current
 editor direction. You will be prompted for a string and
 the bottom of the Editor window.

=TITLE ed_search_menu_find_next
=TITLE Find Next
 You can use this item to search forwards 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
 You can use this item to search backwards 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
 You can use this item to invoke the Editor's
 Query/Replace function. At the bottom of the Editor
 window you will 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 Commands Menu
 You can use the items in this menu to invoke a number
 of common Editor commands which 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
 You can use this item to display the Help buffer with
 a list of available Editor buffers, their names, sizes
 and various status information.

=TITLE ed_commands_menu_select_buf
=TITLE Select Buffer
 You can use this item to select an existing buffer or
 create a new one. You will be prompted for a buffer
 name at the bottom of the Editor window.

=TITLE ed_commands_menu_insert_buf
=TITLE Insert Buffer
 You can use this item to insert the contents of an
 existing buffer at the insertion point in the current
 buffer. You will be prompted for a buffer name at the
 bottom of the Editor window.

=TITLE ed_commands_menu_del_cur_buf
=TITLE Delete Current Buffer
 You can use this item to delete the current buffer from
 memory. If you have modified the buffer since you last
 wrote it you will be 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 will be written to the information area at
 the bottom of the Editor window.

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

=TITLE ed_commands_menu_del_nam_buf
=TITLE Delete Named Buffer
 You can use this item to delete a buffer from memory.
 You will be prompted for a buffer name at the bottom of
 the Editor window. If you have modified the specified
 buffer since you last wrote it you will be prompted for
 whether to write out the buffer before it is deleted.

=TITLE ed_commands_menu_wri_mod_buf
=TITLE Write Modified Buffers
 You can use this item to write out all modified buffers
 to their associated files.

=TITLE ed_commands_menu_wri_cur_buf
=TITLE Write Current Buffer
 You can use this item to write out the current buffer
 to its associated file.

=TITLE ed_commands_menu_split_win
=TITLE Split Window
 You can use this item to split the current Editor
 window.

=TITLE ed_commands_menu_rem-cur_win
=TITLE Remove Current Window
 You can use this item to remove the current Editor
 window from view.

 If you really want to delete the buffer and its
 contents from memory, use the Delete Current Buffer
 item from this menu.

=TITLE ed_commands_menu_rem_oth_win
=TITLE Remove Other Windows
 You can use this item to remove the other Editor
 windows, leaving the current buffer in the only visible
 Editor window.

=TITLE ed_commands_menu_next_win
=TITLE Next Window
 You can use this item to switch input focus from the
 current Editor window to the next one.

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

 For example, if you are in the Debugger, the code
 evaluated here will be 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
 You can use this item to indent selected text as LISP
 code in Editor buffers that have "VAX LISP" as their
 minor style.

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

 -  Overview

 -  About

 -  Apropos Object

 -  Apropos Word

 -  Describe 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
 You can use this item to invoke the Editor's apropos
 mechanism for Editor objects and commands. You will
 be prompted for a string at the bottom of the Editor
 window.

=TITLE ed_help_menu_apropos_word
=TITLE Apropos Editor Object
 You can use this item to invoke the LISP APROPOS
 function on the word nearest to the cursor in the
 current Editor buffer. The output will be displayed
 in the Editor Help buffer.

=TITLE ed_help_menu_describe_object
=TITLE Describe Editor Object
 You can use this item to invoke the Editor's
 description mechanism for Editor objects and commands.
 You will be prompted for a string at the bottom of the
 Editor window.

=TITLE ed_help_menu_describe_word
=TITLE Describe Word
 You can use this item to invoke 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
 You can use this item to display a list of completion
 alternatives whenever 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
 You can use this item to display the message from the
 last editor error encountered. The message is displayed
 in the Editor Help buffer.

=TITLE ih_commands_menu
=TITLE Commands Menu
 You can use the items in this menu to inspect objects,
 affect Inspect windows and exit from the Inspector.

 The items in this menu 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
 You can use this item to invoke the Inspector on an
 object you have selected. If you have selected text it
 will be inspected as a LISP string.

=TITLE ih_return_button
=TITLE Return
 You can use this item to cause the Inspector (i.e. your
 call to the INSPECT function) to return an object you
 have selected. If you have selected text it will be
 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
 You can use this item to close an Inspect window. The
 window associated with the selected object will be
 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
 You can can use this item to remove an object from the
 Inspector History. If there is a window associated with
 this item, the window will be closed, as well.

 This item is only available when you have an object
 selected in the Inspector History which has been
 inspected previously.

=TITLE ih_lock_toggle
=TITLE Lock (toggle)
 You can use this item to lock an and unlock an Inspect
 window. The window associated with the selected object
 will now no longer be overwritten as you inspect more
 objects. You can later unlock the window with another
 use of this item.

 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_exit_button
=TITLE Exit
 You can use this item to exit the Inspector. If the
 Inspector was invoked by calling the INSPECT function
 with :PARALLEL NIL the object originally inspected will
 be returned.

=TITLE ih_edit_menu
=TITLE Edit Menu
 You can use the item in this menu to move 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
 You can use this item to copy selected text or objects
 and put them on the LISP Clipboard.

=TITLE i_commands_menu
=TITLE 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 itself. 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
 You can use this item to invoke the Inspector on an
 object you have selected. If you have selected text it
 will be inspected as a LISP string.

=TITLE i_update_button
=TITLE Update
 You can use this item to easily re-inspect 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 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 i_modify_dialog
 You can use this item to modify the selected component
 of an inspected object. The modify dialog box will
 be 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 which 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
 You can use this item to cause the Inspector (i.e. your
 call to the INSPECT function) to return an object you
 have selected. If you have selected text it will be
 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 i_lock_toggle
=TITLE Lock (toggle)
 You can use this item to lock an and unlock the Inspect
 window. The window in which this menu is found will now
 no longer be overwritten as you inspect more objects.
 You can later unlock the window with another use of
 this item.

=TITLE i_close_button
=TITLE Close
 You can use this item to close the Inspect window. The
 window in which this menu is found will be removed from
 the screen.

=TITLE i_edit_menu
=TITLE Edit Menu
 You can use the items in this menu to 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
 You can use this item undo the previous clipboard
 operation performed through this menu.

 For example, if you have modified an inspected object's
 component with Paste the previous component value will
 be restored.

=TITLE i_copy_button
=TITLE Copy
 You can use this item to copy selected text or objects
 and put them on the LISP Clipboard.

=TITLE i_paste_button
=TITLE Paste
 You can use this item to replace an inspected object's
 selected component with the information on the LISP
 clipboard.

=TITLE i_popup_undo
=TITLE Undo
 You can use this item undo the previous clipboard
 operation performed through the Edit menu or the Copy
 or Paste items on this pop-up menu.

 For example, if you have modified an inspected object's
 component with Paste the previous component value will
 be restored.

=TITLE i_popup_copy
=TITLE Copy
 You can use this item to copy objects to the LISP
 Clipboard. The LISP object that will be 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
 You can use this item to replace an inspected object's
 component with the information on the LISP clipboard.
 The component that will be replaced is the one your
 mouse pointer is over when you press MB2 to bring up
 this pop-up menu.

=TITLE i_popup_lock_toggle
=TITLE Lock
 You can use this item to lock an Inspect window. In the
 pop-up menu in an Inspect window it locks or unlocks
 the window in which you brought up the menu. In the
 pop-up menu in the Inspector History window it locks or
 unlocks the window associated with the LISP object over
 which your mouse pointer is when you press MB2 to bring
 up this pop-up menu.

=TITLE i_popup_inspect
=TITLE Inspect
 You can use this item to invoke the Inspector on an
 object. The LISP object that will be inspected is the
 one your mouse pointer is over when you press MB2 to
 bring up this pop-up menu.

=TITLE i_popup_update
=TITLE Update
 You can use this item to update an Inspect window. In
 the pop-up menu in an Inspect window it updates the
 window in which you brought up the menu. In the pop-up
 menu in the Inspector History window it updates the
 window associated with the LISP object over which your
 mouse pointer is when you press MB2 to bring up this
 pop-up menu.

=TITLE i_popup_modify
=TITLE Modify
=INCLUDE menus_and_objects i_modify_dialog
 You can use this item to modify a component of an
 inspected object. The component that will be modified
 is the one your mouse pointer is over when you press
 MB2 to bring up this pop-up menu. The modify dialog box
 will be 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
 You can use this item to cause the Inspector (i.e.
 your call to the INSPECT function) to return an object.
 The object that will be returned is the one your mouse
 pointer is over when you press MB2 to bring up this
 pop-up menu.

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

=TITLE i_popup_close
=TITLE Close
 You can use this item to close an Inspect window. In
 the pop-up menu in an Inspect window it closes the
 window in which you brought up the menu. In the pop-
 up menu in the Inspector History window it closes the
 window associated with the LISP object over which your
 mouse pointer is when you press MB2 to bring up this
 pop-up menu.

=TITLE i_popup_remove
=TITLE Remove
 You can use this item to remove an object from the
 Inspector History. The object that will be removed is
 the one your mouse pointer is over when you press MB2
 to bring up this pop-up menu. If there is a window
 associated with this item, the window will be closed,
 as well.

=TITLE i_popup_exit
=TITLE Exit
 You can use this item to exit the Inspector. If the
 Inspector was invoked by calling the INSPECT function
 with :PARALLEL NIL the object originally inspected will
 be returned.

=TITLE i_modify_dialog
=TITLE Modify Dialog
 You can 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 can 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 can use this button to complete the modification
 when you are satisfied with the value you have entered
 in the New Value field. The component will be modified
 and the modify dialog box will be removed.

=TITLE i_modify_cancel_button
=TITLE Cancel
 You can use this button to cancel the modification at
 any time. The component will remain unchanged and the
 modify dialog box will be removed.

=TITLE OK_button
=TITLE OK Button
 Clicking on the OK button applies the indicated
 settings and removes the window.

=TITLE Apply_button
=TITLE Apply Button
 Clicking on the Apply button applies the indicated
 settings without removing the window. This enables
 users to work iteratively or test a hypothesis. The
 Apply button is particularly useful when you want to
 change text or graphic attributes.

=TITLE generic_message_box
=TITLE Message Box
 This dialog box is used by the system to deliver a
 message to you, usually in situations where a system
 error has occurred. You should read the text in it to
 determine what has happened and take any subsequent
 actions suggested in the message. 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
 This dialog box is used by the system to allow you
 to make one of two choices. In general the buttons
 are labeled Yes and No. Click on the button that
 appropriately answers the question posed in the dialog.
 The dialog box will be removed and the action described
 in the question will or will not be performed,
 depending on your answer.

 The other notable use of this caution box is when
 your code has signaled 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 will take you into the LISP Debugger,
 Abort will return you to the READ-EVAL-PRINT loop and
 continue will attempt to continue from the continuable
 error.

=TITLE generic_wip_box
=TITLE Work-in-Progress Box
 This box is used by the system to let you know that
 it is busy working on something. The work being done
 is described in the box. When the work is done the box
 will be removed.

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

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

 -  Filter button
    You can push this button to change the contents of
    the filename list box based on a new value you have
    supplied in the filter text field.

 -  Filename list box
    From this you can select a file that already exists.
    Clicking on an element in this area will change the
    value of the selection text field.

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

 -  Cancel button
    You can push this button at any time if you wish to
    cancel the current file operation. The dialog box
    will be removed.

 -  Selection text field
    When the OK button is pushed, the current file
    operation will be performed on the value of
    this field. You can edit the value in this field
    directly.

=TITLE load_file_selection_box
=TITLE Load File Selection Box
=INCLUDE menus_and_objects file_selection_box_controls
 You can 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.

=TITLE compile_file_selection_box
=TITLE Compile File Selection Box
=INCLUDE menus_and_objects file_selection_box_controls
 You can 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 file_selection_box_controls
 You can 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 file_selection_box_controls
 You can 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 file_selection_box_controls
 You can use this file selection box to supply a
 filename for the file into which you want the Listener
 or Debugger transcript text written.

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

=TITLE d_cs_goto_button
=TITLE Goto Frame button
=INCLUDE menus_and_objects d_call_stack_text_widget
=INCLUDE overview utilities debugger debug_call_stack_window
 You can 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 will become 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
 You can use this button to remove the Calling Stack
 window. You can use the Calling Stack... item in the
 Debugger window's Commands to bring the Calling Stack
 window back.

=TITLE d_call_stack_text_widget
=TITLE Backtrace display
=INCLUDE menus_and_objects d_cs_goto_button
=INCLUDE overview utilities debugger debug_call_stack_window
 This area displays 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 frames 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 d_vb_cancel_button
=TITLE Cancel button
=INCLUDE overview utilities debugger debug_var_bind_window
 You can use this button to remove the Variable Bindings
 window. You can use the Variable Bindings... item in
 the Debugger window's Commands to bring the Variable
 Bindings window back.

=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 Overview
=TITLE Overview of VAX LISP Development Environment
=INCLUDE Using_Scrolls
 The VAX LISP Development Environment is an interface to
 the VAX LISP system based on DECwindows. 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 while you
 pull down the menu and point to the item on the menu
 called Help. Release MB1 and 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.

 In addition, general information about VAX LISP,
 including installation, basic LISP interaction, step-
 by-step descriptions of program development and object
 reference pages, is still only to be found in the hard
 copy documentation.

 This on-line documentation occasionally refers you
 to these other sources of information when the scope
 exceeds that of simply the Development Environment's
 structure and syntax.

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, how to use dialog boxes, and how
 to use 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 press 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. Move the pointer to the Help 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 receive 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-hand 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 as in the following utilities:

 -  Listener

 -  Debugger/Stepper

 -  Trace

 -  Editor

 -  Inspector

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

Additional information available:

ListenerdebuggerstepperTraceEditorInspector

=TITLE Listener
=TITLE Listener
=INCLUDE Menus_and_Objects File_menu
=INCLUDE Menus_and_Objects Edit_menu
=INCLUDE Menus_and_Objects Operations_menu
=INCLUDE Menus_and_Objects Help_menu
=INCLUDE Menus_and_Objects Display_stream
 The Listener is the main utility you use for
 interaction with the LISP evaluator. In the main window
 of this utility there is a text widget that is part
 of special stream called a display stream. The COMMON
 LISP standard streams *STANDARD-INPUT* and *STANDARD-
 OUTPUT* are bound to this stream. Since the top-level
 READ-EVAL-PRINT loop reads and writes to these streams
 you will find it in the Listener window. In addition to
 LISP-sensitive input editing you can retrieve both text
 and object information from these streams and ones like
 it in other windows. See the topic on display streams
 in the additional topics below.

 In addition to evaluating LISP code in the READ-EVAL-
 PRINT loop, you can use the menus in the Listener to
 perform a variety of LISP and DECwindows operations.
 These menus are described in 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 either 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 Menus_and_Objects Customization change_font
=INCLUDE Menus_and_Objects Customization change_color
=INCLUDE Menus_and_Objects Customization change_geometry
=INCLUDE Menus_and_Objects 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:

 -  :FONT

 -  :FOREGR0UND-COLOR

 -  :BACKGR0UND-COLOR

 -  :GEOMETRY

 -  :EVALUATION-HISTORY-LIMIT

 -  :OBJECT-RECORDING

 -  :PROMPT-ON-EXIT

Additional information available:

eval hist limitprompt on exitobject recording

=TITLE eval_hist_limit
=TITLE Evaluation history limit
=INCLUDE Menus_and_Objects Display_stream
 You can set a customization attribute that limits on
 how many evaluations are saved in either the Listener
 or Debugger display stream transcript regions.

 Once you have performed as many evaluations as this
 limit, subsequent evaluation will cause the oldest
 evaluations' text and object records to be removed from
 the transcript.

 Note that when you decrease this limit your transcript
 will immediately be reduced by the difference in the
 old limit and 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
 You can set a customization attribute that controls
 whether LISP confirms your use of the Exit item in
 the File menu of the Listener or the Quit item in the
 Debugger's file menu and commands box.

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

 If this attribute is not true then LISP or the Debugger
 will exit 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
 You can set a customization attribute that 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 will be 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.

 If you change this attribute from true to false, all
 stored object information for that utility's transcript
 region will immediately be lost. Changing the attribute
 back to true only affects 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 File_menu
=INCLUDE Menus_and_Objects Edit_menu
=INCLUDE Menus_and_Objects debugger_commands_menu
=INCLUDE Menus_and_Objects Operations_menu
=INCLUDE Menus_and_Objects 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 your
 code on the stack. It consists of four windows: the
 Debugger I/O window, the Calling Stack window, the
 Variable Bindings window and the commands box. The
 Debugger I/O window is described here. You will find
 descriptions of the others under additional topics
 below.

 The main window of the Debugger is entitled Debugger
 I/O and 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 Debugger 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 Debugger I/O window is also used when
 you run the Stepper.)

Additional information available:

debug call stack windowdebug var bind windowd commands boxdebug custom

=TITLE debug_call_stack_window
=TITLE Calling Stack Window
=INCLUDE Menus_and_Objects debugger_commands_menu
=INCLUDE Menus_and_Objects d_cs_goto_button
=INCLUDE Menus_and_Objects d_cs_cancel_button
=INCLUDE Menus_and_Objects d_call_stack_text_widget
 This window shows you the LISP stack from the top-
 level-call (the bottom) to the point where the Debugger
 was invoked (the top). The information is similar to
 what you see in the Debugger I/O window if you issue
 the Debugger BACKTRACE command.

 You can change the current Debugger frame by selecting
 a frame with MB1 (it will be underlined when the
 pointer passes over it) and clicking on the button
 labeled Goto Frame. As a shortcut you can simply
 double-click MB1 on the frame you want to go to. Either
 of these will insert the appropriate command into the
 Debugger I/O window (e.g. GOTO 14, where 14 is the
 number of the frame you clicked on).

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

 You can 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.

=TITLE debug_var_bind_window
=TITLE Variable Bindings Stack Window
=INCLUDE Menus_and_Objects debugger_commands_menu
=INCLUDE Menus_and_Objects d_vb_cancel_button
=INCLUDE Menus_and_Objects var_bindings_text_widget
 This window shows you the variables bound in the
 current frame and their values.

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

 You can 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 Debugger I/O window's Commands menu.

=TITLE d_commands_box
=TITLE Commands Box
=INCLUDE Menus_and_Objects debugger_commands_menu
 This window provides buttons which you can use to
 control the Debugger with the pointer. You can click
 MB1 on any of the buttons to insert a command into
 the Debugger I/O window's input region. The additional
 topics below describe the individual commands.

 If the button's label contains "..." it means that
 this a command that requires arguments. When you click
 on one of them it will bring up a small dialog box
 in which you can 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 can 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.

 You can 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
 Debugger 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 use this button to quit out of the Debugger.
 It works the same as the Quit Debugger item in the
 Debugger window's Commands menu or as typing QUIT at
 the prompt in the Debugger window. When you choose this
 item you may be prompted before the Debugger is exited,
 confirming your desire to quit, depending 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 can use this button to continue from the Debugger
 when you entered it through a continuable error or
 a direct call to the DEBUG function. It works same
 the as the Continue item in the Debugger window's
 Commands menu or as typing CONTINUE at the prompt in
 the Debugger window.

=TITLE d_cancel_button
=TITLE Cancel
 You can use this button to remove the Debugger Commands
 Box from the screen. You can bring it back by using
 the Commands... item in the Debugger window's Commands
 menu.

=TITLE d_backtrace_button
=TITLE Backtrace, Backtrace...
 You can push either of these buttons to print a
 backtrace of the stack to the Debugger I/O window.

 Backtrace prints a quick backtrace of significant
 frames.

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

=TITLE d_bottom_button
=TITLE Bottom, Bottom All
 You can push either of these buttons to make 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...
 You can push either of the buttons to move down the
 stack.

 Down moves you down one significant frame.

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

=TITLE d_error_button
=TITLE Error
 You can push this button to recall the error message in
 the Debugger I/O window.

=TITLE d_evaluate_dots_button
=TITLE Evaluate...
 You can push this button to bring up a small dialog in
 which you can enter an expression to be evaluated in
 the context of the active frame in the Debugger.

=TITLE d_goto_dots_button
=TITLE Goto...
 You can push this button to bring up a small dialog
 in which you can specify a frame number to change the
 active frame.

=TITLE d_redo_button
=TITLE Redo
 You can push this button to try to re-execute your
 original form after having made changes to the stack in
 the debugging environment.

=TITLE d_return_dots_button
=TITLE Return...
 You can push this button to bring up a small dialog in
 which you can enter an expression. When you click on
 OK in this dialog this expression will be computed and
 used as the return value of the form that originally
 put you in the debugger.

=TITLE d_search_dots_button
=TITLE Search...
 You can push this button to bring up a small dialog in
 which you can 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...
 You can push this button to bring up a small dialog in
 which you can set either a function or argument value
 to an arbitrary new value.

=TITLE d_show_dots_button
=TITLE Show...
 You can push this button to bring up a small dialog in
 which you select what you would like shown: arguments,
 call, function or the current frame.

=TITLE d_step_button
=TITLE Step
=INCLUDE overview utility stepper
 You can push this button to invoke 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
 You can push either of these buttons to set 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...
 You can push either of the buttons to move up the
 stack.

 Up moves you up one significant frame.

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

=TITLE d_where_button
=TITLE Where
 You can push this button to re-display the current
 frame in the Debugger I/O window.

=TITLE debug_custom
=TITLE Customizing the Debugger and Stepper
=INCLUDE Menus_and_Objects Customization change_font
=INCLUDE Menus_and_Objects Customization change_color
=INCLUDE Menus_and_Objects Customization change_geometry
=INCLUDE overview utilities listener listener_custom eval_hist_limit
=INCLUDE overview utilities listener listener_custom object_selection
=INCLUDE overview utilities listener listener_custom prompt_on_exit
=INCLUDE Menus_and_Objects 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:

 -  :FONT

 -  :FOREGR0UND-COLOR

 -  :BACKGR0UND-COLOR

 -  :GEOMETRY

 -  :EVALUATION-HISTORY-LIMIT

 -  :OBJECT-RECORDING

 -  :PROMPT-ON-ENTRY

 -  :PROMPT-ON-EXIT

Additional information available:

prompt on entrycust debug aux win

=TITLE prompt_on_entry
=TITLE Prompt on entry
 You can set a customization attribute that controls
 whether LISP confirms entering the Debugger when a
 LISP error is signaled in your program and handled by
 the default error handler. (See the VAX LISP User's
 Guide for more information on defining your own error
 handler.)

 If this attribute is true, LISP will bring up a caution
 box asking if you want enter the Debugger or abort from
 the error. If you wish to enter the Debugger click MB1
 on the button labeled DEBUG. If you wish to ignore the
 error click MB1 on the button labeled ABORT.

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

=TITLE cust_debug_aux_win
=TITLE Customizing auxiliary windows
=INCLUDE Menus_and_Objects Customization change_font
=INCLUDE Menus_and_Objects Customization change_color
=INCLUDE Menus_and_Objects Customization change_geometry
=INCLUDE Menus_and_Objects Customization cust_routine
 In addition to the customizations you can make to the
 main window of the Debugger you can use the following
 combinations of object- 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

    -   :GEOMETRY
    :DEBUGGER-COMMANDS-WINDOW
    :STEPPER-COMMANDS-WINDOW

    -   :FOREGROUND-COLOR

    -   :BACKGROUND-COLOR

    -   :POSITION

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

=TITLE stepper
=TITLE Stepper
=INCLUDE Menus_and_Objects File_menu
=INCLUDE Menus_and_Objects Edit_menu
=INCLUDE Menus_and_Objects step_commands_menu
=INCLUDE Menus_and_Objects Operations_menu
=INCLUDE Menus_and_Objects Help_menu
=INCLUDE Menus_and_Objects Display_stream
=INCLUDE overview utilities listener Evaluating_lisp
=INCLUDE overview utilities debugger
=INCLUDE Menus_and_Objects Customization debug_custom
 The Stepper is the utility you use for stepping through
 your code one call at a time. It consists of two
 windows: the Debugger I/O window and the commands box.
 The Debugger I/O window is described here. The Commands
 window is described in an additional topic below.

 The main window of the Stepper is entitled Debugger
 I/O and 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 Debugger 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 Debugger I/O window is also used when
 you run the Debugger.)

Additional information available:

s commands box

=TITLE s_commands_box
=TITLE Commands Box
=INCLUDE Menus_and_Objects step_commands_menu
 This window provides buttons which you can use to
 control the Stepper with the pointer. You can click
 MB1 on any of the buttons to insert a command into
 the Debugger I/O window's input region. The additional
 topics below describe the individual commands.

 If the button's label contains "..." it means that
 this a command that requires arguments. When you click
 on one of them it will bring up a small dialog box
 in which you can 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 can 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.

 You can 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
 Debugger 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
 You can use this button to quit out of the Stepper.
 It works the same as the Quit Stepper item in the
 Debugger window's Commands menu or as typing QUIT at
 the prompt in the Debugger window. When you choose this
 item you may be prompted before the Debugger is exited,
 confirming your desire to quit, depending 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
 You can use this button to remove the Stepper Commands
 Box from the screen. You can bring it back by using
 the Commands... item in the Debugger window's Commands
 menu.

=TITLE s_backtrace_button
=TITLE Backtrace, Backtrace...
 You can click MB1 on either of these buttons to print a
 backtrace of the stack to the Debugger I/O's transcript
 region.

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

=TITLE s_evaluate_dots_button
=TITLE Evaluate...
 You can push this button to bring up a small dialog in
 which you can enter an expression to be evaluated in
 the context of the current Step form and environment.

=TITLE s_finish_button
=TITLE Finish, Finish T
 You can push either of these buttons to finish the
 computation of the current step form without stepping.
 Finish T will print the intermediate return values.

=TITLE s_over_button
=TITLE Over
 You can push this button to evaluate the current form
 without stepping through it.

=TITLE s_return_dots_button
=TITLE Return...
 You can push this button to bring up a small dialog in
 which you can enter an expression. When you click on
 OK in this dialog this expression will be computed and
 used as the return value of the original step form.

=TITLE s_show_button
=TITLE Show
 You can push this button to re-display the current step
 form.

=TITLE s_step_button
=TITLE Step
 You can push this button to single step the current
 form.

=TITLE s_up_button
=TITLE Up, Up...
 You can push either of the buttons to suspend single
 stepping until control returns to the form immediately
 containing the current form. Additionally, Up... brings
 up a small dialog in which you can set the number of
 levels to move up.

=TITLE Trace
=TITLE Trace
=INCLUDE Menus_and_Objects Trace_commands_menu
=INCLUDE Menus_and_Objects edit_menu
=INCLUDE Menus_and_Objects help_menu
 The Trace utility provides a separate window in which
 you can view the output from tracing the execution of
 functions and macros. The utility consists one window
 separated into two regions: the Trace List regions
 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 operations_menu trace_dots_item
=INCLUDE menus_and_objects operations_menu untrace_item
 This region spans the top of the Trace window,
 immediately below the menu bar. In this region you
 can see the symbols that name the functions and macros
 being traced. If nothing is being traced the Trace List
 will read "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
 This 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. Here you will see the output
 of the TRACE macro. 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 section 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 Trace
=INCLUDE Menus_and_Objects Customization change_font
=INCLUDE Menus_and_Objects Customization change_color
=INCLUDE Menus_and_Objects Customization change_geometry
=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:

 -  :FONT

 -  :FOREGR0UND-COLOR

 -  :BACKGR0UND-COLOR

 -  :GEOMETRY

 -  :OBJECT-RECORDING

 -  :PROMPT-ON-UNTRACE-ALL

 Note that the font, color and geometry 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 All
 You can set a customization attribute that controls
 whether LISP confirms use of the Untrace item on the
 Listener and Debugger 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.)

 If this attribute is true, LISP will bring 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 then LISP will
 immediately untrace 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 ed_file_menu
=INCLUDE Menus_and_Objects ed_edit_menu
=INCLUDE Menus_and_Objects ed_search_menu
=INCLUDE Menus_and_Objects ed_buffers_menu
=INCLUDE Menus_and_Objects 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 Menus_and_Objects Customization change_font
=INCLUDE Menus_and_Objects Customization change_color
=INCLUDE Menus_and_Objects Customization change_geometry
=INCLUDE Menus_and_Objects 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

 -  :FOREGR0UND-COLOR

 -  :BACKGR0UND-COLOR

 -  :POSITION

 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 will automatically update 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 LISP
 data structures. It consists of a number of windows
 of two types. There is exactly one Inspector History
 window and a number of Inspect windows. These two types
 of windows are described in additional topics below.

 The Inspector is invoked either through 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
 haven't inspected anything previously in this LISP the
 Inspector History window and an Inspect window will be
 created. Subsequent invocations bring up new Inspect
 windows.

Additional information available:

insp historyinsp windowsinsp custom

=TITLE insp_history
=TITLE Inspector History
=INCLUDE Menus_and_Objects ih_commands_menu
=INCLUDE Menus_and_Objects ih_edit_menu
=INCLUDE Menus_and_Objects help_menu
=INCLUDE overview utilities inspector
 The Inspector History window displays a list of all
 of the objects you have inspected, one per row. The
 left-hand column of this window may also contain either
 a * or L to indicate that you have an Open or Locked
 Inspect window for the object displayed in that row.

 You can use the pull-down menus in the Inspector
 History window to affect the items in the History,
 as well as access the Clipboard and Help. These menus
 are described in additional topics below.

 In addition to the pull-down menus you can press MB2
 in the Inspector History to bring up a pop-up menu
 that supplies a subset of the items in the pull-down
 menus. The operations in these menus apply to the
 object over which the pointer is when you press MB2
 (as opposed to the pull-down menus, which operate on
 the selected object). Operations in the pop-up which
 are not applicable to the object on which you bring up
 the menu appear grayed (they are inactive).

 An additional shortcut is that you can double-click
 MB2 on any object in the Inspector History window to
 inspect the object. This is the equivalent of selecting
 the object with MB1 and choosing the Inspect item
 from the Inspector History window's Commands menu or
 pressing MB2 while the pointer is over the object and
 selecting Inspect from the pop-up menu.

=TITLE insp_windows
=TITLE Inspect Windows
=INCLUDE Menus_and_Objects i_commands_menu
=INCLUDE Menus_and_Objects i_edit_menu
=INCLUDE Menus_and_Objects help_menu
=INCLUDE overview utilities inspector
 The Inspect Windows each display 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.)

 You can use the pull-down menus in the Inspect windows
 to affect the windows themselves and the objects within
 them, as well as access the Clipboard and Help. These
 menus are described in additional topics below.

 In addition to the pull-down menus you can press MB2
 in the Inspect windows to bring up a pop-up menu
 that supplies a subset of the items in the pull-down
 menus. The operations in these menus apply to the
 object over which the pointer is when you press MB2
 (as opposed to the pull-down menus, which operate on
 the selected object). Operations in the pop-up which
 are not applicable to the object on which you bring up
 the menu appear grayed (they are inactive).

 An additional shortcut is that you can double-click
 MB2 on any object in an Inspect window to inspect
 the object. This is the equivalent of selecting the
 object with MB1 and choosing the Inspect item from the
 Inspect window's Commands menu or pressing MB2 while
 the pointer is over the object and selecting Inspect
 from the pop-up menu.

=TITLE insp_custom
=TITLE Customizing the Inspector
=INCLUDE Menus_and_Objects Customization change_font
=INCLUDE Menus_and_Objects Customization change_color
=INCLUDE Menus_and_Objects Customization change_geometry
=INCLUDE Menus_and_Objects 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.

    -   :FONT

    -   :FOREGR0UND-COLOR

    -   :BACKGR0UND-COLOR

    -   :GEOMETRY

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

    -   :FONT

    -   :FOREGR0UND-COLOR

    -   :BACKGR0UND-COLOR

    -   :GEOMETRY

    -   :GEOMETRY-OFFSETS

    -   :COUNT

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

Additional information available:

seq len threshi win counti win geom

=TITLE seq_len_thresh
=TITLE Sequence Length Threshold
 You can set a customization attribute that limits
 the number of elements in a sequence 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 will be prompted with a Caution box that
 tells you the threshold has been reached and asks
 if would you like to see more. If you do, the count
 will be reset to zero and begin 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.

 If you re-inspect a sequence this entire process is
 repeated, so if you originally only wanted to see the
 first part of a sequence but now want to see more,
 simply re-inspect the object, allowing the Inspector to
 print more of the object this time.

 When you increase or decrease this limit there is no
 effect on objects you have already inspected. Sequences
 which you subsequently inspect will 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 i_win_count
=TITLE Number of Inspect Windows
 You can set a customization attribute that controls the
 number of unlocked Inspect windows the Inspector will
 cycle through.

 If you raise this attribute's value the Inspector will,
 on subsequent inspections, create more new Inspect
 windows until the number of unlocked Inspect windows
 matches the new value.

 If you lower this attribute's value the Inspector will
 only create new Inspect windows when the number of
 unlocked Inspect windows is reduced to below the new
 value. If the number of unlocked Inspect windows is
 greater than the new value you set you will continue to
 cycle through all of the unlocked Inspect windows. As
 you close them, however, new ones will not be created
 unless the number of unlocked Inspect 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 i_win_geom
=TITLE Positioning and Sizing Inspect Windows
 Unlike the Inspector History window and most of the
 other utility windows, you cannot control the absolute
 position and size of Inspect windows. Instead, you
 control the absolute position of the first Inspect
 window created, offsets from that position for
 subsequently created Inspect windows and the size for
 subsequently create Inspect windows.

 You can use the :GEOMETRY attribute-keyword with the
 DECW-UTILS:CUSTOMIZATION routine to get or set the
 first window's position and all of the subsequently
 created Inspect window's sizes. You can use the
 :GEOMETRY-OFFSET attribute-keyword to get or set
 offsets in the x and y directions that specify where,
 relative to the first Inspect window, subsequently
 created Inspect windows will be positioned.

 The stress here on "subsequently created Inspect
 windows" is because changing any of these attributes
 has no effect on any Inspect windows that have already
 been created, including those that have since been
 closed. If you do not change the attributes or change
 them before the first call to INSPECT in a fresh LISP
 then all of the Inspect windows will come up the same
 size and will form a cascade from the first window to
 the last. (The direction and spread of this cascade
 depends on the :GEOMETRY-OFFSET attribute.)

 However, if you create a few Inspect windows, move
 and resize them, modify these attributes (which, as
 indicated above, didn't modify the existing Inspect
 windows) and then perform another inspection, the
 size and position of the new Inspect window will be
 computed from the values of the attributes and may bear
 no relation in size or position to any of the earlier
 Inspect 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 pass the pointer over text that represents
 an object the text will be underlined. When you
 pass 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 begin passing the pointer over
 the list from left to right you will notice that if
 the pointer is over either of the out parentheses, the
 space after the symbol A or the space before the symbol
 B 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) will be underlined.
 Finally, if the pointer is over any of the individual
 symbols they are underlined.

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

 In addition to objects you can still select text in
 the standard DECwindows style: press MB1 and drag
 the pointer across the text you want to select. The
 text will become highlighted as you move the pointer.
 When you release MB1 the text will remain highlighted
 and you can 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 don't 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 can 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 can 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 actually be the same window.

 You can copy a LISP object from any LISP window to
 the window that currently has input focus by clicking
 MB3 when the pointer is positioned over the object.
 Alternatively, you can 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 actually be the same window.
 Note, however, that copying objects only applies
 between certain LISP windows since other applications
 don't understand LISP. If the area to which you copy
 the object doesn't understand LISP only the text
 representation will be copied.

 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
 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.

 -  Enable or disable LISP object recording on output.

 -  Saving and recalling these customizations.

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

 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:

change fontchange colorchange geometrysave customizationload customization
cust routineCustom Vue

=TITLE change_font
=TITLE Changing the font
 You can change the font of an object by using the DECW-
 UTILS:CUSTOMIZATION routine with SETF, the attribute-
 keyword :FONT and a new value which 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 will use the first one it
 finds.

 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 can use the DECW-UTILS:LIST-FONTS
 function with a string to return a list all of 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 will be returned.

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

 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 Changing the window size and position
 You can 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 is either a list of
 four integers in the form (x y width height) or two
 integers in the form (x y).

 (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 save_customization
=TITLE Saving customizations
=INCLUDE overview customization load_customization
 You can write out the current settings of all of the
 customizations using the DECW-UTILS:SAVE-CUSTOMIZATIONS
 routine. You can 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.

 Additionally, you may prefer different arrangements of
 the windows for certain types of work. You can store
 these settings into separate files which you can 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 loaded back in by LISP.

=TITLE load_customization
=TITLE Recalling saved customizations
=INCLUDE overview customization save_customization
 You can recall settings of customization settings using
 the DECW-UTILS:LOAD-CUSTOMIZATIONS routine. You can 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 up a fresh LISP, so you
 don't need to load this explicitly unless you have made
 customization changes in this LISP and want to revert
 to the startup settings.

 Additionally, you may wish to revert to the default
 system settings (i.e. the settings from the factory,
 before you set anything). You can do this by simply
 specifying :SYSTEM-DEFAULTS the :FILE argument in your
 call to DECW-UTILS:LOAD-CUSTOMIZATIONS.

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

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

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

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

Additional information available:

object keywordattribute keyword

=TITLE object_keyword
=TITLE Object keywords
=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
 You can specify any of the following as the object-
 keyword argument to the DECW-UTILS:CUSTOMIZATION
 routine: (*** is this list complete? ***)

    :LISTENER
    :DEBUGGER
    :CALLING-STACK-WINDOW
    :VARIABLE-BINDINGS-WINDOW
    :DEBUGGER-COMMANDS-WINDOW
    :STEPPER-COMMANDS-WINDOW
    :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 the customizing the individual utilities under
 additional topics below or see the Customization
 appendix of the VAX LISP Program Development Guide.

=TITLE attribute_keyword
=TITLE Attribute keywords
=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
 You can specify any of the following as the attribute-
 keyword argument to the DECW-UTILS:CUSTOMIZATION
 routine:

    :FONT
    :BOLD-FONT
    :FOREGROUND-COLOR
    :BACKGROUND-COLOR
    :GEOMETRY
    :GEOMETRY-OFFSETS
    :POSITION
    :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 the customizing the individual utilities under
 additional topics below or see the Customization
 appendix of the VAX LISP Program Development Guide.

=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.

 -  Choose Verbs and Menus... from the Customize menu. A
    dialog box appears.

 -  In the text entry field under Verb Names, type LISP.

 -  Click on Enter in the Verb Names region.

 -  In the text entry field under DCL Command for
    Selected Verb, type LISP with any memory or
    initialization qualifiers you normally use from DCL
    (e.g. LISP/MEMORY=25000/INIT=SYS$LOGIN:MYLISPINIT).

 -  Click on Enter 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).

 -  Under Verbs in Menu, click on Add.

 -  Click on OK.

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

Additional information available:

custom vue comfile

=TITLE custom_vue_comfile
=TITLE Using a DCL command file
 Another approach 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 can 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 on MB1. This allows you to move through the
 data in the window at a pace that is easier to view.

=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 highlighted.

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

=TITLE Slider
=TITLE Using the Slider
 The slider is the highlighted rectangle that appears
 in the scroll bar. The size of the slider indicates how
 much of the data appears on the screen. For example, if
 the slider takes up 10% of the scrolling region, only
 10% of the data is 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.