Next: Online Help, Previous: Use With Terminals, Up: Introduction [Contents][Index]
The echo area is the region which occupies the bottom few lines on the screen. It is used for two purposes: displaying brief messages to the user and prompting.
When a command needs some information from the user, it requests it by displaying a prompt in the echo area. The following is a typical prompt:
Select Buffer: [hemlock-init.lisp /usr/foo/]
The general format of a prompt is a one or two word description of the input requested, possibly followed by a default in brackets. The default is a standard response to the prompt that Hemlock uses if you type Return without giving any other input.
There are four general kinds of prompts:
The response is a single key-event and no confirming Return is needed.
The response is a selection from one of a limited number of choices. Completion is available using Space and Escape, and you only need to supply enough of the keyword to distinguish it from any other choice. In some cases a keyword prompt accepts unknown input, indicating the prompter should create a new entry. If this is the case, then you must enter the keyword fully specified or completed using Escape; this distinguishes entering an old keyword from making a new keyword which is a prefix of an old one since the system completes partial input automatically.
The response is the name of a file, which may have to exist. Unlike other prompts, the default has some effect even after the user supplies some input: the system merges the default with the input filename. See page merging for a description of filename merging. Escape and Space complete the input for a file parse.
The response is a string which must satisfy some property, such as being the name of an existing file.
These key-events have special meanings when prompting:
Confirm the current parse. If no input has been entered, then use the default. If for some reason the input is unacceptable, Hemlock does two things:
This allows you to add to the input before confirming the it again.
Print some sort of help message. If the parse is a keyword parse, then print all the possible completions of the current input in a pop-up window.
Attempt to complete the input to a keyword or file parse as far as possible, beeping if the result is ambiguous. When the result is ambiguous, Hemlock moves the point to the first ambiguous field, which may be the end of the completed input.
In a keyword parse, attempt to complete the input up to the next space. This is useful for completing the names of Hemlock commands and similar things without beeping a lot, and you can continue entering fields while leaving previous fields ambiguous. For example, you can invoke Forward Word as an extended command by typing M-X f Space w Return. Each time the user enters space, Hemlock attempts to complete the current field and all previous fields.
In a string or keyword parse, insert the default so that it may be edited.
Retrieve the text of the last string input from a history of echo area inputs. Repeating this moves to successively earlier inputs.
Go the other way in the echo area history.
Quote the next key-event so that it is not interpreted as a command.
This variable is a list of file types (or extensions), represented as a string without the dot, e.g. "fasl". Files having any of the specified types will be considered nonexistent for completion purposes, making an unambiguous completion more likely. The initial value contains most common binary and output file types.
Next: Online Help, Previous: Use With Terminals, Up: Introduction [Contents][Index]