7 The Listener

7.7 The Expression menu

This menu allows you to perform operations on the current expression, that is, the symbol in which the cursor currently lies. It behaves in exactly the same way as the Expression menu in the editor.

Choose Expression > Documentation to display the Common Lisp documentation for the current expression, if any exists. It is printed in a special output browser window.

Choose Expression > Find Source to search for the source code definition of the current expression. If it is found, the file is displayed in the editor: the cursor is placed at the start of the definition. See Chapter 8, "The Editor" for an introduction to the editor.

You can find only the definitions of expressions you have defined yourself (those for which you have written source code) -- not those provided by the environment.

Choose Expression > Class to look at the class of the current expression in a class browser. See Chapter 9, "The Class Browser" for full details about this tool.

Choose Expression > Arguments to print the lambda list of the current expression in the echo podium, if it is a function, generic function or method. This is the same as using the keyboard commandMeta-=, except that the current expression is automatically used.

Choose Expression > Value to display the value of the current expression in the echo podium.

Choose Expression > Trace to display a menu of trace commands which can be applied to the current expression. See Section 14.4 on page 153 for full details.

Choose Expression > Evaluate Region to evaluate the Lisp code in the current region. You must make sure you have marked a region before choosing this command; see Section 8.10.1 on page 100. Whether you use the mouse or keyboard commands to mark a region does not matter.

Choose Expression > Compile Region to compile the Lisp code in the current region.

Choose Expression > Macroexpand to macroexpand the current form. The macroexpansion is printed in an output window, in the same way that compilation output is shown in the editor. Choose View > Output to redisplay the output at any time.

Choose Expression > Walk to walk the current form. This performs a recursive macroexpansion on the form.

Choose Expression > Generic Function to browse the current expression in a generic function browser. This command is only available if the current expression is a generic function. See Chapter 13, "The Generic Function Browser" for more details.


Common LispWorks User Guide, Liquid Common Lisp Version 5.0 - 18 OCT 1996

Generated with Harlequin WebMaker