28.5.1 System area

The System area is used to enter and display in the name of the system.

You can browse a system by entering its name into the System: area. While doing this you can press Up, Down or click to complete a partially specified name. This allows you to select from a list of all system names which begin with the partial input you have entered. See Completion for detailed instructions.

The members of the system are displayed in the tree area.

28.5.2 Tree area

The Tree area produces a tree of the current system, together with all its members. The generic facilities available to all tree views throughout the environment are available here; see Manipulating Graphs for details.

• Double-click on a filename to display the file in the editor.
• Click on an unfilled circle alongside a system name to display its members.
• Click on a filled circle alongside a system name to hide its members.
• Select either a system name or a file name to display details in the Description area.

You can operate on systems and files via the context menu, which offers commands such as Concatenate... and Search Files... for systems, and Compile and Print... for files. The system commands are also available in the Works > Systems menu. If no items are selected, the commands apply to the current system, whose name is printed in the System area.

To traverse the system hierarchy, expand a system node in the tree. If the desired parent node is not in the tree, choose Works > Systems > Browse All Systems . The parent of all systems defined in the image at any time is called ALL-SYSTEMS.

To see the source code definition of a system, double-click its node in the tree or do Works > Systems > Find Source or click .

28.5.3 Description area

The Description area shows details about any system member selected in the Tree area. The following items of information are shown:

Module

The name of the selected member. This is either the filename (if the member is a file of source code) or the system name (if the member is a subsystem).

Pathname

The directory pathname of the selected member. This is the full pathname of the file, if the selected member is a file of source code, or the default directory of the system, if the selected member is a subsystem.

Flags

This lists any keyword flags which have been set for the selected member in the system definition, such as the :source-only flag.

To operate on any of the items displayed in this area, select them and choose a command from the Works > Description menu, which contains the standard actions described in Performing operations on selected objects. By making multiple selections, you can operate on as many of the items as you like.

28.5.4 Performing operations on system members

A variety of operations can be performed on any number of nodes selected in the Tree area. If no system nodes are selected, or if you are in another view, the commands are performed on the current system, whose name is printed in the System area.

The Works > Systems menu gives you access to the standard actions described in Performing operations on selected objects.

• Works > Systems > Browse All Systems causes the System Browser to display the root node, whose children include all loaded systems.
• Works > Systems > Browse Systems For Directory causes the System Browser to display all systems that have files in a given directory or one of its subdirectories.
• Choose Works > Systems > Compile and Load , Works > Systems > Compile , or Works > Systems > Load to compile or load the selected systems.
• Choose Works > Systems > Concatenate... to produce a single fasl file from a system. You will need to supply the name of the fasl file, when prompted.
• Choose Works > Systems > Search Files... to search the files of the selected systems (and any subsystems) for a given regular expression. A dialog prompts for the regular expression, and then a Search Files tool is raised in System Search mode, displaying the results of the search. The Search Files tool is described in The Search Files tool.
• Choose Works > Systems > Hide Files , to remove system member files from the tree and display only systems. Choose Works > Systems > Show Files to reverse this effect.
• Choose Works > Systems > Replace to search all the files in the selected members (and any subsystems) for a given string and replace it with another string. You are prompted for both strings in the echo area.

You need to save the buffers to actually save the changes on disk, this is easily done using the Editor tool - see Buffers area for details.